Mengambil informasi kedalaman di aplikasi Anda dengan 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

Mempelajari jenis perangkat XR →

Aplikasi Anda dapat mengambil informasi kedalaman melalui ARCore untuk Jetpack XR guna menentukan seberapa dekat objek fisik dengan perangkat.

Membuat sesi ARCore untuk Jetpack XR

Dapatkan informasi kedalaman melalui ARCore untuk Jetpack XR Session. Jika Anda meningkatkan kualitas UI spasial menggunakan Jetpack Compose untuk XR, akses sesi dari Jetpack Compose untuk XR. Jika Anda menggunakan entity spasial dari library Jetpack SceneCore, akses sesi dari Jetpack XR Runtime.

Mengonfigurasi sesi

Pengambilan peta kedalaman tidak diaktifkan secara default pada sesi XR. Untuk mengaktifkan pengambilan peta kedalaman, konfigurasikan sesi dan tetapkan DepthEstimationMode:

val newConfig = Config.Builder(session.config)
    .setDepthEstimation(DepthEstimationMode.SMOOTH_ONLY)
    .build()
when (val result = session.configure(newConfig)) {
    is SessionConfigureSuccess -> TODO(/* Success! */)
    else ->
        TODO(/* The session could not be configured. See SessionConfigureResult for possible causes. */)
}
DepthMaps.kt

Nilai DepthEstimationMode berikut tersedia:

• DISABLED: Tidak ada informasi tentang kedalaman scene yang diberikan.
• RAW_ONLY: Estimasi kedalaman diaktifkan dengan nilai kedalaman mentah dan keyakinan.
• SMOOTH_ONLY: Estimasi kedalaman diaktifkan dengan nilai kedalaman dan keyakinan yang halus.
• SMOOTH_AND_RAW: Estimasi kedalaman diaktifkan dengan nilai kedalaman dan tingkat keyakinan mentah dan halus.

Peta kedalaman mentah memberikan estimasi kedalaman dengan akurasi yang lebih tinggi, tetapi gambar kedalaman mentah mungkin tidak menyertakan estimasi kedalaman untuk semua piksel dalam gambar kamera. Sebaliknya, peta kedalaman yang halus memberikan perkiraan kedalaman untuk setiap piksel, tetapi data kedalaman per piksel mungkin kurang akurat karena penghalusan dan interpolasi perkiraan kedalaman.

Catatan: Mengaktifkan mode estimasi kedalaman apa pun memerlukan izin runtime android.permission.SCENE_UNDERSTANDING_FINE yang diberikan ke aplikasi Anda.

Memeriksa kemampuan peta kedalaman

Perangkat yang berbeda memiliki kemampuan yang berbeda. Perangkat dengan konfigurasi kamera stereo dapat memberikan peta estimasi kedalaman untuk kamera kiri dan kanan. Demikian pula, perangkat dengan kamera tunggal hanya dapat memberikan peta estimasi kedalaman untuk kamera mono.

Untuk memeriksa peta kedalaman yang didukung oleh perangkat, gunakan XrDevice.isRenderingModeSupported:

val xrDevice = XrDevice.getCurrentDevice(context)
val hasMonoDepth = xrDevice.isRenderingModeSupported(RenderingMode.MONO)
val hasStereoDepth = xrDevice.isRenderingModeSupported(RenderingMode.STEREO)
DepthMaps.kt

Mengambil data kedalaman

Untuk mendapatkan data kedalaman untuk kamera tertentu, gunakan Depth:

if (hasStereoDepth) {
    val depthMap = Depth.left(session)
}
DepthMaps.kt

Catatan: Mengakses peta kedalaman yang tidak didukung akan menampilkan IllegalStateException. Sebelum memanggil Depth.left atau fungsi serupa, periksa kemampuan kedalaman yang didukung.

Menghitung nilai kedalaman

Anda dapat memperoleh nilai kedalaman dan tingkat keyakinan dari peta kedalaman yang dihasilkan:

if (hasStereoDepth) {
    val depthMap = Depth.left(session)
}
DepthMaps.kt

Bergantung pada setelan konfigurasi yang digunakan, akses peta kedalaman yang sesuai menggunakan smoothDepthMap atau rawDepthMap. Pengukuran yang terdapat dalam peta ini dinyatakan dalam meter. Anda juga dapat mengakses tingkat keyakinan menggunakan smoothConfidenceMap dan rawConfidenceMap. Nilai ini berkisar antara 0 hingga 255, dengan 255 mewakili keyakinan tertinggi.

Untuk merender peta kedalaman untuk tujuan debug atau visualisasi, lihat Bagian kedalaman aplikasi pengujian ARCore.