XR için Jetpack Compose

Android XR'ın uzamsal özelliklerinden yararlanan uzamsal kullanıcı arayüzü düzenlerini bildirimsel olarak oluşturun.
Son Güncelleme Kararlı Sürüm Sürüm Adayı Beta sürümü Alfa Sürümü
23 Eylül 2026 - - 1.0.0-beta01 -

Bağımlılıkları bildirme

XR Compose'a bağımlılık eklemek için Google Maven deposunu projenize eklemeniz gerekir. Daha fazla bilgi için Google'ın Maven deposunu inceleyin.

Uygulamanız veya modülünüz için build.gradle dosyasına ihtiyacınız olan yapılarla ilgili bağımlılıkları ekleyin:

Eski

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

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

Kotlin

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

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

Bağımlılıklar hakkında daha fazla bilgi için Derleme bağımlılıkları ekleme başlıklı makaleyi inceleyin.

Geri bildirim

Geri bildiriminiz Jetpack'in iyileştirilmesine yardımcı olur. Yeni sorunlar keşfederseniz veya bu kitaplığı iyileştirmeye yönelik fikirleriniz varsa lütfen bize bildirin. Yeni bir sorun oluşturmadan önce lütfen bu kitaplıktaki mevcut sorunlara göz atın. Yıldız düğmesini tıklayarak mevcut bir soruna oyunuzu ekleyebilirsiniz.

Yeni sorun oluşturma

Daha fazla bilgi için Sorun İzleyici belgelerini inceleyin.

Sürüm 1.0

Sürüm 1.0.0-beta01

23 Eylül 2026

androidx.xr.compose:compose:1.0.0-beta01 ve androidx.xr.compose:compose-testing:1.0.0-beta01 yayınlandı. 1.0.0-beta01 sürümü bu commit'leri içerir.

API Değişiklikleri

  • Kullanımdan kaldırılan DragPolicy kaldırıldı. Bunun yerine SubspaceModifier.movable() politikasını kullanın. (I108d4)
  • Desteği sonlandırılan ResizePolicy ve SpatialPanel ile SpatialExternalSurface'deki kullanımları kaldırıldı. Desteği sonlandırılan bir SubspaceModifier.resizable işlevini kaldırın. Bunun yerine yeni SubspaceModifier.resizable ile yeni bir ResizePolicy kullanın. (I59e6b)
  • Eğimi bağımsız olarak etkinleştirmeye veya devre dışı bırakmaya olanak tanıyan isPitchUpdateEnabled parametresi eklendi. (Ie9e86)
  • pitchLimits'nın boş değer içerebilme özelliği kaldırıldı ve PitchLimits.UNCONSTRAINED, PitchLimits.FullRange olarak yeniden adlandırıldı. (I0154f)
  • ExposedDropdownMenu artık üye işlevi yerine ExposedDropdownMenuBoxScope üzerinde bir uzantı işlevidir. Kodunuzu yeni bir içe aktarma işlemiyle güncellemeniz gerekebilir. (Ie8a65)
  • Desteği sonlandırılan SurfaceProtection sınıfı kaldırıldı. Bunun yerine SpatialExternalSurfaceProtection politikasını kullanın. (Iab2c6)
  • OrbiterPoseProvider alan Orbiter işlevinin desteği sonlandırıldı ve SpatialAlignment kullanan işlev tercih edildi. (I4d12b)
  • SpatialActivityPanel artık yerleştirilmiş etkinlikleri başlatmak ve yönetmek için SpatialActivityPanelController (rememberSpatialActivityPanelController kullanılarak oluşturulur) gerektiriyor. (Id25c6)
  • upDirection parametresi rotateToLookAtUser öğesinden kaldırıldı ve döndürme kısıtlaması parametreleri (isYawUpdateEnabled ve pitchLimits) eklendi. (I1370a)

Hata Düzeltmeleri

  • Çeşitli InteractionPolicy sorunları düzeltildi. Composable veya alt öğe (ör. Orbiter) bir imha dizisi başlattığı sırada bir giriş etkinliği gerçekleşirse kilitlenme meydana geliyordu. Ayrıca, çocuğun fareyle üzerine gelme etkinlikleri almasıyla ilgili bir sorun da düzeltildi. (Ifc477)
  • Daha küçük FOV cihazlarda kırpılmayı önlemek için RotateToLookAtUserActivity'da panel boyutu küçültüldü. (I8d672)

Bilinen Sorunlar

  • Compose XR panellerinde, tek bir etkinlikte çok sayıda panel oluşturmanın, paneller yok edildikten sonra bile görüntülenen içerikte bozulmaya neden olabileceği bir sorun var.

Sürüm 1.0.0-alpha17

12 Ağustos 2026

androidx.xr.compose:compose:1.0.0-alpha17 ve androidx.xr.compose:compose-testing:1.0.0-alpha17 yayınlandı. 1.0.0-alpha17 sürümü bu commit'leri içerir.

API Değişiklikleri

  • Meter değer sınıfını kaldırın. Bu sınıf, Scenecore sürümünde virtualPixelDensity ile değiştirilmiştir. (I690ee)
  • SpatialGltfModel API artık deneyseldir ve kullanılabilmesi için etkinleştirilmesi gerekir. (I4557e)
  • system yeniden boyutlandırılabilir ve boş değer atanabilir hale getirildi (Ib0093)
  • Test için SubspaceSemanticsInfo içinde Density kullanıma sunuldu. (I2e826)
  • ResizePolicy varsayılan seçeneğini system olarak yeniden adlandırın ve parametre içermeyen yeni bir Default seçeneği ekleyin (Ic8b16).
  • FollowTarget deneysel olarak işaretlenir. FollowingSubspace API'nin tamamı artık deneyseldir. (Id4ee3)
  • GltfAnimation API'lerini kaldırma (Ic2894)
  • Parametreli MovePolicy.default() yöntemi, MovePolicy.system() olarak yeniden adlandırıldı. Standart varsayılan hareket davranışını temsil etmek için val MovePolicy.Default özelliği kullanıma sunuldu. (Iedcc9)
  • ExperimentalMoveAnchorPolicy katılım şartlarını PlaneSemantic ve PlaneOrientation olarak genişletme (Ief927)
  • resetMins sitesini VolumeConstraints.offset sitesinden kaldırma (Ib2f2f)
  • Desteği sonlandırılan SceneCoreEntitySizeAdapter işlevi kaldırıldı. (Ib6722)
  • Kullanımdan kaldırılan Subspace aşırı yüklemesi allowUnboundedSubspace ile kaldırıldı. (I8e97f)
  • Kullanımdan kaldırılan semantik değiştirici aşırı yüklemesi kaldırıldı. (I4ac10)

