ARCore untuk Jetpack XR

Mendeklarasikan dependensi

Untuk menambahkan dependensi pada ARCore untuk Jetpack XR, Anda harus menambahkan repositori Maven Google ke project Anda. Baca repositori Maven Google untuk mengetahui informasi selengkapnya.

Tambahkan dependensi untuk artefak yang diperlukan dalam file build.gradle bagi aplikasi atau modul Anda:

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

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

Untuk informasi dependensi selengkapnya, lihat Menambahkan dependensi build.

Masukan

Masukan Anda membantu meningkatkan kualitas Jetpack. Beri tahu kami jika Anda menemukan masalah baru atau mempunyai masukan untuk meningkatkan kualitas library ini. Harap periksa masalah yang sudah diketahui dalam library ini sebelum membuat laporan baru. Anda dapat memberikan suara untuk masalah yang sudah diketahui dengan mengklik tombol bintang.

Laporkan masalah baru

Lihat dokumentasi Issue Tracker untuk informasi selengkapnya.

Versi 1.1

Versi 1.1.0-alpha01

21 Oktober 2026

androidx.xr.arcore:arcore-*:1.1.0-alpha01 dirilis. Versi 1.1.0-alpha01 berisi commit ini.

Perubahan API

• Memperkenalkan SpatialAnnotation API untuk melacak geometri dan objek fisik 3D. Menambahkan SpatialAnnotationTrackingOptions dan pola builder yang sesuai untuk mengonfigurasi pelacakan spasial melalui buffering gambar kamera. (I918ce)
• Memperkenalkan SpatialAnnotation dan SpatialAnnotationTrackingMode ke Jetpack XR ARCore, yang memungkinkan developer mengonfigurasi dan melacak geometri segi empat 3D yang dibatasi secara arbitrer (Quad) yang ditargetkan pada lingkungan spasial dunia nyata fisik. (I880e4)
• Menambahkan TestSpatialAnnotation untuk memungkinkan simulasi terprogram anotasi spasial dalam pengujian otomatis. (If2335)
• Menambahkan geospatialPose, horizontalAccuracy, verticalAccuracy, dan orientationYawAccuracy sebagai API baru untuk memberikan informasi selengkapnya dalam status Geospasial. (If28f8)

Perbaikan Bug

• Dependensi androidx.lifecycle:lifecycle-runtime diupdate ke 2.10.0. Versi ini diperlukan agar pemeriksaan lint runtime siklus proses yang dipaketkan dapat berjalan dengan AGP versi 9.5.0-alpha04 atau yang lebih baru. (I99bfd, b/556807521)
• Memeriksa jumlah gambar maksimum 0 saat mengonfigurasi AugmentedImage, menampilkan UnsupportedOperationException, bukan gagal secara tidak terduga. I6ce439
• Perbaiki kebocoran memori dan masalah konkurensi di AugmentedImageRenderer dengan melacak dan membatalkan tugas rendering dengan benar, menghapus entity, dan mengubah koleksi gambar dengan aman. Ie70760

Versi 1.0

Versi 1.0.0

21 Oktober 2026

androidx.xr.arcore:arcore-*:1.0.0 dirilis. Versi 1.0.0 berisi commit ini.

Fitur utama 1.0.0:

• ARCore untuk Jetpack XR kini stabil. Library ARCore untuk Jetpack XR menyediakan kemampuan untuk memadukan konten digital dengan dunia nyata. Library ini mencakup pelacakan gerakan, anchor persisten, hit testing, identifikasi bidang dengan pelabelan semantik (misalnya, lantai, dinding, dan permukaan meja), serta pose Geospasial menggunakan Sistem Pemosisian Visual Google.
• Untuk informasi selengkapnya, lihat Panduan Developer dan Referensi API kami.

Versi 1.0.0-rc02

7 Oktober 2026

androidx.xr.arcore:arcore-*:1.0.0-rc02 dirilis. Versi 1.0.0-rc02 berisi commit ini.

Perbaikan Bug

• Memperbaiki masalah saat OpenXrRuntime gagal mengonfigurasi sesi ketika pelacakan gambar augmented tidak didukung. (I8b9759)
• Memperbaiki beberapa masalah, termasuk: meningkatkan pengelolaan memori di XrInstanceManager dengan menggunakan applicationContext, menyelesaikan potensi masalah terkait siklus proses dengan menyederhanakan mekanisme caching Session dan Scene, serta meningkatkan ReferenceCleaner untuk memastikan pendaftaran pembersihan yang aman untuk thread dan pembuangan eksplisit. (Id0b76c)

Versi 1.0.0-rc01

9 September 2026

androidx.xr.arcore:arcore-*:1.0.0-rc01 dirilis. Versi 1.0.0-rc01 berisi commit ini.

Versi 1.0.0-beta02

12 Agustus 2026

androidx.xr.arcore:arcore-*:1.0.0-beta02 dirilis. Versi 1.0.0-beta02 berisi commit ini.

Perbaikan Bug

• Memperbaiki masalah konkurensi dalam persistensi anchor OpenXR. (I15c8b)
• Mengimplementasikan toString() di lebih banyak class untuk proses debug. (I587e8)

Versi 1.0.0-beta01

15 Juli 2026

androidx.xr.arcore:arcore-*:1.0.0-beta01 dirilis. Versi 1.0.0-beta01 berisi commit ini.

Perubahan API

• Mengubah pengubah yang dapat diubah ukurannya untuk menggunakan ResizePolicy, bukan dua pengubah (I7fb0f, b/496257436, b/519672992)
• Menambahkan overload yang dapat dipindahkan dengan parameter movePolicy dan menghentikan penggunaan transformingMovable dan movable (Ic88c1, b/481781189)
• Menghapus TrackingState.TRACKING_DEGRADED dari platform API publik dan memetakan status runtime yang menurun ke PAUSED. Memperbarui TrackingState agar menggunakan enum, bukan nilai int untuk konversi string dan konversi runtime. (I3eb5b, b/524326338)
• Mengonversi Session.create menjadi fungsi penangguhan. (I5d27f)
• Menghentikan penggunaan ProjectedPermissionsResultContract (I141d5, b/515699436)
• Memperbarui AnchorEntity menjadi AnchorSpace (Ifa95e, b/513619219)

Versi 1.0.0-alpha15

17 Juni 2026

androidx.xr.arcore:arcore-*:1.0.0-alpha15 dirilis. Versi 1.0.0-alpha15 berisi commit ini.

Perubahan API

• HitResult.createAnchor telah dihapus. Developer dapat membuat anchor yang mewakili HitResult jika hasil yang dapat dilacak adalah Anchorable dengan memberikan posisi hit ke fungsi createAnchor dari Anchorable. (Ia851e)
• AnchorUnsupportedObject telah dihapus. Error ini tidak lagi ditampilkan oleh runtime ARCore JXR. (Ia851e)
• androidx.xr.arcore.Anchor dan androidx.xr.arcore.ArDevice kini mengimplementasikan androidx.xr.arcore.Trackable. (I57b65)
• Depth.left, Depth.right, dan Depth.mono kini tidak dapat diubah ke null (I1fc5e)
• Face.getUserFace kini tidak dapat diubah menjadi null (I0eac1)
• (Icf7fa) RenderViewpoint.left, RenderViewpoint.right, RenderViewpoint.mono kini tidak dapat diubah menjadi null
• Hand.left dan Hand.right bukan non-nullable (Icef37)
• Menambahkan QrCode API (Ia0bbe)

Versi 1.0.0-alpha14

19 Mei 2026

androidx.xr.arcore:arcore-*:1.0.0-alpha14 dirilis. Versi 1.0.0-alpha14 berisi commit ini.

Perubahan API

