تشغيل تطبيقات الواقع المعزّز في "محاكي 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 المستوى 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.44.0_x86_for_emulator.apk من صفحة إصدارات GitHub.

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

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

    adb install -r Google_Play_Services_for_AR_1.44.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 من واجهة برمجة التطبيقات Revision 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 للواقع المعزّز. قم بإنشاء جهاز افتراضي جديد وتثبيت الإصدار x86.