XR रनटाइम

हमारे नेटिव रनटाइम की मदद से, कस्टम एआर या 3D सेशन शुरू करें.
नया अपडेट रिलीज़ किया गया जांचा और परखा हुआ वर्शन रिलीज़ कैंडिडेट बीटा रिलीज़ ऐल्फ़ा रिलीज़
7 मई, 2025 - - - 1.0.0-alpha04

डिपेंडेंसी का एलान करना

XR रनटाइम पर डिपेंडेंसी जोड़ने के लिए, आपको अपने प्रोजेक्ट में Google Maven रिपॉज़िटरी जोड़नी होगी. ज़्यादा जानकारी के लिए, Google की मेवन रिपॉज़िटरी पढ़ें.

अपने ऐप्लिकेशन या मॉड्यूल के लिए, build.gradle फ़ाइल में उन आर्टफ़ैक्ट की डिपेंडेंसी जोड़ें जिनकी आपको ज़रूरत है:

ग्रूवीKotlin 
dependencies {
    implementation "androidx.xr.runtime:runtime:1.0.0-alpha04"

    // Use in environments that do not support OpenXR
    testImplementation "androidx.xr.runtime:runtime-testing:1.0.0-alpha04"
}
 
dependencies {
    implementation("androidx.xr.runtime:runtime:1.0.0-alpha04")

    // Use in environments that do not support OpenXR
    testImplementation("androidx.xr.runtime:runtime-testing:1.0.0-alpha04")
}

डिपेंडेंसी के बारे में ज़्यादा जानने के लिए, बिल्ड डिपेंडेंसी जोड़ना लेख पढ़ें.

सुझाव/राय दें या शिकायत करें

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

नई समस्या बनाना

ज़्यादा जानकारी के लिए, समस्या ट्रैकर का दस्तावेज़ देखें.

वर्शन 1.0

वर्शन 1.0.0-alpha04

7 मई, 2025

androidx.xr.runtime:runtime:1.0.0-alpha04, androidx.xr.runtime:runtime-openxr:1.0.0-alpha04, और androidx.xr.runtime:runtime-testing:1.0.0-alpha04 रिलीज़ हो गए हैं. वर्शन 1.0.0-alpha04 में ये कमिट शामिल हैं.

नई सुविधाएं

  • सेशन अब androidx.lifecycle.LifecycleOwner को लागू करता है, ताकि Android के मौजूदा लाइफ़साइकल पैराडाइम के साथ ज़्यादा इंटरऑपरेबिलिटी की जा सके.
  • Android XR के लिए मेनिफ़ेस्ट स्ट्रिंग यहां दी गई हैं और इनके बारे में जानकारी दी गई है.
  • स्पेस में दिखने की सुविधा के कॉलबैक एक्सटेंशन के तरीके जोड़े गए हैं. इनकी मदद से, यह मॉनिटर किया जा सकता है कि सीन का कॉन्टेंट, उपयोगकर्ता के फ़ील्ड ऑफ़ व्यू में है या नहीं.
  • JxrPlatformAdapter (और उससे जुड़ी सभी क्लास) का स्टब वर्शन जोड़ा गया.
  • SceneCore में सेशन के बजाय, SceneCore और रनटाइम, दोनों में सेशन का इस्तेमाल किया जाएगा.
  • ActivityPose.hitTest जोड़ा गया, जिससे वर्चुअल कॉन्टेंट के ख़िलाफ़ hitTest की सुविधा चालू की जा सकती है.
  • अब कंपाइल के समय, एक से ज़्यादा रनटाइम लागू करने की जानकारी दी जा सकती है. डिवाइस की मौजूदा सुविधाओं के आधार पर, सिर्फ़ एक ही फ़ंक्शन को लागू करने के समय लोड किया जाएगा.
  • नया कॉम्पोनेंट टाइप SpatialPointerComponent जोड़ा गया है. इससे क्लाइंट, पॉइंटर के लिए रेंडर किया गया आइकॉन तय कर सकते हैं या आइकॉन को बंद कर सकते हैं. फ़िलहाल, इस कॉम्पोनेंट को सिर्फ़ PanelEntity इंस्टेंस से जोड़ा जा सकता है.

एपीआई में हुए बदलाव

  • कॉन्फ़िगरेशन लागू करने की जानकारी को सार्वजनिक करें. (I95860)
  • HandJointType और TrackingState जोड़ें. (I55880)
  • Kotlin 2.0 के साथ रिलीज़ किए गए प्रोजेक्ट के लिए, KGP 2.0.0 या इसके बाद के वर्शन (Idb6b5) का इस्तेमाल करना ज़रूरी है
  • Hand.isActive (boolean) को बदलकर Hand.trackingState कर दिया गया है. OpenXR को लागू करने के तरीके में बदलाव किया गया है.
  • Session.configure में android.permission.SCENE_UNDERSTANDING की अनुमति की ज़रूरत को android.permission.SCENE_UNDERSTANDING_COARSE में बदल दिया गया है.
  • LifecycleManager.configure लागू हो गया है और अब यह Config ऑब्जेक्ट में पास हो जाता है. इसमें, कॉन्फ़िगर की जा सकने वाली हर रनटाइम सुविधा के लिए एक प्रॉपर्टी होती है.
  • रनटाइम की उपलब्ध सुविधाओं को कॉन्फ़िगर करने के लिए, Session.configure को अब Config के साथ कॉल किया जा सकता है.
  • Session.create में अब CoroutineDispatcher के बजाय CoroutineContext का इस्तेमाल किया जा सकता है.
  • Session.create, Jetpack XR और/या SceneCore के लिए ARCore लोड करने की सुविधा देता है. कम से कम एक इमेज देना ज़रूरी है. टेस्टिंग वर्शन उपलब्ध हैं.
  • जब Anchor.load और Anchor.unpersist को अमान्य यूयूआईडी पास किया जाता है, तो FakePerceptionManager एक AnchorInvalidUuidException दिखाता है.
  • CoreState अब डेटा क्लास नहीं है.

