Sitzung

Die Session ist die primäre Schnittstelle für die räumliche Funktionalität der Anwendung. Für jede geografische Aktivität muss eine Instanz von Session erstellt und gespeichert werden. Nach der Erstellung kann die Anwendung mithilfe der Session-Benutzeroberflächen räumliche Inhaltselemente wie Bereiche oder 3D-Modelle erstellen sowie eine räumliche Umgebung festlegen, die Position des Nutzers identifizieren und Inhalte an der realen Welt verankern.

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
        // ...
    }
    is SessionCreatePermissionsNotGranted ->
        TODO(/* The required permissions in result.permissions have not been granted. */)
}
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