Apps mit ARCore für Jetpack XR durch Wahrnehmung verbessern

Anwendbare XR‑Geräte

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

Informationen zu XR-Gerätetypen →

XR-Headsets

XR-Datenbrille mit Kabel

AI Glasses

Informationen zu XR-Gerätetypen →

ARCore für Jetpack XR bietet leistungsstarke Wahrnehmungsfunktionen für Ihre App, mit denen die reale Welt über eine Vielzahl von APIs erfasst werden kann. Einige dieser APIs helfen Ihnen, immersive Erlebnisse für Geräte wie XR-Headsets und kabelgebundene XR-Brillen zu optimieren, andere helfen Ihnen, Augmented-Reality-Erlebnisse für Geräte wie KI-Brillen zu optimieren, und wieder andere helfen Ihnen, App-Erlebnisse für alle Arten von Android XR-Geräten zu optimieren.

Mit ARCore für Jetpack XR können Sie beispielsweise planare Daten abrufen, Inhalte an einem festen Ort im Raum verankern oder eine geospatiale Pose verwenden, um Inhalte an einem realen Ort zu verankern.

Bibliotheksabhängigkeiten hinzufügen

Bevor Sie mit der Verwendung von Wahrnehmungsfunktionen in Ihrer XR-App beginnen, müssen Sie die erforderlichen Abhängigkeiten hinzufügen, je nachdem, welche Art von App-Erlebnissen Sie mit AR verbessern möchten.

Auf eine Sitzung zugreifen

Wahrnehmungsfunktionen in ARCore für Jetpack XR basieren auf einem Session, das die Jetpack XR-Laufzeit verwendet.

Wie Ihre App auf eine Sitzung zugreifen sollte, hängt von den Arten von App-Erlebnissen ab, die Sie mit Wahrnehmungsfunktionen verbessern:

Wenn Sie in Ihrer App immersive Funktionen mit räumlicher Benutzeroberfläche mithilfe von Jetpack Compose für XR verbessern, können Sie auf eine Sitzung zu Jetpack Compose für XR zugreifen.
In allen anderen Fällen können Sie über die Jetpack XR-Laufzeit auf eine Sitzung zugreifen. Das wird im folgenden Abschnitt auf dieser Seite beschrieben.

Auf eine Sitzung über die Jetpack XR-Laufzeit zugreifen

Um auf eine Sitzung über die Jetpack XR-Laufzeit zuzugreifen, müssen Sie sie erstellen:

Wenn Sie eine Sitzung erstellen möchten, übergeben Sie eine Aktivität an die Methode create(), wie im folgenden Beispiel gezeigt:

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

Wenn die Aktivität einer Sitzung beendet wird, werden alle AR-Inhalte, die mit dieser Sitzung verknüpft sind, beendet und die Sitzung ist nicht mehr gültig.

Sitzung konfigurieren

Einige Funktionen sind möglicherweise standardmäßig deaktiviert und müssen konfiguriert werden, damit sie funktionieren. Verwenden Sie configure(), um eine Sitzung zu konfigurieren, und geben Sie die Konfigurationsoptionen an, die für Session erforderlich sind. Details zur erforderlichen Konfiguration für die verschiedenen AR-Funktionen finden Sie auf den entsprechenden Seiten für die einzelnen AR-Funktionen.

Nächste Schritte

Nachdem Ihre App eine Sitzung hat, können Sie sie nutzen, um die App-Nutzung auf verschiedenen XR-Geräten zu optimieren: