Von Home Space zu Full Space wechseln

Nutzer können Ihre App in zwei Modi verwenden: „Home Space“ oder „Full Space“. Im Home Space kann ein Nutzer mehrere Aufgaben gleichzeitig ausführen, während Ihre App neben anderen Apps ausgeführt wird. Im Full Space steht Ihre App im Mittelpunkt und bietet Nutzern 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.

Übergang zwischen Home Space und Full Space

Wenn Sie die Jetpack Compose for XR-Bibliothek verwenden, fordern Sie den Home- oder den vollständigen Bereich mit dem Kompositionslokal LocalSpatialConfiguration 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 Full-Space-Modus 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_MANAGED" />

Siehe auch