Hata Düzeltmeleri

  • InteractionPolicy bağlı bir Composable öğesinin alt öğelerinin tetikleyici giriş etkinliklerini (Icdba6) tetiklediği sorun düzeltildi.

Sürüm 1.0.0-alpha16

15 Temmuz 2026

androidx.xr.compose:compose:1.0.0-alpha16 ve androidx.xr.compose:compose-testing:1.0.0-alpha16 yayınlandı. 1.0.0-alpha16 sürümü bu commit'leri içerir.

API Değişiklikleri

  • ComponentOverride API'lerini kaldırma (I820c4)
  • GltfAnimation ve SpatialGltfModelAnimation API'leri deneysel olarak işaretlendi. Bazı özellikler getter'a dönüştürüldü. (I8d689, b/524771027)
  • Metre ile pikseller arasındaki dönüşümün sabit olmasını sağlayarak genel yoğunluk davranışını düzelttik. Kullanımdan kaldırılan Meter.kt yerine artık Session.scene.virtualPixelDensity kullanılabilir. (I122ff, b/430097855, b/474168798)
  • Yeniden boyutlandırılabilir değiştiriciyi iki değiştirici yerine ResizePolicy kullanacak şekilde güncelleyin (I7fb0f, b/496257436, b/519672992)
  • Dp = Dp(0.5f) parametresi, SubspaceAssertions.kt içindeki tüm genel kayan noktalı boyut ve konum eşitliği onaylarına eklendi. Varsayılan tolerans davranışı (0.5.dp) tam olarak belgelenmiştir. (I266cb, b/521491915)
  • movePolicy parametresiyle taşınabilir aşırı yükleme eklendi ve transformingMovable ile movable kullanımdan kaldırıldı (Ic88c1, b/481781189)
  • Material Expressive spesifikasyonlarına uygun, standart liste öğesi ve bölümlendirilmiş liste öğesinin yeni etkileşimli olmayan varyantları eklendi. Anlatım içermeyen sürümün desteği sonlandırıldı. (Ide4de, b/491994186)
  • Subspace için allowUnboundedSubspace parametresinin desteği sonlandırıldı ve bu parametre gizlendi. Sınırsız davranış artık alt alan değiştiricisinde SubspaceModifier.requiredSizeIn(maxWidth = Dp.Infinity, maxHeight = Dp.Infinity, maxDepth = Dp.Infinity) kullanılarak elde edilmelidir. allowUnboundedSubspace parametresi, FollowingSubspace öğesinden kaldırıldı. (Ia72ae, b/433624021)
  • Session.create, askıya alma işlevine dönüştürüldü. (I5d27f)
  • SubspaceModifier.spatializedAudioOutput eklendi. Bu sayede, ExoPlayer veya SoundEffectPlayer üzerinden ses oynatmayı uzamsallaştırabilirsiniz (I46697, b/489421980, b/497867019).
  • Durum doğrulaması için SpaceRequestResult döndürmek üzere ComponentActivity.requestHomeSpace() ve requestFullSpace() güncellendi. (If1672)
  • AnchorEntity, AnchorSpace olarak güncellendi (Ifa95e, b/513619219)
  • SpatialGltfModelSource bölgesinden sınırsız fromResource yöntemi (I1f5a1, b/503047416)
  • SubspaceSemanticsMatcher üyeleri herkese açıktır: description özelliği, yardımcı fabrika yöntemleri (expectValue, keyIsDefined, keyNotDefined), üye işlevleri (matches, matchesAny) ve operatörler (and, or, not). (I972a4, b/460427288)
  • SubspaceModifier.semantics, SubspaceModifier.testTag, SubspaceSemanticsInfo, SubspaceSemanticsModifierNode, seçilmiş mekansal semantik türlerini kullanacak şekilde güncellendi. (I80dea, b/460427288)
  • SpatialAlignment içinde position, align olarak yeniden adlandırıldı ve tek yönlü ofset yöntemleri, birleşik align API'si lehine kaldırıldı. (I9bdb2, b/479805937)
  • Desteği sonlandırılan Space Mode API'leri SpatialConfiguration'dan kaldırıldı. (I1ef5c, b/458712461)
  • SubspaceSemanticsConfiguration tanıtıldı. Bu, bir Spatial düğümü için semantik özelliklerin yapılandırmasıdır. Bu sınıf, temel 2D anlamsal yapı özelliklerini harici tüketicilere sızdırmadan 3D anlamsal yapı özellikler için sorgu yöntemlerini güvenli bir şekilde kullanıma sunar. (Id025e, b/460427288)
  • 3D düzen kapsayıcı özelliklerini geçerli alanlarla (başlangıçta testTag ve contentDescription) sınırlayan özel bir sarmalayıcı olan SubspaceSemanticsPropertyReceiver kullanıma sunuldu. (I5cf5c, b/460427288)

Hata Düzeltmeleri

  • Anlamsal değiştiricinin hasContentDescription özelliği, varsayılan olarak alt dize eşleşmesi kullanacak şekilde güncellendi. (I08214)
  • Elastik fizik tarafından yönlendirilen yumuşak bir takip davranışı sağlayan kısıtlanmış FollowBehavior.ExponentialDecay() eklendi. (I7449c, b/485639909, b/500493335)

Çoğu API bu durumdan etkilenir. Daha net bir ifadeyle, LocalSession CompositionLocal ve LocalSession'ya bağlı olan tüm CompositionLocals (ör. LocalSpatialConfiguration, LocalSpatialCapabilities vb.) artık Session başlatılmadan önce null veya XR olmayan sürümlerine yönlendirilecek.

Session kullanılabilir olduğunda yeniden oluşturma işlemi doğru durumla tetiklenir. (I0cfa4, b/514712835, b/514712835)

  • Askıya alma davranışı, iptal ve eşzamanlılık ile ilgili olarak ComponentActivity.requestHomeSpace ve ComponentActivity.requestFullSpace dokümanları netleştirildi. CancellationException yayılımını doğrulamak için testler güncellendi. (I22f75, b/493289528)

Sürüm 1.0.0-alpha15

17 Haziran 2026

androidx.xr.compose:compose:1.0.0-alpha15 ve androidx.xr.compose:compose-testing:1.0.0-alpha15 yayınlandı. 1.0.0-alpha15 sürümü bu commit'leri içerir.

