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

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

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

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

الانتقال بين "المساحة المنزلية" و"المساحة الكاملة"

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

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

انظر أيضًا