Passer du mode d'affichage restreint au mode d'affichage complet

Un utilisateur peut utiliser votre application dans deux modes : Home Space ou Full Space. Dans Home Space, un utilisateur peut effectuer plusieurs tâches à la fois avec votre application exécutée côte à côte avec d'autres applications. Dans l'espace complet, votre application est au centre de l'expérience utilisateur et dispose d'un accès complet aux fonctionnalités immersives d'Android XR.

La spatialisation n'est actuellement disponible que dans l'espace complet. Votre application peut passer en mode Full Space pour profiter des fonctionnalités spatiales et 3D. Lorsque votre application est sélectionnée, vous pouvez passer d'un mode à l'autre en demandant le mode correspondant à partir de la session XR.

Votre application s'ouvre dans l'espace maison par défaut, sauf si vous indiquez le contraire, comme décrit dans la section Déclarer le mode par défaut pour le lancement.

Transition entre l'espace d'accueil et l'espace complet

Pour passer du mode Espace maison au mode Espace complet, vous devez demander le mode de fonctionnement à Session. Comme indiqué dans l'exemple suivant, vous pouvez utiliser ces requêtes pour que votre utilisateur puisse passer d'un mode à l'autre en cliquant sur un bouton.

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

Consultez les consignes de conception pour en savoir plus sur l'espace d'accueil et l'espace complet, et découvrir comment passer de l'un à l'autre.

Déclarer le mode par défaut pour le lancement

Pour choisir si votre application se lance dans l'espace Home ou Full Space, ajoutez les lignes suivantes à votre fichier manifeste Android:

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

Voir aussi