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

इन XR डिवाइसों पर काम करने वाले ऐप्लिकेशन बनाना
इस गाइड की मदद से, इन XR डिवाइसों के लिए ऐप्लिकेशन बनाए जा सकते हैं.
एक्सआर हेडसेट
तार वाले एक्सआर के स्मार्ट ग्लास

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

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

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

होम स्पेस और फ़ुल स्पेस के बीच स्विच करने के लिए, SpaceToggleButton का इस्तेमाल करना

होम स्पेस और फ़ुल स्पेस के बीच ट्रांज़िशन करने के लिए, SpaceToggleButton कंपोज़ेबल का इस्तेमाल करें, जो मटीरियल डिज़ाइन for एक्सआर लाइब्रेरी से है.

यह एक कंपोज़ेबल बटन है, जो मौजूदा स्पेशल मोड के हिसाब से काम करता है. साथ ही, यह फ़ुल स्पेस और होम स्पेस के बीच टॉगल करता है.

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

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

val session = LocalSession.current ?: return
session.scene.requestHomeSpace()
// or
session.scene.requestFullSpace()

अगर Jetpack SceneCore लाइब्रेरी का इस्तेमाल किया जा रहा है, तो से जुड़े स्पेस का अनुरोध किया जा सकता है Session. इसके लिए, Jetpack SceneCore से सेशन ऐक्सेस करना लेख पढ़ें.

xrSession.scene.requestHomeSpace()

बटन पर क्लिक करके, मोड के बीच ट्रांज़िशन करने के लिए, इन अनुरोधों का इस्तेमाल करने के उदाहरण देखने के लिए, Android XR की बुनियादी बातें जानें: पार्ट 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" />

इन्हें भी देखें