Jetpack XR için ARCore

Bağımlılıkları bildirme

Jetpack XR için ARCore'a bağımlılık eklemek istiyorsanız projenize Google Maven deposunu eklemeniz gerekir. Daha fazla bilgi için Google'ın Maven deposu sayfasını okuyun.

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

dependencies {
    implementation "androidx.xr.arcore:arcore:1.1.0-alpha01"
}

dependencies {
    implementation("androidx.xr.arcore:arcore:1.1.0-alpha01")
}

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

Yeni sorun oluşturma

Daha fazla bilgi için Issue Tracker belgelerine bakın.

Sürüm 1.1

Sürüm 1.1.0-alpha01

21 Ekim 2026

androidx.xr.arcore:arcore-*:1.1.0-alpha01 yayınlandı. 1.1.0-alpha01 sürümü bu kayıtları içerir.

API Değişiklikleri

• 3D fiziksel geometrileri ve nesneleri izlemek için SpatialAnnotation API'sini kullanıma sundu. Kamera görüntüsü arabellekleri aracılığıyla uzamsal izlemeyi yapılandırmak için SpatialAnnotationTrackingOptions ve ilgili oluşturucu deseni eklendi. (I918ce)
• Jetpack XR ARCore'a SpatialAnnotation ve SpatialAnnotationTrackingMode eklendi. Böylece geliştiriciler, fiziksel gerçek dünya uzamsal ortamlarını hedefleyen rastgele sınırlı 3D dörtgen geometrileri (Quad) yapılandırabilir ve takip edebilir. (I880e4)
• Otomatik testlerde uzamsal ek açıklamaların programatik simülasyonuna izin vermek için TestSpatialAnnotation eklendi. (If2335)
• Coğrafi durum hakkında daha fazla bilgi sağlamak için yeni API'ler olarak geospatialPose, horizontalAccuracy, verticalAccuracy ve orientationYawAccuracy eklendi. (If28f8)

Hata Düzeltmeleri

• androidx.lifecycle:lifecycle-runtime bağımlılığı 2.10.0 olarak güncellendi. Bu sürüm, paket halinde sunulan yaşam döngüsü çalışma zamanı lint kontrollerinin AGP 9.5.0-alpha04 veya sonraki sürümlerle çalışması için gereklidir. (I99bfd, b/556807521)
• AugmentedImage yapılandırılırken maksimum resim sayısının 0 olup olmadığı kontrol edildi ve beklenmedik bir şekilde başarısız olmak yerine UnsupportedOperationException hatası verildi. I6ce439
• Oluşturma işlerini doğru şekilde izleyip iptal ederek, varlıkları silerek ve resim koleksiyonunu güvenli bir şekilde değiştirerek AugmentedImageRenderer uygulamasındaki bellek sızıntılarını ve eşzamanlılık sorunlarını düzeltin. Ie70760

Sürüm 1.0

Sürüm 1.0.0

21 Ekim 2026

androidx.xr.arcore:arcore-*:1.0.0 yayınlandı. 1.0.0 sürümü bu commit'leri içerir.

1.0.0 sürümünün önemli özellikleri:

• Jetpack XR için ARCore artık kararlı sürümde. Jetpack XR için ARCore kitaplığı, dijital içeriği gerçek dünyayla harmanlama özellikleri sunar. Bu kitaplıkta hareket izleme, kalıcı sabitleyiciler, isabet testi, semantik etiketleme ile düzlem tanımlama (ör. zemin, duvarlar ve masaüstleri) ve Google'ın Görsel Konumlandırma Sistemi'ni kullanan Coğrafi pozlar yer alır.
• Daha fazla bilgi için Geliştirici Kılavuzu ve API Referansı sayfalarımızı inceleyin.

Sürüm 1.0.0-rc02

7 Ekim 2026

androidx.xr.arcore:arcore-*:1.0.0-rc02 yayınlandı. 1.0.0-rc02 sürümü bu kayıtları içerir.

Hata Düzeltmeleri

• Artırılmış görüntü izleme desteklenmediğinde OpenXrRuntime uygulamasının oturumu yapılandıramamasına neden olan sorun düzeltildi. (I8b9759)
• applicationContext kullanarak XrInstanceManager içinde bellek yönetimini iyileştirme, Session ve Scene önbelleğe alma mekanizmalarını basitleştirerek yaşam döngüsüyle ilgili olası sorunları çözme ve iş parçacığı açısından güvenli temizleme kayıtları ile açık imhalar sağlamak için ReferenceCleaner'yi geliştirme gibi birden fazla sorun düzeltildi. (Id0b76c)

