Jetpack Compose pour la XR

Créez de manière déclarative des mises en page d'UI spatiales qui exploitent les fonctionnalités spatiales d'Android XR.
Dernière mise à jour Version stable Version finale Version bêta Version alpha
12 décembre 2024 - - - 1.0.0-alpha01

Déclarer des dépendances

Pour ajouter une dépendance à XR Compose, vous devez ajouter le dépôt Maven de Google à votre projet. Pour en savoir plus, consultez la section Dépôt Maven de Google.

Ajoutez les dépendances correspondant aux artefacts dont vous avez besoin dans le fichier build.gradle de votre application ou de votre module :

Groovy

dependencies {
    implementation "androidx.xr.compose:compose:1.0.0-alpha01"

    // Use to write unit tests
    testImplementation "androidx.xr.compose:compose-testing:1.0.0-alpha01"
}

Kotlin

dependencies {
    implementation("androidx.xr.compose:compose:1.0.0-alpha01")

    // Use to write unit tests
    testImplementation("androidx.xr.compose:compose-testing:1.0.0-alpha01")
}

Pour en savoir plus sur les dépendances, consultez Ajouter des dépendances de compilation.

Commentaires

Vos commentaires nous aident à améliorer Jetpack. N'hésitez pas à nous contacter si vous découvrez de nouveaux problèmes ou si vous avez des idées pour améliorer cette bibliothèque. Veuillez consulter les problèmes existants de cette bibliothèque avant d'en signaler un nouveau. Vous pouvez ajouter votre vote à un problème existant en cliquant sur le bouton en forme d'étoile.

Signaler un nouveau problème

Pour en savoir plus, consultez la documentation sur l'outil Issue Tracker.

Version 1.0

Version 1.0.0-alpha01

12 décembre 2024

Publication d'androidx.xr.compose:compose-*1.0.0-alpha01.

Fonctionnalités de la version initiale

  • Version initiale de Jetpack Compose pour XR destinée aux développeurs. Utilisez des concepts Compose familiers tels que les lignes et les colonnes pour créer des mises en page d'interface utilisateur spatiales dans la réalité XR, que vous portiez une application 2D existante vers la réalité XR ou que vous créiez une application XR à partir de zéro. Cette bibliothèque fournit des composables spatiaux et sous-espaces, tels que des panneaux et des orbiteurs spatiaux, qui vous permettent de placer votre UI 2D Compose ou basée sur Views existante dans une mise en page spatiale. Il introduit le composable de sous-espace Volume, qui vous permet de placer des entités SceneCore, telles que des modèles 3D, par rapport à votre UI. Pour en savoir plus, consultez ce guide du développeur:

    • Subspace: ce composable peut être placé n'importe où dans la hiérarchie de l'UI de votre application. Vous pouvez ainsi gérer les mises en page pour l'UI 2D et l'UI spatiale sans perdre de contexte entre les fichiers. Cela permet de partager plus facilement des éléments tels que l'architecture d'application existante entre la RA et d'autres facteurs de forme, sans avoir à hisser l'état dans l'ensemble de l'arborescence de l'UI ni à réarchitecturer votre application.

    • SpatialPanel: un panneau spatial est un composable de sous-espace qui vous permet d'afficher le contenu de l'application. Par exemple, vous pouvez afficher la lecture d'une vidéo, des images fixes ou tout autre contenu dans un panneau spatial.

    • Orbiteur: un orbiteur est un composant d'UI spatial. Il est conçu pour être associé à un panneau spatial correspondant et contient des éléments de navigation et d'action contextuelle liés à ce panneau spatial. Par exemple, si vous avez créé un panneau spatial pour afficher du contenu vidéo, vous pouvez ajouter des commandes de lecture vidéo dans un orbiteur.

    • Volume: placez les entités SceneCore, telles que les modèles 3D, par rapport à votre UI.

  • Mise en page spatiale : vous pouvez créer plusieurs panneaux spatiaux et les placer dans une mise en page spatiale à l'aide de SpatialRow, SpatialColumn, SpatialBox et SpatialLayoutSpacer. Utilisez des SubspaceModifier pour personnaliser votre mise en page.

  • Composants d'interface utilisateur spatiale: ces éléments peuvent être réutilisés dans votre interface utilisateur 2D. Leurs attributs spatiaux ne seront visibles que lorsque les fonctionnalités spatiales seront activées.

    • SpatialDialog: le panneau recule légèrement en profondeur pour afficher une boîte de dialogue surélevée.
    • SpatialPopUp: le panneau est légèrement repoussé en arrière dans la profondeur de champ pour afficher un pop-up surélevé.
    • SpatialElevation: SpatialElevationLevel peut être défini pour ajouter l'altitude.

  • SpatialCapabilities: les fonctionnalités spatiales peuvent changer à mesure que les utilisateurs interagissent avec votre application ou le système, ou même être modifiées par votre application elle-même (par exemple, en passant à l'espace "Home" ou "Full"). Pour éviter les problèmes, votre application doit rechercher LocalSpatialCapabilities.current pour déterminer quelles API sont compatibles avec l'environnement actuel. isSpatialUiEnabled: Éléments d'interface utilisateur spatialisée (par exemple, SpatialPanel) isContent3dEnabled: Objets 3D isAppEnvironmentEnabled: Environnement isPassthroughControlEnabled: Indique si l'application peut contrôler l'état de passthrough isSpatialAudioEnabled: Son spatialisé

Problèmes connus

  • Actuellement, un SDK minimal de 30 est requis pour utiliser Jetpack Compose pour XR. Pour contourner ce problème, vous pouvez ajouter l'entrée de fichier manifeste <uses-sdk tools:overrideLibrary="androidx.xr.scenecore, androidx.xr.compose"/> suivante afin de pouvoir compiler et exécuter avec un SDK minimal de 23.
  • Les applications Jetpack XR nécessitent actuellement de demander l'autorisation android.permission.SCENE_UNDERSTANDING dans le fichier AndroidManifest.
  • Lorsqu'une application se lance directement dans l'espace complet à l'aide de la propriété PROPERTY_XR_ACTIVITY_START_MODE dans son fichier manifeste, les activités/applications sont initialement ouvertes dans l'espace d'accueil avant de passer à l'espace complet.
  • Les glTF dans les composables de volume peuvent initialement clignoter au mauvais endroit.
  • L'utilisation d'un SpatialDialog dans un panneau qui a été déplacé de manière importante entraînera le déplacement du contenu dans la mauvaise direction.