تشغيل تجارب الواقع المعزّز في تطبيقك على المحاكي

أجهزة XR المشمولة
تساعدك هذه الإرشادات في إنشاء تجارب لهذه الأنواع من أجهزة XR.
النظارات الصوتية و
النظارات المزودة بشاشة

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

تشغيل تطبيقك على المحاكي

لتشغيل تطبيقك على المحاكي، اتّبِع الخطوات التالية:

  1. في أداة إدارة الأجهزة في "استوديو Android"، ابحث عن جهاز Android الافتراضي الذي أنشأته ليكون بمثابة جهاز مضيف لجهاز Android الافتراضي للنظّارة الذكية، وانقر على بدء .

    (يُرجى النقر.)

  2. في أداة إدارة الأجهزة في "استوديو Android"، ابحث عن جهاز Android الافتراضي للنظّارة الذكية الذي أنشأته وانقر على بدء.

    (يُرجى النقر.)

  3. لتشغيل تطبيقك في المحاكي، اختَر جهاز Android الافتراضي للهاتف من القائمة المنسدلة للجهاز المستهدف في شريط الأدوات الرئيسي في "استوديو Android"، ثم انقر على تشغيل.

    إعدادات تشغيل التطبيق في "استوديو Android"

استخدام عناصر التحكّم في المحاكي للنظارات

استخدِم عناصر التحكّم في المحاكي للمساعدة في اختبار سلوك تطبيقك في السيناريوهات الشائعة مع النظارات الصوتية ونظارات بشاشة عرض. راجِع الأقسام التالية للاطّلاع على تفاصيل حول كل عنصر من عناصر التحكّم التي يمكنك استخدامها.

توفير بيانات الإدخال من لوحة اللمس

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

استخدِم فأرة الكمبيوتر داخل منطقة لوحة اللمس لمحاكاة اللمس، وفعِّل وضع إصبعان لتنفيذ إيماءات بإصبعَين.

يمثّل الجانب الأيمن من منطقة لوحة اللمس في المحاكي المنطقة على جهاز حقيقي التي تكون في الجزء الأمامي من النظارات (حيث العدسات)، بينما يمثّل الجانب الأيسر المنطقة على جهاز حقيقي التي تكون في الجزء الخلفي من النظارات (حيث تستقر النظارات على أذنيك). من المهم معرفة هذا الاتجاه عند محاكاة الإيماءات، مثل التمرير للأمام أو للخلف.

الشكل 1. تقع منطقة لوحة اللمس في "محاكي Android XR" أسفل منطقة العرض مباشرةً.

توفير بيانات الإدخال الصوتية

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

أثناء تشغيل الميكروفون، تحدَّث لاستخدام الكلمات الرئيسية وإصدار الأوامر.

الشكل 2. فعِّل الميكروفون لاستخدام ميكروفون الكمبيوتر لتوفير بيانات الإدخال الصوتية.

محاكاة النظارات الصوتية

أثناء اختبار تطبيقك للنظارات بشاشة عرض، عليك محاكاة نظارات صوتية حتى يتمكّن تطبيقك من دعم كلّ من النظارات الصوتية والنظارات بشاشة عرض.

لمساعدتك في اختبار حالات الاستخدام هذه، يتيح لك تطبيق Glasses تفعيل وضع الاستماع إلى الصوت فقط:

  1. في محاكي الهاتف، افتح تطبيق Glasses.

    رمز تطبيق "النظارات"

  2. انقر على إعدادات الجهاز، ثم فعِّل وضع الاستماع إلى الصوت فقط.

    تفعيل وضع "الاستماع إلى الصوت فقط" أو إيقافه من خلال النظارات

  3. أوقِف محاكي الهاتف ومحاكي النظارات.

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

    (يُرجى النقر.)

  5. اتّبِع الخطوات الأخرى لإعادة تشغيل محاكي النظارات وتشغيل تطبيقك.

إيقاف مهلة تأجيل الشاشة

يُعدّ سلوك مهلة الشاشة من الاعتبارات المهمة عند تطوير تجارب تطبيقك للنظارات الصوتية ونظارات بشاشة عرض. لهذا السبب، ننصحك بترك السلوك التلقائي أثناء إجراء اختبار التطبيق المعتاد. ومع ذلك، في الحالات التي تتداخل فيها مهلة الشاشة مع الاختبار، يمكنك إيقاف السلوك التلقائي باستخدام أمر ADB التالي:

adb shell dumpsys activity service com.google.android.glasses.core/com.google.android.projection.core.app.service.AndroidProjectionCoreService preferences_set pref_automatic_snooze_timeout false

لاستعادة السلوك التلقائي لمهلة الشاشة، شغِّل أمر ADB التالي:

