تشغيل تطبيقات الواقع المعزّز في "محاكي Android"

يمكنك استخدام محاكي Android لاختبار سيناريوهات الواقع المعزّز بدون جهاز فعلي. يتيح لك "محاكي Android" تشغيل تطبيقات ARCore في بيئة افتراضية باستخدام جهاز محاكى يمكنك التحكّم فيه.

إعداد بيئة التطوير

متطلبات البرامج:

الحصول على "استوديو Android" وأدوات حزمة تطوير البرامج (SDK) لتطبيق ARCore

  1. ثبِّت الإصدار 3.1 أو إصدارًا أحدث من استوديو Android.

  2. في "استوديو Android"، انتقِل إلى Preferences > Appearance and Behavior > System Settings > Android SDK.

  3. انقر على علامة التبويب SDK Platforms وعلِّم على Show Package Details.

    ضمن إصدار Android المناسب، اختَر:
    Google APIs Intel x86 Atom System Image المستوى 27 من واجهة برمجة التطبيقات أو إصدار أحدث.

  4. انقر على علامة التبويب SDK Tools وأضِف Android Emulator الإصدار 27.2.9 أو إصدارًا أحدث.

  5. انقر على OK لتثبيت الحِزم والأدوات المحدّدة.

  6. انقر على OK مرة أخرى لتأكيد التغييرات.

  7. Accept اتفاقية الترخيص الخاصة بأداة تثبيت المكوّنات.

  8. انقر على Finish.

إنشاء جهاز افتراضي متوافق مع الواقع المعزّز

لمزيد من المعلومات، يُرجى الاطّلاع على تعليمات "استوديو Android" حول إنشاء جهاز افتراضي.

إنشاء جهاز افتراضي جديد لنظام Android (AVD)

  1. في "استوديو Android"، افتح أداة إدارة الأجهزة من خلال النقر على Tools > Device Manager.

  2. انقر على Create Device في أعلى لوحة أداة إدارة الأجهزة.

  3. اختَر أو أنشِئ ملف تعريف الأجهزة الهاتف الذي تريده وانقر على Next.

  4. اختَر صورة نظام x86 أو x86_64 تعمل بالمستوى 27 من واجهة برمجة التطبيقات أو إصدار أحدث وانقر على Next.

    • على الرغم من أنّ أجهزة ARCore الفعلية متوافقة مع المستوى 24 من واجهة برمجة التطبيقات أو إصدار أحدث، يتطلّب Android Emulator المستوى 27 من واجهة برمجة التطبيقات أو إصدارًا أحدث.

    • لا تتوافق هذه الميزة إلا مع بُنى "محاكي Android" المستندة إلى x86. ولا تتوافق حاليًا بُنى أخرى، مثل arm64-v8a وarmeabi-v7.

  5. تأكَّد من إعداد جهازك الافتراضي بشكل صحيح:

    • انقر على Show Advanced Settings.

    • تأكَّد من ضبط Camera Back على VirtualScene.

  6. انقر على Finish لإنشاء جهاز AVD.

تشغيل التطبيق

اختبِر تطبيق ARCore على جهاز افتراضي متوافق مع الواقع المعزّز في المحاكي. لإجراء ذلك، يمكنك اتّباع تعليمات "استوديو Android" حول تشغيل تطبيق في "محاكي Android".

تحديث "خدمات Google Play للواقع المعزّز"

من المحتمل أنّ يكون إصدار "خدمات Google Play للواقع المعزّز" على المحاكي قديمًا. اتّبِع هذه التعليمات لتحديثه:

  1. نزِّل أحدث إصدار من Google_Play_Services_for_AR_1.54.0_x86_for_emulator.apk من صفحة الإصدارات على GitHub.

  2. ثبِّت ملف APK الذي نزّلته في كل جهاز AVD تريد استخدامه:

    ابدأ جهاز AVD المطلوب، ثم اسحب ملف APK الذي نزّلته من مجلد النظام (مثل Downloads) إلى المحاكي قيد التشغيل ، أو ثبِّته باستخدام adb أثناء تشغيل الجهاز الافتراضي: 

    adb install -r Google_Play_Services_for_AR_1.54.0_x86_for_emulator.apk

كرِّر هذه الخطوات لأي أجهزة AVD إضافية تريد استخدامها.

التحكّم في المشهد الافتراضي

عندما يتصل تطبيقك بـ ARCore، سيظهر لك تراكب يوضّح كيفية التحكّم في الكاميرا وشريط حالة أسفل نافذة المحاكي.

تحريك الكاميرا الافتراضية

اضغط مع الاستمرار على Shift للوصول إلى عناصر التحكّم في حركة الكاميرا. استخدِم عناصر التحكّم التالية لتحريك الكاميرا:

الإجراء الإجراءات المطلوبة
التحرّك لليسار أو لليمين اضغط مع الاستمرار على Shift + اضغط على A أو D
التحرّك للأسفل أو للأعلى اضغط مع الاستمرار على Shift + اضغط على Q أو E
التحرّك إلى الأمام أو الخلف اضغط مع الاستمرار على Shift + اضغط على W أو S
تغيير اتجاه الجهاز اضغط مع الاستمرار على Shift + حرِّك الماوس

حرِّر Shift للعودة إلى الوضع التفاعلي في المحاكي.

استخدِم علامة التبويب Virtual Sensors في عناصر التحكّم الموسّعة لتحديد موضع الجهاز بدقة أكبر.

إضافة صور معزّزة إلى المشهد

حمِّل الصور في البيئة المحاكاة للمحاكي لاختبار الصور المعزّزة.

استخدِم علامة التبويب Camera في Extended controls لإضافة Scene images أو تعديلها. هناك موضعان للصور، أحدهما على الحائط والآخر على الطاولة.

لعرض موضعَي هاتَين الصورتَين في المشهد، شغِّل المحاكي، ثم حرِّك الكاميرا إلى منطقة غرفة الطعام من خلال الباب الموجود خلف موضع بدء الكاميرا.

نصائح لتحديد المشاكل وحلّها

  • إذا تم تشغيل تطبيق ARCore وظهرت لك الرسالة "لا يتوافق هذا الجهاز مع الواقع المعزّز"، تحقَّق من رقم المراجعة في صورة النظام. تأكَّد من استخدام المستوى 27 من واجهة برمجة التطبيقات، المراجعة 4 أو إصدار أحدث.

  • إذا تعذّر على تطبيق ARCore فتح الكاميرا عند تشغيله، تأكَّد من ضبط Camera Back على VirtualScene، كما هو موضّح في خطوات الإعداد أعلاه.

  • إذا تعذّر فتح تطبيق ARCore وظهرت لك رسالة الخطأ "تعذّر إنشاء جلسة واقع معزّز"، تحقَّق من سجلّ التطبيق. إذا عثرت على java.lang.UnsatisfiedLinkError مع رسالة تتضمّن /lib/arm/libarcore_c.so" is for EM_ARM (40) instead of EM_386 (3)، قد يكون ذلك بسبب تثبيت الإصدار الخطأ من ملف APK الخاص بـ خدمات Google Play للواقع المعزّز. أنشِئ جهازًا افتراضيًا جديدًا وثبِّت إصدار x86.