الانتقال من "المساحة المنزلية" إلى "المساحة الكاملة"

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

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

يتم فتح تطبيقك في "مساحة العمل" تلقائيًا ما لم تحدّد خلاف ذلك كما هو موضّح في قسم تحديد الوضع التلقائي للتشغيل.

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

استخدِم SpaceToggleButton للتبديل بين "المساحات المنزلية" و"المساحات الكاملة"

للانتقال بين "مساحة الصفحة الرئيسية" و"المساحة الكاملة"، استخدِم العنصر القابل للإنشاء SpaceToggleButton من مكتبة Material Design للواقع الممتد.

هذا زر قابل للإنشاء يتكيّف مع الوضع المكاني الحالي ويتيح التبديل بين "المساحة الكاملة" و"مساحة الشاشة الرئيسية".

إنشاء انتقال مخصّص بين "المساحة الرئيسية" و"المساحة الكاملة"

إذا كنت تستخدم مكتبة Jetpack Compose للواقع الممتد، اطلب المساحة الرئيسية أو المساحة الكاملة باستخدام LocalSession.

LocalSpatialConfiguration.current.requestHomeSpaceMode()
// or
LocalSpatialConfiguration.current.requestFullSpaceMode()
ModeTransition.kt

إذا كنت تستخدم مكتبة Jetpack SceneCore، يمكنك طلب المساحة المقابلة من Session، راجِع الوصول إلى الجلسة من Jetpack SceneCore.

xrSession.scene.requestHomeSpaceMode()
ModeTransition.kt

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

تحديد الوضع التلقائي للتشغيل

بدلاً من ذلك، يمكنك إضافة الأسطر التالية إلى ملف AndroidManifest.xml لتحديد المساحة التي يجب أن يفتح فيها تطبيقك:

<!-- 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" />

انظر أيضًا