• Menghentikan penggunaan GeospatialMode.VPS_AND_GPS dan menggantinya dengan GeospatialMode.SPATIAL serta memperkenalkan mode pelacakan baru yang lebih hemat daya, GeospatialMode.INERTIAL, yang hanya menggunakan IMU dan GPS. (I1e6cd)
• Class pengecualian anchor kustom: AnchorInvalidUuidException, AnchorNotAuthorizedException, AnchorUnsupportedLocationException, AnchorRuntimeFailureException, dan AnchorUnsupportedObjectException kini menjadi instance RuntimeException, yang tidak dimaksudkan untuk diperiksa. (I9356e)
• Menambahkan ArCoreTestRule API, termasuk TestArDevice, TestAugmentableObject, TestDepthMap, TestEye, TestFace, TestGeospatial, TestHand, TestPlane, TestRenderViewpoint, & TestTrackable (I0ad3c)
• Menghapus AnchorLoadInvalidUuid, AnchorCreateUnsupportedObject, AnchorCreateUnsupportedLocation, dan AnchorCreateNotAuthorized. Semua error ini sekarang menjadi pengecualian dalam runtime. Menghapus AnchorCreateIllegalState. Dalam sebagian besar kasus, ini telah diganti dengan AnchorCreateTrackingUnavailable. Menambahkan AnchorException dan class turunan AnchorInvalidUuidException, AnchorNotAuthorizedException, AnchorUnsupportedLocationException, AnchorRuntimeFailureException, dan AnchorUnsupportedObjectException. (I4c4dd)

Kontribusi Eksternal

• Menambahkan AugmentedImage API untuk pelacakan penanda kustom (I0cf09)

Versi 1.0.0-alpha13

6 Mei 2026

androidx.xr.arcore:arcore-*:1.0.0-alpha13 dirilis. Versi 1.0.0-alpha13 berisi commit ini.

Perubahan API

• TrackingState dan VpsAvailabilityResult telah dipindahkan ke androidx.xr.arcore package, dan jenis di androidx.xr.runtime kini tidak digunakan lagi. (Ic7930, b/480462213)
• Mengganti nama Plane.Type menjadi PlaneType. (I8c90c, b/482675376)
• Mengganti nama Hand.HandSide menjadi HandSide. (Ica562, b/482675376)
• Mengganti nama Plane.Label menjadi PlaneLabel. (Ic6b67, b/482675376)
• Mengganti nama Geospatial.Surface menjadi GeospatialSurface. (I1a8be, b/482675376)
• Geospatial.State telah diganti namanya menjadi GeospatialState. (I203fa, b/482675376)
• Memindahkan API NativeData ke library xr:runtime:runtime. (I87954, b/494251500)
• Session.create dan Session.configure kini tidak lengkap dan memerlukan klausa else dalam pernyataan when. (I9885e, b/495805998, b/495805998)
• androidx.xr.runtime.FieldOfView tidak digunakan lagi. Sebagai gantinya, gunakan androidx.xr.runtime.math.FieldOfView. (Ia01a0, b/480233045)
• Mengubah Orbiter untuk menggunakan OrbiterAnchorPoint + VolumeOffset atau OrbiterPoseProvider, bukan posisi, offset, offsetType, perataan, dan elevasi. Juga menghapus parameter shouldRenderInNonSpatial. Jika tidak ingin orbiter dirender dalam non-spasial, developer harus menggabungkan orbiter dalam pernyataan if dan memeriksa SpatialCapabilities. (I9fbb3, b/462428503)
• Menambahkan pengubah yang dapat dipindahkan. Pengubah ini berfungsi dengan baik, saat ini, untuk SpatialPanels dan SpatialExternalSurface. Dalam waktu dekat, fitur ini juga akan didukung untuk SpatialGltfModels. Namun, tujuannya adalah agar fitur ini didukung dengan baik untuk semua SubspaceComposables. (I9a3cd, b/479530787, b/478935063, b/478935063)
• Developer diharapkan mengamati Flow ArDevice.state untuk memantau State.trackingState dan menyesuaikan rendering atau peringatan aplikasi mereka berdasarkan fidelitas pelacakan. (Ic00f0, b/445466590)
• Mengganti nama nilai enum HandJointType. (Ifbc83, b/482670596)
• Mengganti nama konstanta FaceConfidenceRegion. (Ia62d5, b/482670596)
• Mengganti nama konstanta FaceBlendShapeType. (I33b8b, b/482670596)
• Menambahkan CreatePoseFromGeospatialPoseErrorInternal dan CreateGeospatialPoseFromPoseErrorInternal. (I4bcf1, b/482666615)
• Mengganti nama DeviceTrackingMode.LAST_KNOWN menjadi SPATIAL_LAST_KNOWN (dengan fallback yang tidak digunakan lagi), menambahkan INERTIAL_LAST_KNOWN untuk pelacakan 3DoF, dan menambahkan TRACKING_DEGRADED ke TrackingState. (Ie661c, b/445466590)
• GroupEntity tidak digunakan lagi. Untuk memiliki Entity yang hanya memiliki fungsi Entity dasar, panggil Entity.create yang akan menampilkan antarmuka Entity. (I4c450, b/473867483)
• Menambahkan XrLog API. Tetapkan XrLog.isEnabledke true untuk mengaktifkan logging di JetpackXR, dan gunakan XrLog.Level untuk menetapkan level log. (I76a1f, b/463460895, b/487378441)

