Von Home Space zu Full Space wechseln

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

Nutzer können Ihre App in zwei Modi verwenden: Home Space oder Full Space. Im Home Space können Nutzer mehrere Aufgaben gleichzeitig ausführen und Ihre App neben anderen Apps verwenden. Im Full Space steht Ihre App im Mittelpunkt des Nutzererlebnisses und bietet vollen Zugriff auf die immersiven Funktionen von Android XR.

Ihre App wird standardmäßig im Home Space geöffnet, sofern Sie nichts anderes angeben. Weitere Informationen finden Sie im Abschnitt Standardmodus für den Start deklarieren.

Die Räumlichkeit wird nur im Full Space unterstützt. Ihre App kann in den Full Space wechseln, um die räumlichen und 3D‑Funktionen zu nutzen. Wenn Ihre App im Fokus steht, können Sie zwischen diesen Modi wechseln, indem Sie den entsprechenden Space anfordern.

Mit SpaceToggleButton zwischen Home Space und Full Space wechseln

Verwenden Sie die SpaceToggleButton zusammensetzbare Funktion aus der Material Design for XR -Bibliothek, um zwischen Home Space und Full Space zu wechseln.

Dies ist eine zusammensetzbare Schaltfläche, die sich an den aktuellen räumlichen Modus anpasst und zwischen Full Space und Home Space wechselt.

Benutzerdefinierten Übergang zwischen Home Space und Full Space erstellen

Wenn Sie die Jetpack Compose for XR-Bibliothek verwenden, fordern Sie den Home Space oder Full Space mit der LocalSession lokalen Zusammensetzung an.

val session = LocalSession.current ?: return
session.scene.requestHomeSpace()
// or
session.scene.requestFullSpace()

Wenn Sie die Jetpack SceneCore-Bibliothek verwenden, können Sie den entsprechenden Space von der Sessionanfordern. Weitere Informationen finden Sie unter Auf Sitzung über Jetpack SceneCore zugreifen.

xrSession.scene.requestHomeSpace()

Im Codelab Android XR-Grundlagen: Teil 1 – Modi und räumliche Panels finden Sie Beispiele dafür, wie Sie mit diesen Anfragen per Klick auf eine Schaltfläche zwischen Modi wechseln können. Wir empfehlen Ihnen außerdem, unsere Designrichtlinien zu lesen, um mehr über den Übergang von Home Space zu Full Space und die beste Möglichkeit zu erfahren, zwischen den beiden zu wechseln.

Standardmodus für den Start deklarieren

Alternativ können Sie die folgenden Zeilen in die Android-Manifestdatei einfügen, um auszuwählen, in welchem Space Ihre App geöffnet werden soll:

<!-- Launch in Full Space. -->
<property
   android:name="android.window.PROPERTY_XR_ACTIVITY_START_MODE"
   android:value="XR_ACTIVITY_START_MODE_FULL_SPACE_MANAGED" />

<!-- Or, launch in Home Space. -->
<property
   android:name="android.window.PROPERTY_XR_ACTIVITY_START_MODE"
   android:value="XR_ACTIVITY_START_MODE_HOME_SPACE" />

Weitere Informationen