Melacak pose perangkat menggunakan ARCore untuk Jetpack XR

Perangkat XR yang kompatibel

Panduan ini membantu Anda membangun pengalaman untuk jenis perangkat XR ini.

Mempelajari jenis perangkat XR →

Mempelajari jenis perangkat XR →

Dengan ARCore untuk Jetpack XR, aplikasi Anda dapat mengambil pose perangkat: orientasi (pitch, yaw, roll) dan posisi (X, Y, Z) perangkat relatif terhadap asal dunia.

Gunakan informasi ini untuk merender konten digital di dunia nyata, atau mengonversi postur perangkat menjadi postur geospasial untuk menghasilkan data yang mengetahui lokasi.

Mengakses sesi

Akses informasi postur perangkat melalui Session Jetpack XR Runtime, yang harus dibuat oleh aplikasi Anda.

Mengonfigurasi sesi

Informasi pose perangkat tidak diaktifkan secara default pada sesi XR. Untuk mengaktifkan aplikasi Anda mengambil informasi pose perangkat, konfigurasi sesi dan tetapkan mode DeviceTrackingMode.LAST_KNOWN:

// Define the configuration object to enable tracking device pose.
val newConfig = session.config.copy(
    deviceTracking = DeviceTrackingMode.LAST_KNOWN
)
// Apply the configuration to the session.
try {
    when (val configResult = session.configure(newConfig)) {
        is SessionConfigureSuccess -> {
            // The session is now configured to track the device's pose.
        }
        else -> {
            // Catch-all for other configuration errors returned using the result class.
        }
    }
} catch (e: UnsupportedOperationException) {
    // Handle configuration failure. For example, if the specific mode is not supported on the current device or API version.
}
DevicePose.kt

Tidak semua perangkat XR mendukung mode DeviceTrackingMode.LAST_KNOWN. Jika Session.configure() berhasil, perangkat mendukung mode ini.

Mendapatkan pose perangkat

Setelah mengonfigurasi sesi, Anda dapat memperoleh postur perangkat dalam sistem koordinat AR menggunakan objek ArDevice:

// Get the ArDevice instance
val arDevice = ArDevice.getInstance(session)
// There are two ways to get the device pose.

// 1. Get the current device pose once.
// This is the device's position and orientation relative to the tracking origin.
val devicePose = arDevice.state.value.devicePose
processDevicePose(devicePose)

// 2. Continuously receive updates for the device pose.
// `collect` is a suspending function that will run indefinitely and process new poses.
arDevice.state.collect { state ->
    processDevicePose(state.devicePose)
}
DevicePose.kt

Mendapatkan terjemahan dan rotasi pose perangkat

Pose perangkat merepresentasikan posisi (terjemahan) dan orientasi (rotasi) perangkat relatif terhadap asal pelacakan. Gunakan informasi ini di aplikasi Anda untuk meningkatkan pengalaman aplikasi Anda:

1. Memberikan petunjuk navigasi yang akurat secara posisi: Data posisi dapat digunakan untuk membantu pengguna memahami posisi mereka dan menavigasi lingkungan sekitar dengan bantuan konten digital yang ditayangkan di atasnya.

2. Menghitung penyesuaian dunia menengah: Pose ini digunakan oleh Geospatial API untuk menghitung lokasi dunia nyata.

fun processDevicePose(pose: Pose) {
    // Extract Translation and Rotation
    val translation = pose.translation // Vector3(x, y, z)
    val rotation = pose.rotation // Quaternion (x, y, z, w)
    TODO(/* Use the translation and rotation in your app. */)
}
DevicePose.kt

Mengonversi pose perangkat menjadi pose geospasial

Setelah memiliki pose perangkat, Anda dapat memperoleh pose geospasial darinya. Mengonversi ke pose geospasial akan mengubah konten AR Anda dari pengalaman sementara dan terisolasi menjadi fitur permanen, yang dibagikan secara universal, dan sadar konteks di dunia nyata.

Pelajari cara mengonversi pose perangkat menjadi pose geospasial dalam dokumentasi Geospatial API.