एक्सआर के लिए Jetpack Compose
| नया अपडेट | स्टेबल वर्शन | रिलीज़ कैंडिडेट | बीटा रिलीज़ | ऐल्फ़ा रिलीज़ |
|---|---|---|---|---|
| 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ऐलोकेशन हो रहे थे. डेप्थ कैलकुलेशन की परफ़ॉर्मेंस को भी बेहतर बनाया गया है. I34a10aandroidx.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.sizekdocs (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) Sizekdocs अपडेट किया गया (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किया गया.SpatialExternalSurfacekdocs अपडेट किए गए (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 के बजाय,
SceneCoreEntityAPI का इस्तेमाल किया जाना चाहिए. (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के लिए एक बुनियादी इंटरफ़ेस जोड़ा गया है, ताकि टाइप सेफ़्टी और एक्सटेंशन इंटरफ़ेस की उपयोगिता को बेहतर बनाया जा सके; जैसे किCompositionLocalConsumerSubspaceModifierNodeLayoutCoordinatesAwareModifierNodeSubspaceLayoutModifierNodeCoreEntityNode(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,depthInSubspaceModifiersजोड़े गए हैं. इनकी मदद से, चौड़ाई, ऊंचाई, और गहराई के लिए कम से कम और ज़्यादा से ज़्यादा सटीक सीमाएं सेट की जा सकती हैं. (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 की ज़रूरत होती है.OrbiterEdgeOffset.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 का इस्तेमाल करने से कॉन्टेंट गलत दिशा में चला जाएगा जिसे काफ़ी मूव किया गया है.