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

Appareils XR concernés
Ces conseils vous aident à créer des expériences pour ces types d'appareils XR.
En savoir plus sur les types d'appareils XR →
Casques XR
Lunettes XR filaires
En savoir plus sur les types d'appareils XR →

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

Votre application s'ouvre par défaut en mode Home Space, sauf indication contraire, comme décrit dans la section Déclarer le mode par défaut pour le lancement.

La spatialisation n'est compatible qu'en mode Full Space. Votre application peut passer en mode Full Space 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.

Utiliser SpaceToggleButton pour basculer entre Home Space et Full Space

Pour passer de Home Space à Full Space, utilisez le SpaceToggleButton composable de la bibliothèque Material Design pour XR.

Il s'agit d'un bouton composable qui s'adapte au mode spatial actuel et bascule entre Full Space et Home Space.

Créer une transition personnalisée entre Home Space et Full Space

Si vous utilisez la bibliothèque Jetpack Compose pour XR, demandez l'espace Home Space ou Full Space à l'aide du LocalSession local de composition.

val session = LocalSession.current ?: return
session.scene.requestHomeSpace()
// or
session.scene.requestFullSpace()

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

xrSession.scene.requestHomeSpace()

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 afin de 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 Home Space à Full Space 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" />

Voir aussi