أدوات "استوديو Android" لأجهزة الواقع المعزّز

توضّح لك هذه المستندات كيفية استخدام "محاكي Android XR" و"أداة فحص التنسيق" في "استوديو Android" لإنشاء تطبيق XR.

يتضمّن "استوديو Android" الميزات الجديدة التالية لتجربة الواقع الممتد:

• Android XR Emulator
• إتاحة ميزات الواقع الممتد في "أداة فحص التنسيق"

Android XR Emulator

يوفّر "محاكي Android XR" جهازًا افتراضيًا للواقع الممتد من أجل اختبار تطبيقات الواقع الممتد وتصحيح أخطائها في Android Studio. يحاكي هذا المحاكي جهاز XR، ما يتيح لك تجربة تطبيقك في بيئة مكانية ثلاثية الأبعاد. يتيح لك ذلك إنشاء تطبيقاتك بدون الحاجة إلى أجهزة فعلية خلال مراحل التطوير المبكرة، ما يؤدي إلى تبسيط سير العمل وتسريع عملية التكرار.

إذا كانت هذه هي المرة الأولى التي تستخدم فيها محاكيًا مع "استوديو Android"، ننصحك بمراجعة المستندات العامة الخاصة بمحاكي Android.

تشغيل "محاكي Android XR"

بعد تثبيت "محاكي Android XR"، انقر على الزر تشغيل في "إدارة الأجهزة" على الجهاز.

تفعيل الماوس ولوحة المفاتيح

يتيح المحاكي حاليًا إدخال البيانات باستخدام الماوس ولوحة المفاتيح فقط. عند استخدام المحاكي، تأكَّد من اختيار رمز لوحة المفاتيح والماوس.

بعد الانتهاء من ذلك، يمكنك البدء في التفاعل مع عناصر مختلفة داخل المساحة الافتراضية عن طريق تحريك مؤشر الماوس فوق نافذة المحاكي.

النظر والتنقّل في البيئة الافتراضية

يحاكي Android XR عناصر التطبيق في بيئة ثلاثية الأبعاد افتراضية. استخدِم عناصر التحكّم التالية لتغيير اتجاه العرض والتحريك الأفقي والتحريك العمودي والتدوير وإعادة الضبط:

	التحريك: انقر واسحب الماوس للانتقال للأعلى والأسفل ومن جانب إلى آخر. سيسمح ذلك بعرض محتويات المحاكي من زوايا مختلفة
	التحريك للأمام أو الخلف: انقر على الماوس واسحبه للتحرّك بالقرب من الكائنات المعروضة أو بعيدًا عنها
	التدوير: انقر على الماوس واسحبها لتدوير طريقة العرض في هذا الاتجاه
	إعادة الضبط: انقر على هذا الزر لإعادة المحاكي إلى العرض التلقائي

يمكنك أيضًا استخدام اختصارات لوحة المفاتيح التالية للتنقّل في البيئة الافتراضية. لاستخدام هذه الإيماءات أثناء استخدام الماوس ولوحة المفاتيح، اضغط مع الاستمرار على مفتاح Option (في نظام التشغيل macOS) أو مفتاح Alt (في نظام التشغيل Windows).

• W (أو مفتاح السهم المتّجه للأعلى): للانتقال إلى الأمام في طريقة العرض الحالية
• A (أو مفتاح السهم المتّجه لليسار): التنحّي إلى اليسار
• S: (أو مفتاح السهم المتّجه للأسفل): للانتقال إلى الخلف
• D (أو مفتاح السهم المتّجه لليمين): التنحّي إلى اليمين
• س: تحريك الجهاز عموديًا للأسفل
• E: تحريك المؤشر عموديًا للأعلى

تفعيل وضع "عرض فيديو خارجي"

استخدِم خيار القائمة التالي لتفعيل أو إيقاف بيئة محاكاة للرؤية المجسمة.

عند تفعيل وضع "الرؤية المحيطة"، سيتم عرض بيئة داخلية محاكاة. استخدِم هذا الوضع لاختبار التطبيقات في الواقع المختلط.

عناصر التحكّم الأخرى في المحاكي

	الطاقة: يحاكي تشغيل الجهاز أو إيقاف تشغيله
	مستوى الصوت: يحاكي التحكّم في مستوى الصوت
	لقطة شاشة: لالتقاط لقطة شاشة للحالة الحالية للجهاز
	التحكّم باستخدام 3 أزرار في Android: يحاكي أزرار "رجوع" و"الشاشة الرئيسية" و"نظرة عامة"

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

راجِع ملاحظات الإصدار لمعرفة أي مشاكل معروفة والحلول البديلة لها.

إذا واجهت مشكلة غير معروفة، يمكنك الاطّلاع على صفحة الدعم للحصول على تعليمات حول كيفية طلب المساعدة والإبلاغ عن المشاكل.

سيساعدنا تضمين تقرير عن الأعطال أو الأخطاء في فهم المشكلة بشكل أفضل. تقدّم لقطات الشاشة والتسجيلات أيضًا تفاصيل إضافية مطلوبة. توضّح التعليمات الواردة في هذا القسم كيفية تحميل تقرير أعطال واستخدام أداة adb لإنشاء تقرير أخطاء.

استخدام "أداة فحص التنسيق" في "استوديو Android" مع تطبيق XR

بعد البدء في إنشاء اللوحات المكانية والأجهزة المدارية، يمكنك فحص التصميم باستخدام "أداة فحص التنسيق" في Android Studio. إذا لم تكن معتادًا على استخدام أداة Layout Inspector، يمكنك الاطّلاع على الدليل حول تصحيح أخطاء التصميم.

اتّبِع الخطوات التالية لاستخدام "أداة فحص التنسيق" مع تطبيق Android XR:

1. بعد فتح مشروعك في "استوديو Android"، تأكَّد من إيقاف "أداة فحص التنسيق" المضمّنة (ألغِ تحديد الخيار وأعِد تشغيل "استوديو Android").
2. شغِّل تطبيقك.
3. بعد اكتمال نشر التطبيق، اختَر الأدوات > أداة فحص التنسيق.

سيتم فتح "أداة فحص التنسيق" هذه في نافذة مضمّنة. بعد بضع ثوانٍ، ستظهر المعاينة على اليمين وشجرة المكوّنات على اليسار. تظهر العناصر الدوّارة واللوحات كعناصر منفصلة أسفل المحتوى الرئيسي.

يمكنك الآن التفاعل مع تطبيقك في المحاكي. إذا أردت فحص أي مكوّن، انقر عليه في المعاينة أو في شجرة المكوّنات.

يمكنك الاطّلاع على سمات المكوّن من خلال النقر على علامة التبويب "السمات" في الزاوية اليمنى.

تفعيل "إحصاءات الاستخدام" للمساعدة في تحسين Android Studio لنظام التشغيل XR

ننصحك بتفعيل إحصاءات الاستخدام وإرسال الملاحظات لمساعدتنا في تحسين هذه الأدوات. بما أنّ هذا الإصدار هو إصدار تجريبي من Android Studio، لا تزال العديد من هذه الميزات قيد التطوير.

انقر على الإعدادات > المظهر والسلوك > إعدادات النظام > مشاركة البيانات، وتأكَّد من تحديد الخيار إرسال إحصاءات الاستخدام إلى Google.

‫OpenXR™ وشعار OpenXR هما علامتان تجاريتان مملوكتان لشركة The Khronos Group Inc. ومسجّلتان كعلامة تجارية في الصين والاتحاد الأوروبي واليابان والمملكة المتحدة.