होम स्पेस से फ़ुल स्पेस पर स्विच करना

उपयोगकर्ता आपके ऐप्लिकेशन को दो मोड में इस्तेमाल कर सकता है: होम स्पेस या फ़ुल स्पेस. होम स्क्रीन पर, उपयोगकर्ता आपके ऐप्लिकेशन के साथ-साथ अन्य ऐप्लिकेशन का इस्तेमाल करके, एक साथ कई काम कर सकता है. फ़ुल स्पेस में, आपका ऐप्लिकेशन उपयोगकर्ता के अनुभव का मुख्य हिस्सा बन जाता है. साथ ही, Android XR की इमर्सिव सुविधाओं का पूरा ऐक्सेस भी मिलता है.

फ़िलहाल, स्पेशलाइज़ेशन की सुविधा सिर्फ़ फ़ुल स्पेस में काम करती है. आपका ऐप्लिकेशन, स्पेस और 3D की सुविधाओं का फ़ायदा पाने के लिए, फ़ुल स्पेस में ट्रांज़िशन कर सकता है. जब आपका ऐप्लिकेशन फ़ोकस में हो, तो 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" />

यह भी देखें: