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

Android XR की स्पेशल सुविधाओं का फ़ायदा लेने वाले स्पेशल यूज़र इंटरफ़ेस (यूआई) लेआउट बनाएं.
नया अपडेट स्टेबल वर्शन रिलीज़ कैंडिडेट बीटा रिलीज़ ऐल्फ़ा रिलीज़
21 अक्टूबर, 2026 - - 1.0.0-beta02 -

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

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

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

ग्रूवी

dependencies {
    implementation "androidx.xr.compose:compose:1.0.0-beta02"

    // Use to write unit tests
    testImplementation "androidx.xr.compose:compose-testing:1.0.0-beta02"
}

Kotlin

dependencies {
    implementation("androidx.xr.compose:compose:1.0.0-beta02")

    // Use to write unit tests
    testImplementation("androidx.xr.compose:compose-testing:1.0.0-beta02")
}

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

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

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

नई समस्या दर्ज करने का तरीका

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

संस्करण 1.0

वर्शन 1.0.0-beta02

21 अक्टूबर, 2026

androidx.xr.compose:compose:1.0.0-beta02 और androidx.xr.compose:compose-testing:1.0.0-beta02 रिलीज़ हो गए हैं. वर्शन 1.0.0-beta02 में ये बदलाव शामिल हैं.

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

  • लाइब्रेरी अब Kotlin 2.2 को टारगेट करती हैं. इसके लिए, kotlinc 2.2 ज़रूरी है (I82396, b/498369605)
  • FollowMode.soft() के halfLifeMs पैरामीटर का नाम बदलकर halfLifeMillis कर दिया गया है. (I39187)
  • ऑब्जेक्ट के ऐलोकेशन को हटाने के लिए, PitchLimits को @JvmInline value class में बदला गया. साथ ही, दो फ़्लोट को Long में पैक किया गया. (Id43c3)
  • FollowMode.soft के लिए नया पैरामीटर जोड़ा गया: halfLifeMs, startDelay, और startThresholds पैरामीटर. durationMs पैरामीटर को हटा दिया गया है, क्योंकि अब इसकी ज़रूरत नहीं है. ऐसा इसलिए, क्योंकि हम smoothStep एल्गोरिदम से exponentialDecay एल्गोरिदम पर स्विच कर रहे हैं. (If0140)
  • अब इस्तेमाल में नहीं होने वाले SpatialActivityPanel ओवरलोड को हटाएं. इसके बजाय, SpatialActivityPanel के ओवरलोड का इस्तेमाल करें, जो SpatialActivityPanelController को स्वीकार करता है. (I5abc3)
  • FullSpaceMode में एक ही ऐक्टिविटी के अंदर, 3D और 2D कंपोज़ेबल कॉन्टेंट के बीच ट्रांज़िशन की सुविधा चालू करें. यह बदलाव SpatialComposeFlags.isMainPanelResetOnSubspaceDisposeEnabled के ज़रिए कंट्रोल किया जाता है. (I4e237)
  • एक्सपेरिमेंटल Subspace ओवरलोड को एक्सपोज़ किया गया है. यह FollowTarget पैरामीटर लेता है, ताकि इस कॉन्टेंट के साथ काम कर सके. (Iec1a9)
  • हटाए जा चुके मूवेबल मॉडिफ़ायर हटाएं. इसके बजाय, नए मूवेबल मॉडिफ़ायर का इस्तेमाल करें. यह नए MovePolicy को पैरामीटर के तौर पर स्वीकार करता है. (Ib135d)
  • इस्तेमाल से बाहर हो चुके DragPolicy को हटाएं. इसके बजाय, SubspaceModifier.movable() का इस्तेमाल करें. (I108d4)
  • स्टेटलेस Slider और RangeSlider ओवरलोड को बंद कर दिया गया है. अब इनके स्टेटफ़ुल वर्शन इस्तेमाल किए जा सकते हैं. RangeSliderState में activeRangeStart और activeRangeEnd का नाम बदलकर startValue और endValue किया गया. साथ ही, DeprecationLevel.HIDDEN के साथ पुराने, प्रमोट नहीं किए गए, और एक्सपेरिमेंट के तौर पर इस्तेमाल किए जा रहे Slider API को बंद किया गया. (If8995)

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

  • poseInActivitySpace को शामिल करके RotateToLookAtUser को ठीक किया गया, ताकि सभी सबस्पेस टाइप के लिए पोज़ का सही तरीके से हिसाब लगाया जा सके. इनमें ऐंकर या उपयोगकर्ताओं से जुड़े सबस्पेस टाइप भी शामिल हैं.Ica367b
  • ऑर्बिटर को बड़े पैनल से अटैच करने पर, कंस्ट्रेंट क्रैश होने की समस्या को ठीक किया गया (I8c4bf)
  • SubspaceLayoutNode में मौजूद एक गड़बड़ी को ठीक किया गया है. इसकी वजह से, removeAll() में ग़ैर-ज़रूरी ArrayList ऐलोकेशन हो रहे थे. डेप्थ कैलकुलेशन की परफ़ॉर्मेंस को भी बेहतर बनाया गया है. I34a10a
  • androidx.lifecycle:lifecycle-runtime डिपेंडेंसी को 2.10.0 पर अपडेट किया गया. यह वर्शन, एजीपी के 9.5.0-alpha04 या इसके बाद के वर्शन के साथ बंडल किए गए लाइफ़साइकल रनटाइम लिंट की जांच करने के लिए ज़रूरी है. (I99bfd, b/556807521)
  • AudioOutputProvider से जुड़े kdocs को बेहतर बनाया गया, ताकि यह हाइलाइट किया जा सके कि इसे कई ExoPlayer इंस्टेंस के साथ फिर से इस्तेमाल नहीं किया जाना चाहिए (I6b18e)
  • kdoc की स्पेलिंग और व्याकरण से जुड़ी छोटी-मोटी गड़बड़ियां ठीक की गईं (Id3ba6)

पहले से मालूम समस्याएं

  • androidx.xr.compose का यह वर्शन, androidx.xr.scenecore:1.0.0-rc01 पर निर्भर करता है. इसमें मेमोरी लीक की समस्या है. अपने बिल्ड कॉन्फ़िगरेशन में, SceneCore डिपेंडेंसी को साफ़ तौर पर वर्शन 1.0.0 में बदला जा सकता है. इसमें मेमोरी लीक की समस्या को ठीक करने का तरीका शामिल है.

वर्शन 1.0.0-beta01

23 सितंबर, 2026

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

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

  • DragPolicy को हटा दिया गया है, क्योंकि अब इसका इस्तेमाल नहीं किया जाता. इसके बजाय, SubspaceModifier.movable() का इस्तेमाल करें. (I108d4)
  • इस्तेमाल से बाहर हो चुके ResizePolicy और SpatialPanel और SpatialExternalSurface में इसके इस्तेमाल को हटा दिया गया है. इस्तेमाल से बाहर हो चुके SubspaceModifier.resizable फ़ंक्शन को हटाना. इसके बजाय, नए ResizePolicy के साथ नए SubspaceModifier.resizable का इस्तेमाल करें. (I59e6b)
  • isPitchUpdateEnabled पैरामीटर जोड़ा गया, ताकि पिच ट्रैकिंग को अलग से चालू या बंद किया जा सके. (Ie9e86)
  • pitchLimits की शून्यता को हटाया गया और PitchLimits.UNCONSTRAINED का नाम बदलकर PitchLimits.FullRange किया गया. (I0154f)
  • ExposedDropdownMenu अब ExposedDropdownMenuBoxScope पर सदस्य के बजाय, एक्सटेंशन फ़ंक्शन के तौर पर उपलब्ध है. आपको नए इंपोर्ट के साथ अपना कोड अपडेट करना पड़ सकता है. (Ie8a65)
  • बंद की जा चुकी SurfaceProtection क्लास को हटा दिया गया है. इसके बजाय, SpatialExternalSurfaceProtection का इस्तेमाल करें. (Iab2c6)
  • OrbiterPoseProvider का इस्तेमाल करने वाले Orbiter फ़ंक्शन को अब बंद कर दिया गया है. इसकी जगह, SpatialAlignment का इस्तेमाल करने वाले फ़ंक्शन को लाया गया है. (I4d12b)
  • SpatialActivityPanel को अब एम्बेड की गई गतिविधियों को लॉन्च और मैनेज करने के लिए, SpatialActivityPanelController (rememberSpatialActivityPanelController का इस्तेमाल करके इंस्टैंशिएट किया गया) की ज़रूरत होती है. (Id25c6)
  • rotateToLookAtUser से upDirection पैरामीटर को हटाया गया और रोटेशन से जुड़ी पाबंदियों के पैरामीटर (isYawUpdateEnabled और pitchLimits) जोड़े गए. (I1370a)

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

  • InteractionPolicy से जुड़ी कई समस्याएं ठीक की गईं. अगर कंपोज़ेबल या चाइल्ड (उदाहरण के लिए, ऑर्बिटर) ने डिस्पोज़ल सीक्वेंस शुरू किया और उसी समय कोई इनपुट इवेंट हुआ, तो ऐप्लिकेशन क्रैश हो गया. साथ ही, उस समस्या को ठीक किया गया है जिसमें चाइल्ड एलिमेंट को होवर इवेंट मिलते थे. (Ifc477)
  • RotateToLookAtUserActivity में पैनल का साइज़ कम किया गया है, ताकि छोटे एफ़ओवी डिवाइसों पर क्लिपिंग की समस्या न हो. (I8d672)

पहले से मालूम समस्याएं

  • Compose XR पैनल में एक समस्या है. इसमें एक ही ऐक्टिविटी में कई पैनल बनाने से, पैनल को बंद करने के बाद भी, स्क्रीन पर दिख रहे कॉन्टेंट में कुछ गड़बड़ी हो सकती है.

वर्शन 1.0.0-alpha17

12 अगस्त, 2026

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

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

  • Meter वैल्यू क्लास को हटाएं. इसे Scenecore में virtualPixelDensity से बदल दिया गया है. (I690ee)
  • SpatialGltfModel एपीआई अब एक्सपेरिमेंट के तौर पर उपलब्ध है. इसका इस्तेमाल करने के लिए, आपको इसमें ऑप्ट इन करना होगा. (I4557e)
  • system के साइज़ को बदलने की सुविधा को नलेबल बनाएं (Ib0093)
  • टेस्टिंग के लिए, SubspaceSemanticsInfo में Density को एक्सपोज़ किया गया. (I2e826)
  • ResizePolicy के डिफ़ॉल्ट विकल्प का नाम बदलकर system करें और बिना पैरामीटर वाला नया Default विकल्प जोड़ें (Ic8b16)
  • FollowTarget को एक्सपेरिमेंट के तौर पर मार्क करें. FollowingSubspace एपीआई को अब एक्सपेरिमेंट के तौर पर उपलब्ध कराया गया है. (Id4ee3)
  • GltfAnimation एपीआई हटाएं (Ic2894)
  • पैरामीटर वाले MovePolicy.default() तरीके का नाम बदलकर MovePolicy.system() किया गया. मूवमेंट के स्टैंडर्ड डिफ़ॉल्ट तरीके को दिखाने के लिए, val MovePolicy.Default प्रॉपर्टी को शामिल किया गया. (Iedcc9)
  • ExperimentalMoveAnchorPolicy के लिए शामिल होने की ज़रूरी शर्तों को PlaneSemantic और PlaneOrientation तक बढ़ाना (Ief927)
  • VolumeConstraints.offset (Ib2f2f) से resetMins को हटाया गया
  • SceneCoreEntitySizeAdapter फ़ंक्शन को हटा दिया गया है, क्योंकि अब इसका इस्तेमाल नहीं किया जाता. (Ib6722)
  • allowUnboundedSubspace के साथ, अब इस्तेमाल नहीं किए जा रहे Subspace ओवरलोड को हटाया गया. (I8e97f)
  • सेमैंटिक मॉडिफ़ायर ओवरलोड को हटा दिया गया है. (I4ac10)

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

  • उस समस्या को ठीक किया गया है जहां InteractionPolicy से अटैच किए गए Composable के चाइल्ड कॉम्पोनेंट, इनपुट इवेंट ट्रिगर करते थे (Icdba6)

वर्शन 1.0.0-alpha16

15 जुलाई, 2026

androidx.xr.compose:compose:1.0.0-alpha16 और androidx.xr.compose:compose-testing:1.0.0-alpha16 रिलीज़ हो गए हैं. वर्शन 1.0.0-alpha16 में ये बदलाव शामिल हैं.

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

  • ComponentOverride एपीआई हटाना (I820c4)
  • GltfAnimation और SpatialGltfModelAnimation एपीआई को एक्सपेरिमेंट के तौर पर मार्क किया गया है. कुछ प्रॉपर्टी को गेटर में बदल दिया गया. (I8d689, b/524771027)
  • मीटर और पिक्सल के बीच कन्वर्ज़न को कॉन्स्टेंट के तौर पर सेट करके, डेंसिटी के व्यवहार को ठीक किया गया. Meter.kt को अब इस्तेमाल नहीं किया जा सकता. इसके बजाय, Session.scene.virtualPixelDensity का इस्तेमाल किया जा सकता है. (I122ff, b/430097855, b/474168798)
  • दो मॉडिफ़ायर के बजाय ResizePolicy का इस्तेमाल करने के लिए, साइज़ बदलने वाले मॉडिफ़ायर को अपडेट करें (I7fb0f, b/496257436, b/519672992)
  • SubspaceAssertions.kt में सभी सार्वजनिक फ़्लोटिंग-पॉइंट डाइमेंशन और पोज़िशन इक्वालिटी असर्शन में, टॉलरेंस: Dp = Dp(0.5f) पैरामीटर जोड़ा गया. डिफ़ॉल्ट टॉलरेंस बिहेवियर (0.5.dp) को पूरी तरह से दस्तावेज़ में दर्ज किया गया है. (I266cb, b/521491915)
  • movePolicy पैरामीटर के साथ, मूव किए जा सकने वाले ओवरलोड को जोड़ा गया. साथ ही, transformingMovable और movable को बंद किया गया (Ic88c1, b/481781189)
  • स्टैंडर्ड लिस्ट आइटम और सेगमेंटेड लिस्ट आइटम के नए नॉन-इंटरैक्टिव वैरिएंट जोड़े गए हैं. ये वैरिएंट, Material Expressive की खास बातों के मुताबिक हैं. नॉन-एक्सप्रेसिव वर्शन अब काम नहीं करता. (Ide4de, b/491994186)
  • Subspace के लिए, allowUnboundedSubspace पैरामीटर अब बंद कर दिया गया है और छिपा दिया गया है. अनबाउंडेड बिहेवियर को अब सबस्पेस मॉडिफ़ायर पर SubspaceModifier.requiredSizeIn(maxWidth = Dp.Infinity, maxHeight = Dp.Infinity, maxDepth = Dp.Infinity) का इस्तेमाल करके हासिल किया जाना चाहिए. allowUnboundedSubspace पैरामीटर को FollowingSubspace से हटा दिया गया है. (Ia72ae, b/433624021)
  • Session.create को suspend फ़ंक्शन में बदला गया. (I5d27f)
  • SubspaceModifier.spatializedAudioOutput को जोड़ा गया. इसकी मदद से, ExoPlayer या SoundEffectPlayer के ज़रिए ऑडियो प्लेबैक को स्पेशल ऑडियो में बदला जा सकता है (I46697, b/489421980, b/497867019)
  • स्थिति की पुष्टि करने के लिए, ComponentActivity.requestHomeSpace() और requestFullSpace() को अपडेट किया गया, ताकि SpaceRequestResult को वापस किया जा सके. (If1672)
  • AnchorEntity को अपडेट किया गया, ताकि उसे AnchorSpace कहा जा सके (Ifa95e, b/513619219)
  • SpatialGltfModelSource से fromResource तरीके को बिना किसी पाबंदी के ऐक्सेस किया जा सकता है (I1f5a1, b/503047416)
  • SubspaceSemanticsMatcher के मेंबर सार्वजनिक हैं: description प्रॉपर्टी, कंपैनियन फ़ैक्ट्री मेथड (expectValue, keyIsDefined, keyNotDefined), मेंबर फ़ंक्शन (matches, matchesAny), और ऑपरेटर (and, or, not). (I972a4, b/460427288)
  • SubspaceModifier.semantics, SubspaceModifier.testTag, SubspaceSemanticsInfo, और SubspaceSemanticsModifierNode को अपडेट किया गया, ताकि क्यूरेट किए गए स्पेशल सिमैंटिक टाइप का इस्तेमाल किया जा सके. (I80dea, b/460427288)
  • SpatialAlignment में position का नाम बदलकर align कर दिया गया है. साथ ही, यूनिफ़ाइड align एपीआई के लिए, अलग-अलग डायरेक्शनल ऑफ़सेट के तरीकों को हटा दिया गया है. (I9bdb2, b/479805937)
  • SpatialConfiguration से, स्पेस मोड के ऐसे एपीआई हटा दिए गए हैं जिनका अब इस्तेमाल नहीं किया जाता. (I1ef5c, b/458712461)
  • SubspaceSemanticsConfiguration को पेश किया गया. यह स्पेशल नोड के लिए, सिमैंटिक प्रॉपर्टी का कॉन्फ़िगरेशन है. यह क्लास, 3D सिमैंटिक के लिए क्वेरी के तरीकों को सुरक्षित तरीके से एक्सपोज़ करती है. साथ ही, बाहरी उपभोक्ताओं को बुनियादी 2D सिमैंटिक क्षमताओं को लीक नहीं करती. (Id025e, b/460427288)
  • SubspaceSemanticsPropertyReceiver को लॉन्च किया गया: यह एक खास रैपर है, जो 3D लेआउट कंटेनर की प्रॉपर्टी को मान्य फ़ील्ड तक सीमित करता है. शुरुआत में, testTag और contentDescription. (I5cf5c, b/460427288)

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

  • सिमैंटिक मॉडिफ़ायर के hasContentDescription को अपडेट किया गया, ताकि सबस्ट्रिंग मैचिंग को डिफ़ॉल्ट के तौर पर सेट किया जा सके. (I08214)
  • प्रतिबंधित FollowBehavior.ExponentialDecay() जोड़ा गया. यह इलास्टिक फ़िज़िक्स के हिसाब से, सॉफ़्ट फ़ॉलो बिहेवियर उपलब्ध कराता है. (I7449c, b/485639909, b/500493335)