गड़बड़ियां ठीक की गईं

  • रनटाइम के लिए ProGuard कॉन्फ़िगरेशन ठीक किए गए.

वर्शन 1.0.0-alpha03

26 फ़रवरी, 2025

androidx.xr.runtime:runtime:1.0.0-alpha03, androidx.xr.runtime:runtime-openxr:1.0.0-alpha03, और androidx.xr.runtime:runtime-testing:1.0.0-alpha03 को पिछले ऐल्फ़ा वर्शन के बाद से कोई खास बदलाव किए बिना रिलीज़ किया गया है. वर्शन 1.0.0-alpha03 में ये कमिट शामिल हैं.

वर्शन 1.0.0-alpha02

12 फ़रवरी, 2025

androidx.xr.runtime:runtime:1.0.0-alpha02, androidx.xr.runtime:runtime-openxr:1.0.0-alpha02, और androidx.xr.runtime:runtime-testing:1.0.0-alpha02 रिलीज़ हो गए हैं. वर्शन 1.0.0-alpha02 में ये कमिट शामिल हैं.

ब्रेकिंग और व्यवहार में बदलाव

  • OpenXR रनटाइम फ़ंक्शन, ऐंकर दिखाते हैं. अगर उन्हें गड़बड़ी का कोड मिलता है, तो वे अब AnchorResourcesExhaustedException दिखाते हैं. इस कोड से पता चलता है कि OpenXR संसाधन की सीमा पूरी हो गई है.
  • Session.create और Session.resume के लिए, अब android.permission.HAND_TRACKING की अनुमति लेना ज़रूरी है.

नई सुविधाएं

  • हाथ ट्रैक करने की सुविधा जोड़ी गई.

गड़बड़ियां ठीक की गईं

  • एमुलेटर पर ऐप्लिकेशन चलाते समय, ऐंकर बनाने की प्रोसेस ज़्यादा आसान होती है

वर्शन 1.0.0-alpha01

12 दिसंबर, 2024

androidx.xr.runtime:runtime-* 1.0.0-alpha01 रिलीज़ हो गया है.

शुरुआती रिलीज़ की सुविधाएं

Jetpack XR Runtime की शुरुआती रिलीज़. इस लाइब्रेरी में, Jetpack XR सुइट की लाइब्रेरी के लिए बुनियादी फ़ंक्शन शामिल हैं. इसमें क्षमता की खोज, लाइफ़साइकल मैनेजमेंट, कॉन्फ़िगरेशन वगैरह शामिल हैं. रनटाइम लाइब्रेरी, लागू करने के प्लैटफ़ॉर्म के आधार पर अलग-अलग वैरिएशन (जैसे, runtime-openxr या runtime-testing) उपलब्ध कराती है. इसके अलावा, यह लाइब्रेरी Vector3 और Matrix4 जैसे बुनियादी गणित के एब्स्ट्रैक्शन भी उपलब्ध कराती है. इनका इस्तेमाल, Jetpack XR API के पूरे प्लैटफ़ॉर्म पर किया जाता है.

  • Session: इससे आपको एक्सआर सिस्टम पर बेहतर कंट्रोल मिलते हैं. जैसे, यह तय करना कि प्रोसेसिंग कब की जाए और कब न की जाए. साथ ही, पूरे कॉन्फ़िगरेशन को कंट्रोल करना. यह वही हैंडल है जिसका इस्तेमाल, सिस्टम की क्षमताओं को अनलॉक करने के लिए, सभी अन्य एपीआई में किया जाएगा.

  • Pose: किसी भी कोऑर्डिनेट सिस्टम में मौजूद जगह, जिसकी पोज़िशन और ओरिएंटेशन से जुड़ी जानकारी होती है. इस क्लास का इस्तेमाल, Jetpack XR और Jetpack SceneCore के लिए ARCore की मदद से ऑब्जेक्ट की जगह की जानकारी देने के लिए किया जाएगा.

ऐसी समस्याएं जिनकी जानकारी पहले से है

  • फ़िलहाल, configure का इस्तेमाल नहीं किया जा सकता. आने वाले समय में रिलीज़ होने वाले वर्शन में नई सेटिंग जोड़ी जाएंगी. इनका इस्तेमाल करके, Session के काम करने के तरीके को कंट्रोल किया जा सकेगा.