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

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

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

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

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

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

  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 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 لإنشاء جهاز افتراضي.

تشغيل تطبيقك

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

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

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

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

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

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

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