XR Çalışma Zamanı

Yerel çalışma zamanımızla özel AR veya 3D oturumunuzu başlatın.
Son Güncelleme Kararlı Sürüm Sürüm Adayı Beta Sürümü Alfa Sürümü
25 Şubat 2026 - - - 1.0.0-alpha11

Bağımlılıkları bildirme

XR çalışma zamanına 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ıtların bağımlılıklarını ekleyin:

Eski

dependencies {
    implementation "androidx.xr.runtime:runtime:1.0.0-alpha11"

    // Optional dependencies for asynchronous conversions
    implementation "androidx.xr.runtime:runtime-guava:1.0.0-alpha11"
    implementation "androidx.xr.runtime:runtime-rxjava3:1.0.0-alpha11"

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

Kotlin

dependencies {
    implementation("androidx.xr.runtime:runtime:1.0.0-alpha11")

    // Optional dependencies for asynchronous conversions
    implementation("androidx.xr.runtime:runtime-guava:1.0.0-alpha11")
    implementation("androidx.xr.runtime:runtime-rxjava3:1.0.0-alpha11")

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

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 olursa 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 Issue Tracker belgelerini inceleyin.

Sürüm 1.0

Sürüm 1.0.0-alpha11

25 Şubat 2026

androidx.xr.runtime:runtime-*:1.0.0-alpha11 iptal edilir. 1.0.0-alpha11 sürümü bu commit'leri içerir.

API Değişiklikleri

  • ConfigMode arayüzü dahili kullanımla kısıtlandı (Ibfb87)
  • androidx.xr.runtime.Config.GeospatialMode, paket düzeyine taşındı (Ibe682)
  • androidx.xr.runtime.Config.FaceTrackingMode, paket düzeyine (Iac501) taşındı
  • androidx.xr.runtime.Config.AnchorPersistenceMode, paket düzeyine taşındı (I0360f)
  • androidx.xr.runtime.Config.DepthEstimationMode, paket düzeyine taşındı (I7e3e9)
  • androidx.xr.runtime.Config.DeviceTrackingMode, paket düzeyine taşındı (I3aacd)
  • androidx.xr.runtime.Config.HandTrackingMode, paket düzeyine taşındı (I658f3)
  • androidx.xr.runtime.Config.PlaneTrackingMode, paket düzeyine taşındı (Ia251b)
  • androidx.xr.runtime.XrDevice.DisplayBlendMode, paket düzeyine (I6f333) taşındı.
  • Bir Context, Session ve CoroutineContext kullanarak XrDevice oluşturmak için bir fabrika yöntemi eklendi. (I139c5)
  • Platformda kullanılabilen Android XR'ın çalışma zamanı sürümünü sorgulamaya yardımcı olması için SpatialApiVersionHelper eklendi. (I7c53c)
  • xr:runtime:runtime-openxr modülü eklendi (Ib42ea)

Sürüm 1.0.0-alpha10

28 Ocak 2026

androidx.xr.runtime:runtime-*:1.0.0-alpha10 iptal edilir. 1.0.0-alpha10 sürümü bu commit'leri içerir.

API Değişiklikleri

  • ConfigMode.HeadTrackingMode, ConfigMode.DeviceTrackingMode ile değiştirilir. (le273e, b/467150206)
  • Quaternion'ın toNormalized, times(float), div(float) yöntemleri kaldırıldı. Bu yöntemler, tüm kuaterniyonlar oluşturma sırasında normalleştirildiği ve sınıfın değişmez olduğu göz önüne alındığında gereksizdir. (l558fc, b/460210457)

Hata Düzeltmeleri

  • Uygulamanın ana iş parçacığında oturum oluşturmaktan nasıl kaçınılacağını gösteren Session.create dokümanı eklendi. (le5554, b/463687170)
  • Uygulamaların NaN değeriyle BoundingBox oluşturması engellendi. (l58c14, b/464025895)

Sürüm 1.0.0-alpha09

3 Aralık 2025

androidx.xr.runtime:runtime-*:1.0.0-alpha09 iptal edilir. 1.0.0-alpha09 sürümü bu commit'leri içerir.

Sürüm 1.0.0-alpha08

19 Kasım 2025

androidx.xr.runtime:runtime-*:1.0.0-alpha08 iptal edilir. 1.0.0-alpha08 sürümü bu commit'leri içerir.

Yeni Özellikler

  • Cihaz özellikleri hakkında bilgi sağlamak için XrDevice eklendi. (Ic9d1f)
  • Oturum özelliklerini sorgulamak için yeni ConfigMode.isSupported API'si eklendi. (Iff7af)
  • XrDisplay.BlendMode API'si eklendi. (I484e4)

API Değişiklikleri

  • [XrDevice.getPreferredBlendMode] işlevi [XrDevice.getPreferredDisplayBlendMode] olarak yeniden adlandırıldı. (I7e48f)

Sürüm 1.0.0-alpha07

22 Ekim 2025

androidx.xr.runtime:runtime-*:1.0.0-alpha07 iptal edilir. 1.0.0-alpha07 sürümü bu commit'leri içerir.

API Değişiklikleri

  • SessionConfigureConfigureNotSupported öğesini kaldırıp UnsupportedOperationException ile değiştirin. (I7680f)

Sürüm 1.0.0-alpha06

24 Eylül 2025

androidx.xr.runtime:runtime-*:1.0.0-alpha06 iptal edilir. 1.0.0-alpha06 sürümü bu commit'leri içerir.

API Değişiklikleri

  • HandJointType, xr:runtime:runtime kuruluş biriminden xr:arcore:arcore kuruluş birimine taşındı. (Iadb9c, b/409058039)
  • componentWiseMultiplication için çarpma operatörünü Vector2, Vector3, Vector4 için ölçeklendirme amacıyla değiştirme ve diğer matematik kitaplıklarıyla tutarlılık için operatör simgesini kaldırma. Ayrıca Vector.scale(otherVector.inverse()) yerine componentWiseDivision öğesini Vector sınıflarından kaldırıyoruz. (I8e1f6, b/399146447)
  • Ölçeği bir olan bir matris döndürmek için [unscaled] ekleyin. (I6381d, b/434928658)
  • Coroutines.kt, SuspendtoFutureAdapter ile değiştirildiğinden :xr:runtime:runtime-guava kaldırılacak. (I0cd3c, b/406597902)

Sürüm 1.0.0-alpha05

30 Temmuz 2025

androidx.xr.runtime:runtime-*:1.0.0-alpha05 iptal edilir. 1.0.0-alpha05 sürümü bu commit'leri içerir.

Yeni Özellikler

  • HandJointType ve TrackingState öğelerini ekleyin. (I55880, b/334645808)
  • Yapılandırma uygulamasını herkese açık hale getirin. (I95860, b/334645808)
  • Yeni SessionCreateResult ve SessionConfigureResult türleri eklendi. (Icb8cb, b/334645808)
  • Minimum ve maksimum köşe noktalarıyla tanımlanan, 3D uzayda eksenle hizalı bir sınırlayıcı kutuyu temsil eden yeni bir BoundingBox sınıfı ekleyin. (Ic68c5, b/423073468)

API Değişiklikleri

  • androidx.xr.scenecore.PixelDimensions adlı öğe, androidx.xr.runtime.math.IntSize2d olarak yeniden adlandırıldı ve taşındı. androidx.xr.scenecore.Dimensions adlı öğe, androidx.xr.runtime.math.FloatSize3d olarak yeniden adlandırıldı ve taşındı. androidx.xr.scenecore.PlaneType, androidx.xr.scenecore.PlaneOrientation olarak yeniden adlandırıldı. androidx.xr.scenecore.PlaneSemantic, androidx.xr.scenecore.PlaneSemanticType olarak yeniden adlandırıldı. (Ifd405, b/416456228)
  • androidx.xr.runtime.FoV sınıfı kaldırıldı. Bunun yerine androidx.xr.runtime.FieldOfView politikasını kullanın. (I9ae27)
  • Session.create için, oturumun bağlanacağı bir LifecycleOwner sağlayabilen ek bir aşırı yükleme eklendi. Kaynak sahipliği için bir Etkinlik sağlanması gerektiğini ve LifecycleOwner özelliğinin Etkinlik kapsamında olması gerektiğini unutmayın. (I1690b)
  • FakeRuntimeAnchor.anchorsCreated, anchorsCreatedCount olarak yeniden adlandırıldı (I96df9, b/424441218)
  • Yapılandırma *Mode değerleri, davranışlarını yansıtacak şekilde yeniden adlandırıldı. (I6d247, b/414648065)
  • Kotlin 2.0 ile yayınlanan projelerin kullanılabilmesi için KGP 2.0.0 veya daha yeni bir sürümün kullanılması gerekir (Idb6b5, b/344563182).
  • Manifest dizeleriyle ilgili API'ler :xr:runtime:runtime konumundan :xr:runtime:runtime-manifest konumuna taşındı. Paket adı androidx.xr.runtime iken androidx.xr.runtime.manifest olarak değiştirildi. (I610ad, b/418800249)
  • Session.resume(), Session.pause() ve Session.destroy(), API yüzeyinden kaldırıldı. Oturum artık LifecycleOwner değil. Oturumun yaşam döngüsü artık Session.create() içinde iletilen Etkinliğin yaşam döngüsüne bağlı olacak. (I28a03)
  • Bu kitaplık artık tür kullanımı olan JSpecify nullness ek açıklamalarını kullanıyor. Kotlin geliştiricileri, doğru kullanımı zorunlu kılmak için şu derleyici bağımsız değişkenini kullanmalıdır: -Xjspecify-annotations=strict (Bu, Kotlin derleyicisinin 2.1.0 sürümünden itibaren varsayılan değerdir) (Ia8420, b/326456246)
  • Ana çalışma zamanı yapısı (:xr:runtime:runtime) yalnızca Kotlin tarzı asenkron API'ler içerir. Java geliştiriciler, uyumlu API'lere erişmek için :xr:runtime:runtime-guava'ye güvenebilir. (I05d4a, b/426639315)
  • Ana çalışma zamanı yapısı (:xr:runtime:runtime) yalnızca Kotlin tarzı eş zamansız API'ler içerir. Java geliştiriciler, uyumlu API'lere erişmek için xr:runtime:runtime-rxjava3 kitaplığını kullanabilir. (I64122, b/426639775)
  • Coroutines'i :xr:runtime:runtime-guava'ya, Flow'ları :xr:runtime:runtime-rxjava3'ye taşıyın. (I60ae9)
  • Session.create ve Session.configure artık SessionCreatePermissionsNotGranted veya SessionConfigurePermissionsNotGranted değerini döndürmek yerine yeterli izin verilmediğinde SecurityException hatası veriyor. (I7c488, b/430651879)

Sürüm 1.0.0-alpha04

7 Mayıs 2025

androidx.xr.runtime:runtime:1.0.0-alpha04, androidx.xr.runtime:runtime-openxr:1.0.0-alpha04 ve androidx.xr.runtime:runtime-testing:1.0.0-alpha04 özellikleri kullanıma sunulur. 1.0.0-alpha04 sürümü bu commit'leri içerir.

Yeni Özellikler

  • Session artık mevcut Android yaşam döngüsü paradigmalarıyla daha fazla birlikte çalışabilirlik için androidx.lifecycle.LifecycleOwner'ı uyguluyor.
  • Android XR için manifest dizeleri burada belirtilir ve belgelenir.
  • Sahne içeriği kullanıcının görüş alanının içine veya dışına taşındığında bunu izlemek için Spatial Visibility Callback (Mekansal Görünürlük Geri Çağırma) uzantısı yöntemleri eklendi.
  • JxrPlatformAdapter (ve ilgili tüm sınıflar) için bir taslak sürüm eklendi.
  • Oturum, SceneCore içindeki oturum yerine hem SceneCore hem de çalışma zamanında kullanılacak.
  • ActivityPose.hitTest eklendi. Bu sayede, sanal içeriklere karşı hitTest kullanılabiliyor.
  • Derleme süresinde birden fazla çalışma zamanı uygulaması belirtme özelliği artık destekleniyor. Yürütme sırasında, mevcut cihazın özelliklerine göre yalnızca biri yüklenir.
  • Yeni bileşen türü SpatialPointerComponent eklendi. Bu tür, müşterilerin işaretçi için oluşturulan simgeyi belirtmesine veya simgeyi devre dışı bırakmasına olanak tanır. Bu Bileşen şu anda yalnızca PanelEntity örneğe eklenebilir.

API Değişiklikleri

  • Yapılandırma uygulamasını herkese açık hale getirin. (I95860)
  • HandJointType ve TrackingState öğelerini ekleyin. (I55880)
  • Kotlin 2.0 ile yayınlanan projelerin kullanılabilmesi için KGP 2.0.0 veya daha yeni bir sürüm gerekir (Idb6b5).
  • Hand.isActive (boolean), Hand.trackingState olarak değiştirildi. OpenXR uygulaması buna göre değiştirildi.
  • Session.configure içindeki android.permission.SCENE_UNDERSTANDING izni şartı android.permission.SCENE_UNDERSTANDING_COARSE olarak değiştirildi.
  • LifecycleManager.configure uygulanır ve artık yapılandırılabilir her çalışma zamanı özelliği için bir özellik içeren Config nesnesinde iletilir.
  • Kullanılabilir çalışma zamanı özelliklerini yapılandırmak için artık Session.configure, Config ile çağrılabilir.
  • Session.create artık CoroutineDispatcher yerine CoroutineContext iletmeyi destekliyor.
  • Session.create, Jetpack XR ve/veya SceneCore için ARCore yüklemeyi destekler. En az biri sağlanmalıdır (test sürümleri mevcuttur).
  • FakePerceptionManager, Anchor.load ve Anchor.unpersist'e geçersiz bir UUID iletildiğinde AnchorInvalidUuidException hatası verir.
  • CoreState artık bir veri sınıfı değil.

Hata Düzeltmeleri

  • Çalışma zamanı ProGuard yapılandırmaları düzeltildi.

Sürüm 1.0.0-alpha03

26 Şubat 2025

androidx.xr.runtime:runtime:1.0.0-alpha03, androidx.xr.runtime:runtime-openxr:1.0.0-alpha03 ve androidx.xr.runtime:runtime-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.runtime:runtime:1.0.0-alpha02, androidx.xr.runtime:runtime-openxr:1.0.0-alpha02 ve androidx.xr.runtime:runtime-testing:1.0.0-alpha02 yayınlandı. 1.0.0-alpha02 sürümü bu commit'leri içerir.

Kırılma ve davranış değişiklikleri

  • Artık OpenXR çalışma zamanı işlevleri, OpenXR kaynak sınırına ulaşıldığını bildiren bir hata koduyla karşılaştıklarında Anchor döndürmek yerine AnchorResourcesExhaustedException hata mesajını veriyor.
  • Session.create ve Session.resume için artık android.permission.HAND_TRACKING izni gerekiyor.

Yeni özellikler

  • El takibi desteği eklendi.

Hata düzeltmeleri

  • Çapa oluşturma, emülatörde çalıştırıldığında daha kararlıdır.

Sürüm 1.0.0-alpha01

12 Aralık 2024

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

İlk sürümün özellikleri

Jetpack XR Runtime'ın ilk sürümü. Bu kitaplık, Jetpack XR kitaplık paketinin temel işlevlerini içerir. Özellik keşfi, yaşam döngüsü yönetimi ve yapılandırma gibi işlevler dahildir. Çalışma zamanı kitaplığı, yürütme platformuna bağlı olarak farklı varyasyonlar (ör. runtime-openxr veya runtime-testing) sağlar. Ayrıca bu kitaplık, tüm Jetpack XR API yüzeyinde kullanılan Vector3 ve Matrix4 gibi temel matematiksel soyutlamalar sunar.

  • Session: İşlemin ne zaman yürütüleceğine ve genel yapılandırmaya karar verme dahil olmak üzere XR sistemi üzerinde ayrıntılı kontroller sağlar. Bu, temel sistem özelliklerinin kilidini açmak için diğer tüm API'lerde kullanacağınız işleyendir.

  • Pose: Konum ve yönlendirme bilgisi içeren, rastgele bir koordinat sistemindeki konum. Bu sınıfı, Jetpack XR ve Jetpack SceneCore için ARCore ile nesnelerin konumunu iletmek üzere kullanırsınız.

Bilinen Sorunlar

  • configure şu anda işlem yapmamaktadır. Gelecekteki sürümlerde, Session davranışını kontrol etmek için kullanabileceğiniz yeni ayarlar eklenecektir.