अपने ऐप्लिकेशन में सबस्पेस जोड़ना

इस्तेमाल किए जा सकने वाले XR डिवाइस
इन दिशा-निर्देशों से आपको इस तरह के एक्सआर डिवाइसों के लिए अनुभव तैयार करने में मदद मिलती है.
एक्सआर हेडसेट
वायर वाले एक्सआर स्मार्ट ग्लास

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

स्पेशल लेआउट और सबस्पेस में इस्तेमाल किए जा सकने वाले कॉम्पोनेंट के बारे में ज़्यादा जानने के लिए, स्पेशलाइज़्ड कॉम्पोनेंट देखें.

सबस्पेस हैरारकी के बारे में जानकारी

टॉप-लेवल Subspace, सबसे बाहरी सबस्पेस होता है जिसे आपका ऐप्लिकेशन शुरू करता है. Subspace मेथड को किए गए हर कॉल से, एक नया और अलग Spatial यूज़र इंटरफ़ेस (यूआई) हैरारकी बनती है. यह किसी भी पैरंट Subspace की जगह, ओरिएंटेशन या स्केल को इनहेरिट नहीं करता है.

SpatialPanel, Orbiter, SpatialPopup या किसी अन्य कॉम्पोनेंट में एंबेड या नेस्ट किया गया Subspace बनाने के लिए, PlanarEmbeddedSubspace का इस्तेमाल करें.

PlanarEmbeddedSubspace और Subspace में दो मुख्य अंतर हैं:

  • ये उस 2D लेआउट में हिस्सा लेते हैं जिसमें इन्हें शुरू किया जाता है. इसका मतलब है कि सबस्पेस की ऊंचाई और चौड़ाई, उसके 2D पैरंट लेआउट की ऊंचाई और चौड़ाई के हिसाब से तय होगी.
  • ये उस इकाई के चाइल्ड के तौर पर काम करते हैं जिसमें इन्हें शुरू किया जाता है. इसका मतलब है कि अगर किसी SpatialPanel के अंदर नेस्ट किए गए सबस्पेस कंपोज़ेबल को कॉल किया जाता है, तो वह सबस्पेस उस SpatialPanel का चाइल्ड होता है जिसमें उसे कॉल किया जाता है.

PlanarEmbeddedSubspace के इन व्यवहारों से, ये काम किए जा सकते हैं:

  • चाइल्ड इकाई को पैरंट इकाई के साथ ले जाना
  • ऑफ़सेट SubspaceModifier का इस्तेमाल करके, चाइल्ड एलिमेंट की जगह को ऑफ़सेट करना
  • इसमें 2D यूज़र इंटरफ़ेस (यूआई) के ऊपर 3D ऑब्जेक्ट दिखाया जाता है. इसकी ऊंचाई और चौड़ाई, 2D लेआउट में मौजूद स्पेस के हिसाब से होती है

सबस्पेस के लिए लेआउट अडैप्ट करना

Android XR पर, आपके ऐप्लिकेशन का लेआउट डिफ़ॉल्ट रूप से फ़ुल स्पेस मोड में Subspace के VolumeConstraints से बंधा होता है. इस वजह से, आपको उपयोगकर्ता के लिए उपलब्ध विज़िबल स्पेस को ध्यान में रखना चाहिए और उसके हिसाब से अपना लेआउट अडजस्ट करना चाहिए. recommendedContentBoxInFullSpace, ActivitySpace के अंदर बाउंडिंग बॉक्स के लिए खास डाइमेंशन उपलब्ध कराता है, ताकि कॉन्टेंट को उपयोगकर्ता के फ़ील्ड ऑफ़ व्यू (कैमरे से दिख रहा व्यू) में रखा जा सके.

आपके ऐप्लिकेशन का मुख्य कॉन्टेंट इस बॉक्स में फ़िट होना चाहिए. अगर आपके पास ऐसा कॉन्टेंट है जो सुझाई गई सीमाओं से ज़्यादा है, तो ऐसे लेआउट का इस्तेमाल करें जिससे उपयोगकर्ता अपने सिर को घुमाकर, स्पेस को एक्सप्लोर कर सकें. recommendedContentBoxInFullSpace की डिफ़ॉल्ट सीमा को बदला जा सकता है. इसके लिए, साइज़ के हिसाब से कस्टम मॉडिफ़ायर लागू करें, जैसे कि SubspaceModifier.requiredSizeIn. अनबाउंडेड व्यवहार के लिए, allowUnboundedSubspace = true सेट करें.

ज़रूरत के हिसाब से ये डाइमेंशन पाने के लिए, मौजूदा सेशन का इस्तेमाल करके recommendedContentBoxInFullSpace को कॉल करें. यह उदाहरण देखें:

val session = LocalSession.current
session?.scene?.activitySpace?.recommendedContentBoxInFullSpace

अपने ऐप्लिकेशन में सबस्पेस जोड़ना

यहां दिए गए कोड के उदाहरण से पता चलता है कि अपने ऐप्लिकेशन में Subspace और PlanarEmbeddedSubspace को कैसे जोड़ा जाए:

setContent {
    // This is a top-level subspace
    Subspace {
        SpatialPanel {
            MyComposable()
        }
    }
}

@Composable
private fun MyComposable() {
    Row {
        PrimaryPane()
        SecondaryPane()
    }
}

@Composable
private fun PrimaryPane() {
    // This is an embedded subspace, because PrimaryPane is in a SpatialPanel
    // and that SpatialPanel is in the top-level Subspace
    PlanarEmbeddedSubspace {
        SpatialPanel {}
    }
}

ज़्यादा जानकारी के लिए, Subspace और PlanarEmbeddedSubspace पर पूरा रेफ़रंस दस्तावेज़ देखें.