Sitzung

Die Session ist die primäre Schnittstelle für die standortbezogenen Funktionen der Anwendung. Für jede geografische Aktivität muss eine Sitzungs-Instanz erstellt und beibehalten werden. Nach der Erstellung kann die Anwendung über die Sitzungsoberflächen räumliche Inhaltselemente wie Bereiche oder 3D‑Modelle erstellen sowie eine räumliche Umgebung festlegen, die Position des Nutzers ermitteln 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:

import androidx.xr.compose.platform.LocalSession

class myActivity : Activity() {
   val xrSession = checkNotNull(LocalSession.current)
}

Über Jetpack SceneCore auf die Sitzung zugreifen

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

Das Erstellen einer Sitzung wird nur auf einem Android XR-Gerät unterstützt. Wenn du derzeit eine Session erstellst und versuchst, sie auf einem Gerät zu verwenden, das kein Android XR-Gerät ist, erhältst du eine NullPointerException.

Pro Aktivität kann nur eine Sitzung erstellt werden. Wenn Sie eine Sitzung erstellen möchten, übergeben Sie der Methode create eine Aktivität, wie im folgenden Beispiel gezeigt. Wenn Sie versuchen, eine Sitzung auf einem inkompatiblen Gerät zu erstellen, können Laufzeitfehler auftreten.

import androidx.xr.scenecore.Session

class myActivity : Activity() {
  val xrSession = Session.create(this)
}

Wenn die Aktivität einer Sitzung gelöscht wird, werden alle zugehörigen räumlichen UI- und 3D-Inhalte gelöscht und die Sitzung ist nicht mehr gültig.

Siehe auch