Sürüm 1.0.0-rc01

9 Eylül 2026

androidx.xr.arcore:arcore-*:1.0.0-rc01 yayınlandı. 1.0.0-rc01 sürümü bu kayıtları içerir.

Sürüm 1.0.0-beta02

12 Ağustos 2026

androidx.xr.arcore:arcore-*:1.0.0-beta02 yayınlandı. 1.0.0-beta02 sürümü bu commit'leri içerir.

Hata Düzeltmeleri

• OpenXR sabitleme kalıcılığındaki eşzamanlılık sorunu düzeltildi. (I15c8b)
• Hata ayıklama için daha fazla sınıfta toString() uygulandı. (I587e8)

Sürüm 1.0.0-beta01

15 Temmuz 2026

androidx.xr.arcore:arcore-*:1.0.0-beta01 yayınlandı. 1.0.0-beta01 sürümü bu kayıtları içerir.

API Değişiklikleri

• Yeniden boyutlandırılabilir değiştirici, iki değiştirici yerine ResizePolicy kullanacak şekilde güncellendi (I7fb0f, b/496257436, b/519672992)
• movePolicy parametresiyle taşınabilir aşırı yükleme eklendi ve transformingMovable ile movable desteği sonlandırıldı (Ic88c1, b/481781189)
• TrackingState.TRACKING_DEGRADED, herkese açık API yüzeyinden kaldırıldı ve harita çalışma zamanı düşürülmüş durumları PAUSED olarak eşlendi. Dize dönüşümü ve çalışma zamanı dönüşümü için int değerleri yerine enum'ları kullanmak üzere TrackingState güncellenmelidir. (I3eb5b, b/524326338)
• Session.create, askıya alma işlevine dönüştürüldü. (I5d27f)
• ProjectedPermissionsResultContract desteği sonlandırıldı (I141d5, b/515699436)
• AnchorEntity, AnchorSpace olarak güncellendi (Ifa95e, b/513619219)

Sürüm 1.0.0-alpha15

17 Haziran 2026

androidx.xr.arcore:arcore-*:1.0.0-alpha15 yayınlandı. 1.0.0-alpha15 sürümü bu kayıtları içerir.

API Değişiklikleri

• HitResult.createAnchor kaldırıldı. Geliştiriciler, sonucun izlenebilir öğesi bir Anchorable ise isabet konumunu Anchorable öğesinin createAnchor işlevine sağlayarak HitResult öğesini temsil eden bir sabitleyici oluşturabilir. (Ia851e)
• AnchorUnsupportedObject kaldırıldı. Artık JXR ARCore çalışma zamanı tarafından oluşturulmaz. (Ia851e)
• androidx.xr.arcore.Anchor ve androidx.xr.arcore.ArDevice artık androidx.xr.arcore.Trackable sınıfını uyguluyor. (I57b65)
• Depth.left, Depth.right ve Depth.mono artık null değer alamaz (I1fc5e)
• Face.getUserFace artık null değer alamaz (I0eac1)
• RenderViewpoint.left, RenderViewpoint.right, RenderViewpoint.mono artık null değer alamaz (Icf7fa)
• Hand.left ve Hand.right null değer alamaz (Icef37)
• QrCode API'si eklendi (Ia0bbe)

Sürüm 1.0.0-alpha14

19 Mayıs 2026

androidx.xr.arcore:arcore-*:1.0.0-alpha14 yayınlandı. 1.0.0-alpha14 sürümü bu kayıtları içerir.

API Değişiklikleri