Perbaikan Bug

• Menambahkan dukungan status pelacakan perangkat ke perangkat openxr. (I91485, b/445466590)

Versi 1.0.0-alpha12

25 Maret 2025

androidx.xr.arcore:arcore-*:1.0.0-alpha12 dirilis. Versi 1.0.0-alpha12 berisi commit ini.

Perubahan API

• Mengubah Config.augmentedObjectCategories dari Daftar menjadi Set. (I25a64, b/487376359)
• Jenis androidx.xr.arcore.Eye dan androidx.xr.arcore.Hand. (I42438, b/449032900)
• Menambahkan overload Session.create untuk mengizinkan penerusan Android Context untuk pencakupan resource. (I7d3fe, b/415805990, b/477386334)
• Mengubah FakeRuntimeAnchor.ANCHOR_RESOURCE_LIMIT menjadi FakeRuntimeAnchor.anchorResourceLimit. (I90841, b/431992235)
• Menjadikan API TiltGesture sebagai eksperimental karena dapat diubah atau dihapus pada masa mendatang. Untuk menggunakan API ini, pilih ikut serta dalam @ExperimentalGesturesApi (Ic9858)
• Menambahkan kemampuan untuk menetapkan kategori pelacakan AugmentedObject di Config (I1f6e4, b/480220930)

Perbaikan Bug

• Memperbaiki build Chrome dengan mengupdate file META-INF/services/ dengan lokasi PerceptionRuntimeFactory yang sebenarnya. (I7a801, b/481288291)

Versi 1.0.0-alpha11

25 Februari 2026

androidx.xr.arcore:arcore-*:1.0.0-alpha11 dirilis. Versi 1.0.0-alpha11 berisi commit ini.

Versi 1.0.0-alpha10

28 Januari 2026

androidx.xr.arcore:arcore-*:1.0.0-alpha10 dirilis. Versi 1.0.0-alpha10 berisi commit ini.

Fitur Baru

• Memperkenalkan TiltGesture API, yang menyediakan Flow reaktif untuk deteksi stabil status kemiringan perangkat (NAIK/TURUN) dengan progres transisi. (Ic269f, b/448152779)
• ARCore untuk Jetpack XR kini menggunakan mekanisme Logging XR Runtime. Lihat androidx.xr.runtime.Log untuk mengetahui informasi selengkapnya. (l52735, b/448697662)

Perubahan API

• Geospatial.createPoseFromGeospatialPose kini berfungsi di perangkat yang mendukung OpenXR. (l362c6)

Versi 1.0.0-alpha09

03 Desember 2025

androidx.xr.arcore:arcore-*:1.0.0-alpha09 dirilis. Versi 1.0.0-alpha09 berisi commit ini.

Versi 1.0.0-alpha08

19 November 2025

androidx.xr.arcore:arcore-*:1.0.0-alpha08 dirilis. Versi 1.0.0-alpha08 berisi commit ini.

Fitur Baru

• ARCore untuk Jetpack XR kini mendukung perangkat yang menyediakan Layanan Google Play untuk AR.
• Menambahkan Geospatial API untuk Ketersediaan VPS dan konversi pose (I144dc)

Versi 1.0.0-alpha07

22 Oktober 2025

androidx.xr.arcore:arcore-*:1.0.0-alpha07 dirilis. Versi 1.0.0-alpha07 berisi commit ini.

Perbaikan Bug

• :xr:arcore:arcore-openxr ditambahkan sebagai dependensi implementasi ke :xr:arcore:arcore (I47315, b/446999229)

Versi 1.0.0-alpha06

24 September 2025

androidx.xr.arcore:arcore-*:1.0.0-alpha06 dirilis. Versi 1.0.0-alpha06 berisi commit ini.

Perubahan API

