Sitzung

Die Session ist die primäre Schnittstelle für die standortbezogenen Funktionen der Anwendung. Für jede geografische Aktivität muss eine Instanz von Session erstellt und gespeichert werden. Nach der Erstellung können mithilfe der Session-Benutzeroberflächen räumliche Inhaltselemente wie Panels oder 3D-Modelle erstellt, eine räumliche Umgebung festgelegt, die Nutzerposition identifiziert und Inhalte in der realen Welt verankert werden.

Auf Sitzungen von Jetpack Compose für XR zugreifen

Wenn Sie Jetpack Compose for 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

Über Jetpack SceneCore auf die Sitzung zugreifen

Wenn Sie lokalisierte Entitäten aus der SceneCore-Bibliothek erstellen, müssen Sie die Sitzung erstellen.

Das Erstellen einer Sitzung wird nur auf einem Android XR-Gerät unterstützt. Der Versuch, eine Sitzung auf einem inkompatiblen Gerät zu erstellen, schlägt fehl. Wenn Sie eine Sitzung erstellen möchten, übergeben Sie der Methode create() eine Aktivität, 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 gelöscht wird, werden alle zugehörigen räumlichen Benutzeroberflächen und 3D-Inhalte gelöscht und die Sitzung ist nicht mehr gültig.

Siehe auch