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ü
7 Mayıs 2025 - - - 1.0.0-alpha04

Bağımlılıkları beyan etme

XR çalışma zamanına bağımlılık eklemek için projenize Google Maven deposunu eklemeniz gerekir. Daha fazla bilgi için Google'ın Maven deposunu inceleyin.

Uygulamanızın veya modülünüzün build.gradle dosyasına ihtiyacınız olan yapıların bağımlılıklarını ekleyin:

GroovyKotlin 
dependencies {
    implementation "androidx.xr.runtime:runtime:1.0.0-alpha04"

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

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

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ştirmek için fikirleriniz varsa lütfen bize bildirin. Yeni bir kitaplık oluşturmadan önce lütfen bu kitaplıktaki mevcut sorunlara göz atın. Yıldız düğmesini tıklayarak mevcut bir soruna oy verebilirsiniz.

Yeni bir sorun oluşturma

Daha fazla bilgi için Sorun İzleyici belgelerine bakın.

Sürüm 1.0

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 yayınlandı. 1.0.0-alpha04 sürümü bu taahhütleri içerir.

Yeni Özellikler

  • Oturum, mevcut Android yaşam döngüsü paradigmalarıyla daha fazla birlikte çalışabilirlik için artık androidx.lifecycle.LifecycleOwner'ü uygular.
  • Android XR için manifest dizeleri burada belirtilmiş ve açıklanmıştır.
  • Sahne içeriğinin kullanıcının görüş alanının içine veya dışına taşınmasını izlemek için eklenen Mekansal Görünürlük Geri Çağırma uzantı yöntemleri.
  • JxrPlatformAdapter (ve ilgili tüm sınıflar) için bir taslak sürüm eklendi.
  • SceneCore'teki Session yerine hem SceneCore hem de Runtime'da Session kullanılacak.
  • ActivityPose.hitTest eklendi. Bu, sanal içeriklere karşı hitTest yapılmasına olanak tanır.
  • Derleme zamanında birden fazla çalışma zamanı uygulaması belirtme artık desteklenmektedir. Mevcut cihazın özellik grubuna göre, yürütme sırasında yalnızca bir tane yüklenir.
  • İstemcilerin işaretçi için oluşturulan simgeyi belirtmesine veya simgeyi devre dışı bırakmasına olanak tanıyan yeni bileşen türü SpatialPointerComponent eklendi. Bu bileşen şu anda yalnızca PanelEntity örneklerine 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ılması 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'daki android.permission.SCENE_UNDERSTANDING izin şartı android.permission.SCENE_UNDERSTANDING_COARSE olarak değiştirildi.
  • LifecycleManager.configure uygulanır ve artık her yapılandırılabilir çalışma anı özelliği için bir özellik içeren bir Config nesnesi iletilir.
  • Mevcut çalışma zamanı özelliklerini yapılandırmak için Session.configure artık Config ile çağrılabilir.
  • Session.create artık CoroutineDispatcher yerine CoroutineContext iletmeyi desteklemektedir.
  • Session.create, Jetpack XR ve/veya SceneCore için ARCore yüklemeyi destekler. En az bir tane sağlanmalıdır (test sürümleri kullanılabilir).
  • FakePerceptionManager, Anchor.load ve Anchor.unpersist'e geçersiz bir UUID iletildiğinde AnchorInvalidUuidException atar.
  • 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ümden bu yana önemli bir değişiklik içermeden yayınlandı. 1.0.0-alpha03 sürümü bu taahhütleri 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 taahhütleri içerir.

Zararlı içerikler ve davranış değişiklikleri

  • OpenXR kaynak sınırına ulaşıldığını bildiren bir hata koduyla karşılaşan OpenXR çalışma zamanı işlevleri artık Anchor döndürüyor.AnchorResourcesExhaustedException
  • Session.create ve Session.resume için artık android.permission.HAND_TRACKING izni gereklidir.

Yeni özellikler

  • El takibi desteği eklendi.

Hata düzeltmeleri

  • Sabitleme noktaları oluşturma işlemi, 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 yayınlanır.

İlk Sürümün Özellikleri

Jetpack XR Çalışma Zamanı'nın ilk sürümü. Bu kitaplık, Jetpack XR kitaplık paketi için temel işlev parçalarını içerir. Bu kapsamda özellik keşfi, yaşam döngüsü yönetimi, yapılandırma ve daha fazlası yer alır. Ç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, Jetpack XR API yüzeyinin tamamında kullanılan Vector3 ve Matrix4 gibi temel matematik soyutlamaları sunar.

  • Session: İşlemenin ne zaman yürütüleceğine ve yürütülmeyeceğine karar verme ve genel yapılandırma dahil olmak üzere XR sistemi üzerinde ayrıntılı kontroller sağlar. Ayrıca, temel sistem özelliklerinin kilidini açmak için diğer tüm API'lerde kullanacağınız herkese açık kullanıcı adıdır.

  • Pose: İsteğe bağlı bir koordinat sisteminde, konumu ve yönü olan bir 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şlevsizdir. Gelecek sürümlerde, Session öğesinin davranışını kontrol etmek için kullanabileceğiniz yeni ayarlar eklenecektir.