API Değişiklikleri

  • ResizePolicy ve eski yeniden boyutlandırılabilir değiştiricinin desteği sonlandırıldı. Bunun yerine yeni bir SubspaceModifier.resizable aşırı yüklemesi ve SubspaceModifier.transformingResizable kullanıma sunuldu. (I9e4bc)
  • SpatialGltfModel API'leri güncellendi: SpatialGltfModelSource aracılığıyla kaynaklardan model yükleme desteği eklendi.fromResource SpatialGltfModelAnimation içinde hız, playbackSpeed olarak yeniden adlandırıldı ve resume() yöntemi eklendi. SpatialGltfModelStatus.Loaded ve Loading artık nesne. (I523de)
  • rotateToLookAtUser, deneysel API olarak işaretlendi. (I86c16)
  • Korunan targetCurrentPose değişkeni, yerel currentTargetPoseMeter değişkeni olarak taşındı ve yeniden adlandırıldı. (Ia557c)
  • Nesnenin düzen boyutu içinde nerede oluşturulduğunu eklemek için SpatialPanel ve SpatialExternalSurface kdocs'u güncelleyin (I72104).
  • SpatialGltfModel yükleme mantığı SpatialGltfModelState içinde kapsandı ve hata davranışı netleştirildi. (Ibe98b)
  • SubspaceModifer.size dokümanlarında depth netleştirildi (I0f84f)

Sürüm 1.0.0-alpha14

19 Mayıs 2026

androidx.xr.compose:compose:1.0.0-alpha14 ve androidx.xr.compose:compose-testing:1.0.0-alpha14 yayınlandı. 1.0.0-alpha14 sürümü bu commit'leri içerir.

API Değişiklikleri

  • Varsayılan sistem tarafından işlenen 3D hareket için transformingMovable, özel hareket davranışlarını işlemek için movable'ye yeni bir aşırı yükleme eklendi. (I50960)
  • SpatialGltfModel.fromData() kaldırıldı. (I4d083)
  • Ölçüm geçişinden sonra onRemeasured geri çağırma işlevi sağlayan yeni bir değiştirici düğümü arayüzü SubspaceMeasuredSizeAwareModifierNode eklendi. SubspaceLayoutAwareModifierNode artık bu yeni arayüzü kullanıyor. onSizeChanged değiştiricisi, onRemeasured kullanacak şekilde güncellendi. Böylece geri çağırma, yerleştirmeden sonra değil, ölçümden hemen sonra tetiklenir. (Iafbae)
  • InteractionPolicy, Interface (I0ff30) sürümüne güncellendi.
  • Compose compileSdk, API 37'ye güncellendi. Bu nedenle, Compose kullanılırken minimum AGP sürümü 9.2.0 olmalıdır. (Id45cd)
  • Size kdocs güncellendi (Iefa9a)

Sürüm 1.0.0-alpha13

6 Mayıs 2026

androidx.xr.compose:compose:1.0.0-alpha13 ve androidx.xr.compose:compose-testing:1.0.0-alpha13 yayınlandı. 1.0.0-alpha13 sürümü bu commit'leri içerir.

API Değişiklikleri

  • Orbiter API'de ek değişiklikler yapılması bekleniyor. Orbiter'lar için kullanımdan kaldırma bildirimlerini devre dışı bırakmanızı ve gelecek sürümlerde Orbiter değişikliklerine dikkat etmenizi öneririz.
  • glTF'leri oluşturmak için SceneCoreEntity kullananlar, glTF'lerinin oluşturulmasını sağlamak amacıyla GltfModel.create çağrılarının parent parametresine session.scene.activitySpace değerini ilettiklerinden emin olmalıdır.
  • Geliştiricilerin Gltf'leri Compose For XR uygulamalarına eklemesine olanak tanıyan SpatialGltfModel API'si eklendi. Geliştiriciler, Gltf modellerindeki animasyonları ve düğümleri de sorgulayabilir. (I8b542, b/495422586)
  • Sınıftan arayüze değişiklikler SceneCoreEntitySizeAdapter (I5a784, b/475292310)
  • SurfaceProtection, SpatialExternalSurfaceProtection olarak yeniden adlandırıldı. SpatialExternalSurface kdoc'u güncellendi (Ifad0a, b/485231082)
  • currentWindowAdaptiveInfo desteğini sonlandırma ve bunun V2 sürümünü kullanıma sunma (I40ecf, b/424442112)
  • resizable değiştiricisi artık herkese açık ve gruplar için geçerli (ör. SpatialRow). (I2bcf6, b/348483527, b/489753178, b/479530787)
  • movable değiştiricisi artık herkese açık. Bu değiştirici şu anda SpatialPanels ve SpatialExternalSurface için iyi çalışmaktadır. Ancak bu değiştiricilerin tüm SubspaceComposables için iyi bir şekilde desteklenmesi amaçlanmaktadır. (I9a3cd, b/479530787, b/478935063, b/478935063)
  • SpatialEnterTransition ve SpatialExitTransition, @Immutable olarak işaretlendi (If1710, b/487757837)
  • SpatialGltfModel API, ek testler yapılana kadar bu sürüm için kısıtlanmış olarak işaretlenir. (Ibf003, b/466090694)
  • DeviceTrackingMode.LAST_KNOWN, SPATIAL_LAST_KNOWN olarak yeniden adlandırıldı (kullanımdan kaldırılmış bir geri dönüşle), 3DoF izleme için INERTIAL_LAST_KNOWN eklendi ve TRACKING_DEGRADED, TrackingState'ye eklendi. (Ie661c, b/445466590)
  • Desteği sonlandırılan SpatialLayoutSpacer (I7b36c) kaldırılıyor
  • Desteği sonlandırılan dolgu API'si (If1886) kaldırılıyor
  • Eğilim değerlerine floatRange eklendi. LayoutDirection için varsayılan değer kaldırıldı (I9d74e)

Hata Düzeltmeleri

  • SpatialColumn, SpatialRow ve SpatialCurvedRow için kod örnekleri ve KDoc belgeleri eklendi. (Iaf54f, b/495777633)

Sürüm 1.0.0-alpha12

25 Mart 2026

androidx.xr.compose:compose:1.0.0-alpha12 ve androidx.xr.compose:compose-testing:1.0.0-alpha12 yayınlandı. 1.0.0-alpha12 sürümü bu commit'leri içerir.

