Geräteposition mit ARCore für Jetpack XR erfassen

XR‑Geräte, für die der Leitfaden gilt

Dieser Leitfaden hilft Ihnen dabei, Erlebnisse für die folgenden Arten von XR-Geräten zu entwickeln.

Informationen zu XR-Gerätetypen →

Informationen zu XR-Gerätetypen →

Mit ARCore für Jetpack XR kann Ihre App die Ausrichtung eines Geräts abrufen: die Orientierung (Neigung, Gieren, Rollen) und eine Position (X, Y, Z) des Geräts relativ zum Weltursprung.

Mit diesen Informationen können Sie digitale Inhalte in der realen Welt rendern oder die Geräteposition in eine georäumliche Position umwandeln, um standortbezogene Daten zu generieren.

Auf eine Sitzung zugreifen

Sie können über eine Jetpack XR-Laufzeit Session auf Informationen zur Geräteposition zugreifen, die von Ihrer App erstellt werden muss.

Sitzung konfigurieren

Informationen zur Geräteposition sind bei XR-Sitzungen nicht standardmäßig aktiviert. Damit Ihre App Informationen zur Geräteposition abrufen kann, müssen Sie die Sitzung konfigurieren und den Modus DeviceTrackingMode.LAST_KNOWN festlegen:

// 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

Nicht alle XR-Geräte unterstützen den DeviceTrackingMode.LAST_KNOWN-Modus. Wenn Session.configure() erfolgreich ist, unterstützt das Gerät diesen Modus.

Geräteposition abrufen

Nachdem Sie die Sitzung konfiguriert haben, können Sie die Position des Geräts im AR-Koordinatensystem mit dem ArDevice-Objekt abrufen:

// 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

Translation und Rotation der Geräte-Pose abrufen

Das Gerät Pose stellt die Position (Translation) und Ausrichtung (Rotation) des Geräts relativ zum Tracking-Ursprung dar. So können Sie diese Informationen in Ihrer App nutzen, um die Nutzerfreundlichkeit zu verbessern:

1. Positionsgenaue Navigationsanweisungen bereitstellen: Mithilfe von Positionsdaten kann sich ein Nutzer orientieren und mit überlagerten digitalen Inhalten in seiner Umgebung navigieren.

2. Zwischenausrichtung der realen Welt berechnen: Diese Pose wird von der Geospatial API verwendet, um den realen Standort zu berechnen.

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

Geräteposition in eine raumbezogene Position umwandeln

Sobald Sie die Geräteposition haben, können Sie daraus eine geospatiale Position ableiten. Durch die Umwandlung in eine raumbezogene Position wird Ihr AR-Inhalt von einem temporären, isolierten Erlebnis zu einer dauerhaften, universell geteilten und kontextbezogenen Funktion in der realen Welt.

Informationen zum Konvertieren einer Geräte-Pose in eine raumbezogene Pose finden Sie in der Dokumentation zur Geospatial API.