इससे ज़्यादातर एपीआई पर असर पड़ेगा. खास तौर पर, LocalSession CompositionLocal और LocalSession पर निर्भर सभी CompositionLocals (जैसे, LocalSpatialConfiguration, LocalSpatialCapabilities वगैरह) अब null या इसके नॉन-एक्सआर वर्शन पर रिज़ॉल्व हो जाएंगे. ऐसा Session के शुरू होने से पहले होगा.

Session उपलब्ध होने के बाद, सही स्थिति के साथ रीकंपोज़िशन ट्रिगर हो जाएगा. (I0cfa4, b/514712835, b/514712835)

  • ComponentActivity.requestHomeSpace और ComponentActivity.requestFullSpace के लिए, सदस्यता निलंबित करने, रद्द करने, और एक साथ कई सदस्यताएं लेने से जुड़े दस्तावेज़ों को साफ़ तौर पर समझाया गया. CancellationException के प्रोपेगेशन की पुष्टि करने के लिए, टेस्ट अपडेट किए गए. (I22f75, b/493289528)

वर्शन 1.0.0-alpha15

17 जून, 2026

androidx.xr.compose:compose:1.0.0-alpha15 और androidx.xr.compose:compose-testing:1.0.0-alpha15 रिलीज़ हो गए हैं. वर्शन 1.0.0-alpha15 में ये बदलाव शामिल हैं.

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

  • ResizePolicy और साइज़ बदलने वाले पुराने मॉडिफ़ायर को बंद कर दिया गया है. इसकी जगह, नया SubspaceModifier.resizable ओवरलोड और SubspaceModifier.transformingResizable इस्तेमाल किया जा रहा है. (I9e4bc)
  • SpatialGltfModel एपीआई अपडेट किए गए: SpatialGltfModelSource के ज़रिए संसाधनों से मॉडल लोड करने की सुविधा जोड़ी गई.fromResource. SpatialGltfModelAnimation में स्पीड का नाम बदलकर playbackSpeed किया गया और resume() तरीका जोड़ा गया. SpatialGltfModelStatus.Loaded और Loading अब ऑब्जेक्ट हैं. (I523de)
  • rotateToLookAtUser को एक्सपेरिमेंटल एपीआई के तौर पर मार्क किया गया. (I86c16)
  • सुरक्षित वैरिएबल targetCurrentPose को लोकल वैरिएबल currentTargetPoseMeter में बदला गया और उसका नाम बदला गया. (Ia557c)
  • SpatialPanel और SpatialExternalSurface के kdocs को अपडेट किया गया, ताकि यह शामिल किया जा सके कि ऑब्जेक्ट को उसके लेआउट साइज़ (I72104) में कहां रेंडर किया गया है
  • SpatialGltfModel के लोड होने के लॉजिक को SpatialGltfModelState में शामिल किया गया और लोड न होने की वजह बताई गई. (Ibe98b)
  • depth को SubspaceModifer.size kdocs (I0f84f) में साफ़ तौर पर बताया गया

वर्शन 1.0.0-alpha14

19 मई, 2026

androidx.xr.compose:compose:1.0.0-alpha14 और androidx.xr.compose:compose-testing:1.0.0-alpha14 रिलीज़ हो गए हैं. वर्शन 1.0.0-alpha14 में ये बदलाव शामिल हैं.

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

  • सिस्टम से मैनेज किए जाने वाले डिफ़ॉल्ट 3D मूवमेंट के लिए, transformingMovable को लॉन्च किया गया. साथ ही, कस्टम मूवमेंट के व्यवहार को मैनेज करने के लिए, movable के लिए एक नया ओवरलोड लॉन्च किया गया. (I50960)
  • SpatialGltfModel.fromData() हटाया गया. (I4d083)
  • एक नया मॉडिफ़ायर नोड इंटरफ़ेस, SubspaceMeasuredSizeAwareModifierNode जोड़ा गया है. यह मेज़र पास के बाद, onRemeasured कॉलबैक देता है. SubspaceLayoutAwareModifierNode अब इस नए इंटरफ़ेस को और बेहतर बना रहा है. onSizeChanged मॉडिफ़ायर को onRemeasured का इस्तेमाल करने के लिए अपडेट किया गया है. इससे यह पक्का होता है कि कॉलबैक, प्लेसमेंट के बाद नहीं, बल्कि मेज़रमेंट के तुरंत बाद ट्रिगर हो. (Iafbae)
  • InteractionPolicy को Interface (I0ff30) में अपडेट किया गया
  • Compose compileSdk को एपीआई 37 पर अपडेट किया गया. इसका मतलब है कि Compose का इस्तेमाल करने के लिए, एजीपी का कम से कम 9.2.0 वर्शन होना ज़रूरी है. (Id45cd)
  • Size kdocs अपडेट किया गया (Iefa9a)

वर्शन 1.0.0-alpha13

6 मई, 2026