• GeospatialMode.VPS_AND_GPS, GeospatialMode.SPATIAL için kullanımdan kaldırılıyor ve yalnızca IMU ile GPS kullanan yeni bir düşük güç izleme modu olan GeospatialMode.INERTIAL kullanıma sunuluyor. (I1e6cd)
• Özel sabitleme istisnası sınıfları: AnchorInvalidUuidException, AnchorNotAuthorizedException, AnchorUnsupportedLocationException, AnchorRuntimeFailureException ve AnchorUnsupportedObjectException artık RuntimeException örnekleridir ve kontrol edilmeleri amaçlanmamıştır. (I9356e)
• TestArDevice, TestAugmentableObject, TestDepthMap, TestEye, TestFace, TestGeospatial, TestHand, TestPlane, TestRenderViewpoint ve TestTrackable dahil olmak üzere ArCoreTestRule API'si eklendi (I0ad3c)
• AnchorLoadInvalidUuid, AnchorCreateUnsupportedObject, AnchorCreateUnsupportedLocation ve AnchorCreateNotAuthorized öğelerini kaldırır. Bu hataların tümü artık çalışma zamanında istisna olarak kabul edilir. AnchorCreateIllegalState öğesini kaldırır. Çoğu durumda bu raporun yerini AnchorCreateTrackingUnavailable aldı. AnchorException ve türetilmiş sınıflar olan AnchorInvalidUuidException, AnchorNotAuthorizedException, AnchorUnsupportedLocationException, AnchorRuntimeFailureException ve AnchorUnsupportedObjectException'yi ekler. (I4c4dd)

Harici Katkı

• Özel işaretçi izleme için AugmentedImage API'si eklendi (I0cf09)

Sürüm 1.0.0-alpha13

6 Mayıs 2026

androidx.xr.arcore:arcore-*:1.0.0-alpha13 yayınlandı. 1.0.0-alpha13 sürümü bu kayıtları içerir.

API Değişiklikleri

• TrackingState ve VpsAvailabilityResult, androidx.xr.arcore package paketine taşındı ve androidx.xr.runtime paketindeki türler artık kullanımdan kaldırıldı. (Ic7930, b/480462213)
• Plane.Type, PlaneType olarak yeniden adlandırıldı. (I8c90c, b/482675376)
• Hand.HandSide, HandSide olarak yeniden adlandırıldı. (Ica562, b/482675376)
• Plane.Label, PlaneLabel olarak yeniden adlandırıldı. (Ic6b67, b/482675376)
• Geospatial.Surface, GeospatialSurface olarak yeniden adlandırıldı. (I1a8be, b/482675376)
• Geospatial.State, GeospatialState olarak yeniden adlandırıldı. (I203fa, b/482675376)
• NativeData API'si xr:runtime:runtime kitaplığına taşındı. (I87954, b/494251500)
• Session.create ve Session.configure artık olası her duruma/örneğe yer vermeyen/içermeyen ve when ifadelerinde else yan tümceleri gerektirir. (I9885e, b/495805998, b/495805998)
• androidx.xr.runtime.FieldOfView desteği sonlandırıldı. Bunun yerine androidx.xr.runtime.math.FieldOfView kullanın. (Ia01a0, b/480233045)
• Orbiter, konum, ofset, ofsetType, hizalama ve yükseklik yerine OrbiterAnchorPoint + VolumeOffset veya OrbiterPoseProvider kullanacak şekilde değiştirildi. shouldRenderInNonSpatial parametresi de kaldırıldı. Geliştirici, orbiter'ın uzamsal olmayan modda oluşturulmasını istemiyorsa orbiter'ı bir if ifadesine sarmalı ve SpatialCapabilities değerini kontrol etmelidir. (I9fbb3, b/462428503)
• Taşınabilir değiştiriciler eklendi. Bu değiştiriciler şu anda SpatialPanels ve SpatialExternalSurface için iyi sonuçlar veriyor. Çok yakında SpatialGltfModels için de desteklenecek. Ancak bu özelliklerin tüm SubspaceComposables için iyi bir şekilde desteklenmesi amaçlanmaktadır. (I9a3cd, b/479530787, b/478935063, b/478935063)
• Geliştiricilerin, State.trackingState izlemek için ArDevice.state akışını gözlemlemeleri ve uygulamalarının oluşturma veya uyarılarını izleme doğruluğuna göre ayarlamaları beklenir. (Ic00f0, b/445466590)
• HandJointType enum değeri yeniden adlandırıldı. (Ifbc83, b/482670596)
• FaceConfidenceRegion sabit değer yeniden adlandırıldı. (Ia62d5, b/482670596)
• FaceBlendShapeType sabit değer yeniden adlandırıldı. (I33b8b, b/482670596)
• CreatePoseFromGeospatialPoseErrorInternal ve CreateGeospatialPoseFromPoseErrorInternal eklendi. (I4bcf1, b/482666615)
• DeviceTrackingMode.LAST_KNOWN, SPATIAL_LAST_KNOWN olarak yeniden adlandırıldı (desteği sonlandırılmış bir yedekle birlikte), 3DoF izleme için INERTIAL_LAST_KNOWN eklendi ve TrackingState için TRACKING_DEGRADED eklendi. (Ie661c, b/445466590)
• GroupEntity kullanımdan kaldırıldı. Yalnızca temel Entity işlevine sahip bir Entity oluşturmak için Entity.create yöntemini çağırın. Bu yöntem, Entity arayüzünü döndürür. (I4c450, b/473867483)
• XrLog API'si eklendi. JetpackXR'da günlük kaydını etkinleştirmek için XrLog.isEnabled özelliğini true olarak ayarlayın ve günlük düzeyini ayarlamak için XrLog.Level özelliğini kullanın. (I76a1f, b/463460895, b/487378441)

