Jetpack Compose pour XR inclut divers composants spatialisés pour vous aider à créer une UI et des mises en page spatiales pour votre application.
Composables Subspace
Les composables de sous-espace sont un type spécial de composants spatialisés qui ne peuvent être affichés que dans un sous-espace et doivent être entourés de Subspace avant d'être placés dans une mise en page 2D. Un SubspaceModifier vous permet d'ajouter des attributs tels que la profondeur, le décalage et le positionnement à vos composables de sous-espace.
Autres composants spatialisés
Les autres composants spatialisés ne nécessitent pas d'être appelés dans un sous-espace. Ils se composent d'éléments 2D conventionnels encapsulés dans un conteneur spatial. Ces éléments peuvent être utilisés dans des mises en page 2D ou 3D s'ils sont définis pour les deux. Lorsque la spatialisation n'est pas activée, leurs fonctionnalités spatialisées sont ignorées et elles reviennent à leurs équivalents 2D.
Les composants spatialisés peuvent être placés n'importe où dans la hiérarchie de l'interface utilisateur de votre application. Ces éléments peuvent être réutilisés dans votre UI 2D, et leurs attributs spatiaux ne sont visibles que lorsque les fonctionnalités spatiales sont activées. Vous pouvez ainsi ajouter une élévation aux menus, aux boîtes de dialogue et à d'autres composants sans avoir à écrire votre code deux fois. Voici quelques exemples de la façon dont différents composants spatialisés modifient leur comportement lorsque la spatialisation est activée ou non :
Composant spatialisé |
Lorsque la spatialisation est activée |
Dans un environnement 2D |
|---|---|---|
|
Le panneau recule légèrement en profondeur Z pour afficher une boîte de dialogue surélevée |
Retourne à la 2D |
|
Le panneau recule légèrement sur l'axe Z pour afficher un pop-up surélevé |
Utilise un |
|
|
Indique des tendances ordinaires sans augmentation inattendue. |
Guides
Cette section comprend les guides du développeur suivants :