androidx.xr.compose:compose:1.0.0-alpha13 और androidx.xr.compose:compose-testing:1.0.0-alpha13 रिलीज़ हो गए हैं. वर्शन 1.0.0-alpha13 में ये बदलाव शामिल हैं.

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

  • Orbiter API में कुछ और बदलाव होने बाकी हैं. हमारा सुझाव है कि Orbiter के बंद होने की सूचनाओं को दबाकर रखें. साथ ही, आने वाली रिलीज़ में Orbiter में होने वाले बदलावों पर नज़र रखें.
  • glTF रेंडर करने के लिए SceneCoreEntity का इस्तेमाल करने वाले लोगों को यह पक्का करना चाहिए कि वे अपने GltfModel.create कॉल के parent पैरामीटर में session.scene.activitySpace पास कर रहे हों. इससे यह पक्का किया जा सकेगा कि उनके glTF रेंडर होंगे.
  • SpatialGltfModel एपीआई जोड़ा जा रहा है, ताकि डेवलपर अपने Compose For XR ऐप्लिकेशन में Gltf जोड़ सकें. डेवलपर, अपने Gltf मॉडल में ऐनिमेशन और नोड के बारे में भी क्वेरी कर सकते हैं. (I8b542, b/495422586)
  • SceneCoreEntitySizeAdapter को क्लास से इंटरफ़ेस में बदलता है (I5a784, b/475292310)
  • SurfaceProtection का नाम बदलकर SpatialExternalSurfaceProtection किया गया. SpatialExternalSurface kdocs अपडेट किए गए (Ifad0a, b/485231082)
  • currentWindowAdaptiveInfo को बंद किया गया और इसका दूसरा वर्शन लॉन्च किया गया (I40ecf, b/424442112)
  • resizable मॉडिफ़ायर अब सार्वजनिक है और इसे ग्रुप पर लागू किया जा सकता है. जैसे, SpatialRow. (I2bcf6, b/348483527, b/489753178, b/479530787)
  • movable मॉडिफ़ायर अब सार्वजनिक है. फ़िलहाल, यह मॉडिफ़ायर SpatialPanels और SpatialExternalSurface के लिए अच्छी तरह से काम करता है. हालांकि, हमारा मकसद यह है कि यह सभी SubspaceComposables के लिए अच्छी तरह से काम करे. (I9a3cd, b/479530787, b/478935063, b/478935063)
  • SpatialEnterTransition और SpatialExitTransition को @Immutable के तौर पर मार्क किया गया (If1710, b/487757837)
  • इस रिलीज़ के लिए, SpatialGltfModel एपीआई को प्रतिबंधित के तौर पर मार्क किया गया है. ऐसा इसलिए किया गया है, क्योंकि इसकी अतिरिक्त जांच बाकी है. (Ibf003, b/466090694)
  • DeviceTrackingMode.LAST_KNOWN का नाम बदलकर SPATIAL_LAST_KNOWN किया गया (जिसमें अब काम न करने वाला फ़ॉलबैक है), 3DoF ट्रैकिंग के लिए INERTIAL_LAST_KNOWN जोड़ा गया, और TRACKING_DEGRADED को TrackingState में जोड़ा गया. (Ie661c, b/445466590)
  • अब इस्तेमाल नहीं किए जा रहे SpatialLayoutSpacer (I7b36c) को हटाया जा रहा है
  • पैडिंग एपीआई को हटाया जा रहा है, क्योंकि अब इसका इस्तेमाल नहीं किया जाता (If1886)
  • बायस वैल्यू में floatRange जोड़ा गया. LayoutDirection (I9d74e) के लिए डिफ़ॉल्ट वैल्यू हटाई गई

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

  • SpatialColumn, SpatialRow, और SpatialCurvedRow के लिए कोड सैंपल और KDoc दस्तावेज़ जोड़े गए. (Iaf54f, b/495777633)

वर्शन 1.0.0-alpha12

25 मार्च, 2026

androidx.xr.compose:compose:1.0.0-alpha12 और androidx.xr.compose:compose-testing:1.0.0-alpha12 रिलीज़ हो गए हैं. वर्शन 1.0.0-alpha12 में ये बदलाव शामिल हैं.

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

  • glTF को रेंडर करने और ऐनिमेशन को कंट्रोल करने के लिए, SpatialGltfModel एपीआई और SpatialGltfModelAnimation एपीआई जोड़ें. SpatialGltfModelState को बदलकर AutoCloseable किया गया. इसके संसाधनों को खाली करने के लिए, अब इसे बंद करना होगा. (I11fde, b/466065486, b/481379924). हालांकि, इस रिलीज़ के लिए SpatialGltfModel एपीआई को प्रतिबंधित के तौर पर मार्क किया गया है. ऐसा इसलिए, क्योंकि इसकी अतिरिक्त जांच बाकी है. (Ibf003, b/466090694)
  • SubspaceModifier.rotate के लिए, अब काम न करने वाला खाली ओवरलोड जोड़ा गया. (Idceb6)
  • SpatialSmoothFeatheringEffect फ़ंक्शन का नाम बदलकर spatialSmoothFeatheringEffect कर दिया गया है और इसे ड्रॉ मॉड्यूल में ले जाया गया है. SpatialExternalSurface की डिफ़ॉल्ट फ़ेदरिंग वैल्यू को शून्य पर अपडेट किया गया. यह पुरानी ZeroFeatheringEffect सुविधा की तरह काम करता है. (I5fdaa, b/460426800)
  • onPointSourceParamsAvailable को हटाया गया. आने वाले समय में, ऑडियो स्पेशलाइज़ेशन के लिए एक अलग एपीआई उपलब्ध होगा. (I86507, b/458513439)
  • ऑफ़सेट सबस्पेस मॉडिफ़ायर के लिए, दाईं से बाईं ओर (आरटीएल) टेक्स्ट लिखने की सुविधा जोड़ी गई. लेआउट की दिशा को अनदेखा करने के लिए, absoluteOffset को भी जोड़ा गया. (I30e4b, b/474409165)

वर्शन 1.0.0-alpha11

25 फ़रवरी, 2026

androidx.xr.compose:compose:1.0.0-alpha11 और androidx.xr.compose:compose-testing:1.0.0-alpha11 रिलीज़ हो गए हैं. वर्शन 1.0.0-alpha11 में ये बदलाव शामिल हैं.

नई सुविधाएं

  • SpatialExternalSurfaces (Icd4d1) में SuperSampling पैरामीटर जोड़ा गया

पहले से मालूम समस्याएं

  • SceneCore में SurfaceEntity से जुड़ी समस्या की वजह से, SpatialExternalSurface के इंस्टेंस बनाते समय ऐप्लिकेशन क्रैश हो सकते हैं. इस समस्या को androidx.xr.scenecore:scenecore-*:1.0.0-alpha13, androidx.xr.compose:compose:1.0.0-alpha12, और इसके बाद की रिलीज़ में ठीक कर दिया गया है. जिन ऐप्लिकेशन पर असर पड़ा है उन्हें नए वर्शन पर अपडेट करना चाहिए.

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

  • लेआउट की दिशा के बारे में जानकारी देने के लिए, सबस्पेस मॉडिफ़ायर की पैडिंग में बदलाव किए गए हैं. (I53e25)
  • SpatialCapabilities को अब सील कर दिया गया है और इसे आगे नहीं बढ़ाया जा सकता. (I07aef)
  • SpatialRow और SpatialColumn एपीआई, जो सामान्य SpatialAlignment पैरामीटर स्वीकार करते हैं वे अब काम नहीं करते. इसके बजाय, ऐसे एपीआई इस्तेमाल करें जो SpatialRow और SpatialColumn के लिए, क्रमशः verticalAlignment या horizontalAlignment स्वीकार करते हैं. (Iec390)
  • ओवरलोडिंग SubspaceLayout फ़ंक्शन एपीआई को कंबाइन किया गया (Idd30a)
  • SubspaceModifier.lookAtUser का नाम बदलकर rotateToLookAtUser और up पैरामीटर का नाम बदलकर upDirection कर दिया गया है. (Icafb8)
  • SpatialRow को इनलाइन फ़ंक्शन बनाना (Ia2f20)
  • SpatialColumn को इनलाइन फ़ंक्शन बनाना (I681be)
  • बिलबोर्ड एपीआई को हटाया गया (Ib76cd)

वर्शन 1.0.0-alpha10

28 जनवरी, 2026

androidx.xr.compose:compose:1.0.0-alpha10 और androidx.xr.compose:compose-testing:1.0.0-alpha10 रिलीज़ हो गए हैं. वर्शन 1.0.0-alpha10 में ये बदलाव शामिल हैं.

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

  • अब काम न करने वाले एपीआई को हटाया जा रहा है - ApplicationSubspace (Ia6596, b/468345186)
  • SpatialShape को सील किए गए इंटरफ़ेस में अपडेट किया गया (I7e3f5, b/460426800)
  • SpatialAlignment में, बंद किए जा चुके एपीआई हटाए जा रहे हैं. (Ib0b61, b/468011887)
  • SpatialLayoutSpacer को बंद किया जा रहा है और SpatialSpacer को लॉन्च किया जा रहा है. (I2ebf3, b/466071383)
  • UserSubspace एपीआई को अपडेट किया गया, ताकि "लेज़ी लॉकिंग" शब्दावली को "सॉफ़्ट लॉकिंग" से बदला जा सके. (I9ded1, b/464035984)

वर्शन 1.0.0-alpha09

03 दिसंबर, 2025