Hata Düzeltmeleri

• OpenXR cihazlarına cihaz izleme durumu desteği ekleyin. (I91485, b/445466590)

Sürüm 1.0.0-alpha12

25 Mart 2026

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

API Değişiklikleri

• Config.augmentedObjectCategories, Liste'den Küme'ye değiştirildi. (I25a64, b/487376359)
• androidx.xr.arcore.Eye ve androidx.xr.arcore.Hand türleri. (I42438, b/449032900)
• Kaynak kapsamı için Android bağlamının iletilmesine olanak tanıyan Session.create aşırı yüklemesi eklendi. (I7d3fe, b/415805990, b/477386334)
• FakeRuntimeAnchor.ANCHOR_RESOURCE_LIMIT, FakeRuntimeAnchor.anchorResourceLimit olarak değiştirildi. (I90841, b/431992235)
• TiltGesture API, gelecekte değiştirilebileceği veya kaldırılabileceği için deneysel olarak işaretleniyor. Bu API'yi kullanmak için @ExperimentalGesturesApi (Ic9858) özelliğini etkinleştirin.
• Yapılandırma'da AugmentedObject izleme için kategori ayarlama özelliği eklendi (I1f6e4, b/480220930)

Hata Düzeltmeleri

• META-INF/services/ dosyası, PerceptionRuntimeFactory öğesinin gerçek konumuyla güncellenerek Chrome'un derlemesi düzeltildi. (I7a801, b/481288291)

Sürüm 1.0.0-alpha11

25 Şubat 2026

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

Sürüm 1.0.0-alpha10

28 Ocak 2026

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

Yeni özellikler

• Cihazın eğim durumunun (YUKARI/AŞAĞI) geçiş ilerleme durumuyla birlikte kararlı bir şekilde algılanması için reaktif bir Flow sağlayan TiltGesture API'si kullanıma sunuldu. (Ic269f, b/448152779)
• Jetpack XR için ARCore artık XR Çalışma Zamanı Günlük Kaydı mekanizmasını kullanıyor. Daha fazla bilgi için androidx.xr.runtime.Log sayfasına bakın. (l52735, b/448697662)

API Değişiklikleri

• Geospatial.createPoseFromGeospatialPose artık OpenXR özellikli cihazlarda çalışıyor. (l362c6)

Sürüm 1.0.0-alpha09

3 Aralık 2025

androidx.xr.arcore:arcore-*:1.0.0-alpha09 yayınlandı. 1.0.0-alpha09 sürümü bu kayıtları içerir.

Sürüm 1.0.0-alpha08

19 Kasım 2025

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

Yeni özellikler

• Jetpack XR için ARCore, artık AR için Google Play Hizmetleri'nin kullanılabildiği cihazları destekliyor.
• VPS kullanılabilirliği ve poz dönüşümü için Geospatial API'ler eklendi (I144dc)

Sürüm 1.0.0-alpha07

22 Ekim 2025

androidx.xr.arcore:arcore-*:1.0.0-alpha07 yayınlandı. 1.0.0-alpha07 sürümü bu kayıtları içerir.

Hata Düzeltmeleri

• :xr:arcore:arcore-openxr, :xr:arcore:arcore için uygulama bağımlılığı olarak eklendi (I47315, b/446999229)

Sürüm 1.0.0-alpha06

24 Eylül 2025

androidx.xr.arcore:arcore-*:1.0.0-alpha06 yayınlandı. 1.0.0-alpha06 sürümü bu kayıtları içerir.

API Değişiklikleri

