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

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 →
XR‑Headsets
Kabelgebundene XR‑Brillen
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äumliche Inhaltsobjekte wie Panels oder 3D-Modelle zu erstellen, sowie eine räumliche Umgebung festzulegen, die Position des Nutzers zu ermitteln und Inhalte in der realen Welt zu verankern.

Auf eine Sitzung von Jetpack Compose for XR aus zugreifen

Wenn Sie Jetpack Compose for XR verwenden, wird die Sitzung für Sie erstellt und kann über LocalSession.currentaufgerufen werden. Siehe folgendes Beispiel:

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

Auf eine Sitzung von Jetpack XR Runtime aus zugreifen

Wenn Sie räumliche Objekte aus der Jetpack SceneCore-Bibliothek erstellen, müssen Sie eine Sitzung erstellen.

Übergeben Sie zum Erstellen einer Sitzung einen Context an die create() Methode. Dies Context kann ein Activity auf immersiven XR‑Geräten oder Mobilgeräten oder ein projizierter Kontext sein.

Das Erstellen einer ARCore-Sitzung kann aufwendig sein und sollte im Hintergrund erfolgen, wie in folgendem Beispiel gezeigt:

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

Wenn die Aktivität einer Sitzung beendet wird, werden alle räumlichen UI- und 3D-Inhalte, die mit dieser Sitzung verknüpft sind, zerstört und die Sitzung ist nicht mehr gültig.

Weitere Informationen