3D मॉडल के साथ काम करते समय, Jetpack XR SDK टूल, glTF 2.0 ओपन स्टैंडर्ड के साथ काम करता है. जब Android XR, Jetpack XR SDK की मदद से बनाए गए ऐप्लिकेशन रेंडर करता है, तो 3D मॉडल, glTF 2.0 स्टैंडर्ड में बताई गई फ़िज़िकली बेस्ड रेंडरिंग (पीबीआर) तकनीकों के साथ रेंडर किए जाएंगे. साथ ही, इनमें इस्तेमाल किए जा सकने वाले एक्सटेंशन भी शामिल होंगे. डिजिटल कॉन्टेंट बनाने (डीसीसी) वाले ज़्यादातर टूल, 3D मॉडल को glTF फ़ॉर्मैट (.gltf या .glb फ़ाइलें) में एक्सपोर्ट कर सकते हैं. जैसे, Autodesk Maya, Maxon ZBrush, Blender, और Spline.
अगर उपयोगकर्ता या आपके ऐप्लिकेशन ने SpatialEnvironment स्काईबॉक्स तय किया है, तो 3D मॉडल को एनवायरमेंट स्काईबॉक्स से मिली रोशनी की जानकारी के हिसाब से रोशन किया जाएगा. रिफ्लेक्टिव मटीरियल और स्पेक्युलर हाइलाइट भी एनवायरमेंट स्काईबॉक्स को रिफ्लेक्ट करेंगे. अगर पासथ्रू की सुविधा चालू है, तो रोशनी, रिफ़्लेक्शन, और स्पेक्युलर हाइलाइट, एक ही दिशा में रोशनी वाले उजालेदार कमरे के हिसाब से होंगे.
इस्तेमाल किए जा सकने वाले मटीरियल की खास जानकारी पाने के लिए, Khronos की साइट पर glTF PBR प्रॉपर्टी देखें. इन प्रॉपर्टी और अन्य प्रॉपर्टी की मदद से, 3D मॉडल को पसंद के मुताबिक बनाने का तरीका जानने के लिए, अपने ऐप्लिकेशन में 3D मॉडल को पसंद के मुताबिक बनाना लेख पढ़ें
अपने ऐसेट फ़ोल्डर में glTF फ़ाइल जोड़ना
glTF फ़ाइल मिलने के बाद, अगला चरण उसे Android Studio में ऐसेट डायरेक्ट्री में जोड़ना है. हमारा सुझाव है कि आप अपनी ऐसेट टाइप को बेहतर तरीके से व्यवस्थित करने के लिए, models डायरेक्ट्री बनाएं.

SpatialGltfModel का इस्तेमाल करके 3D ऑब्जेक्ट जोड़ना
Android XR, 3D मॉडल के लिए glTF फ़ॉर्मैट के साथ काम करता है. आम तौर पर, ये मॉडल .glb फ़ाइलों के तौर पर सेव किए जाते हैं. इन ऑब्जेक्ट को अपने लेआउट में जोड़ने के लिए, SpatialGltfModel का इस्तेमाल करें. SpatialGltfModel एक सबस्पेस कंपोज़ेबल है. इसकी मदद से, अपने स्पेशल लेआउट में glTF फ़ॉर्मैट में 3D मॉडल जोड़े जा सकते हैं. यह एपीआई, ऐसेट लोड करने और उनकी स्थिति को मैनेज करने की प्रोसेस को आसान बनाता है.
किसी मॉडल को दिखाने के लिए, पहले rememberSpatialGltfModelState का इस्तेमाल करके, उसका सोर्स और स्थिति तय करें. मॉडल को अपने ऐप्लिकेशन के assets फ़ोल्डर, URI या raw data से लोड किया जा सकता है.
val modelState = rememberSpatialGltfModelState( source = SpatialGltfModelSource.fromPath( Paths.get("models/model_name.glb") ) )
स्टेट तय करने के बाद, सबस्पेस में इसे रेंडर करने के लिए, SpatialGltfModel कंपोज़ेबल का इस्तेमाल करें:
SpatialGltfModel(state = modelState, modifier = SubspaceModifier)
कोड के बारे में अहम बातें
- एसिंक्रोनस लोडिंग: मॉडल को एसिंक्रोनस तरीके से लोड किया जाता है. शुरुआती कंपोज़िशन के दौरान, इसका इंट्रिन्सिक साइज़ शून्य हो सकता है. मॉडल तैयार होने के बाद, लेआउट को फिर से मेज़र किया जाता है.
- स्टेट कंट्रोल करना: लोड होने की स्थिति के बारे में क्वेरी करने या ऐनिमेशन कंट्रोल करने के लिए,
SpatialGltfModelState.statusका इस्तेमाल करें. - साइज़ और स्केल तय करना: डिफ़ॉल्ट रूप से, लेआउट का साइज़ ऐसेट के बाउंडिंग बॉक्स से मैच होता है.
SubspaceModifier.sizeका इस्तेमाल करके, इस सेटिंग को बदला जा सकता है. इससे मॉडल को तय की गई सीमाओं के अंदर फ़िट करने के लिए, एक समान रूप से स्केल किया जा सकता है.
Compose SceneCoreEntity का इस्तेमाल करके 3D मॉडल दिखाना
SceneCoreEntity का इस्तेमाल करके 3D मॉडल को प्लेस करने के लिए, आपको पहले GltfModel.create() का इस्तेमाल करके, glTF को मेमोरी में लोड करना होगा. इसके बाद, SceneCoreEntity में 3D मॉडल को रखा जा सकता है, ताकि SceneCore कॉम्पोनेंट को Compose for XR लेआउट के साथ जोड़ा जा सके. अपने लेआउट में 3D ऑब्जेक्ट जोड़ने के लिए, SceneCoreEntity का इस्तेमाल करना लेख पढ़ें.
Jetpack Scenecore का इस्तेमाल करके 3D मॉडल दिखाना
glTF मॉडल लोड करने के लिए, GltfModel.create() को कॉल करें.
val gltfModel = GltfModel.create(session, Paths.get("models", "saturn_rings.glb"))
इस समय, मॉडल को मेमोरी में लोड किया जाता है. हालांकि, इसे अभी रेंडर नहीं किया जाता. अगर आपको कई 3D मॉडल लोड करने हैं या आपका मॉडल बड़ा है, तो उन्हें समय से पहले एसिंक्रोनस तरीके से लोड करना बेहतर होगा. इस तरह, उपयोगकर्ताओं को आपके मॉडल के मेमोरी में लोड होने का इंतज़ार नहीं करना पड़ता.
glTF को ActivitySpace में जोड़ें. कोई इकाई बनाने और उसे ActivitySpace में डालने के लिए, GltfModelEntity.create को कॉल करें. सबसे सही तरीके के तौर पर, आपको यह देखना चाहिए कि ऐप्लिकेशन ऐसी स्थिति में हो जो स्पेशल कैपेबिलिटी की अनुमति देती हो.
if (session.scene.spatialCapabilities.contains(SpatialCapability.SPATIAL_3D_CONTENT)) { val gltfEntity = GltfModelEntity.create(session, gltfModel) }
ऐप्लिकेशन चलाने पर, अब आपको लोड किया गया 3D मॉडल दिखेगा.

