تشغيل تطبيقات الواقع المعزّز في "محاكي 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 المناسب، اختَر:
    صورة نظام Intel x86 Atom من Google APIs المستوى 27 من واجهة برمجة التطبيقات أو إصدار أحدث

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

  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 المستوى 27 من واجهة برمجة التطبيقات أو المستويات الأحدث.

    • تتوافق فقط بُنى Android Emulator المستندة إلى x86. مشاكل أخرى البِنى الأساسية مثل arm64-v8a وarmeabi-v7 ليست حاليًا

  5. تحقَّق من ضبط جهازك الافتراضي بشكلٍ صحيح:

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

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

  6. انقر على Finish لإنشاء متوسّط مدة المشاهدة.

تشغيل تطبيقك

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

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

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

  1. يمكنك تنزيل أحدث إصدار من Google_Play_Services_for_AR_1.45.0_x86_for_emulator.apk من GitHub. الإصدارات.

  2. ثبِّت حزمة APK التي تم تنزيلها في كل متوسّط مدة مشاهدة تريد استخدامها:

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

    adb install -r Google_Play_Services_for_AR_1.45.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)، فربما تكون ثبّت الإصدار الخاطئ من خدمات Google Play للواقع المعزّز، حِزم APK أنشِئ جهازًا افتراضيًا جديدًا وثبِّته. الإصدار x86.