API Değişiklikleri

  • glTF'leri oluşturmak ve animasyonları kontrol etmek için SpatialGltfModel API'sini ve SpatialGltfModelAnimation API'lerini ekleyin. SpatialGltfModelState, AutoCloseable olarak değiştirildi. Kaynaklarını serbest bırakmak için kapatılması gerekiyor. (I11fde, b/466065486, b/481379924). Ancak SpatialGltfModel API, ek testler yapılana kadar bu sürüm için kısıtlanmış olarak işaretlenir. (Ibf003, b/466090694)
  • SubspaceModifier.rotate için desteği sonlandırılan boş bir aşırı yükleme eklendi. (Idceb6)
  • SpatialSmoothFeatheringEffect işlevinin adı spatialSmoothFeatheringEffect olarak değiştirildi ve işlev, çizim modülüne taşındı. Eski ZeroFeatheringEffect işlevini taklit eden, güncellenmiş SpatialExternalSurface varsayılan yumuşatma değerini null olarak ayarlayın. (I5fdaa, b/460426800)
  • onPointSourceParamsAvailable kaldırıldı. Yakın gelecekte farklı bir işitsel uzamsallaştırma API'si kullanıma sunulacak. (I86507, b/458513439)
  • Ofset alt uzay değiştiricileri için sağdan sola davranış eklendi. Ayrıca, düzen yönünü yoksaymak için absoluteOffset eklendi. (I30e4b, b/474409165)

Sürüm 1.0.0-alpha11

25 Şubat 2026

androidx.xr.compose:compose:1.0.0-alpha11 ve androidx.xr.compose:compose-testing:1.0.0-alpha11 yayınlandı. 1.0.0-alpha11 sürümü bu commit'leri içerir.

Yeni Özellikler

  • SuperSampling parametresini SpatialExternalSurfaces öğesine ekleme (Icd4d1)

Bilinen Sorunlar

  • SceneCore'daki SurfaceEntity ile ilgili bir sorun, SpatialExternalSurface örnekleri oluşturulurken uygulamaların kilitlenmesine neden olabilir. Bu sorun androidx.xr.scenecore:scenecore-*:1.0.0-alpha13, androidx.xr.compose:compose:1.0.0-alpha12 ve sonraki sürümlerde giderilmiştir. Etkilenen uygulamalar en yeni sürümlere güncellenmelidir.

API Değişiklikleri

  • Düzen yönü farkındalığı için alt alan değiştirici dolgusu değişiklikleri. (I53e25)
  • SpatialCapabilities artık kapatıldı ve uzatılamaz. (I07aef)
  • Genel bir SpatialAlignment parametresini kabul eden SpatialRow ve SpatialColumn API'lerinin desteği sonlandırıldı. Bunun yerine, sırasıyla SpatialRow ve SpatialColumn için verticalAlignment veya horizontalAlignment parametrelerini kabul eden API'leri kullanın. (Iec390)
  • Aşırı yükleme SubspaceLayout işlev API'lerini birleştirme (Idd30a)
  • SubspaceModifier.lookAtUser, rotateToLookAtUser olarak, up parametresi ise upDirection olarak yeniden adlandırıldı. (Icafb8)
  • SpatialRow işlevini satır içi işlev haline getirme (Ia2f20)
  • SpatialColumn işlevini satır içi işlev yapma (I681be)
  • Billboard API'si kaldırıldı (Ib76cd)

Sürüm 1.0.0-alpha10

28 Ocak 2026

androidx.xr.compose:compose:1.0.0-alpha10 ve androidx.xr.compose:compose-testing:1.0.0-alpha10 yayınlandı. 1.0.0-alpha10 sürümü bu commit'leri içerir.

API Değişiklikleri

  • Kullanımdan kaldırılan API'yi kaldırma - ApplicationSubspace (Ia6596, b/468345186)
  • SpatialShape, kapalı bir arayüze güncellendi (I7e3f5, b/460426800)
  • SpatialAlignment'de desteği sonlandırılan API'leri kaldırma. (Ib0b61, b/468011887)
  • SpatialLayoutSpacer desteği sonlandırılıyor ve SpatialSpacer kullanıma sunuluyor. (I2ebf3, b/466071383)
  • "Lazy locking" teriminin yerine "soft locking" teriminin kullanılması için UserSubspace API'si güncellendi. (I9ded1, b/464035984)

Sürüm 1.0.0-alpha09

3 Aralık 2025

androidx.xr.compose:compose:1.0.0-alpha09 ve androidx.xr.compose:compose-testing:1.0.0-alpha09 yayınlandı. 1.0.0-alpha09 sürümü bu commit'leri içerir.

API Değişiklikleri

  • İçeriğin her zaman kullanıcıya dönük olmasını sağlayan LookAtUser ve Billboard değiştiricilerini ekleme (I49b99)
  • ile SpatialExternalSurfaces ve SpatialPanels arasında InteractionPolicy ayarlama özelliği eklenir. Bu sayede tıklamalar ve diğer 3D giriş etkinlikleri algılanabilir. (Iae155)
  • Dp değerleri olarak genişlik, yükseklik ve derinlik ile boyut ve requiredSize değiştirici aşırı yüklemesi eklendi. (I92f79)
  • ParentLayoutParamsModifier arayüzü artık DelegatableSubspaceNode. (I1a6d4)
  • ApplicationSubspace, Subspace API lehine kullanımdan kaldırıldı.
    • Subspace API davranışı, yalnızca önerilen duruş ve ölçekte uygulama genelinde bir alt alan sağlayacak şekilde değiştirildi.
    • 2D bağlamlarda yerleştirilmiş alt alanlar sağlamak için PlanarEmbeddedSubspace API'si kullanıma sunulmuştur. (Id3343)
  • SubspaceModifier.Node API'sine shouldAutoInvalidate işareti eklendi. (I93902)
  • required(Size|Width|Depth|Height)Geliştiricilerin, üst öğenin gelen ölçüm kısıtlamalarını dikkate almadan bir @SubspaceComposable boyutunu belirli bir aralıkla sınırlamasına olanak tanıyan API'ler eklendi. (Ifaa78)
  • Geliştiricilerin @SubspaceComposable boyutunda değişiklik olduğunda tepki vermesini sağlayan basit ve odaklanmış bir geri çağırma işlevi sunan SubspaceModifier.onSizeChanged eklendi. (I994f9)
  • Volume API kaldırıldı. Volume API yerine SceneCoreEntity API kullanılmalıdır. (I4162b)
  • SubspaceLayoutModifierNode.requestRelayout öğesini invalidateMeasurement/invalidatePlacement olarak bölün. (I14805)
  • Geliştiricilerin glTF'leri Compose'da oluşturmasına olanak tanıyan SpatialGltfModel API'si eklendi. (Icc91f)
  • glTF'leri kolayca oluşturmak için SpatialGltfModel composable API'si kullanıma sunuldu (Iade67)

