يمكن للمستخدم تجربة تطبيقك في وضعَين، "المساحة الرئيسية" أو "المساحة الكاملة". في "مساحة" Home ، يمكن للمستخدم إنجاز مهام متعدّدة مع تشغيل تطبيقك جنبًا إلى جنب مع التطبيقات الأخرى. في وضع "ملء الشاشة"، يأخذ تطبيقك مركز الصدارة كنقطة تركيز لتجربة المستخدم مع إمكانية الوصول الكامل إلى الإمكانات الغامرة لنظام Android XR.
يتم فتح تطبيقك في "مساحة المنزل" تلقائيًا ما لم تحدّد خلاف ذلك كما هو описан في قسم تحديد الوضع التلقائي لبدء التشغيل.
لا تتوفّر ميزة الصوت المكاني إلا في "المساحة الكاملة". يمكن لتطبيقك الانتقال إلى "المساحة الكاملة" للاستفادة من الإمكانات المكانية والثلاثية الأبعاد. عندما يكون تطبيقك في المقدّمة، يمكنك التبديل بين هذين الوضعَين من خلال طلب المساحة المقابلة.
الانتقال بين "المساحة المنزلية" و"المساحة الكاملة"
إذا كنت تستخدم مكتبة Jetpack Compose لتطبيقات الواقع الممتد، اطلب المساحة الرئيسية
أو المساحة الكاملة باستخدام العنصر LocalSpatialConfiguration
composition local.
LocalSpatialConfiguration.current.requestHomeSpaceMode()
// or
LocalSpatialConfiguration.current.requestFullSpaceMode()
إذا كنت تستخدم مكتبة Jetpack SceneCore، يمكنك طلب
المساحة المقابلة من Session.
val xrSession = Session.create(this)
xrSession.spatialEnvironment.requestHomeSpaceMode()
اطّلِع على الدرس التطبيقي التعرّف على أساسيات الواقع الممتد على Android: الجزء 1 - الأوضاع ولوحات العرض المكانية للاطّلاع على أمثلة عن كيفية استخدام هذه الطلبات للانتقال بين الأوضاع من خلال النقر على زر. ننصحك أيضًا بمراجعة إرشادات التصميم للتعرّف على مزيد من المعلومات عن الانتقال من "المساحة الرئيسية" إلى "المساحة الكاملة" وكيفية الانتقال بينهما على أفضل نحو.
تحديد الوضع التلقائي لبدء التطبيق
بدلاً من ذلك، يمكنك إضافة الأسطر التالية إلى ملف بيان Android لتحديد المساحة التي يجب أن يفتح فيها تطبيقك:
<!-- 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" />
انظر أيضًا
- التحقّق من الإمكانات المكانية
- إنشاء جلسة
- إضافة بيئات إلى تطبيقك
- إضافة نماذج ثلاثية الأبعاد إلى تطبيقك