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

Un utilisateur peut utiliser votre application dans deux modes : le mode d'affichage restreint et le mode d'affichage complet. Dans l'espace d'accueil, un utilisateur peut effectuer plusieurs tâches en même temps, car votre application s'exécute côte à côte avec d'autres applications. En mode d'affichage 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.

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

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

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

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

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

Si vous utilisez la bibliothèque Jetpack SceneCore, vous pouvez demander l'espace correspondant à partir de Session.

val xrSession = Session.create(this)
xrSession.spatialEnvironment.requestHomeSpaceMode()

Consultez l'atelier de programmation Principes de base d'Android XR: Partie 1 – Modes et panneaux spatiaux pour découvrir comment utiliser 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 le passage de l'espace d'accueil à l'espace 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