يمكن للمستخدم تجربة تطبيقك في وضعَين، هما "المساحة المشتركة" أو "المساحة الكاملة". في "مساحة الصفحة الرئيسية"، يمكن للمستخدم تنفيذ مهام متعدّدة مع تشغيل تطبيقك جنبًا إلى جنب مع تطبيقات أخرى. في "المساحة الكاملة"، يكون تطبيقك هو محور تجربة المستخدم مع إمكانية الوصول الكامل إلى الإمكانات المُجسمة في Android XR.
يتم فتح تطبيقك في المساحة المشتركة تلقائيًا ما لم تحدّد خلاف ذلك كما هو موضّح في قسم تحديد الوضع التلقائي للتشغيل.
لا تتوفّر ميزة التوزيع المكاني إلا في "المساحة الكاملة". يمكن أن ينتقل تطبيقك إلى "المساحة الكاملة" للاستفادة من الإمكانات المكانية والثلاثية الأبعاد. عندما يكون تطبيقك هو محور التركيز، يمكنك الانتقال بين هذَين الوضعَين من خلال طلب المساحة المقابلة.
استخدِم SpaceToggleButton للتبديل بين "المساحة المشتركة" و"المساحة الكاملة"
للانتقال بين "المساحة المشتركة" و"المساحة الكاملة"، استخدِم الدالة المركّبة
SpaceToggleButton من مكتبة التصميم المتعدد الأبعاد للواقع الممتد.
هذا زر قابل للتركيب يتكيّف مع الوضع المكاني الحالي ويُبدّل بين "المساحة الكاملة" و"المساحة المشتركة".
إنشاء انتقال مخصّص بين "المساحة المشتركة" و"المساحة الكاملة"
إذا كنت تستخدم مكتبة Jetpack Compose for XR، اطلب "مساحة الصفحة الرئيسية" أو "المساحة الكاملة" باستخدام العنصر المحلي للتركيب LocalSession.
val session = LocalSession.current ?: return session.scene.requestHomeSpace() // or session.scene.requestFullSpace()
إذا كنت تستخدم مكتبة Jetpack SceneCore، يمكنك طلب المساحة المقابلة من Session؛ اطّلِع على الوصول إلى الجلسة من Jetpack
SceneCore.
xrSession.scene.requestHomeSpace()
اطّلِع على الدرس التطبيقي حول الترميز التعرّف على أساسيات Android XR: الجزء 1 - الأوضاع واللوحات المكانية للحصول على أمثلة حول كيفية استخدام هذه الطلبات للانتقال بين الأوضاع من خلال النقر على زر. ننصحك أيضًا بمراجعة إرشادات التصميم لمعرفة المزيد عن الانتقال من "المساحة المشتركة" إلى "المساحة الكاملة" وكيفية الانتقال بينهما على أفضل وجه.
تحديد الوضع التلقائي للتشغيل
بدلاً من ذلك، يمكنك إضافة الأسطر التالية إلى ملف Android Manifest لاختيار المساحة التي يجب فتح تطبيقك فيها:
<!-- Launch in Full Space. -->
<property
android:name="android.window.PROPERTY_XR_ACTIVITY_START_MODE"
android:value="XR_ACTIVITY_START_MODE_FULL_SPACE_MANAGED" />
<!-- Or, launch in Home Space. -->
<property
android:name="android.window.PROPERTY_XR_ACTIVITY_START_MODE"
android:value="XR_ACTIVITY_START_MODE_HOME_SPACE" />
انظر أيضًا
- التحقّق من الإمكانات المكانية
- إنشاء جلسة
- إضافة بيئات إلى تطبيقك
- إضافة نماذج ثلاثية الأبعاد إلى تطبيقك