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

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

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

يتم فتح تطبيقك في "مساحة المنزل" تلقائيًا ما لم تحدّد خلاف ذلك كما هو описан في القسم تحديد الوضع التلقائي لبدء التشغيل.

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

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

@Composable
private fun HomeSpaceFullSpaceToggleButton() {
    val xrSession = checkNotNull(LocalSession.current)

    val uiIsSpatialized = LocalSpatialCapabilities.current.isSpatialUiEnabled
    val toggleModes = if (uiIsSpatialized) {
        { xrSession.requestHomeSpaceMode() }
    } else {
        { xrSession.requestFullSpaceMode() }
    }

    IconButton(
        onClick = {
            toggleModes()
        }
    ) {
        Icon(
            painter = painterResource(id = drawable),
            contentDescription = stringResource(contentDescription)
        )
    }
}

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

تحديد الوضع التلقائي لبدء التطبيق

لاختيار ما إذا كان سيتم تشغيل تطبيقك في "المساحة الرئيسية" أو "المساحة الكاملة"، أضِف السطور التالية إلى ملف بيان 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" />

انظر أيضًا