Jetpack XR SDK टूल का इस्तेमाल करके ऐप्लिकेशन बनाना

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

Jetpack XR SDK में वे सभी टूल और लाइब्रेरी शामिल हैं जिनकी मदद से, Android XR डिवाइसों के लिए इमर्सिव और ऑगमेंटेड एक्सपीरियंस तैयार किए जा सकते हैं.

बेहतरीन अनुभव पाएं

एक्सआर हेडसेट और वायर वाले एक्सआर ग्लास जैसे खास और हाई-फ़िडेलिटी वाले डिवाइसों को टारगेट करें. Kotlin और Compose जैसे मॉडर्न Android डेवलपमेंट टूल इस्तेमाल करें. साथ ही, Java और Views जैसे पिछली जनरेशन के टूल इस्तेमाल करें. अपने यूज़र इंटरफ़ेस (यूआई) को स्पेशलाइज़ किया जा सकता है, 3D मॉडल लोड और रेंडर किए जा सकते हैं, और असल दुनिया को बेहतर तरीके से समझा जा सकता है.

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

बेहतर और मददगार अनुभव देना

हल्के और स्टाइलिश ऑडियो ग्लास और डिसप्ले ग्लास को टारगेट करें. Kotlin और Jetpack Compose Glimmer जैसे मॉडर्न Android डेवलपमेंट टूल इस्तेमाल करें. ऐसे एपीआई इस्तेमाल करें जो फ़ोन से स्मार्ट ग्लास पर ऐप्लिकेशन इस्तेमाल करने के अनुभव को प्रोजेक्ट करने में मदद करते हैं.

Jetpack लाइब्रेरी का इस्तेमाल करना

Jetpack XR SDK टूल की लाइब्रेरी में, बेहतरीन और इमर्सिव अनुभव, हल्के-फुल्के और ऑगमेंटेड अनुभव, और इनके बीच की हर चीज़ बनाने के लिए एक बेहतरीन टूलकिट उपलब्ध है. यहां दी गई लाइब्रेरी, Jetpack XR SDK का हिस्सा हैं:

  • Jetpack Compose for XR: डिक्लेरेटिव तरीके से स्पेशल यूज़र इंटरफ़ेस (यूआई) लेआउट बनाएं, जो Android XR की स्पेशल सुविधाओं का फ़ायदा लेते हैं.
  • एक्सआर के लिए मटीरियल डिज़ाइन: मटीरियल कॉम्पोनेंट और लेआउट की मदद से, एक्सआर के लिए ऐप्लिकेशन बनाएं.
  • Jetpack SceneCore: 3D कॉन्टेंट की मदद से, Android XR सीन ग्राफ़ बनाएं और उसमें बदलाव करें.
  • Jetpack XR के लिए ARCore: इसकी मदद से, डिजिटल कॉन्टेंट को असल दुनिया में लाया जा सकता है.
  • Jetpack Compose Glimmer: यह एक यूज़र इंटरफ़ेस (यूआई) टूलकिट है. इसका इस्तेमाल, Android XR के बेहतर अनुभव देने वाले ऐप्लिकेशन बनाने के लिए किया जाता है. ये ऐप्लिकेशन, डिसप्ले ग्लास के लिए ऑप्टिमाइज़ किए गए होते हैं.
  • Jetpack Projected: ये ऐसे एपीआई हैं जो फ़ोन से ऑडियो ग्लास या डिसप्ले ग्लास पर, ऐप्लिकेशन इस्तेमाल करने के अनुभव को प्रोजेक्ट करने में मदद करते हैं.

डेवलपर के लिए झलक के दौरान एपीआई डेवलपमेंट

Jetpack XR SDK की लाइब्रेरी, Android XR के डेवलपर के लिए झलक का हिस्सा हैं. साथ ही, ये एपीआई अब भी डेवलप किए जा रहे हैं. पहले से मौजूद समस्याओं के बारे में जानने के लिए, लाइब्रेरी के रिलीज़ नोट देखें:

