Von Home Space zu Full Space wechseln

Anwendbare XR‑Geräte
Dieser Leitfaden hilft Ihnen dabei, Erlebnisse für diese Arten von XR-Geräten zu entwickeln.
Informationen zu XR-Gerätetypen →
XR-Headsets
XR-Datenbrille mit Kabel
Informationen zu XR-Gerätetypen →

Nutzer können Ihre App in zwei Modi verwenden: im Home Space oder im Full Space. Im Home Space kann ein Nutzer Multitasking ausführen, während Ihre App parallel zu anderen Apps ausgeführt wird. Im Full Space steht Ihre App im Mittelpunkt der Nutzererfahrung und hat vollen Zugriff auf die immersiven Funktionen von Android XR.

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

Räumliche Audioausgabe wird nur in Full Space unterstützt. Ihre App kann in den Full Space-Modus wechseln, um räumliche und 3D-Funktionen zu nutzen. Wenn Ihre App den Fokus hat, können Sie zwischen diesen Modi wechseln, indem Sie den entsprechenden Bereich anfordern.

Mit SpaceToggleButton können Sie zwischen dem Home Space und dem Full Space wechseln.

Verwende das SpaceToggleButton-Composable 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 den Full Space mit dem LocalSpatialConfiguration-Kompositionslokal an.

LocalSpatialConfiguration.current.requestHomeSpaceMode()
// or
LocalSpatialConfiguration.current.requestFullSpaceMode()
ModeTransition.kt

Wenn Sie die Jetpack SceneCore-Bibliothek verwenden, können Sie den entsprechenden Bereich über Session anfordern. Weitere Informationen finden Sie unter Auf Sitzung über Jetpack SceneCore zugreifen.

xrSession.scene.requestHomeSpaceMode()
ModeTransition.kt

Im Codelab Android XR-Grundlagen: Teil 1 – Modi und räumliche Panels finden Sie Beispiele dafür, wie Sie diese Anfragen verwenden können, um durch Klicken auf eine Schaltfläche zwischen Modi zu wechseln. Wir empfehlen Ihnen außerdem, unsere Designrichtlinien zu lesen, um mehr über die Übergänge zwischen dem Home- und dem Vollbildmodus zu erfahren.

Standardmodus für den Start deklarieren

Alternativ können Sie Ihrer Android-Manifestdatei die folgenden Zeilen hinzufügen, um festzulegen, in welchem Bereich 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" />

Siehe auch