Hata Düzeltmeleri

  • SceneCoreEntity uygulamasındaki düzen hatası düzeltildi. Artık kısıtlamalarına uygun şekilde uyması gerekir. (I11bb8)
  • Jxr-compose modüllerini Compile sdk = 34'ye (I2d5db) düşürün.

Sürüm 1.0.0-alpha08

22 Ekim 2025

androidx.xr.compose:compose:1.0.0-alpha08 ve androidx.xr.compose:compose-testing:1.0.0-alpha08 yayınlandı. 1.0.0-alpha08 sürümü bu commit'leri içerir.

API Değişiklikleri

  • ResizePolicy, onResizeStartonResizeUpdate ve onResizeEnd'ü kabul edecek şekilde değiştirildi. (I7e21f)

Hata Düzeltmeleri

  • Bir etkinliği alt alanla yok ederken kilitlenmeyi önler. (I595a1)

Sürüm 1.0.0-alpha07

24 Eylül 2025

androidx.xr.compose:compose:1.0.0-alpha07 ve androidx.xr.compose:compose-testing:1.0.0-alpha07 yayınlandı. 1.0.0-alpha07 sürümü bu commit'leri içerir.

API Değişiklikleri

  • SpatialMainPanel için geliştirilmiş KDocs. (I27b70, b/444467891)
  • SpatialRow ve SpatialColumn gibi 3D düzenlerde çocukları ana eksen boyunca düzenlemek için SpatialArrangement özelliği eklendi. Bu yeni API, 2D Compose'daki Start, End, Center, SpaceBetween, SpaceAround ve SpaceEvenly gibi düzenleme seçeneklerini sunar. Ayrıca hem soldan sağa hem de sağdan sola düzen yönleri için tam destek sağlar. (I7db38, b/436289959)
  • SubspaceModifier.Node için temel bir arayüz eklenerek uzantı arayüzlerinin tür güvenliği ve kullanılabilirliği iyileştirildi. Örneğin:
    • CompositionLocalConsumerSubspaceModifierNode
    • LayoutCoordinatesAwareModifierNode
    • SubspaceLayoutModifierNode
    • CoreEntityNode (internal) (Iede00, b/440599394, b/440599394)
  • Kısıtlamayı kaldırın SpatialExternalSurface (I33315, b/439646773)
  • Subspace composable'larına SubspaceModifier parametresini ekleyin ve kısıtlamalar parametresini, boyutla ilgili SubspaceModifiers ile SubspaceModifier olarak değiştirin. allowUnboundedSubspace doğruysa alt uzaylar sınırsız kısıtlamalara sahip olmaya devam edebilir. (Ib06e6, b/433331675)
  • DragPolicy() ve ResizePolicy() artık SpatialPanel ve SpatialExternalSurface API'sinin (I397bf, b/437924639) bir parçası olduğundan taşınabilir ve yeniden boyutlandırılabilir SubspaceModifiers desteği sonlandırıldı.
  • Uzamsal düzenlerde LayoutDirection için destek eklendi. SpatialAlignment kullanılarak oluşturulan composable'lar artık hem soldan sağa (LTR) hem de sağdan sola (RTL) bağlamlarda öğeleri doğru şekilde konumlandıracak. (I964bb, b/436300273)
  • Bu davranışların yalnızca desteklenen kapsayıcılara uygulanabilmesini sağlamak için Panel API'lerine Resizable (Yeniden Boyutlandırılabilir) ve Movable (Taşınabilir) parametrelerini ekleyin. (Id491c)
  • Genişlik, yükseklik ve derinlik için tam minimum ve maksimum kısıtlamalar belirlemenize olanak tanıyan sizeIn, widthIn, heightIn, depthIn SubspaceModifiers özellikleri eklendi. (I1af09, b/433330761)

Sürüm 1.0.0-alpha06

13 Ağustos 2025

androidx.xr.compose:compose:1.0.0-alpha06 ve androidx.xr.compose:compose-testing:1.0.0-alpha06 yayınlandı. 1.0.0-alpha06 sürümü bu commit'leri içerir.

Hata Düzeltmeleri

  • Yaşam döngüsü sahibi yok edildiğinde ComposeXrOwnerLocals öğesini yeniden oluşturun. (9123ce1)

Sürüm 1.0.0-alpha05

30 Temmuz 2025

androidx.xr.compose:compose:1.0.0-alpha05 ve androidx.xr.compose:compose-testing:1.0.0-alpha05 yayınlandı. 1.0.0-alpha05 sürümü bu commit'leri içerir.

Yeni Özellikler

  • SubspaceComposable not sınıfı herkese açık hale getirildi. (Ic2a34, b/399432430)
  • 180 ve 360 derecelik küreleri temsil eden iki yeni SpatialExternalSurface Composables. (I40ef2, b/391705799)
  • SubspaceModifier.aspectRatio tarihinde eklendi (Ide5ab, b/399729509, b/414762147)
  • SceneCoreEntity API'si, SceneCore ile Compose for XR arasındaki birlikte çalışabilirliği artırmak için eklendi. (I50bb3, b/423020989)
  • Ölçeklendirilmemiş VE GravityAligned özelliğini desteklemek için GravityAlignedsubspace API'si sağlandı (I07359).

API Değişiklikleri

  • SpatialDialog(), SpatialDialogProperties.dismissOnBack tuşuna basma yapılandırmasını izler. (Ib453b, b/416797132)
  • Metre cinsinden gösterildiği için minimumPanelDimension boyutunu Dimensions(0.1f, 0.1f, 0.1f) olan yeni bir varsayılan boyutla güncelleyin. (Ib852a)
  • Alt alanlar ve Orbiters artık ana alanda ve uygulama arka plandayken kendi iç durumlarını koruyacak. Ev alanı modunda Subspace, tam alan moduna geçişe hazırlanmak için sahnesini kurmaya devam eder. (I40317, b/416037751)
  • SpatialDialogs artık uygulama arka plandayken durumlarını koruyacak. (I6aa56)
  • ApplicationSubspace artık önerilen ölçeğini ve konumunu sistemden devralacak. (I4565f, b/418834194)
  • SubspaceComposable bağlamı dışında bir SubspaceComposable kullanıldığında daha iyi bir hata mesajı eklendi ve hata daha erken tetikleniyor. (Iee2ae, b/416484684)
  • Uyarılar, birleştirilebilir API'ler yanlış kullanıldığında genellikle gözden kaçırıldığından ExperimentalSubspaceVolumeApi, uyarıdan hataya güncellendi. (I427aa, b/424864286)
  • Alt uzay ve ApplicationSubspace artık recommendedContentBoxInFullSpace ile sınırlanıyor. Daha önce SpatialUser'nın görüş alanı ile sınırlıydı. (I41015, b/423074142)
  • Sabit kodlanmış boyutun artık kullanılmaması için SpatialElevation güncellemesiyle minimum boyutun kullanılması (I2dbe6, b/427785338)
  • Önemli bir değişken değiştirildiğinde güncellenmesi için SpatialAcitivityPanel ile ilgili yaptığımız hazırlık maçlarının güncellenme şeklini değiştirin. (I0f64d, b/427999029)
  • Varsayılan kısıtlama değerlerini eşdeğer olarak ayarlamak için VolumeConstraints.Unbounded kaldırıldı. (Ie24ec, b/407938414)
  • SpatialFeatheringSize artık herkese açık değil (I1c15b, b/399432430)
  • Compose'un Placeable öğesinden ayırt etmek için XR Placeable öğesini SubspacePlaceable olarak yeniden adlandırdı. (I74874)
  • Orbiter ayarlarını kaldırma ve shouldRenderInNonSpatial öğesini yeni bir parametre olarak ekleme. Ayrıca, EdgeOffset sınıfını kaldırıp Orbiter() işlevlerini birleştirmek için orbiterOffsetType sınıfını yeni bir parametre olarak ekliyoruz. Ayrıca OrbiterEdge adlı öğeyi ContentEdge olarak yeniden adlandırın. (Iebf3d)
  • Türün Compose'un Measurable türünden ayırt edilebilmesi için Measurable, SubspaceMeasurable olarak yeniden adlandırıldı. (I9726c)
  • MeasureResult dosyasını SubspaceMeasureResult olarak yeniden adlandırın (I9f34d)
  • setSubspaceContent API'si kaldırıldı. Bunun yerine, Subspace composable'ı ile Compose'un setContent composable'ı kullanılacak. (Ifff4c, b/421427391, b/421427391)
  • MeasurePolicy, SubspaceMeasurePolicy olarak yeniden adlandırıldı. (I37a9b, b/422553904)
  • Varsayılanlar olmadan üye ekleyemeyeceğimiz için SubspaceSemanticsInfo adlı alanı kapalı bir arayüze dönüştür. (I372f9, b/423704068)
  • SpatialExternalSurface dokümanları güncellendi, ContentSecurityLevel, SurfaceProtection olarak yeniden adlandırıldı (I3c460, b/420982808)
  • Taşınabilir değiştirici için, sabitlemeye olanak tanıyan aşırı yüklenmiş oluşturucu sağlandı. (Ic0c70)
  • İpuçları için daha fazla konum sağlayıcı eklendi. Böylece geliştiriciler, ipucunun sabit öğenin üstünde, altında, solunda veya sağında yerleştirilip yerleştirilmeyeceğini kontrol edebilir. Şapka için Şekil alan bir API ekleyin. Böylece daha fazla özel şekil sağlanabilir. (Ie513c, b/374766087, b/418854637)
  • CoreEntity, PublishedApi olarak kaldırıldı (Ifee05)

Hata Düzeltmeleri

  • SpatialDialog simgesinin oluşturulurken yanıp sönmesiyle ilgili sorun düzeltildi. (Ife73c, b/401619909)
  • SpatialDialog öğesinin Etkinlik Paneli'ni karartamamasıyla ilgili sorun düzeltildi. (I8ca6c, b/367442109)
  • XR iletişim kutusunda bazı içeriklerin gösterilmemesi sorunu düzeltildi (I17cd5, b/418062437)
  • İçerik içinde tıklandığında SpatialPopup öğesinin kapatılması sorunu düzeltildi. (If262c, b/417245722)
  • resizable().movable() ile zincirleme yapıldığında SpatialPanel'in yeni boyuta doğru şekilde yeniden boyutlandırılamaması sorunu düzeltildi. (I02ee3, b/422264230)
  • SpatialComposeVideoPlayer içindeki menüyle çakışan sabit topBar (Id33bc, b/427168167)
  • Sabit köşe yarıçapının oluşturulmaması sorunu düzeltildi (I975fe, b/428261830).

Sürüm 1.0.0-alpha04

7 Mayıs 2025

androidx.xr.compose:compose:1.0.0-alpha04 ve androidx.xr.compose:compose-testing:1.0.0-alpha04 yayınlandı. 1.0.0-alpha04 sürümü bu commit'leri içerir.

Yeni Özellikler

  • Özel SubspaceModifier türlerinin kompozisyon yerel değerlerine erişmesine izin vermek için CompositionLocalConsumerSubspaceModifierNode arayüzü eklendi.
  • Compose AndroidView uygulama stilini izleyen ve önceki ViewBased SpatialPanel'yi kullanımdan kaldıran yeni bir SpatialPanel API'si eklendi.
  • Sınırsız kısıtlamaları temsil eden VolumeConstraints.Unbounded yardımcı nesnesi eklendi.
  • Uzamsallaştırılmış ses kaynağına izin vermek için SubspaceModifier.onPointSourceParams eklendi.
  • Herkese açık bir ApplicationSubspace eklendi. Bu, uygulamanın uzamsal içerik oluşturabileceği bir 3D alan tanımlamak için isteğe bağlı VolumeConstraints sunar. Varsayılan olarak, herhangi bir kısıtlama belirtilmezse alt uzay, SpatialUser'nın genişlik ve yükseklik açısından mevcut görüş alanıyla sınırlanır. Kullanıcılar, görüş alanı belirlenemezse kullanılacak kısıtlamalar sağlayabilir. Aksi takdirde, varsayılan görüş alanı genişliği ve yüksekliği değerleri kullanılır.
  • Stereoskopik içerik oluşturmak için kullanılabilecek SpatialExternalSurface eklendi. SpatialExternalSurface, değiştiriciler (alfa hariç) ve kenar yumuşatma efektiyle özelleştirilebilir.
  • Kullanıcıların uzamsal işaretçinin simgesini ayarlamasına olanak tanıyan yeni bir pointerHoverIcon alt alan değiştiricisi eklendi.