• ARCore için test desteği xr:arcore:arcore-testing modülüne taşındı. (I25469)
• Uygulamaların, oluşturma amacıyla cihazın duruş ve ekran yapılandırmasını almasına izin vermek için ArDevice ve RenderViewpoint ekleniyor. (Ib7e3f)
• HandJointType numaralandırmalarını HAND_JOINT_TYPE_ önekiyle yeniden adlandırın. (I3f7cd)
• HandJointType, xr:runtime:runtime konumundan xr:arcore:arcore konumuna taşındı. (Iadb9c, b/409058039)
• Hand.State artık performansa dayalı uygulamalara kolay erişim sağlayan bir biçimde eklem pozlarıyla birlikte bir java.nio.FloatBuffer sunuyor. (I55e27)

Sürüm 1.0.0-alpha05

30 Temmuz 2025

androidx.xr.arcore:arcore:1.0.0-alpha05, androidx.xr.arcore:arcore-guava:1.0.0-alpha05 ve androidx.xr.arcore:arcore-rxjava3:1.0.0-alpha05 yayınlandı. 1.0.0-alpha05 sürümü bu commit'leri içerir.

Yeni özellikler

• Geliştiricinin el tarafı bilgilerini alabilmesi için getPrimaryHandSide ekleyin (I270bd)
• Jeo-uzamsal VPS kullanılabilirliğini kontrol etme API'sini ekleme (I58573)
• checkVpsAvailability (Idbded) için ARCore API ekleyin
• Java geliştiricilerinin kullanması için :xr:arcore:arcore-rxjava3 sınıfına stateFlowable uzantı işlevleri eklendi. (I083aa, b/427247794)

API Değişiklikleri

• *Mode yapılandırma değerleri, davranışlarını yansıtacak şekilde yeniden adlandırıldı. (I6d247, b/414648065)
• Ana ARCore yapısı (xr:arcore:arcore) yalnızca Kotlin tarzı eş zamansız API'ler içerir. Java geliştiricileri, uyumlu API'lere erişmek için xr:arcore:arcore-rxjava3 kitaplığını kullanabilir. (Ia525e, b/422794329)
• Ana ARCore yapısı (xr:scenecore:scenecore) yalnızca Kotlin tarzı eşzamansız API'ler içerir. Java geliştiricileri, uyumlu API'lere erişmek için xr:arcore:arcore-guava kitaplığını kullanabilir. (Iffcb4, b/422773524)
• Java geliştiricilerin kullanması için Anchor.persistAsync(), AnchorGuava hizmetine eklendi. (I4af1c, b/425984631)
• Java geliştiricilerin kullanması için Earth.createAnchorOnSurfaceAsync(Session, Double, Double, Double, Quaternion, Surface), EarthGuava hizmetine eklendi. (I66357, b/425992992)
• Java geliştiricileri, GltfModel.kt içinde GltfModel.createAsync için uzantı işlevlerini kullanır. GltfModel içindeki eşzamansız işlevler silinecek. (I0af60)
• Bu kitaplık artık tür kullanımı olan JSpecify boşluk 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)
• Java geliştiricilerinin kullanması için :xr:arcore:arcore-rxjava3 sınıfına subscribeAsFlowable uzantı işlevleri eklendi. (Id3e49, b/427277298)

Sürüm 1.0.0-alpha04

7 Mayıs 2025

androidx.xr.arcore:arcore:1.0.0-alpha04 yayınlandı. 1.0.0-alpha04 sürümü bu kayıtları içerir.

API Değişiklikleri

• Kotlin 2.0 ile yayınlanan projelerin kullanılabilmesi için KGP 2.0.0 veya daha yeni bir sürüm gerekir. (Idb6b5)
• TrackingState ve HandJointType, ARCore'dan Çalışma Zamanı'na taşındı.
• Hand.State.isActive (boolean), Hand.State.trackingState (androidx.xr.runtime.TrackingState) olarak değiştirildi.
• UUID geçersizse Anchor.load, Anchor.AnchorLoadInvalidUuid değerini döndürür.

Sürüm 1.0.0-alpha03

26 Şubat 2025

androidx.xr.arcore:arcore:1.0.0-alpha03, son alfa sürümünden bu yana önemli bir değişiklik olmadan yayınlandı. 1.0.0-alpha03 sürümü bu kayıtları içerir.

Sürüm 1.0.0-alpha02

12 Şubat 2025

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

Yeni özellikler