androidx.xr.compose:compose:1.0.0-alpha09 और androidx.xr.compose:compose-testing:1.0.0-alpha09 रिलीज़ हो गए हैं. वर्शन 1.0.0-alpha09 में ये बदलाव शामिल हैं.

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

  • LookAtUser और बिलबोर्ड मॉडिफ़ायर जोड़े गए हैं. इनकी मदद से, कॉन्टेंट हमेशा उपयोगकर्ता के सामने दिखता है. (I49b99)
  • इससे InteractionPolicy को SpatialExternalSurfaces और SpatialPanels पर सेट किया जा सकता है. इससे क्लिक और अन्य 3D इनपुट इवेंट का पता लगाया जा सकता है. (Iae155)
  • चौड़ाई, ऊंचाई, और गहराई को डीपी वैल्यू के तौर पर इस्तेमाल करके, साइज़ और requiredSize मॉडिफ़ायर ओवरलोड को जोड़ा गया. (I92f79)
  • ParentLayoutParamsModifier इंटरफ़ेस अब DelegatableSubspaceNode तक बढ़ गया है. (I1a6d4)
  • ApplicationSubspace को बंद कर दिया गया है. इसकी जगह, Subspace API का इस्तेमाल किया जा रहा है.
    • Subspace API के काम करने के तरीके में बदलाव किया गया है. अब यह सिर्फ़ सुझाए गए पोज़ और स्केल पर, ऐप्लिकेशन-वाइड सबस्पेस उपलब्ध कराता है.
    • PlanarEmbeddedSubspace एपीआई को 2D कॉन्टेक्स्ट में एम्बेड किए गए सबस्पेस उपलब्ध कराने के लिए पेश किया गया है. (Id3343)
  • SubspaceModifier.Node एपीआई में shouldAutoInvalidate फ़्लैग जोड़ा गया. (I93902)
  • required(Size|Width|Depth|Height) को उन एपीआई में जोड़ा गया है जो डेवलपर को @SubspaceComposable के साइज़ को एक तय रेंज तक सीमित करने की अनुमति देते हैं. इससे पैरंट के इनकमिंग मेज़रमेंट की पाबंदियों को अनदेखा किया जा सकता है. (Ifaa78)
  • SubspaceModifier.onSizeChanged को जोड़ा गया है. इससे डेवलपर को एक आसान और फ़ोकस किया गया कॉलबैक मिलता है, ताकि वे @SubspaceComposable के साइज़ में बदलाव होने पर प्रतिक्रिया दे सकें. (I994f9)
  • Volume API को हटा दिया गया है. Volume API के बजाय, SceneCoreEntity API का इस्तेमाल किया जाना चाहिए. (I4162b)
  • SubspaceLayoutModifierNode.requestRelayout को invalidateMeasurement/invalidatePlacement में बांटें. (I14805)
  • SpatialGltfModel एपीआई जोड़ा गया. इसकी मदद से, डेवलपर Compose में glTF रेंडर कर सकते हैं. (Icc91f)
  • glTF को आसानी से रेंडर करने के लिए, SpatialGltfModel कंपोज़ेबल एपीआई को पेश किया गया (Iade67)

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

  • SceneCoreEntity में लेआउट से जुड़ी गड़बड़ी को ठीक किया गया. अब यह अपनी सीमाओं का सही तरीके से पालन करेगा. (I11bb8)
  • jxr-compose मॉड्यूल को कम करके Compile sdk = 34 पर लाया गया (I2d5db)

वर्शन 1.0.0-alpha08

22 अक्टूबर, 2025

androidx.xr.compose:compose:1.0.0-alpha08 और androidx.xr.compose:compose-testing:1.0.0-alpha08 रिलीज़ हो गए हैं. वर्शन 1.0.0-alpha08 में ये बदलाव शामिल हैं.

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

  • ResizePolicy को बदलकर, onResizeStart, onResizeUpdate, और onResizeEnd को स्वीकार करने के लिए सेट किया गया. (I7e21f)

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

  • सबस्पेस वाली किसी ऐक्टिविटी को बंद करते समय, क्रैश होने से रोकना. (I595a1)

वर्शन 1.0.0-alpha07

24 सितंबर, 2025

androidx.xr.compose:compose:1.0.0-alpha07 और androidx.xr.compose:compose-testing:1.0.0-alpha07 रिलीज़ हो गए हैं. वर्शन 1.0.0-alpha07 में ये बदलाव शामिल हैं.

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

  • SpatialMainPanel के लिए KDocs को बेहतर बनाया गया. (I27b70, b/444467891)
  • SpatialArrangement को पेश किया गया, ताकि SpatialRow और SpatialColumn जैसे 3D लेआउट में, चाइल्ड कॉम्पोनेंट को मुख्य ऐक्सिस के हिसाब से व्यवस्थित किया जा सके. यह नया एपीआई, 2D Compose से जाने-पहचाने अरेंजमेंट के विकल्प उपलब्ध कराता है. इनमें Start, End, Center, SpaceBetween, SpaceAround, और SpaceEvenly शामिल हैं. साथ ही, यह एलटीआर और आरटीएल, दोनों लेआउट के लिए पूरी तरह से काम करता है. (I7db38, b/436289959)
  • SubspaceModifier.Node के लिए एक बुनियादी इंटरफ़ेस जोड़ा गया है, ताकि टाइप सेफ़्टी और एक्सटेंशन इंटरफ़ेस की उपयोगिता को बेहतर बनाया जा सके; जैसे कि
    • CompositionLocalConsumerSubspaceModifierNode
    • LayoutCoordinatesAwareModifierNode
    • SubspaceLayoutModifierNode
    • CoreEntityNode (internal) (Iede00, b/440599394, b/440599394)
  • अप्रतिबंधित SpatialExternalSurface (I33315, b/439646773)
  • SubspaceModifier को Subspace composables में शामिल करें. साथ ही, constraints पैरामीटर को SubspaceModifier से बदलें. इसके लिए, साइज़ से जुड़े SubspaceModifiers का इस्तेमाल करें. अगर allowUnboundedSubspace की वैल्यू 'सही है' पर सेट है, तो सबस्पेस में अब भी अनबाउंडेड कंस्ट्रेंट हो सकते हैं. (Ib06e6, b/433331675)
  • SubspaceModifiers को मूव और रीसाइज़ करने की सुविधा को बंद कर दिया गया है. अब DragPolicy() और ResizePolicy(), SpatialPanel और SpatialExternalSurface एपीआई का हिस्सा हैं (I397bf, b/437924639)
  • स्पेशल लेआउट में LayoutDirection के लिए सहायता जोड़ी गई. SpatialAlignment का इस्तेमाल करके कंपोज़ेबल, अब एलटीआर और आरटीएल, दोनों कॉन्टेक्स्ट में एलिमेंट को सही तरीके से पोज़िशन करेगा. (I964bb, b/436300273)
  • Panel एपीआई में, साइज़ बदलने और मूव करने वाले पैरामीटर जोड़ें. इससे यह पक्का किया जा सकेगा कि ये व्यवहार सिर्फ़ उन कंटेनर पर लागू हों जो इनके साथ काम करते हैं. (Id491c)
  • sizeIn, widthIn, heightIn, depthIn SubspaceModifiers जोड़े गए हैं. इनकी मदद से, चौड़ाई, ऊंचाई, और गहराई के लिए कम से कम और ज़्यादा से ज़्यादा सटीक सीमाएं सेट की जा सकती हैं. (I1af09, b/433330761)

वर्शन 1.0.0-alpha06

13 अगस्त, 2025

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

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

  • लाइफ़साइकल के मालिक के खत्म होने पर, ComposeXrOwnerLocals को फिर से बनाएं. (9123ce1)

वर्शन 1.0.0-alpha05

30 जुलाई, 2025

androidx.xr.compose:compose:1.0.0-alpha05 और androidx.xr.compose:compose-testing:1.0.0-alpha05 रिलीज़ हो गए हैं. वर्शन 1.0.0-alpha05 में ये बदलाव शामिल हैं.

