Passare dallo spazio Home a quello intero

Un utente può utilizzare la tua app in due modalità: Spazio domestico o Spazio completo. In Spazio domestico, un utente può eseguire il multitasking con la tua app affiancata ad altre app. In Full Space, la tua app è al centro dell'esperienza dell'utente, con accesso completo alle funzionalità immersive di Android XR.

La spazializazione è attualmente supportata solo in Spazio intero. La tua app può passare allo spazio completo per sfruttare le funzionalità spaziali e 3D. Quando l'app ha il focus, puoi passare da una modalità all'altra richiedendo la modalità corrispondente dalla sessione XR.

L'app si apre nello spazio Home per impostazione predefinita, a meno che non specifichi diversamente come descritto nella sezione Dichiarare la modalità predefinita per l'avvio.

Passare dallo spazio Home allo spazio intero

Per passare dallo spazio Home Space allo spazio Full Space, devi richiedere la modalità di funzionamento da Session. Come mostrato nell'esempio seguente, puoi utilizzare queste richieste in modo che l'utente possa passare da una modalità all'altra facendo clic su un pulsante.

@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)
        )
    }
}

Consulta le linee guida per il design per scoprire di più sullo spazio Home e sullo spazio Completo e su come passare al meglio da uno all'altro.

Dichiarare la modalità predefinita per l'avvio

Per scegliere se l'app deve essere avviata nello spazio Home o nello spazio intero, aggiungi le seguenti righe al file Android Manifest:

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

Vedi anche