Apps mit ARCore für Jetpack XR durch Wahrnehmung verbessern

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 →

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

Mit ARCore for 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, fügen Sie die erforderlichen Abhängigkeitenhinzu. Das hängt davon ab, welche Arten von App-Erlebnissen Sie mit AR verbessern .

Auf eine Sitzung zugreifen

Die Wahrnehmungsfunktionen in ARCore for Jetpack XR basieren auf einer Session, die die Jetpack XR Runtime verwendet.

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

• Wenn Ihre App immersive Erlebnisse mit räumlicher UI mithilfe von Jetpack Compose for XR verbessert, greifen Sie über Jetpack Compose for XR auf eine Sitzung zu.
• In allen anderen Fällen können Sie über die Jetpack XR Runtime auf eine Sitzung zugreifen. Das wird im folgenden Abschnitt auf dieser Seite beschrieben.

Über die Jetpack XR Runtime auf eine Sitzung zugreifen

Wenn Sie über die Jetpack XR Runtime auf eine Sitzung zugreifen möchten, müssen Sie sie erstellen:

Übergeben Sie dazu eine Aktivität an die create() Methode, wie im folgenden Beispiel gezeigt:

when (val result = Session.create(context)) {
    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, ebenfalls 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 Ihre Session erforderlich sind. Weitere Informationen zur erforderlichen Konfiguration für verschiedene 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 sich ansehen, wie Sie sie verwenden können, um App-Erlebnisse für verschiedene XR‑Geräte zu verbessern:

• Ebenen mit ARCore for Jetpack XR erkennen
• Anker mit ARCore for Jetpack XR erstellen
• Mit ARCore for Jetpack XR mit Händen interagieren
• Gesichtserkennung mit ARCore for Jetpack XR in Ihre App einbinden
• Tiefeninformationen mit ARCore for Jetpack XR in Ihrer App abrufen
• Pose eines Geräts mit ARCore for Jetpack XR verfolgen