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

Un utilisateur peut découvrir votre application dans deux modes : le mode d'affichage restreint ou le mode d'affichage complet. Dans l'espace Maison, un utilisateur peut effectuer plusieurs tâches en exécutant votre application côte à côte avec d'autres applications. En mode d'affichage complet, votre application est au centre de l'expérience de l'utilisateur et a un accès complet aux fonctionnalités immersives d'Android XR.

Votre application s'ouvre par défaut dans l'espace Maison, sauf si vous spécifiez le contraire, comme décrit dans la section Déclarer le mode de lancement par défaut.

La spatialisation n'est disponible que dans l'espace complet. Votre application peut passer en mode d'affichage complet pour profiter des fonctionnalités spatiales et 3D. Lorsque votre application est au premier plan, vous pouvez passer d'un mode à l'autre en demandant l'espace correspondant.

Transition entre l'espace restreint et l'espace complet

Si vous utilisez la bibliothèque Jetpack Compose pour XR, demandez l'espace de la maison ou l'espace complet à l'aide de la composition locale LocalSpatialConfiguration.

LocalSpatialConfiguration.current.requestHomeSpaceMode()
// or
LocalSpatialConfiguration.current.requestFullSpaceMode()
ModeTransition.kt

Si vous utilisez la bibliothèque Jetpack SceneCore, vous pouvez demander l'espace correspondant à partir de Session. Pour en savoir plus, consultez Accéder à la session depuis Jetpack SceneCore.

xrSession.scene.requestHomeSpaceMode()
ModeTransition.kt

Consultez l'atelier de programmation Principes de base d'Android XR : Partie 1 – Modes et panneaux spatiaux pour obtenir des exemples d'utilisation de ces requêtes pour passer d'un mode à l'autre en cliquant sur un bouton. Nous vous recommandons également de consulter nos conseils de conception pour en savoir plus sur les modes d'affichage restreint et complet, et sur la meilleure façon de passer de l'un à l'autre.

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

Vous pouvez également ajouter les lignes suivantes à votre fichier manifeste Android pour choisir l'espace dans lequel votre application doit s'ouvrir :

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