API Değişiklikleri

  • Tüm Jetpack XR paketlerindeki RequiresApi(34) kısıtlaması kaldırıldı. Jetpack XR şu anda yalnızca API düzeyi 34 ve üzeri olan cihazlarda kullanılabildiğinden bu kısıtlama gereksizdi. (Iae0f8)
  • Kotlin 2.0 ile yayınlanan projelerin kullanılabilmesi için KGP 2.0.0 veya daha yeni bir sürüm gerekir. (Idb6b5)
  • Geriye gitme işleme özelliği artık yerleştirilmiş etkinlikler içermeyen uzamsal panellerde çalışacak. Geriye doğru işlemeyi kullanmak için android manifest dosyasında android:enableOnBackInvokedCallback="true" belirtmeniz gerekir.
  • Geriye doğru işleme artık uzamsal iletişim kutularında çalışacak. Geriye doğru işleme özelliğinin çalışması için android manifestinde android:enableOnBackInvokedCallback="true" belirtmeniz gerekir.
  • Oluşturma tabanlı ve görüntüleme tabanlı SpatialPanel artık içeriklerine göre boyutlandırılabilir.
  • Geliştiriciler artık kendi özel SpatialElevationLevel değerlerini belirleyebilir ve önceden tanımlanmış seviyelerle sınırlı değildir.
  • Yörünge aracı yükseklik düzeyi artık elevation parametresiyle özelleştirilebilir.
  • Alt alan artık varsayılan olarak SpatialUser'nın genişlik ve yükseklik açısından görüş alanıyla sınırlanabilir. Görüş alanı belirlenemezse varsayılan görüş alanı genişliği ve yüksekliği değerleri kullanılır.
  • Movable değiştiricisine onMoveStart ve onMoveEnd olmak üzere yeni geri çağırmalar eklendi. Kullanıcı, taşınabilir değiştiriciyle birleştirilebilen bir alt alanı taşımaya başladığında ve taşımayı bitirdiğinde onMoveStart ve onMoveEnd geri çağırmaları çağrılır.
  • name parametresi, SpatialRow ve SpatialPanel gibi coğrafi API'lerden kaldırıldı. Uzamsal Compose ağaçlarında hata ayıklamak için bunun yerine SubspaceModifier.testTag kullanın.
  • Yalnızca spatialElevationLevel ve content içeren, desteklenmeyen bir SpatialPopup aşırı yüklemesi kaldırıldı. Lütfen onDimissRequest özelliğini destekleyen arayüzü kullanın.
  • Movable değiştiricisinden gelen onPoseChange geri çağırma kaldırıldı. Bunun yerine onMove politikasını kullanın.
  • SubspaceModifiers ayrılırsa veya ayrılıyorsa artık efektlerini uygulamaz.
  • Mevcut SpatialRow API'si SpatialRow ve SpatialCurvedRow olarak ikiye ayrıldı. Daha önce SpatialRow'nın curveRadius parametresini kullanıyorsanız artık aynı davranışı sunan SpatialCurvedRow parametresini kullanın.
  • MainPanel ve ActivityPanel, benzer şekilde yeni bir sistem görüntüsünde çalıştırıldığında artık başlık çubuğuna sahip değildir.
  • Alfa ve ölçek değiştiriciler artık yığılabilir ve nihai uygulanan alfa veya ölçek değeri için değerlerini çarpacaktır.
  • onPoseChange Taşınabilir değiştiriciden gelen geri çağırma, daha sorunsuz poz hareketi gerçekleştirecek şekilde optimize edildi.
  • Taşınabilir ve yeniden boyutlandırılabilir değiştiriciler artık durum değişikliklerinin yeniden oluşturmayı tetiklemesini sağlamak için geri çağırmalarını ana iş parçacığında gerçekleştirecek.
  • SubspaceLayout içindeki durum değişikliklerinin yeniden düzenlemeyi tetiklemesini sağlamak için düzen ve ölçüm aşamalarına durum gözlemi eklendi.
  • Mevcut değiştiricilerin daha iyi yeniden kullanılması için optimize edilmiş değiştirici zinciri güncellemeleri.

Hata Düzeltmeleri

  • SpatialDialog gösterildiğinde scrimming durduruldu. (Ic4594)
  • Değiştirici düğümler ayrılmış durumdayken yapılan yeniden düzenleme istekleri artık yoksayılacak.
  • Movable ve Resizable değiştiricileri tarafından tetiklenen yeniden düzenleme aşamaları kaldırıldı.
  • Boyutlardan biri doğrudan veya düzen hesaplaması sırasında (ör. SpatialRow/SpatialColumn hesaplaması) sıfıra ayarlandığında MainPanel() composable'da meydana gelen kilitlenme sorunu düzeltildi. Panel artık gizlenecek. Bu düzeltmenin özellikle düzen aşamasındaki kilitlenmeleri ele aldığını unutmayın. Panelin kullanıcı etkileşimi aracılığıyla sıfıra yeniden boyutlandırılması ayrı olarak ele alınacaktır. Gizli panelde kullanıcı arayüzü özellikleri eksik.
  • Yeniden boyutlandırılabilir değiştiriciden maintainAspectRatio ile ilgili sorun düzeltildi. En boy oranı korunmalıdır.
  • İç içe yerleştirilmiş alt uzayların tek bir kare için yanlış konumlandırılmasına neden olan sorun düzeltildi.
  • Yuvarlak köşelerin bazen uygulanması gerektiği halde uygulanmamasına neden olan sorun düzeltildi.
  • NestedSubspaces artık yanlış konumda bir kare için görünmeyecek.

Sürüm 1.0.0-alpha03

26 Şubat 2025

androidx.xr.compose:compose:1.0.0-alpha03 ve androidx.xr.compose:compose-testing:1.0.0-alpha03, son alfa sürümünden bu yana önemli bir değişiklik yapılmadan yayınlandı. 1.0.0-alpha03 sürümü bu commit'leri içerir.

Sürüm 1.0.0-alpha02

12 Şubat 2025

androidx.xr.compose:compose:1.0.0-alpha02 ve androidx.xr.compose:compose-testing:1.0.0-alpha02 yayınlandı. 1.0.0-alpha02 sürümü bu commit'leri içerir.

Yeni Özellikler

  • Etkinlik paneli, artık bir uzamsal iletişim kutusu etkinleştirildiğinde içeriğini karartabilir.
  • Orbiter API artık SubspaceComposable bağlamlarında kullanılabilir ve Orbiters'ı en yakın SubspaceLayout tabanlı composable üst öğeye ekler.
  • Konuma dayalı özel değiştiricilere izin vermek için LayoutCoordinatesAwareModifierNode tanıtıldı.
  • SubspaceModifier.Node için ekleme/ayırma yaşam döngüsü yöntemleri eklendi.
  • Hareketli değiştiriciye scaleWithDistance eklendi. scaleWithDistance etkinleştirildiğinde, taşınan alt alan öğesi büyür veya küçülür. Ayrıca, taşınmadan önce sahip olduğu açık ölçeği de korur.

API Değişiklikleri

  • SessionCallbackProvider, SpatialCapabilities lehine kaldırıldı.

