Von Home Space zu Full Space wechseln

Nutzer können Ihre App in zwei Modi verwenden: im Home Space oder im Full Space. Im Home Space können Nutzer mit Ihrer App neben anderen Apps Multitasking betreiben. Im Vollraum steht Ihre App im Mittelpunkt der Nutzererfahrung und bietet vollen Zugriff auf die immersiven Funktionen von Android XR.

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

Raumklang wird nur im Vollbildmodus unterstützt. Ihre App kann auf „Full Space“ umgestellt werden, 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.

Zwischen Home Space und Full Space wechseln

Wenn Sie die Jetpack Compose for XR-Bibliothek verwenden, fordern Sie den privaten oder den gesamten Bereich mit der LocalSpatialConfiguration-Komposition lokal 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 Sitzungen über Jetpack SceneCore zugreifen.

xrSession.scene.spatialEnvironment.requestHomeSpaceMode()
ModeTransition.kt

Im Codelab Android XR-Grundlagen kennenlernen: Teil 1 – Modi und räumliche Steuerfelder finden Sie Beispiele dafür, wie Sie mithilfe dieser Anfragen durch Klicken auf eine Schaltfläche zwischen den Modi wechseln können. Wir empfehlen Ihnen außerdem, unsere Designrichtlinien zu lesen, um mehr über den Wechsel zwischen dem Home-Bereich und dem Full-View-Modus zu erfahren.

Standardmodus für den Start angeben

Alternativ können Sie der Android-Manifestdatei die folgenden Zeilen hinzufügen, um auszuwählen, in welchem Gruppenbereich 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_MANAGED" />

Siehe auch