नई सुविधाएं

  • SubspaceComposable एनोटेशन क्लास को सार्वजनिक किया गया. (Ic2a34, b/399432430)
  • दो नए SpatialExternalSurface कंपोज़ेबल, जो 180 और 360 डिग्री के स्फ़ीयर दिखाते हैं. (I40ef2, b/391705799)
  • SubspaceModifier.aspectRatio को जोड़ा गया (Ide5ab, b/399729509, b/414762147)
  • SceneCore और Compose for XR के बीच इंटरऑपरेबिलिटी को बेहतर बनाने के लिए, SceneCoreEntity एपीआई जोड़ा गया. (I50bb3, b/423020989)
  • GravityAligned की सुविधा को बिना स्केल किए इस्तेमाल करने के लिए, GravityAlignedsubspace एपीआई उपलब्ध कराया गया (I07359)

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

  • SpatialDialog(), SpatialDialogProperties.dismissOnBack बार दबाने पर होने वाली कार्रवाई के हिसाब से काम करेगा. (Ib453b, b/416797132)
  • minimumPanelDimension को Dimensions(0.1f, 0.1f, 0.1f) के नए डिफ़ॉल्ट डाइमेंशन साइज़ में अपडेट करें, क्योंकि इसे मीटर में दिखाया गया है. (Ib852a)
  • सबस्पेस और ऑर्बिटर, अब होम स्पेस में और ऐप्लिकेशन के बैकग्राउंड में होने पर, अपनी इंटरनल स्टेट को बनाए रखेंगे. होम स्पेस मोड में, Subspace अब भी अपना सीन सेट अप करेगा, ताकि फ़ुल स्पेस मोड पर स्विच किया जा सके. (I40317, b/416037751)
  • SpatialDialogs अब ऐप्लिकेशन के बैकग्राउंड में होने पर भी अपनी स्थिति बनाए रखेगा. (I6aa56)
  • ApplicationSubspace अब सिस्टम से सुझाए गए स्केल और पोज़िशन को इनहेरिट करेगा. (I4565f, b/418834194)
  • गड़बड़ी का बेहतर मैसेज जोड़ा गया. साथ ही, जब SubspaceComposable का इस्तेमाल, SubspaceComposable के अलावा किसी अन्य कॉन्टेक्स्ट में किया जाता है, तो गड़बड़ी को पहले ट्रिगर किया जाता है. (Iee2ae, b/416484684)
  • ExperimentalSubspaceVolumeApi को चेतावनी से गड़बड़ी में अपडेट किया जा रहा है, क्योंकि कंपोज़ेबल एपीआई का गलत इस्तेमाल करने पर, चेतावनियों को अक्सर अनदेखा कर दिया जाता है. (I427aa, b/424864286)
  • सबस्पेस और ApplicationSubspace अब recommendedContentBoxInFullSpace से सीमित हैं. पहले, यह SpatialUser के फ़ील्ड ऑफ़ व्यू (कैमरे से दिख रहा व्यू) तक ही सीमित था. (I41015, b/423074142)
  • SpatialElevation को अपडेट किया गया, ताकि हार्ड कोड किए गए साइज़ के बजाय, कम से कम साइज़ का इस्तेमाल किया जा सके (I2dbe6, b/427785338)
  • किसी मुख्य वैरिएबल में बदलाव होने पर, SpatialAcitivityPanel को स्क्रिम करने के तरीके को अपडेट करें. (I0f64d, b/427999029)
  • VolumeConstraints.Unbounded को हटाएं, ताकि डिफ़ॉल्ट कंस्ट्रेंट वैल्यू को इसके बराबर सेट किया जा सके. (Ie24ec, b/407938414)
  • SpatialFeatheringSize अब सार्वजनिक नहीं है (I1c15b, b/399432430)
  • XR Placeable का नाम बदलकर SubspacePlaceable किया गया, ताकि इसे Compose के Placeable से अलग किया जा सके. (I74874)
  • Orbiter की सेटिंग हटाई जा रही हैं और नए पैरामीटर के तौर पर shouldRenderInNonSpatial को जोड़ा जा रहा है. इसके अलावा, Orbiter() फ़ंक्शन को एक साथ लाने के लिए, क्लास EdgeOffset को हटाया जा रहा है और orbiterOffsetType को नए पैरामीटर के तौर पर जोड़ा जा रहा है. साथ ही, OrbiterEdge का नाम बदलकर ContentEdge कर दिया गया है. (Iebf3d)
  • Measurable का नाम बदलकर SubspaceMeasurable कर दिया गया है, ताकि इसे Compose के Measurable टाइप से अलग किया जा सके. (I9726c)
  • MeasureResult का नाम बदलकर SubspaceMeasureResult किया गया (I9f34d)
  • setSubspaceContent एपीआई को हटा दिया गया है. इसकी जगह, Compose के setContent का इस्तेमाल किया जा सकता है. इसके लिए, Subspace कंपोज़ेबल का इस्तेमाल करना होगा. (Ifff4c, b/421427391, b/421427391)
  • MeasurePolicy का नाम बदलकर SubspaceMeasurePolicy कर दिया गया है. (I37a9b, b/422553904)
  • SubspaceSemanticsInfo को सील किए गए इंटरफ़ेस में बदलें, क्योंकि हम डिफ़ॉल्ट के बिना सदस्यों को नहीं जोड़ पाएंगे. (I372f9, b/423704068)
  • SpatialExternalSurface के दस्तावेज़ को अपडेट किया गया. साथ ही, ContentSecurityLevel का नाम बदलकर SurfaceProtection किया गया (I3c460, b/420982808)
  • मूवेबल मॉडिफ़ायर के लिए ओवरलोडेड कंस्ट्रक्टर उपलब्ध कराया गया है. इससे ऐंकरिंग की जा सकती है. (Ic0c70)
  • टूलटिप के लिए, पोज़िशन प्रोवाइडर की ज़्यादा सुविधाएं जोड़ी गई हैं. इससे डेवलपर अब यह कंट्रोल कर सकते हैं कि टूलटिप को ऐंकर के ऊपर, नीचे, बाईं या दाईं ओर रखा जाए. कैरेट के लिए शेप लेने वाला एपीआई जोड़ें, ताकि ज़्यादा कस्टम शेप उपलब्ध कराए जा सकें. (Ie513c, b/374766087, b/418854637)
  • CoreEntity को PublishedApi के तौर पर हटाया गया (Ifee05)

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

  • उस समस्या को ठीक किया गया है जिसकी वजह से रेंडर होने के दौरान, SpatialDialog फ़्लैश होता था. (Ife73c, b/401619909)
  • उस समस्या को ठीक किया गया है जिसकी वजह से SpatialDialog, गतिविधि पैनल को स्क्रिम नहीं कर पा रहा था. (I8ca6c, b/367442109)
  • एक्सआर डायलॉग में कुछ कॉन्टेंट न दिखने की समस्या को ठीक किया गया (I17cd5, b/418062437)
  • उस समस्या को ठीक कर दिया गया है जिसकी वजह से कॉन्टेंट के अंदर क्लिक करने पर, SpatialPopup खारिज हो जाता था. (If262c, b/417245722)
  • उस समस्या को ठीक किया गया है जिसमें resizable().movable() को चेन करने पर, SpatialPanel का साइज़ सही तरीके से नए साइज़ में नहीं बदलता था. (I02ee3, b/422264230)
  • SpatialComposeVideoPlayer में, topBar के मेन्यू के साथ ओवरलैप होने की समस्या को ठीक किया गया (Id33bc, b/427168167)
  • कॉर्नर रेडियस के रेंडर न होने की समस्या को ठीक किया गया (I975fe, b/428261830)

वर्शन 1.0.0-alpha04

7 मई, 2025

androidx.xr.compose:compose:1.0.0-alpha04 और androidx.xr.compose:compose-testing:1.0.0-alpha04 रिलीज़ हो गए हैं. वर्शन 1.0.0-alpha04 में ये बदलाव शामिल हैं.

