{ } { }

Jetpack SceneCore

Créez et manipulez le graphe de scène Android XR avec du contenu 3D.
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 SceneCore, 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.scenecore:scenecore:1.0.0-alpha01"
    // Required for Java
    implementation "com.google.guava:listenableFuture:1.0"
    // Required for Kotlin
    implementation "org.jetbrains.kotlinx:kotlinx-coroutines-guava:1.9.0"

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

Kotlin

dependencies {
    implementation("androidx.xr.scenecore:scenecore:1.0.0-alpha01")
    // Required for Java
    implementation("com.google.guava:listenableFuture:1.0")
    // Required for Kotlin
    implementation("org.jetbrains.kotlinx:kotlinx-coroutines-guava:1.9.0")

    // Use to write unit tests
    testImplementation("androidx.xr.scenecore:scenecore-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.scenecore:scenecore-* 1.0.0-alpha01.

Fonctionnalités de la version initiale Version initiale pour les développeurs de Jetpack SceneCore, une bibliothèque de graphes de scène 3D permettant de créer et de manipuler des scènes et des environnements immersifs. Cette bibliothèque vous permet de placer et d'organiser des modèles 3D et des panneaux de contenu les uns par rapport aux autres et par rapport à vos environnements virtuels ou réels.

  • SpatialEnvironment: créez des expériences entièrement immersives avec une image de ciel et/ou une géométrie de modèle 3D comme toile de fond pour votre scène XR de votre environnement. Vous pouvez également activer le passthrough pour que votre scène virtuelle puisse s'intégrer à l'environnement réel de l'utilisateur.
  • PanelEntity: ajoutez du contenu 2D à vos scènes 3D en intégrant des mises en page et des activités Android standards dans des panneaux spatialisés pouvant flotter ou être ancrés à des surfaces réelles.
  • GltfModelEntity: placez, animez et interagissez avec des modèles 3D dans votre scène. SceneCore est compatible avec le format de fichier glTF pour faciliter l'intégration aux modèles existants.
  • SpatialAudio: ajoutez des sources audio ambiantes et ponctuelles à votre scène 3D pour un son spatialisé et immersif.
  • StereoSurfaceEntity: SceneCore prend en charge le routage des contenus affichés sur une surface Android pour les yeux gauche et droit. Vous pouvez l'utiliser pour afficher du contenu stéréoscopique dans un format côte à côte ou haut/bas, comme des photos stéréo, des vidéos 3D ou d'autres UI affichées de manière dynamique. Les applications doivent utiliser MediaPlayer ou ExoPlayer pour le décodage vidéo.
  • Système de composants: SceneCore propose un système de composants robuste et flexible pour ajouter des fonctionnalités à votre contenu XR, y compris des affordances permettant aux utilisateurs de déplacer, redimensionner et interagir avec des modèles et des panneaux.
  • Ancrage: lorsque le passthrough est activé, vous pouvez attacher des panneaux et des modèles à des surfaces réelles, ce qui permet aux utilisateurs d'intégrer facilement des contenus virtuels à leur environnement réel.
  • Posture de l'utilisateur: accédez à la position de l'utilisateur dans la scène virtuelle pour orienter votre contenu en fonction de sa position.
  • SpatialCapabilities: créez des applications entièrement adaptatives qui exploitent les fonctionnalités spatialisées lorsqu'elles sont disponibles, comme le positionnement 3D du contenu de l'interface utilisateur. De plus, votre application peut surveiller les modifications apportées aux fonctionnalités pendant son exécution afin de modifier l'expérience en fonction de la façon dont l'utilisateur utilise son appareil Android XR.

Problèmes connus

  • Actuellement, un SDK minimal de 30 est requis pour utiliser Jetpack SceneCore. Pour contourner ce problème, ajoutez 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 min de 23.
  • La session peut devenir non valide dans diverses situations qui recréent automatiquement l'activité, y compris en redimensionnant un panneau principal, en connectant des périphériques et en passant du mode clair au mode sombre. Si vous rencontrez des problèmes d'invalidation de session, vous pouvez contourner le problème en rendant votre panneau principal non redimensionnable, en utilisant une entité de panneau dynamique, en désactivant la recréation d'activité pour des modifications de configuration spécifiques ou en désactivant les modifications de thème en mode clair/sombre.
  • Les composants mobiles et redimensionnables ne sont pas compatibles avec GltfEntity.
  • Entity.getSize() n'est pas compatible avec GltfEntity.
  • Les applications Jetpack XR doivent demander l'autorisation android.permission.SCENE_UNDERSTANDING dans AndroidManifest.
  • La création d'une session n'est possible que sur un appareil Android XR. Pour le moment, si vous créez une session et que vous essayez de l'utiliser sur un appareil XR autre qu'Android, vous obtiendrez une exception RuntimeException.
  • Définir la skybox sur "null" via "SpatialEnvironment.setSpatialEnvironmentPreference()" ne génère pas de skybox noire unie, comme indiqué dans la documentation. Il est possible que le ciel par défaut du système soit utilisé ou qu'aucune modification ne soit apportée au ciel actuel.
  • Les clients SceneCore doivent ajouter implementation(“com.google.guava:listenablefuture-1.0”) à leur configuration Gradle pour les dépendances de leur application. Dans une prochaine version, Scenecore inclura cette bibliothèque en tant que dépendance api. Les clients n'auront donc pas besoin de la déclarer explicitement.
  • SceneCore inclut par erreur com.google.guava:guava-31.1-android et com.google.protobuf:protobuf-javalite comme dépendances transitives. Si cela entraîne des erreurs de classe en double dans votre compilation, ces deux dépendances peuvent être exclues en toute sécurité.
  • Si votre application utilise SceneCore et active ProGuard, elle plantera lorsque vous créerez une session. Pour contourner ce problème, désactivez ProGuard. Pour savoir comment activer ProGuard, consultez ce guide.