अगर आपको ऐसी समस्या आती है जो इनमें से किसी भी सूची में नहीं है, तो कृपया गड़बड़ी की शिकायत करें या सुझाव/राय दें या शिकायत करें.

एक्सआर के लिए Jetpack Compose

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

Jetpack Compose for XR की मदद से, पंक्तियों और कॉलम जैसे स्पेशलाइज़्ड कॉम्पोनेंट का इस्तेमाल किया जा सकता है. इससे, जाने-पहचाने, डिक्लेरेटिव Compose मॉडल का इस्तेमाल करके, स्पेशियल यूज़र इंटरफ़ेस (यूआई) और लेआउट बनाए जा सकते हैं.

यह लाइब्रेरी, सबस्पेस कंपोज़ेबल भी उपलब्ध कराती है. जैसे, स्पेशल पैनल और ऑर्बिटर. इनकी मदद से, अपने मौजूदा 2D Compose या व्यू पर आधारित यूज़र इंटरफ़ेस (यूआई) को स्पेशल लेआउट में रखा जा सकता है. अन्य सबस्पेस कंपोज़ेबल, स्पेशल यूज़ केस के अन्य टाइप को हैंडल करते हैं. जैसे, SceneCoreEntity. इसकी मदद से, अपने यूज़र इंटरफ़ेस (यूआई) के हिसाब से 3D मॉडल जैसी इकाइयां रखी जा सकती हैं.

यूज़र इंटरफ़ेस (यूआई) के एक्सआर कॉम्पोनेंट ऑर्बिटर का सामान्य उदाहरण

Jetpack Compose for XR का इस्तेमाल, अपने मौजूदा Android ऐप्लिकेशन को स्पेशलाइज़ करने या नया XR ऐप्लिकेशन बनाने के लिए किया जा सकता है.

ज़्यादा जानकारी के लिए, स्पेशल यूज़र इंटरफ़ेस (यूआई) के लिए डेवलपर गाइड और लाइब्रेरी और एपीआई का संदर्भ दस्तावेज़ देखें.

एक्सआर के लिए मटीरियल डिज़ाइन

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

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

Jetpack SceneCore

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

Jetpack SceneCore लाइब्रेरी की मदद से, 3D कॉन्टेंट को एक-दूसरे और अपने आस-पास के माहौल के हिसाब से सेट और व्यवस्थित किया जा सकता है. इस कॉन्टेंट को एंटिटी के हिसाब से तय किया जाता है. SceneCore की मदद से, ये काम किए जा सकते हैं:

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

ज़्यादा जानकारी के लिए, एपीआई का संदर्भ देखें.

Jetpack XR के लिए ARCore

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

Jetpack XR लाइब्रेरी के लिए ARCore, ARCore लाइब्रेरी से प्रेरित है. यह लाइब्रेरी, डिजिटल कॉन्टेंट को असल दुनिया के साथ ब्लेंड करने की सुविधाएं देती है. इस लाइब्रेरी में मोशन ट्रैकिंग, स्थायी ऐंकर, हिट टेस्टिंग, और सेमैंटिक लेबलिंग के साथ प्लेन की पहचान करने की सुविधा शामिल है. जैसे, फ़्लोर, दीवारें, और टेबलटॉप. यह लाइब्रेरी, OpenXR की मदद से काम करने वाले परसेप्शन स्टैक का इस्तेमाल करती है. इससे यह पक्का होता है कि यह लाइब्रेरी, कई तरह के डिवाइसों के साथ काम करे और ऐप्लिकेशन को आने वाले समय के लिए तैयार करने में मदद करे.

ज़्यादा जानकारी के लिए, Jetpack XR के लिए ARCore के साथ काम करना देखें.

Jetpack Compose Glimmer

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

