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

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

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

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

الحصول على "استوديو Android" وأدوات SDK لـ ARCore

  1. تثبيت استوديو Android 3.1 أو إصدار أحدث.

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

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

    ضِمن إصدار Android المناسب، اختَر:
    واجهة برمجة التطبيقات Intel x86 Atom System Image Google APIs المستوى 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 لإنشاء "متوسّط مدة المشاهدة".

تشغيل تطبيقك

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

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

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

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

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

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

    adb install -r Google_Play_Services_for_AR_1.41.0_x86_for_emulator.apk

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

السيطرة على المشهد الافتراضي

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

نقل الكاميرا الافتراضية

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

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

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

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

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

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

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

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

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

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

  • إذا تعذَّر على تطبيق 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.