• Dukungan pengujian untuk ARCore telah dimigrasikan ke modul xr:arcore:arcore-testing. (I25469)
• Menambahkan ArDevice dan RenderViewpoint untuk memungkinkan aplikasi mengambil pose dan konfigurasi tampilan perangkat untuk tujuan rendering. (Ib7e3f)
• Mengganti nama enum HandJointType dengan awalan HAND_JOINT_TYPE_. (I3f7cd)
• HandJointType telah dipindahkan ke xr:arcore:arcore dari xr:runtime:runtime. (Iadb9c, b/409058039)
• Hand.State kini mengekspos java.nio.FloatBuffer dengan pose sendi dalam format yang memungkinkan akses mudah ke aplikasi yang berorientasi pada performa. (I55e27)

Versi 1.0.0-alpha05

30 Juli 2025

androidx.xr.arcore:arcore:1.0.0-alpha05, androidx.xr.arcore:arcore-guava:1.0.0-alpha05, dan androidx.xr.arcore:arcore-rxjava3:1.0.0-alpha05 dirilis. Versi 1.0.0-alpha05 berisi commit ini.

Fitur Baru

• Menambahkan getPrimaryHandSide agar developer bisa mendapatkan info sisi tangan (I270bd)
• Menambahkan API ketersediaan VPS pemeriksaan geospasial (I58573)
• Menambahkan ARCore API untuk checkVpsAvailability (Idbded)
• Fungsi ekstensi stateFlowable ditambahkan ke :xr:arcore:arcore-rxjava3 untuk digunakan oleh developer Java. (I083aa, b/427247794)

Perubahan API

• Nilai konfigurasi *Mode telah diganti namanya untuk mencerminkan perilakunya. (I6d247, b/414648065)
• Artefak ARCore utama (xr:arcore:arcore) hanya akan berisi API asinkron bergaya Kotlin. Developer Java dapat mengandalkan library xr:arcore:arcore-rxjava3 untuk mengakses API yang kompatibel. (Ia525e, b/422794329)
• Artefak ARCore utama (xr:scenecore:scenecore) hanya akan berisi API asinkron bergaya Kotlin. Developer Java dapat mengandalkan library xr:arcore:arcore-guava untuk mengakses API yang kompatibel. (Iffcb4, b/422773524)
• Anchor.persistAsync() ditambahkan ke AnchorGuava untuk digunakan oleh developer Java. (I4af1c, b/425984631)
• Earth.createAnchorOnSurfaceAsync(Session, Double, Double, Double, Quaternion, Surface) ditambahkan ke EarthGuava untuk digunakan oleh developer Java. (I66357, b/425992992)
• Developer Java akan menggunakan fungsi ekstensi untuk GltfModel.createAsync di GltfModel.kt. Fungsi asinkron di GltfModel akan dihapus. (I0af60)
• Library ini sekarang menggunakan anotasi nullness JSpecify, yang merupakan penggunaan jenis. Developer Kotlin harus menggunakan argumen compiler berikut untuk menerapkan penggunaan yang benar: -Xjspecify-annotations=strict (ini adalah setelan default mulai dari versi 2.1.0 compiler Kotlin) (Ia8420, b/326456246)
• Fungsi ekstensi subscribeAsFlowable ditambahkan ke :xr:arcore:arcore-rxjava3 untuk digunakan oleh developer Java. (Id3e49, b/427277298)

Versi 1.0.0-alpha04

7 Mei 2025

androidx.xr.arcore:arcore:1.0.0-alpha04 dirilis. Versi 1.0.0-alpha04 berisi commit ini.

Perubahan API

• Project yang dirilis dengan Kotlin 2.0 memerlukan KGP 2.0.0 atau yang lebih baru untuk digunakan. (Idb6b5)
• TrackingState dan HandJointType telah dipindahkan dari ARCore ke Runtime.
• Hand.State.isActive (boolean) telah diubah menjadi Hand.State.trackingState (androidx.xr.runtime.TrackingState).
• Anchor.load menampilkan Anchor.AnchorLoadInvalidUuid jika UUID tidak valid.

Versi 1.0.0-alpha03

26 Februari 2025

androidx.xr.arcore:arcore:1.0.0-alpha03 dirilis tanpa perubahan penting sejak versi alfa terakhir. Versi 1.0.0-alpha03 berisi commit ini.