नई सुविधाएं

  • CompositionLocalConsumerSubspaceModifierNode इंटरफ़ेस जोड़ा गया, ताकि कस्टम SubspaceModifier टाइप, कंपोज़िशन की लोकल वैल्यू को ऐक्सेस कर सकें.
  • नया SpatialPanel एपीआई जोड़ा गया है, जो कंपोज़ AndroidView को लागू करने के स्टाइल का पालन करता है. साथ ही, पिछले ViewBased SpatialPanel को बंद कर देता है.
  • VolumeConstraints.Unbounded कंपैनियन ऑब्जेक्ट जोड़ा गया, जो अनबाउंडेड कंस्ट्रेंट को दिखाता है.
  • स्पेशल ऑडियो सोर्स की अनुमति देने के लिए, SubspaceModifier.onPointSourceParams को जोड़ा गया.
  • एक सार्वजनिक ApplicationSubspace जोड़ा गया है. इसमें वैकल्पिक VolumeConstraints की सुविधा दी गई है, ताकि 3D एरिया को तय किया जा सके. इस एरिया में, ऐप्लिकेशन स्पेशल कॉन्टेंट को रेंडर कर सकता है. अगर कोई पाबंदी तय नहीं की गई है, तो डिफ़ॉल्ट रूप से सबस्पेस की चौड़ाई और ऊंचाई, SpatialUser के मौजूदा फ़ील्ड ऑफ़ व्यू (कैमरे से दिख रहा व्यू) के हिसाब से तय होगी. अगर फ़ील्ड ऑफ़ व्यू का पता नहीं लगाया जा सकता, तो उपयोगकर्ता पाबंदियां लगा सकते हैं. ऐसा न होने पर, फ़ील्ड ऑफ़ व्यू की चौड़ाई और ऊंचाई की डिफ़ॉल्ट वैल्यू का इस्तेमाल किया जाता है.
  • SpatialExternalSurface को जोड़ा गया. इसका इस्तेमाल, स्टीरियोस्कोपिक कॉन्टेंट को रेंडर करने के लिए किया जा सकता है. SpatialExternalSurface को मॉडिफ़ायर (ऐल्फ़ा को छोड़कर) और एज फ़ेदरिंग इफ़ेक्ट की मदद से पसंद के मुताबिक बनाया जा सकता है.
  • एक नया pointerHoverIcon सबस्पेस मॉडिफ़ायर जोड़ा गया है. इसकी मदद से, उपयोगकर्ता स्पेशल पॉइंटर के लिए आइकॉन सेट कर सकते हैं.

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

  • Jetpack XR के सभी पैकेज से RequiresApi(34) की पाबंदी हटा दी गई है. यह पाबंदी ज़रूरी नहीं थी, क्योंकि Jetpack XR फ़िलहाल सिर्फ़ एपीआई लेवल 34 और इसके बाद के वर्शन वाले डिवाइसों पर उपलब्ध है. (Iae0f8)
  • Kotlin 2.0 के साथ रिलीज़ किए गए प्रोजेक्ट इस्तेमाल करने के लिए, KGP 2.0.0 या इसके बाद का वर्शन ज़रूरी है. (Idb6b5)
  • बैक हैंडलिंग की सुविधा अब उन स्पेशल पैनल पर काम करेगी जिनमें एम्बेड की गई गतिविधियां नहीं हैं. बैक हैंडलिंग की सुविधा काम करे, इसके लिए आपको Android मेनिफ़ेस्ट में android:enableOnBackInvokedCallback="true" की जानकारी देनी होगी.
  • बैकहैंडलिंग की सुविधा, अब स्पेशियल डायलॉग पर काम करेगी. बैकहैंडलिंग की सुविधा काम करे, इसके लिए आपको Android मेनिफ़ेस्ट में android:enableOnBackInvokedCallback="true" की जानकारी देनी होगी.
  • Compose और View पर आधारित SpatialPanel, अब अपने कॉन्टेंट के हिसाब से साइज़ बदल सकते हैं.
  • डेवलपर अब अपनी पसंद के मुताबिक SpatialElevationLevel वैल्यू सेट कर सकते हैं. वे पहले से तय किए गए लेवल तक ही सीमित नहीं हैं.
  • ऑर्बिटर के एलिवेशन लेवल को अब elevation पैरामीटर की मदद से पसंद के मुताबिक बनाया जा सकता है.
  • अब सबस्पेस को डिफ़ॉल्ट रूप से, चौड़ाई और ऊंचाई में SpatialUser के फ़ील्ड ऑफ़ व्यू (कैमरे से दिख रहा व्यू) से सीमित किया जा सकता है. अगर फ़ील्ड ऑफ़ व्यू का पता नहीं लगाया जा सकता, तो फ़ील्ड ऑफ़ व्यू की चौड़ाई और ऊंचाई की डिफ़ॉल्ट वैल्यू का इस्तेमाल किया जाता है.
  • Movable मॉडिफ़ायर में नए कॉलबैक onMoveStart और onMoveEnd जोड़े गए. जब उपयोगकर्ता, movable मॉडिफ़ायर की मदद से सबस्पेस कंपोज़ेबल को मूव करना शुरू करता है और खत्म करता है, तब onMoveStart और onMoveEnd कॉलबैक को कॉल किया जाता है.
  • name पैरामीटर को SpatialRow और SpatialPanel जैसे स्पेशल एपीआई से हटा दिया गया है. स्पेशल कंपोज़ ट्री को डीबग करने के लिए, SubspaceModifier.testTag का इस्तेमाल करें.
  • SpatialPopup का एक ऐसा ओवरलोड हटाया गया है जो काम नहीं करता. इसमें सिर्फ़ spatialElevationLevel और content है. कृपया ऐसे इंटरफ़ेस का इस्तेमाल करें जो onDimissRequest के साथ काम करता हो.
  • Movable मॉडिफ़ायर से onPoseChange कॉलबैक को हटा दिया गया है. इसके बजाय, onMove का इस्तेमाल करें.
  • अगर SubspaceModifiersएलयूटी को अलग कर दिया गया है या अलग किया जा रहा है, तो उनके इफ़ेक्ट लागू नहीं होंगे.
  • मौजूदा SpatialRow एपीआई को SpatialRow और SpatialCurvedRow में बांट दिया गया है. अगर पहले SpatialRow के curveRadius पैरामीटर का इस्तेमाल किया जा रहा था, तो अब इसके बजाय SpatialCurvedRow का इस्तेमाल करें. यह भी उसी तरह काम करता है.
  • MainPanel और ActivityPanel को हाल ही के सिस्टम इमेज पर चलाने पर, उनमें टाइटल बार नहीं दिखते.
  • ऐल्फ़ा और स्केल मॉडिफ़ायर अब स्टैक किए जा सकते हैं. साथ ही, ये लागू की गई फ़ाइनल ऐल्फ़ा या स्केल वैल्यू के लिए, अपनी वैल्यू को गुणा करेंगे.
  • Movable मॉडिफ़ायर से मिलने वाले onPoseChange कॉलबैक को ऑप्टिमाइज़ किया गया है, ताकि पोज़ को आसानी से मूव किया जा सके.
  • मूव किए जा सकने वाले और साइज़ बदले जा सकने वाले मॉडिफ़ायर, अब मुख्य थ्रेड पर अपने कॉलबैक करेंगे. इससे यह पक्का किया जा सकेगा कि स्टेटस में होने वाले बदलावों से, फिर से कंपोज़िशन ट्रिगर होगा.
  • लेआउट और मेज़र फ़ेज़ में, स्टेटस को मॉनिटर करने की सुविधा जोड़ी गई है. इससे यह पक्का किया जा सकेगा कि SubspaceLayout में स्टेटस में बदलाव होने पर, फिर से लेआउट ट्रिगर होगा.
  • मौजूदा मॉडिफ़ायर का बेहतर तरीके से फिर से इस्तेमाल करने के लिए, मॉडिफ़ायर चेन के अपडेट को ऑप्टिमाइज़ किया गया.

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

  • SpatialDialog दिखने पर, स्क्रिमिंग बंद हो गई. (Ic4594)
  • मॉडिफ़ायर नोड के अलग होने के दौरान, फिर से लेआउट करने के अनुरोधों को अब अनदेखा कर दिया जाएगा.
  • Movable और Resizable मॉडिफ़ायर से ट्रिगर होने वाले रिलायआउट फ़ेज़ हटा दिए गए हैं.
  • MainPanel() कंपोज़ेबल में क्रैश होने की समस्या को ठीक किया गया.यह समस्या तब होती थी, जब किसी डाइमेंशन को सीधे तौर पर या लेआउट कैलकुलेशन के दौरान शून्य पर सेट किया जाता था. उदाहरण के लिए, SpatialRow/SpatialColumn कैलकुलेशन. इसके बजाय, अब पैनल को छिपा दिया जाएगा. ध्यान दें कि यह समस्या खास तौर पर लेआउट फ़ेज़ के दौरान होने वाले क्रैश से जुड़ी है. उपयोगकर्ता के इंटरैक्शन की वजह से पैनल का साइज़ शून्य होने की समस्या को अलग से ठीक किया जाएगा. छिपे हुए पैनल में यूज़र इंटरफ़ेस (यूआई) अफ़ोर्डेंस की कमी है.
  • साइज़ बदलने वाले मॉडिफ़ायर से maintainAspectRatio की समस्या को ठीक किया गया. अब आसपेक्ट रेशियो (लंबाई-चौड़ाई का अनुपात) को बनाए रखना चाहिए.
  • नेस्ट किए गए सबस्पेस से जुड़ी समस्या को ठीक किया गया है. इसकी वजह से, वे एक फ़्रेम के लिए गलत तरीके से पोज़िशन हो रहे थे.
  • उस समस्या को ठीक किया गया है जिसकी वजह से, कभी-कभी राउंड कॉर्नर लागू नहीं होते थे.
  • NestedSubspaces अब किसी एक फ़्रेम में गलत जगह पर नहीं दिखेगा.

