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

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

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

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

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

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

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

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

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

إذا كنت تستخدم مكتبة 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" />

انظر أيضًا