adb shell dumpsys activity service com.google.android.glasses.core/com.google.android.projection.core.app.service.AndroidProjectionCoreService preferences_set pref_automatic_snooze_timeout true

استخدام Gemini Live

اتّبِع الخطوات التالية لتشغيل Gemini Live في محاكي النظارات:

  1. قبل محاولة استخدام Gemini Live، حدِّث تطبيق Google إلى أحدث إصدار (الحد الأدنى للإصدار المطلوب هو 16.46.63) على محاكي الهاتف:

    1. على محاكي الهاتف، افتح تطبيق "متجر Google Play".
    2. ابحث عن "Google" وانقر على تطبيق Google.

      تحديث تطبيق Google من تطبيق "متجر Google Play"

    3. انقر على تحديث (Update).

  2. شغِّل Gemini Live من محاكي النظارات من خلال النقر مع الاستمرار على لوحة اللمس لمدة ثانيتَين تقريبًا.

    في المرة الأولى، سيؤدي ذلك إلى تشغيل مجموعة من طلبات الأذونات على محاكي الهاتف. امنح جميع الأذونات المطلوبة، ثم انقر مع الاستمرار على لوحة اللمس في محاكي النظارات لمدة ثانيتَين تقريبًا مرة أخرى.

    قبول جميع الأذونات المطلوبة لاستخدام Gemini Live على محاكي النظّارة الذكية

    عندما يكون Gemini Live نشطًا ويستمع، سيظهر لك ما يلي على محاكي النظارات:

    يظهر مؤشر مرئي على الشاشة عندما تكون ميزة Gemini Live نشطة.

  3. تأكَّد من أنّ إدخال الميكروفون المضيف نشط على محاكي النظارات من خلال النظر إلى محاكي الهاتف. من المفترض أن يظهر لك إشعار مشابه للإشعار التالي:

    يشير إشعار على محاكي الهاتف إلى أنّ إدخال الميكروفون المضيف نشط.

استخدام بيئات صور مخصّصة

يمكنك إجراء الاختبار باستخدام صور للبيئات الحقيقية لمساعدتك في تقييم كيفية عرض تجاربك المعزّزة في هذه السيناريوهات باستخدام Jetpack Compose Glimmer.

في حين أنّ التصميم التلقائي تم تحسينه مسبقًا للبيئات الفاتحة والداكنة، تتطلب التخصيصات الخاصة بالعلامة التجارية إعادة الاختبار بعناية. اختبِر بعناية حتى تحافظ واجهة المستخدم على مستوى عالٍ من الوضوح والتباين على الشاشات البصرية الشفافة، بغض النظر عن بيئة المستخدم.

لاستخدام صورة ثابتة مخصّصة كخلفية داخل المحاكي:

  1. اختَر البيئات من عناصر التحكّم في المحاكي.
  2. في القائمة المنسدلة، اختَر بيئة مخصّصة.

    اختَر صورة مخصّصة لبيئة الصور في "استوديو Android".

  3. اختَر صورة لاستخدامها أو اختَر صورة سبق استخدامها من قائمة البيئات الأخيرة.

    أثناء معاينة واجهة مستخدم تطبيقك، ستظهر البيئة المخصّصة في الخلفية.

التقاط لقطة شاشة

لالتقاط الناتج المرئي لتطبيقك الذي يتم تشغيله داخل المحاكي، يمكنك أخذ لقطات شاشة.

لإجراء ذلك، انقر على أخذ لقطة شاشة في عناصر التحكّم في المحاكي.

استخدِم عناصر التحكّم في المحاكي لالتقاط لقطة شاشة لعرض المحاكي في "استوديو Android".
 

تعمل هذه الميزة بالطريقة نفسها التي تعمل بها عند أخذ لقطات شاشة للأجهزة الافتراضية الأخرى في "محاكي Android XR"، ويتم حفظ لقطة الشاشة التي تم التقاطها كملف PNG.

تسجيل محتوى الشاشة

لتسجيل محتوى شاشة تطبيقك الذي يتم تشغيله داخل المحاكي:

  1. انقر على تسجيل الشاشة في عناصر التحكّم في المحاكي.

    استخدِم عناصر التحكّم في المحاكي لتسجيل شاشة المحاكي في "استوديو Android".

  2. اختَر "عرض النقرات" إذا كنت تريد تمييز تفاعلات المستخدم.

  3. بعد تسجيل المحتوى الذي تريده، انقر على إيقاف التسجيل.

    ستظهر معاينة، ويمكنك حفظ الملف على جهاز الكمبيوتر.

التقاط الصور أو الفيديوهات

لا تتوفّر بعد ميزات التقاط الصور بالكاميرا في "محاكي Android XR".