वर्शन 1.0.0-alpha03

26 फ़रवरी, 2025

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

वर्शन 1.0.0-alpha02

12 फ़रवरी, 2025

androidx.xr.compose:compose:1.0.0-alpha02 और androidx.xr.compose:compose-testing:1.0.0-alpha02 रिलीज़ हो गए हैं. वर्शन 1.0.0-alpha02 में ये बदलाव शामिल हैं.

नई सुविधाएं

  • स्पेशल डायलॉग चालू होने पर, गतिविधि पैनल अब अपने कॉन्टेंट को स्क्रिम कर सकता है.
  • Orbiter एपीआई का इस्तेमाल अब SubspaceComposable कॉन्टेक्स्ट में किया जा सकता है. यह ऑर्बिटर को उनके सबसे नज़दीकी SubspaceLayout-आधारित कंपोज़ेबल पैरंट से अटैच करेगा.
  • LayoutCoordinatesAwareModifierNode को लॉन्च किया गया, ताकि कस्टम पोज़िशनिंग-आधारित मॉडिफ़ायर की अनुमति दी जा सके.
  • SubspaceModifier.Node में, अटैच/डिटैच लाइफ़साइकल के तरीके जोड़े गए.
  • scaleWithDistance को मूवेबल मॉडिफ़ायर में जोड़ा गया. scaleWithDistance के चालू होने पर, सबस्पेस एलिमेंट को मूव करने पर उसका साइज़ बड़ा या छोटा हो जाएगा. यह उस साफ़ तौर पर दिखने वाले स्केल को भी बनाए रखेगा जो मूवमेंट से पहले था.

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

  • SessionCallbackProvider को हटाकर, SpatialCapabilities को जोड़ा गया.

दूसरे बदलाव

  • minSDK को घटाकर 24 कर दिया गया. सभी Jetpack XR API को रनटाइम के दौरान, एपीआई 34 की ज़रूरत होती है.
  • Orbiter EdgeOffset.inner, EdgeOffset.outer, और EdgeOffset.overlap कंस्ट्रक्टर अब @Composable तरीके नहीं हैं. इससे उन्हें कंपोज़ न किए जा सकने वाले कॉन्टेक्स्ट में इस्तेमाल किया जा सकता है.
  • यूएक्स की नई खास बातों के मुताबिक, स्पेशल एलिवेशन लेवल अपडेट करें.
  • MeasurableLayout में SubspaceSemanticsInfo इंटरफ़ेस लागू करें.
  • SubspaceModifierElement का नाम बदलकर SubspaceModifierNodeElement किया गया.

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

  • SubspaceModifier के क्रम को बेहतर बनाने के लिए सुधार किए गए. SubspaceModifier को ज़्यादा भरोसेमंद तरीके से काम करना चाहिए. ऑफ़सेट, रोटेट, स्केल, मूवेबल, और साइज़ बदलने वाले मॉडिफ़ायर को अब किसी भी क्रम में इस्तेमाल किया जा सकता है.

वर्शन 1.0.0-alpha01

12 दिसंबर, 2024

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

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

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

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

    • SpatialPanel: स्पेशल पैनल, सबस्पेस कंपोज़ेबल होता है. इसकी मदद से, ऐप्लिकेशन का कॉन्टेंट दिखाया जा सकता है. उदाहरण के लिए, स्पेशल पैनल में वीडियो प्लेबैक, स्टिल इमेज या कोई अन्य कॉन्टेंट दिखाया जा सकता है.

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

    • वॉल्यूम: SceneCore की इकाइयों, जैसे कि 3D मॉडल को अपने यूज़र इंटरफ़ेस (यूआई) के हिसाब से सेट करें.

  • स्पेशल लेआउट: SpatialRow, SpatialColumn, SpatialBox, और SpatialLayoutSpacer का इस्तेमाल करके, कई स्पेशल पैनल बनाए जा सकते हैं और उन्हें स्पेशल लेआउट में रखा जा सकता है. लेआउट को पसंद के मुताबिक बनाने के लिए, SubspaceModifier का इस्तेमाल करें.

  • स्पेशल यूज़र इंटरफ़ेस (यूआई) कॉम्पोनेंट: इन एलिमेंट को आपके 2D यूज़र इंटरफ़ेस (यूआई) में फिर से इस्तेमाल किया जा सकता है. साथ ही, इनकी स्पेशल विशेषताएं सिर्फ़ तब दिखेंगी, जब स्पेशल सुविधाएं चालू होंगी.

    • SpatialDialog: पैनल, z-डेप्थ में थोड़ा पीछे की ओर पुश होगा, ताकि एलिवेटेड डायलॉग बॉक्स दिखाया जा सके.
    • SpatialPopUp: पैनल, z-डेप्थ में थोड़ा पीछे की ओर जाएगा, ताकि एलिवेटेड पॉप-अप दिखाया जा सके
    • SpatialElevation: ऊंचाई जोड़ने के लिए, SpatialElevationLevel को सेट किया जा सकता है.
  • SpatialCapabilities: उपयोगकर्ता के आपके ऐप्लिकेशन या सिस्टम के साथ इंटरैक्ट करने पर, स्पेशल कैपेबिलिटी में बदलाव हो सकता है. इसके अलावा, आपके ऐप्लिकेशन से भी इनमें बदलाव किया जा सकता है. उदाहरण के लिए, होम स्पेस या फ़ुल स्पेस में जाना. समस्याओं से बचने के लिए, आपके ऐप्लिकेशन को LocalSpatialCapabilities.current की जांच करनी होगी. इससे यह पता चलेगा कि मौजूदा एनवायरमेंट में कौनसे एपीआई काम करते हैं. isSpatialUiEnabled: स्पेशल यूज़र इंटरफ़ेस (यूआई) एलिमेंट (जैसे, SpatialPanel) isContent3dEnabled: 3D ऑब्जेक्ट isAppEnvironmentEnabled: एनवायरमेंट isPassthroughControlEnabled: ऐप्लिकेशन, पासथ्रू की स्थिति को कंट्रोल कर सकता है या नहीं isSpatialAudioEnabled: स्पेशल ऑडियो

पहले से मालूम समस्याएं

  • फ़िलहाल, Jetpack Compose for XR का इस्तेमाल करने के लिए, minSDK 30 होना ज़रूरी है. इसके बजाय, मेनिफ़ेस्ट में यह एंट्री <uses-sdk tools:overrideLibrary="androidx.xr.scenecore, androidx.xr.compose"/> जोड़ें, ताकि 23 के minSDK के साथ ऐप्लिकेशन को बनाया और चलाया जा सके.
  • फ़िलहाल, Jetpack XR ऐप्लिकेशन के लिए AndroidManifest में android.permission.SCENE_UNDERSTANDING अनुमति का अनुरोध करना ज़रूरी है.
  • जब कोई ऐप्लिकेशन अपने मेनिफ़ेस्ट में PROPERTY_XR_ACTIVITY_START_MODE प्रॉपर्टी का इस्तेमाल करके सीधे फ़ुल स्पेस में लॉन्च होता है, तो गतिविधियां/ऐप्लिकेशन, फ़ुल स्पेस में ट्रांज़िशन करने से पहले होम स्पेस में खुलते हैं.
  • वॉल्यूम कंपोज़ेबल में glTF, शुरुआत में गलत जगह पर फ़्लिकर कर सकते हैं.
  • किसी ऐसे पैनल में SpatialDialog का इस्तेमाल करने से कॉन्टेंट गलत दिशा में चला जाएगा जिसे काफ़ी मूव किया गया है.