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

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

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

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

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

  8. انقر على Finish

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

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

إنشاء جهاز افتراضي جديد (AVD) يعمل بنظام التشغيل Android

  1. في "استوديو Android"، افتح مدير AVD من خلال النقر على Tools > AVD Manager.

  2. انقر على Create Virtual Device في أسفل مربع الحوار مدير AVD.

  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 لإنشاء AVD.

تشغيل تطبيقك

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

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

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

  1. نزِّل أحدث إصدار من Google_Play_Services_for_AR_1.32.0_x86_for_emulator.APK من صفحة إصدارات GitHub.

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

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

    adb install -r Google_Play_Services_for_AR_1.32.0_x86_for_emulator.apk

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

التحكم في المشهد الافتراضي

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

تحريك الكاميرا الافتراضية

اضغط مع الاستمرار على Option (نظام التشغيل macOS) أو Alt (Linux أو Windows) للوصول إلى عناصر التحكم في الحركة للكاميرا. استخدِم عناصر التحكّم التالية لتحريك الكاميرا:

النظام الأساسي الإجراء ما يجب فعله
نظام التشغيل Mac نقل إلى اليسار أو اليمين الضغط مع الاستمرار على Option + الضغط على A أو D
النقل لمستوى أدنى أو أعلى الضغط مع الاستمرار على Option + الضغط على Q أو E
التحرك إلى الأمام أو الخلف الضغط مع الاستمرار على Option + الضغط على W أو S
تغيير اتجاه الجهاز الضغط مع الاستمرار على Option + تحريك الماوس
نظام التشغيل Linux أو Windows نقل إلى اليسار أو اليمين الضغط مع الاستمرار على Alt + A أو D
النقل لمستوى أدنى أو أعلى الضغط مع الاستمرار على Alt + Q أو E
التحرك إلى الأمام أو الخلف الضغط مع الاستمرار على Alt + W أو S
تغيير اتجاه الجهاز الضغط مع الاستمرار على Alt + تحريك الماوس

عليك إصدار Option أو Alt للعودة إلى الوضع التفاعلي في المحاكي.

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

إضافة الصور المحسّنة إلى المشهد

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

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

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

ملاحظات حول تحديد المشاكل وحلّها

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

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

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