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

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

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

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

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

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

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

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

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

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

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

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

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

  8. انقر على Finish.

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

لمزيد من المعلومات، راجِع تعليمات Android Studio حول إنشاء جهاز افتراضي.

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

  1. في Android Studio، افتح مدير الأجهزة من خلال النقر على 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 لإنشاء جهاز محاكاة Android.

تشغيل تطبيقك

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

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

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

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

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

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

    adb install -r Google_Play_Services_for_AR_1.50.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 وظهرت لك الرسالة "هذا الجهاز لا يتوافق مع الواقع المعزّز"، تحقَّق من رقم المراجعة في صورة النظام. تأكَّد من استخدام المستوى 27 من واجهة برمجة التطبيقات، الإصدار 4 أو الإصدارات الأحدث.

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

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