Runtime XR

Untuk menambahkan dependensi pada runtime 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.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")
}

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.0

Versi 1.0.0-alpha04

7 Mei 2025

androidx.xr.runtime:runtime:1.0.0-alpha04, androidx.xr.runtime:runtime-openxr:1.0.0-alpha04, dan androidx.xr.runtime:runtime-testing:1.0.0-alpha04 dirilis. Versi 1.0.0-alpha04 berisi commit ini.

Fitur Baru

• Sesi kini menerapkan androidx.lifecycle.LifecycleOwner untuk interoperabilitas yang lebih baik dengan paradigma siklus proses Android yang ada.
• String manifes untuk Android XR ditentukan dan didokumentasikan di sini.
• Metode ekstensi Callback Visibilitas Spasial ditambahkan untuk memantau saat konten tampilan bergerak di dalam atau di luar bidang pandang pengguna.
• Menambahkan versi stub JxrPlatformAdapter (dan semua class terkaitnya).
• Sesi akan digunakan di SceneCore dan Runtime, bukan Sesi di SceneCore.
• ActivityPose.hitTest telah ditambahkan, sehingga memungkinkan hitTest terhadap konten virtual.
• Menentukan beberapa implementasi Runtime pada waktu kompilasi kini didukung. Hanya satu yang akan dimuat pada waktu eksekusi berdasarkan kumpulan fitur perangkat saat ini.
• Menambahkan jenis Komponen baru SpatialPointerComponent, yang memungkinkan klien menentukan ikon yang dirender untuk pointer, atau menonaktifkan ikon. Komponen ini saat ini hanya dapat dilampirkan ke instance PanelEntity.

Perubahan API

• Buat implementasi Config menjadi publik. (I95860)
• Tambahkan HandJointType dan TrackingState. (I55880)
• Project yang dirilis dengan Kotlin 2.0 memerlukan KGP 2.0.0 atau yang lebih baru untuk digunakan (Idb6b5)
• Hand.isActive (boolean) telah diubah menjadi Hand.trackingState. Implementasi OpenXR telah diubah sebagaimana mestinya.
• Persyaratan izin android.permission.SCENE_UNDERSTANDING di Session.configure telah diubah menjadi android.permission.SCENE_UNDERSTANDING_COARSE.
• LifecycleManager.configure diimplementasikan dan sekarang meneruskan objek Config yang berisi properti untuk setiap fitur runtime yang dapat dikonfigurasi.
• Session.configure kini dapat dipanggil dengan Config untuk mengonfigurasi fitur runtime yang tersedia.
• Session.create kini mendukung penerusan CoroutineContext, bukan CoroutineDispatcher.
• Session.create mendukung pemuatan ARCore untuk Jetpack XR dan/atau SceneCore. Setidaknya satu harus diberikan (versi pengujian tersedia).
• FakePerceptionManager menampilkan AnchorInvalidUuidException saat UUID yang tidak valid diteruskan ke Anchor.load dan Anchor.unpersist.
• CoreState bukan lagi class data.

Perbaikan Bug

• Memperbaiki konfigurasi proguard Runtime.

Versi 1.0.0-alpha03

26 Februari 2025

androidx.xr.runtime:runtime:1.0.0-alpha03, androidx.xr.runtime:runtime-openxr:1.0.0-alpha03, dan androidx.xr.runtime:runtime-testing: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.runtime:runtime:1.0.0-alpha02, androidx.xr.runtime:runtime-openxr:1.0.0-alpha02, dan androidx.xr.runtime:runtime-testing:1.0.0-alpha02 dirilis. Versi 1.0.0-alpha02 berisi commit ini.

Perubahan perilaku & yang dapat menyebabkan gangguan

• Fungsi runtime OpenXR yang menampilkan Anchor kini menampilkan AnchorResourcesExhaustedException jika menemukan kode error yang memberi tahu bahwa batas resource OpenXR telah tercapai.
• Izin android.permission.HAND_TRACKING kini diperlukan untuk Session.create dan Session.resume.

Fitur baru

• Menambahkan dukungan pelacakan tangan.

Perbaikan bug

• Membuat anchor lebih stabil saat berjalan di emulator

Versi 1.0.0-alpha01

12 Desember 2024

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

Fitur Rilis Awal

Rilis awal Runtime Jetpack XR. Library ini berisi bagian fungsi dasar untuk suite library Jetpack XR. Hal ini mencakup penemuan kemampuan, pengelolaan siklus proses, konfigurasi, dan lainnya. Library Runtime menyediakan variasi yang berbeda (misalnya, runtime-openxr atau runtime-testing) bergantung pada platform eksekusi. Selain itu, library ini menawarkan abstraksi matematika dasar seperti Vector3 dan Matrix4 yang digunakan di seluruh platform Jetpack XR API.

• Session: Memberi Anda kontrol yang mendetail atas sistem XR, termasuk menentukan kapan pemrosesan dijalankan dan tidak dijalankan serta konfigurasi secara keseluruhan. Ini juga merupakan nama sebutan yang akan Anda gunakan di semua API lainnya untuk membuka kemampuan sistem yang mendasarinya.

• Pose: Lokasi dalam sistem koordinat arbitrer yang memiliki posisi dan orientasi yang terkait dengannya. Anda akan menggunakan class ini untuk mengomunikasikan lokasi objek dengan ARCore untuk Jetpack XR dan Jetpack SceneCore.

Masalah Umum

• configure saat ini tidak berfungsi. Rilis mendatang akan menambahkan setelan baru yang dapat Anda gunakan untuk mengontrol perilaku Session.