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

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

आपका ऐप्लिकेशन डिफ़ॉल्ट रूप से होम स्पेस में खुलता है. हालांकि, अगर आपने लॉन्च के लिए डिफ़ॉल्ट मोड तय करें सेक्शन में कुछ और बताया है, तो ऐप्लिकेशन उसी मोड में खुलेगा.

स्पेशल ऑडियो की सुविधा सिर्फ़ फ़ुल स्पेस में काम करती है. आपका ऐप्लिकेशन, स्पेस और 3D की सुविधाओं का फ़ायदा पाने के लिए, फ़ुल स्पेस में ट्रांज़िशन कर सकता है. जब आपके ऐप्लिकेशन पर फ़ोकस होता है, तो उससे जुड़े स्पेस का अनुरोध करके, इन मोड के बीच ट्रांज़िशन किया जा सकता है.

होम स्पेस और फ़ुल स्पेस के बीच ट्रांज़िशन

अगर XR लाइब्रेरी के लिए Jetpack Compose का इस्तेमाल किया जा रहा है, तो LocalSpatialConfiguration कॉम्पोज़िशन लोकल का इस्तेमाल करके, होम स्पेस या पूरे स्पेस का अनुरोध करें.

LocalSpatialConfiguration.current.requestHomeSpaceMode()
// or
LocalSpatialConfiguration.current.requestFullSpaceMode()

अगर Jetpack SceneCore लाइब्रेरी का इस्तेमाल किया जा रहा है, तो Session से उससे जुड़े स्टोरेज का अनुरोध किया जा सकता है.

val xrSession = Session.create(this)
xrSession.spatialEnvironment.requestHomeSpaceMode()

बटन पर क्लिक करके, एक मोड से दूसरे मोड पर जाने के लिए, इन अनुरोधों का इस्तेमाल करने के उदाहरण देखने के लिए, Android XR के बुनियादी सिद्धांतों के बारे में जानें: पहला भाग - मोड और स्पेस पैनल कोडलैब देखें. हमारा सुझाव है कि होम स्पेस से फ़ुल स्पेस पर स्विच करने और इन दोनों के बीच बेहतर तरीके से ट्रांज़िशन करने के बारे में ज़्यादा जानने के लिए, डिज़ाइन से जुड़े दिशा-निर्देश पढ़ें.

लॉन्च के लिए डिफ़ॉल्ट मोड तय करना

इसके अलावा, अपनी 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" />

यह भी देखें: