استخدِم محاكي Android لاختبار سيناريوهات الواقع المعزّز بدون جهاز فعلي. يتيح لك "محاكي Android" تشغيل تطبيقات ARCore في بيئة افتراضية باستخدام جهاز محاكي يمكنك التحكّم فيه.
إعداد بيئة التطوير
متطلبات البرامج:
الإصدار 3.1 من استوديو Android أو إصدار أحدث
محاكي Android 27.2.9 أو إصدار أحدث
الحصول على "استوديو Android" وأدوات حزمة تطوير البرامج (SDK) لـ ARCore
ثبِّت الإصدار 3.1 أو إصدار أحدث من Android Studio.
في Android Studio، انتقِل إلى Preferences > Appearance and Behavior > System Settings > Android SDK.
انقر على علامة التبويب SDK Platforms وضع علامة في المربّع Show Package Details.
ضمن إصدار Android المناسب، اختَر:
Google APIs Intel x86 Atom System Image المستوى 27 من واجهة برمجة التطبيقات أو إصدار أحدث.انقر على علامة التبويب SDK Tools وأضِف Android Emulator 27.2.9 أو إصدارًا أحدث.
انقر على OK لتثبيت الحِزم والأدوات المحدّدة.
انقر على OK مرة أخرى لتأكيد التغييرات.
Accept اتفاقية ترخيص "أداة تثبيت المكوّنات"
انقر على Finish.
إنشاء جهاز افتراضي متوافق مع ميزة "الواقع المعزّز"
لمزيد من المعلومات، يُرجى الاطّلاع على تعليمات Android Studio لإنشاء جهاز افتراضي.
إنشاء جهاز Android افتراضي جديد (AVD)
في Android Studio، افتح مدير الأجهزة بالنقر على Tools > Device Manager.
انقر على Create Device في أعلى لوحة مدير الأجهزة.
اختَر ملفّ الأجهزة الهاتف المطلوب أو أنشِئه، ثم انقر على Next.
اختَر صورة نظام
x86أوx86_64تعمل بالمستوى 27 من واجهة برمجة التطبيقات أو إصدار أحدث ثم اختَر Next.على الرغم من أنّ أجهزة ARCore المادية متوافقة مع المستوى 24 من واجهة برمجة التطبيقات أو الإصدارات الأحدث، يتطلب توافق "محاكي Android" المستوى 27 من واجهة برمجة التطبيقات أو الإصدارات الأحدث.
لا تتوفّر سوى معماريات Android Emulator المستندة إلى x86. لا تتوفّر حاليًا التصاميم الأخرى، مثل
arm64-v8aوarmeabi-v7.
تأكَّد من ضبط إعدادات جهازك الظاهري بشكل صحيح:
انقر على Show Advanced Settings.
تأكَّد من ضبط السمة Camera Back على VirtualScene.
انقر على Finish لإنشاء جهاز افتراضي.
تشغيل تطبيقك
اختبِر تطبيق ARCore على جهاز افتراضي متوافق مع الواقع المعزّز في المحاكي. لإجراء ذلك، يمكنك اتّباع تعليمات Android Studio لتشغيل تطبيق في "محاكي Android".
تحديث "خدمات Google Play للواقع المعزّز"
من المحتمل أنّ إصدار "خدمات Google Play للواقع المعزّز" على المحاكي قديم. اتّبِع التعليمات التالية لتعديله:
نزِّل أحدث إصدار من Google_Play_Services_for_AR_1.48.0_x86_for_emulator.apk من صفحة GitHub الإصدارات.
ثبِّت حزمة APK التي تم تنزيلها في كل جهاز افتراضي Android تريد استخدامه:
ابدأ جهاز Android الظاهري المطلوب، ثم اسحب حزمة APK التي تم تنزيلها من مجلد النظام (أي Downloads) على الemuالناسخقيد التشغيل، أو ثبِّته باستخدام
adbأثناء تشغيل الجهاز الافتراضي:adb install -r Google_Play_Services_for_AR_1.48.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)، قد تكون قد ثبَّت الإصدار غير الصحيح من حزمة apk الخاصة بتطبيق خدمات Google Play للواقع المعزّز. أنشئ جهازًا افتراضيًا جديدًا وثبِّت الإصدار x86.