Jetpack Compose Glimmer, एक यूज़र इंटरफ़ेस (यूआई) टूलकिट है. इसका इस्तेमाल, Android XR के बेहतर अनुभव देने वाले ऐप्लिकेशन बनाने के लिए किया जाता है. ये ऐप्लिकेशन, डिसप्ले ग्लास के लिए ऑप्टिमाइज़ किए गए होते हैं. पूरे दिन पहने जाने वाले डिवाइसों के लिए, खूबसूरत, आसान, और आरामदायक यूज़र इंटरफ़ेस (यूआई) बनाएं.

  • एक नज़र में आसानी से पढ़ने लायक कॉन्टेंट: फ़ोन के उलट, स्मार्ट ग्लास का मुख्य कैनवस एक ऑप्टिकल सी-थ्रू डिसप्ले होता है. यह पारदर्शी होता है. Jetpack Compose Glimmer, स्मार्ट ग्लास के लिए खास थीम, आसान कलर पैलेट, और टाइपोग्राफ़ी उपलब्ध कराता है. इससे आपका कॉन्टेंट पढ़ने में आसान, प्रोसेस करने में तेज़, और ध्यान भटकाने वाला नहीं होता.
  • पहने जाने वाले डिवाइसों के हिसाब से ऑप्टिमाइज़ किए गए इंटरैक्शन: हमने इंटरैक्शन मॉडल को इस तरह से ऑप्टिमाइज़ किया है कि लोग चश्मे का इस्तेमाल कर सकें. Jetpack Compose Glimmer कॉम्पोनेंट में फ़ोकस की साफ़ स्थितियां दिखती हैं. जैसे, ध्यान भटकाने वाले रिपल इफ़ेक्ट के बजाय ऑप्टिमाइज़ की गई आउटलाइन. इन्हें टैप करने, फ़्रेम पर स्वाइप करने, और आवाज़ जैसे सामान्य फ़िज़िकल इनपुट को हैंडल करने के लिए बनाया गया है.
  • जाने-पहचाने डिक्लेरेटिव यूज़र इंटरफ़ेस (यूआई) पैटर्न इस्तेमाल करें: Jetpack Compose Glimmer को पूरी तरह से Jetpack Compose पर बनाया गया है. इसलिए, Android में डिक्लेरेटिव यूज़र इंटरफ़ेस (यूआई) बनाने के बारे में आपको जो भी जानकारी है उसका इस्तेमाल किया जा सकता है. हम पहले से बने हुए मुख्य कंपोज़ेबल फ़ंक्शन का पूरा सेट उपलब्ध कराते हैं. जैसे, टेक्स्ट, आइकॉन, बटन, और खास कॉम्पोनेंट, जैसे कि TitleChip. ये सभी कॉम्पोनेंट, स्मार्ट ग्लास के एनवायरमेंट के लिए ऑप्टिमाइज़ किए गए हैं.
यूज़र इंटरफ़ेस (यूआई) के एक्सआर कॉम्पोनेंट ऑर्बिटर का सामान्य उदाहरण

Jetpack Projected

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

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

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

Android XR एम्युलेटर की मदद से, एक्सआर ऐप्लिकेशन इस्तेमाल करने के अनुभवों को टेस्ट करना

Android XR एम्युलेटर, Android Emulator का एक खास वर्शन है. इसे XR ऐप्लिकेशन डेवलप करने के लिए डिज़ाइन किया गया है. इसकी मदद से, Android Studio के जाने-पहचाने एनवायरमेंट में, अपने एक्सआर ऐप्लिकेशन को टेस्ट और डीबग किया जा सकता है. किसी भी तरह के Android XR डिवाइस के लिए वर्चुअल डिवाइस बनाएं. इनमें एक्सआर हेडसेट और वायर वाले एक्सआर ग्लास जैसे इमर्सिव डिवाइसों से लेकर, ऑडियो और डिसप्ले ग्लास जैसे इंटेलिजेंट आईवियर शामिल हैं.

जब आप अपना ऐप्लिकेशन चलाने और उसे डीबग करने के लिए तैयार हों, तो शुरू करने के लिए ये गाइड देखें:


OpenXR™ और OpenXR लोगो, The Khronos Group Inc. के मालिकाना हक वाले ट्रेडमार्क हैं. इन्हें चीन, यूरोपियन यूनियन, जापान, और यूनाइटेड किंगडम में ट्रेडमार्क के तौर पर रजिस्टर किया गया है.