Versi 1.0.0-alpha02

12 Februari 2025

androidx.xr.arcore:arcore:1.0.0-alpha02 dirilis. Versi 1.0.0-alpha02 berisi commit ini.

Fitur Baru

• Menambahkan dukungan pelacakan gerak tangan. Gunakan Hand.left dan Hand.right untuk mengakses informasi pelacakan.
• API yang menghasilkan anchor (Anchor.create, Anchor.load, Plane.createAnchor) kini semuanya menampilkan AnchorCreateResult dan mengimplementasikan AnchorCreateResourcesExhausted dengan benar.

Perbaikan bug

• Anchor.detach tidak lagi menyebabkan error fatal karena kondisi race dengan thread update Sesi.
• Anchor.create lebih stabil saat berjalan di emulator

Versi 1.0.0-alpha01

12 Desember 2024

androidx.xr.arcore:arcore-* 1.0.0-alpha01 dirilis.

Fitur rilis awal

Terinspirasi oleh library ARCore yang ada, library ARCore untuk Jetpack XR menyediakan kemampuan untuk memadukan konten digital dengan dunia nyata. Library ini mencakup pelacakan gerakan, anchor persisten, hit testing, dan identifikasi bidang dengan pelabelan semantik (misalnya, lantai, dinding, dan permukaan meja). Lihat panduan developer untuk mempelajari lebih lanjut cara menggunakan ARCore untuk Jetpack XR.

• Session: ARCore untuk Jetpack XR menggunakan Jetpack XR Runtime di balik layar untuk mendukung fungsinya. Anda akan menggunakan Sesi untuk berinteraksi dengan sebagian besar API ARCore untuk Jetpack XR, jadi lihat dokumentasinya.

• Plane: Gunakan bidang untuk memahami dunia di sekitar Anda. Setiap bidang memiliki Label yang mendeskripsikannya secara semantik. Anda dapat menggunakan subscribe untuk mendapatkan notifikasi tentang bidang terbaru yang terdeteksi atau state untuk mendapatkan notifikasi tentang perubahan pada bidang tertentu.

• Anchor: Link antara objek virtual dan lokasi dunia nyata. Anchor dapat dipasang ke lokasi tertentu di ruang (menggunakan create) atau Trackable (menggunakan createAnchor).

  • Anchor dapat digunakan kembali di seluruh sesi. Anda dapat menggunakan persist untuk menyimpannya, getPersistedAnchorUuids untuk menghitungnya, dan load untuk mengambilnya. Pastikan Anda unpersist setelah tidak lagi digunakan.

  • Anchor dapat dioperasikan antara ARCore untuk Jetpack XR dan Jetpack SceneCore. Anda dapat membuat AnchorEntity menggunakan anchor atau, jika sudah memiliki AnchorEntity, Anda dapat menggunakan getAnchor untuk mengambil anchor pendukungnya.

  • Menawarkan interaksi pengguna yang alami menggunakan hitTest. hitTest menggunakan Ray untuk menentukan konten mana yang berpotongan dan untuk membuat Anchor dari lokasi tersebut. Pertimbangkan untuk melakukan hitTest dari InputEvent.

Masalah Umum

• Mungkin ada penundaan antara pemanggilan unpersist dan penghapusan UUID-nya dari hasil yang ditampilkan oleh getPersistedAnchorUuids.

• create tidak akan memvalidasi bahwa sistem memiliki resource yang cukup untuk menampilkan anchor baru. Membuat anchor dalam jumlah berlebihan dapat menyebabkan error.

• Mempertahankan Anchor yang sebelumnya dipertahankan dan tidak dipertahankan saat ini tidak didukung.

• Penggunaan di emulator didukung, tetapi perilakunya mungkin tidak stabil seperti saat dijalankan di perangkat yang sebenarnya. Secara khusus, panggilan ke create mungkin gagal dengan error kode native dan segera menghentikan aktivitas.

• Dalam situasi tertentu, RuntimeException mungkin salah ditampilkan saat memanggil persist dengan pesan “Anchor was not persisted”. Dalam situasi tersebut, fungsi akan tetap berhasil dan anchor akan dipertahankan. Sebaiknya gabungkan panggilan ke persist dengan blok try sebagai solusinya.