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 im Abschnitt Standardmodus für den Start angeben nichts anderes angeben.

Raumklang wird nur im Vollbildmodus unterstützt. Ihre App kann zu „Full Space“ wechseln, um die Vorteile von räumlichen 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()

Wenn Sie die Jetpack SceneCore-Bibliothek verwenden, können Sie den entsprechenden Speicherplatz über die Session anfordern.

val xrSession = Session.create(this)
xrSession.spatialEnvironment.requestHomeSpaceMode()

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 Startbildschirm und dem Vollbildmodus 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