Auf eine Sitzung zugreifen, um räumliche Benutzeroberflächen und Entitäten zu erstellen

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
Informationen zu XR-Gerätetypen →

Die Session bietet die primäre Schnittstelle für räumliche Funktionen für Ihre App. Jede räumliche Activity muss eine Instanz von Session erstellen und beibehalten. Nachdem Ihre App eine Sitzung erstellt hat, kann sie die Session-Schnittstellen verwenden, um räumlich angeordnete Inhaltsobjekte wie Panels oder 3D-Modelle zu erstellen, sowie eine räumliche Umgebung festlegen, die Nutzerposition ermitteln und Inhalte in der realen Welt verankern.

Auf eine Sitzung von Jetpack Compose für XR zugreifen

Wenn Sie Jetpack Compose für XR verwenden, wird die Sitzung für Sie erstellt und kann über LocalSession.current aufgerufen werden. Sehen Sie sich folgendes Beispiel an:

@Composable
fun ComposableUsingSession() {
    val session = LocalSession.current
}
Session.kt

Auf eine Sitzung über die Jetpack XR-Laufzeit zugreifen

Wenn Sie räumliche Einheiten aus der Jetpack SceneCore-Bibliothek erstellen, müssen Sie eine Sitzung 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 räumlichen Benutzeroberflächen und 3D-Inhalte, die mit dieser Sitzung verknüpft sind, beendet und die Sitzung ist nicht mehr gültig.

Siehe auch