Scene Viewer का इस्तेमाल करके 3D मॉडल लोड करना
अगर आपको इंटरैक्शन की बुनियादी सुविधाओं के साथ 3D मॉडल लोड करने का सबसे आसान तरीका चाहिए, तो Scene Viewer का इस्तेमाल उसी तरह किया जा सकता है जिस तरह मोबाइल पर किया जाता है. Android XR और मोबाइल पर Scene Viewer के बीच एक मुख्य अंतर यह है कि Scene Viewer सिर्फ़ glTF फ़ाइल पर ले जाने वाले फ़ाइल यूआरआई पैरामीटर के साथ काम करता है. साथ ही, अन्य सभी पैरामीटर को अनदेखा कर दिया जाता है.
Scene Viewer एक अलग ऐप्लिकेशन है, जिसे इंटेंट का इस्तेमाल करके चालू किया जाता है. यह फ़ुल स्पेस मोड में चलता है. इस वजह से, इसे शुरू करने पर आपका ऐप्लिकेशन नहीं दिखेगा और Scene Viewer पर फ़ोकस होगा. आपने जिन एनवायरमेंट में बदलाव किया है वे उपयोगकर्ता के सिस्टम की सेटिंग के हिसाब से रीसेट हो जाएंगे.
Android XR पर Scene Viewer में glTF फ़ाइल देखने के लिए, Intent इस्तेमाल करने का उदाहरण यहां दिया गया है:
val url = "https://raw.githubusercontent.com/KhronosGroup/glTF-Sample-Models/master/2.0/Avocado/glTF/Avocado.gltf" val sceneViewerIntent = Intent(Intent.ACTION_VIEW) val intentUri = Uri.parse("https://arvr.google.com/scene-viewer/1.2") .buildUpon() .appendQueryParameter("file", url) .build() sceneViewerIntent.setData(intentUri) try { startActivity(sceneViewerIntent) } catch (e: ActivityNotFoundException) { // There is no activity that could handle the intent. }
Scene Viewer में इंटरैक्टिविटी के विकल्पों के बारे में ज़्यादा जानने के लिए, हमारा 3D मॉडल डिज़ाइन दस्तावेज़ देखें.
glTF एक्सटेंशन
Jetpack XR SDK, कई glTF एक्सटेंशन के साथ काम करता है. ये एक्सटेंशन, 3D मॉडल की क्षमताओं को बढ़ाते हैं. ये सुविधाएं, GltfModelEntity और Scene Viewer, दोनों के ज़रिए उपलब्ध हैं.
KHR_animation_pointerKHR_draco_mesh_compressionKHR_lights_punctualKHR_materials_clearcoatKHR_materials_sheenKHR_materials_unlitKHR_materials_variantsKHR_mesh_quantizationKHR_texture_basisuKHR_texture_transformEXT_texture_webp