Diğer değişiklikler

  • minSDK değeri 24'e düşürüldü. Tüm Jetpack XR API'leri, çalışma zamanında API 34'ü gerektirmeye devam eder.
  • Orbiter EdgeOffset.inner, EdgeOffset.outer ve EdgeOffset.overlap oluşturucular artık @Composable yöntemleri değildir. Bu sayede, birleştirilemeyen bağlamlarda kullanılabilirler.
  • Uzamsal yükseklik seviyelerini en son kullanıcı deneyimi spesifikasyonuna uyacak şekilde güncelleyin.
  • SubspaceSemanticsInfo arayüzünü MeasurableLayout'ye uygulayın.
  • SubspaceModifierElement, SubspaceModifierNodeElement olarak yeniden adlandırıldı.

Hata düzeltmeleri

  • SubspaceModifier siparişini sabitlemek için düzeltmeler. SubspaceModifier daha güvenilir bir şekilde çalışmalıdır. Öteleme, döndürme, ölçeklendirme, taşınabilir ve yeniden boyutlandırılabilir değiştiriciler artık herhangi bir sırada kullanılabilir.

Sürüm 1.0.0-alpha01

12 Aralık 2024

androidx.xr.compose:compose-*1.0.0-alpha01 iptal edilir.

İlk sürümdeki özellikler

  • Jetpack Compose for XR'ın ilk geliştirici sürümü. İster mevcut bir 2D uygulamayı XR'a taşıyor olun ister sıfırdan yeni bir XR uygulaması oluşturuyor olun, satırlar ve sütunlar gibi tanıdık Compose kavramlarını kullanarak XR'da uzamsal kullanıcı arayüzü düzenleri oluşturabilirsiniz. Bu kitaplık, mevcut 2D Compose veya Views tabanlı kullanıcı arayüzünüzü uzamsal bir düzende yerleştirmenize olanak tanıyan alt alan ve uzamsal composable'lar (ör. uzamsal paneller ve orbiter'ler) sağlar. Bu kitaplık, 3D modeller gibi SceneCore öğelerini kullanıcı arayüzünüze göre yerleştirmenize olanak tanıyan Volume alt alan oluşturulabilirini sunar. Daha fazla bilgiyi bu geliştirici kılavuzunda bulabilirsiniz:

    • Subspace: Bu composable, uygulamanızın kullanıcı arayüzü hiyerarşisinde herhangi bir yere yerleştirilebilir. Böylece, dosyalar arasındaki bağlamı kaybetmeden 2D ve uzamsal kullanıcı arayüzü düzenlerini koruyabilirsiniz. Bu sayede, mevcut uygulama mimarisi gibi öğeleri tüm kullanıcı arayüzü ağacınızda durumu yükseltmenize veya uygulamanızı yeniden yapılandırmanıza gerek kalmadan XR ve diğer form faktörleri arasında daha kolay paylaşabilirsiniz.

    • SpatialPanel: Uzamsal panel, uygulama içeriğini görüntülemenize olanak tanıyan bir alt alan oluşturulabiliridir. Örneğin, video oynatma, sabit görüntüler veya diğer içerikleri uzamsal panelde görüntüleyebilirsiniz.

    • Orbiter: Orbiter, uzamsal bir kullanıcı arayüzü bileşenidir. İlgili bir uzamsal panele eklenmek üzere tasarlanmıştır ve bu uzamsal panelle ilgili gezinme ve bağlamsal işlem öğelerini içerir. Örneğin, video içeriği göstermek için bir uzamsal panel oluşturduysanız yörüngeye video oynatma kontrolleri ekleyebilirsiniz.

    • Hacim: 3D modeller gibi SceneCore öğelerini kullanıcı arayüzünüze göre yerleştirin.

  • Üç boyutlu yerleşim: SpatialRow, SpatialColumn, SpatialBox ve SpatialLayoutSpacer kullanarak birden fazla üç boyutlu panel oluşturup bunları üç boyutlu yerleşim içinde yerleştirebilirsiniz. Düzeninizi özelleştirmek için SubspaceModifier simgelerini kullanın.

  • Uzamsal kullanıcı arayüzü bileşenleri: Bu öğeler 2D kullanıcı arayüzünüzde yeniden kullanılabilir ve uzamsal özellikleri yalnızca uzamsal özellikler etkinleştirildiğinde görünür.

    • SpatialDialog: Panel, yükseltilmiş bir iletişim kutusu göstermek için z derinliğinde biraz geriye itilir.
    • SpatialPopUp: Panel, yükseltilmiş bir pop-up göstermek için z derinliğinde biraz geriye itilir.
    • SpatialElevation: Yükseklik eklemek için SpatialElevationLevel ayarlanabilir.

  • SpatialCapabilities: Kullanıcılar uygulamanızla veya sistemle etkileşim kurarken mekansal özellikler değişebilir, hatta uygulamanızın kendisi tarafından da değiştirilebilir (ör. Ana Sayfa Alanı'na veya Tam Alan'a geçiş). Sorun yaşamamak için uygulamanızın, mevcut ortamda hangi API'lerin desteklendiğini belirlemek üzere LocalSpatialCapabilities.current kontrolü yapması gerekir. isSpatialUiEnabled: Uzamsal kullanıcı arayüzü öğeleri (ör. SpatialPanel) isContent3dEnabled: 3D nesneler isAppEnvironmentEnabled: Ortam isPassthroughControlEnabled: Uygulamanın, geçiş durumunu kontrol edip edemeyeceği isSpatialAudioEnabled: Uzamsal ses

Bilinen Sorunlar

  • Şu anda XR için Jetpack Compose'u kullanmak üzere minimum SDK sürümünün 30 olması gerekir. Geçici çözüm olarak, 23 minSDK ile derleme ve çalıştırma yapabilmek için aşağıdaki manifest girişini <uses-sdk tools:overrideLibrary="androidx.xr.scenecore, androidx.xr.compose"/> ekleyebilirsiniz.
  • Jetpack XR uygulamalarının şu anda AndroidManifest'te android.permission.SCENE_UNDERSTANDING izni istemesi gerekiyor.
  • Bir uygulama, manifest dosyasındaki PROPERTY_XR_ACTIVITY_START_MODE özelliğini kullanarak doğrudan Tam Ekran Alanı'nda başlatıldığında Etkinlikler/Uygulamalar, Tam Ekran Alanı'na geçmeden önce başlangıçta Ana Sayfa Alanı'nda açılır.
  • Volume Composables'daki glTF'ler başlangıçta yanlış konumda titreyebilir.
  • Önemli ölçüde taşınmış bir panelde SpatialDialog kullanmak, içeriği yanlış yöne iter.