• El takibi desteği eklendi. İzleme bilgilerine erişmek için Hand.left ve Hand.right yöntemlerini kullanın.
• Sabit nokta oluşturan API'ler (Anchor.create, Anchor.load, Plane.createAnchor) artık AnchorCreateResult değerini döndürüyor ve AnchorCreateResourcesExhausted değerini doğru şekilde uyguluyor.

Hata düzeltmeleri

• Anchor.detach, oturum güncelleme iş parçacığıyla ilgili yarışma durumu nedeniyle artık önemli bir kilitlenmeye neden olmuyor.
• Anchor.create, emülatörde çalışırken daha kararlıdır

Sürüm 1.0.0-alpha01

12 Aralık 2024

androidx.xr.arcore:arcore-* 1.0.0-alpha01 yayınlandı.

İlk sürümün özellikleri

Mevcut ARCore kitaplığından ilham alan Jetpack XR için ARCore kitaplığı, dijital içeriği gerçek dünyayla harmanlama özellikleri sunar. Bu kitaplıkta hareket izleme, kalıcı bağlantılar, isabet testi ve anlamsal etiketleme (ör. zemin, duvarlar ve masaüstleri) ile düzlem tanımlama özellikleri bulunur. Jetpack XR için ARCore ile çalışma hakkında daha fazla bilgi edinmek üzere geliştirici kılavuzunu inceleyin.

• Session: Jetpack XR için ARCore, işlevlerini desteklemek amacıyla arka planda Jetpack XR Çalışma Zamanı'nı kullanır. Jetpack XR API'leri için çoğu ARCore ile etkileşimde bulunmak üzere oturum kullanacağınızdan lütfen dokümanlarına göz atın.

• Plane: Çevrenizdeki dünyayı anlamak için düzlemleri kullanın. Her düzlemin, onu semantik olarak tanımlayan bir Label vardır. Algılanan en son uçaklar hakkında bildirim almak için subscribe, belirli bir uçaktaki değişiklikler hakkında bildirim almak için state kullanabilirsiniz.

• Anchor: Sanal bir nesne ile gerçek dünyadaki bir konum arasındaki bağlantı. Sabitler, uzayda belirli bir konuma (create kullanılarak) veya bir Trackable'e (createAnchor kullanılarak) eklenebilir.

  • Sabit noktalar oturumlar arasında yeniden kullanılabilir. Bunları depolamak için persist, listelemek için getPersistedAnchorUuids ve almak için load kullanabilirsiniz. Artık kullanılmayan anahtarları unpersist.

  • Sabitler, Jetpack XR için ARCore ve Jetpack SceneCore arasında birlikte çalışabilir. Bir sabitleyici kullanarak AnchorEntity oluşturabilir veya mevcut bir AnchorEntity'niz varsa destekleyici sabitleyicisini almak için getAnchor kullanabilirsiniz.

  • hitTest kullanarak doğal kullanıcı etkileşimleri sunun. Bir hitTest, kesiştiği içerikleri belirlemek ve bu konumdan bir Anchor oluşturmak için Ray kullanır. InputEvent'den bir hitTest yapmayı düşünün.

Bilinen Sorunlar

• unpersist çağrısı ile UUID'sinin getPersistedAnchorUuids tarafından döndürülen sonuçlardan kaldırılması arasında bir gecikme olabilir.

• create, sistemin yeni sabitleyiciler döndürmek için yeterli kaynağa sahip olduğunu doğrulamaz. Çok fazla sabitleyici oluşturmak kilitlenmeye neden olabilir.

• Daha önce kalıcı hale getirilmiş ve kalıcı hale getirilmemiş bir sabitleyiciyi kalıcı hale getirme özelliği şu anda desteklenmiyor.

• Emülatörde kullanım desteklenir ancak davranış, gerçek bir cihazda çalıştırıldığındaki kadar kararlı olmayabilir. Özellikle create çağrıları yerel kod hatasıyla başarısız olabilir ve etkinliği hemen sonlandırabilir.

• Bazı durumlarda, persist çağrılırken "Bağlantı noktası kalıcı hale getirilmedi" mesajıyla birlikte hatalı bir şekilde RuntimeException oluşturulabilir. Bu durumlarda işlev yine de başarılı olur ve bağlantı noktası kalıcı hale getirilir. Geçici çözüm olarak persist çağrısını bir try bloğuyla sarmalamanızı öneririz.