Von Home Space zu Full Space wechseln

Nutzer können Ihre App in zwei Modi verwenden: im Home Space oder im Full Space. In 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.

Raumklang wird derzeit nur im Vollbildmodus unterstützt. Ihre App kann auf „Full Space“ umgestellt werden, um die Vorteile von Spatial Audio und 3D-Funktionen zu nutzen. Wenn Ihre App den Fokus hat, können Sie zwischen diesen Modi wechseln, indem Sie den entsprechenden Modus von der XR-Sitzung anfordern.

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

Zwischen Home Space und Full Space wechseln

Wenn Sie zwischen dem Home Space und dem Full Space wechseln möchten, müssen Sie den Betriebsmodus über die Session anfordern. Wie im folgenden Beispiel gezeigt, können Sie diese Anfragen verwenden, damit Nutzer durch Klicken auf eine Schaltfläche zwischen den Modi wechseln können.

@Composable
private fun HomeSpaceFullSpaceToggleButton() {
    val xrSession = checkNotNull(LocalSession.current)

    val uiIsSpatialized = LocalSpatialCapabilities.current.isSpatialUiEnabled
    val toggleModes = if (uiIsSpatialized) {
        { xrSession.requestHomeSpaceMode() }
    } else {
        { xrSession.requestFullSpaceMode() }
    }

    IconButton(
        onClick = {
            toggleModes()
        }
    ) {
        Icon(
            painter = painterResource(id = drawable),
            contentDescription = stringResource(contentDescription)
        )
    }
}

In den Designrichtlinien erfahren Sie mehr über den Wechsel zwischen dem Startbildschirm und dem Vollbildschirm und wie Sie diesen am besten gestalten.

Standardmodus für den Start angeben

Wenn Sie festlegen möchten, ob Ihre App im Home Space oder im Full Space gestartet wird, fügen Sie Ihrer Android-Manifestdatei die folgenden Zeilen hinzu:

// 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