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

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

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

पूरी तरह से इमर्सिव अनुभव बनाना

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

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

ऑगमेंटेड रिएलिटी (एआर) और काम के अनुभव बनाना

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

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

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

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

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

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

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

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

एक्सआर डिवाइसों के लिए ज़रूरी शर्तें: एक्सआर हेडसेट, वायर वाले एक्सआर ग्लास

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

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

ज़्यादा जानकारी के लिए, एक्सआर के लिए Jetpack Compose की मदद से यूज़र इंटरफ़ेस (यूआई) डेवलप करना देखें.

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

एक्सआर के लिए Compose में, SceneCoreEntity सबस्पेस कंपोज़ेबल की सुविधा मिलती है. इसकी मदद से, यूज़र इंटरफ़ेस (यूआई) के हिसाब से, 3D मॉडल जैसी इकाइयां रखी जा सकती हैं.

मौजूदा Android ऐप्लिकेशन को स्पेशलाइज़ करने का तरीका जानें या ज़्यादा जानकारी के लिए, एपीआई का संदर्भ देखें.

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

एक्सआर डिवाइसों के लिए ज़रूरी शर्तें: एक्सआर हेडसेट, वायर वाले एक्सआर ग्लास

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

Jetpack SceneCore

एक्सआर डिवाइसों के लिए ज़रूरी शर्तें: एक्सआर हेडसेट, वायर वाले एक्सआर ग्लास

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

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

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

Jetpack XR के लिए ARCore

एक्सआर डिवाइसों के लिए ज़रूरी शर्तें: एक्सआर हेडसेट, वायर वाले एक्सआर ग्लास, ऑडियो ग्लास, डिसप्ले वाले स्मार्ट ग्लास

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

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

Jetpack Compose Glimmer

एक्सआर डिवाइसों के लिए ज़रूरी शर्तें: डिसप्ले वाले स्मार्ट ग्लास

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

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

Jetpack Projected

एक्सआर डिवाइसों के लिए ज़रूरी शर्तें: ऑडियो ग्लास, डिसप्ले वाले स्मार्ट ग्लास

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

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

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