Meningkatkan pengalaman aplikasi dengan persepsi menggunakan ARCore untuk Jetpack XR

Perangkat XR yang kompatibel
Panduan ini membantu Anda membangun pengalaman untuk jenis perangkat XR ini.
Mempelajari jenis perangkat XR →
Headset XR
Kacamata XR Berkabel
Kacamata Pintar dengan Layar
& Audio
Mempelajari jenis perangkat XR →

ARCore untuk Jetpack XR menghadirkan kemampuan persepsi yang andal agar aplikasi Anda dapat memahami dunia nyata melalui berbagai API. Beberapa API ini membantu Anda meningkatkan pengalaman imersif untuk perangkat seperti headset XR dan kacamata XR berkabel, beberapa membantu Anda meningkatkan pengalaman augmented untuk perangkat seperti kacamata AI, dan beberapa membantu Anda meningkatkan pengalaman aplikasi untuk semua jenis perangkat Android XR.

Misalnya, Anda dapat menggunakan ARCore untuk Jetpack XR guna mengambil data planar, menambatkan konten ke lokasi tetap di ruang, atau menggunakan pose geospasial untuk menambatkan konten ke lokasi di dunia nyata.

Menambahkan dependensi library

Sebelum mulai menggunakan fitur persepsi di aplikasi XR, tambahkan dependensi yang diperlukan, bergantung pada jenis pengalaman aplikasi yang Anda tingkatkan dengan AR.

Mengakses sesi

Fitur persepsi di ARCore untuk Jetpack XR mengandalkan Session, yang menggunakan Jetpack XR Runtime.

Cara aplikasi Anda mengakses sesi bergantung pada jenis pengalaman aplikasi yang Anda tingkatkan dengan fitur persepsi:

Membuat sesi menggunakan Jetpack XR Runtime

Untuk membuat sesi, teruskan Context ke metode create(). Context ini dapat berupa Activity di perangkat XR imersif atau perangkat seluler, atau konteks yang diproyeksikan di kacamata AI.

Membuat sesi ARCore dapat menjadi tugas yang mahal, dan harus diproses di latar belakang, seperti yang ditunjukkan dalam contoh berikut:

lifecycleScope.launch {
    when (val result = Session.create(context)) {
        is SessionCreateSuccess -> {
            val xrSession = result.session
            // ...
        }
        else ->
            TODO(/* A different unhandled exception was thrown. */)
    }
}

Fungsi create() dapat menggunakan parameter LifecycleOwner opsional, yang memungkinkan siklus proses sesi dikelola oleh LifecycleOwner yang berbeda. LifecycleOwner harus memulai dan mengakhiri siklus prosesnya dalam cakupan konteks yang disediakan, jika tidak, Session mungkin rentan terhadap kebocoran.

Mengonfigurasi sesi

Beberapa fitur mungkin dinonaktifkan secara default dan harus dikonfigurasi agar dapat berfungsi. Untuk mengonfigurasi sesi, gunakan configure() dan tentukan opsi konfigurasi yang diperlukan Session Anda. Untuk mengetahui detail tentang konfigurasi yang diperlukan untuk berbagai fitur AR, lihat halaman yang sesuai untuk setiap fitur AR.

Langkah berikutnya

Setelah aplikasi Anda memiliki sesi, pelajari cara menggunakannya untuk meningkatkan pengalaman aplikasi untuk berbagai perangkat XR: