Cette page a été traduite par l'API Cloud Translation.

Jetpack SceneCore

Documentation de référence de l'API
androidx.xr.scenecore
androidx.xr.scenecore.testing

Créez et manipulez le graphique de scène Android XR avec du contenu 3D.

Dernière mise à jour	Version stable	Version finale	Version bêta	Version alpha
30 juillet 2025	-	-	-	1.0.0-alpha05

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-alpha05"
    // 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-alpha05"
}

Kotlin

dependencies {
    implementation("androidx.xr.scenecore:scenecore:1.0.0-alpha05")
    // 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-alpha05")
}

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-alpha05

30 juillet 2025

Publication d'androidx.xr.scenecore:scenecore-guava:1.0.0-alpha05, androidx.xr.scenecore:scenecore-testing:1.0.0-alpha05 et androidx.xr.scenecore:scenecore:1.0.0-alpha05. La version 1.0.0-alpha05 contient ces commits.

Nouvelles fonctionnalités

Ajout de l'API Perceived Resolution aux entités de panneau et à SurfaceEntities. (I118f6)
Méthodes de rappel PerceivedResolution ajoutées à Scene.kt pour surveiller la résolution perçue du panneau principal de l'activité dans HSM. (I58084)
SurfaceEntity : ajout de la compatibilité pour que l'application demande le supersampling au moment de la création. Cela permet aux applications d'utiliser un filtre de suréchantillonnage pour l'anticrénelage. (I06913)
La propriété recommendedContentBoxInFullSpace a été ajoutée à ActivitySpace. Elle renvoie une boîte recommandée pour le contenu à placer en mode d'affichage complet. (I4cd6f)
Fourni un constructeur surchargé pour le modificateur déplaçable qui permet l'ancrage. (Ic0c70)

Modifications apportées à l'API

De nombreuses modifications ont été apportées à l'API SceneCore pour cette version. Plusieurs classes ont été renommées et/ou déplacées vers différents modules, et la plupart des méthodes getter/setter ont été remplacées par des propriétés Kotlin. Bien que nous prévoyions d'autres modifications destructives de l'API avant notre première version bêta, elles ne seront pas aussi perturbantes ni aussi nombreuses.

Les classes et interfaces suivantes ont été renommées et/ou déplacées : androidx.xr.scenecore.PixelDimensions vers androidx.xr.runtime.math.IntSize2d ; androidx.xr.scenecore.Dimensions vers androidx.xr.runtime.math.FloatSize3d ; androidx.xr.scenecore.ActivityPose vers ScenePose, androidx.xr.scenecore.ContentlessEntity vers GroupEntity, androidx.xr.scenecore.PlaneType vers PlaneOrientation ; androidx.xr.scenecore.PlaneSemantic vers PlaneSemanticType. (Ifd405)(I3b622) (If534d)
Un certain nombre de setters pour les propriétés de Scene ont été définis comme privés. Ils n'étaient pas destinés à être modifiés par les clients SceneCore : activitySpace, activitySpaceRoot, mainPanelEntity, perceptionSpace, spatialCapabilities, spatialEnvironment et spatialUser. (I2f506)
Dans l'entité : les éléments suivants sont devenus des propriétés : get/setParent(), setContentDescription. Entity.is/setHidden() est obsolète, utilisez Entity.is/setEnabled à la place. (Ibc4c6)
La classe androidx.xr.scenecore.BasePanelEntity a été supprimée. Utilisez directement PanelEntity à la place. Remplacement des getters et setters pour PanelEntity par des propriétés. La propriété PanelEntity.size est passée de Float3dSize à Float2dSize. Suppression de la méthode obsolète androidx.xr.scenecore.PanelEntity.getPixelDimensions. Utilisez plutôt getSizeInPixels. (Icc174)
androidx.xr.scenecore.OnSpaceUpdatedListener a été remplacé par Runnable. (I19308)
Remplacement de SpatialUser.getCameraViews() par une propriété. (Ib0cc5) Pour ExrImage et GltfModel:, les méthodes create ont été modifiées pour devenir des fonctions de suspension. Les paramètres de création ont été modifiés pour accepter un Uri ou un Path au lieu d'un String. (Id8883) (I0d247), (I25706)
SpatialEnvironment.requestFullSpaceMode et SpatialEnvironment.requestHomeSpaceMode ont été déplacés vers "Scene". Par exemple, utilisez session.scene.requestFullSpaceMode() au lieu de session.scene.spatialEnvironment.requestFullSpaceMode(). addOnPassthroughOpacityChangedListener et addOnSpatialEnvironmentChangedListener disposent désormais de remplacements qui acceptent les exécuteurs facultatifs. (I12fe0) (I6b21e)
Suppression des méthodes SpatialEnvironment obsolètes suivantes : togglePassthrough, setPassthrough, setPassthroughOpacity, getPassthroughMode, getPassthroughOpacity, setSkybox et setGeometry. Suppression de la classe obsolète SpatialEnvironment.PassthroughMode (I927bd) (I927bd) (I927bd)
Remplacement des getters et setters SpatialEnvironment suivants par des propriétés Kotlin : getCurrentPassthroughOpacity(), get/setPassthroughOpacityPreference(), get/setSpatialEnvironmentPreference(), isSpatialEnvironmentPreferenceActive() (I33a7b) (Ie06e2) (Ie06e2)
Le type de SpatialEnvironmentPreference.preferredPassthroughOpacity est passé de Float? à Float. Il n'accepte plus les valeurs nulles. À la place, SpatialEnvironment.NO_PASSTHROUGH_OPACITY_PREFERENCE est utilisé pour indiquer qu'il n'y a pas de préférence d'opacité. (I40107)
Mise à jour du paramètre windowBoundsPx sur pixelDimensions et de son type de Rect à IntSize2d dans la méthode create. (I1926e)
Le constructeur SpatialEnvironment est désormais interne (I75a51).
Remplacement des classes SpatialPointerIconNone et SpatialPointerIconCircle par les objets compagnons SpatialPointerIcon.NONE et SpatialPointerIcon.CIRCLE (I416d2)
SpatialPointerIcon dans SpatialPointerComponent n'est plus nullable. Utilisez SpatialPointerIcon.DEFAULT au lieu de null pour indiquer que l'icône de pointeur système par défaut doit être utilisée. (I416d2)
androidx.xr.scenecore.AnchorEntity.getState() a été remplacé par une propriété en lecture seule. Les paramètres de la méthode AnchorEntity.create() ont été renommés pour plus de clarté. Dans les méthodes de AnchorEntity pour définir et ajouter des écouteurs, l'écouteur a été déplacé vers le dernier argument pour activer les lambdas de fin. androidx.xr.scenecore.OnStateChangedListener pour AnchorEntity a été remplacé par Consumer<AnchorEntity.State>. (I472e0)
GltfModelEntity.getAnimationState() est désormais une propriété. (I10b29)
Remplacement de ActivitySpace.getBounds() par une propriété. ActivitySpace.addBoundsChangedListener a été renommé ActivitySpace.addOnBoundsChangedListener. Remplacement de ActivitySpace.setOnSpaceUpdatedListener par des méthodes d'ajout/de suppression. (I4c956)
Pour AnchorPlacement: planeTypeFilter, anchorablePlaneOrientations a été renommé planeSemanticFilter et anchorablePlaneSemanticTypes. L'ajout d'un MovableComponent à un AnchorEntity ou un ActivitySpace renverra la valeur "false". MoveListener a été renommé EntityMoveListener shouldDisposeParentAnchor, qui a lui-même été renommé disposeParentOnReAnchor systemMovable et supprimé de la fonction create au profit de creeateCustomMovable, createSystemMovable et createAnchorable (If11c4).
Suppression de SurfaceEntity.featherRadiusX/Y et ajout d'un concept de classe EdgeFeatheringParams. (Ic78fc)
La méthode PanelEntity.enablePanelDepthTest() a été remplacée par la propriété panelClippingConfig. Définissez Scene.panelClippingConfig = PanelClippingConfig(isDepthTestEnabled = true) sur PanelClippingConfig(isDepthTestEnabled = false) pour activer le test de profondeur ou sur PanelClippingConfig(isDepthTestEnabled = false) pour le désactiver. (I0cbe0)
Scene.mainPanelEntity est désormais de type MainPanelEntity au lieu de PanelEntity (I7125a)
Les méthodes setFullSpaceMode et setFullSpaceModeWithEnvironmentInherited de Scene ont été renommées configureBundleForFullSpaceModeLaunch et configureBundleForFullSpaceModeLaunchWithEnvironmentInherited. (I0cbe0) (I0cbe0)
Les valeurs UNKNOWN, OUTSIDE_FOV, PARTIALLY_WITHIN_FOV et WITHIN_FOV de SpatialVisibility ont été renommées SPATIAL_VISIBILITY_UNKNOWN, SPATIAL_VISIBILITY_OUTSIDE_FIELD_OF_VIEW, SPATIAL_VISIBILITY_PARTIALLY_WITHIN_FIELD_OF_VIEW et SPATIAL_VISIBILITY_WITHIN_FIELD_OF_VIEW, respectivement (Ie7e8c).
La classe SpatialVisibility a été remplacée par un objet public avec des valeurs int constantes. setSpatialVisibilityChangedListener accepte désormais Consumer<Int> au lieu de Consumer<SpatialVisibility> (Ie7e8c).
Les constantes PointerCaptureComponent ont été renommées et déplacées vers l'objet PointerCaptureComponent.PointerCaptureState (I9c7ac).
PointerCaptureComponents' StateListener a été remplacé par Consumer<Int>. (I9c7ac)
Remplacement de InputEventListener par Consumer<InputEvent>. (I9c7ac)
setPreferredAspectRatio a été déplacé de la classe Scene vers l'objet SpatialWindow et prend Session comme premier paramètre. (I7b717)
Entity.setHidden() remplacé par Entity.setEnabled() et Entity.isHidden() remplacé par Entity.isEnabled(). setHidden(false) est égal à setEnabled(true) et isHidden() == !isEnabled(). (Icf0de)
Le type de Entity.contentDescription est passé de String à CharSequence. (Ie59be)
Session.create et Session.configure génèrent désormais une SecurityException lorsque les autorisations suffisantes n'ont pas été accordées, au lieu de renvoyer SessionCreatePermissionsNotGranted ou SessionConfigurePermissionsNotGranted. (I7c488)
ResizableComponent.create nécessite désormais un Consumer<ResizeEvent> ResizeEventListener. Consumer<ResizeEvent> ResizableComponent.size a été remplacé par ResizableComponent.affordanceSize ResizableComponent.minimumSize, qui a été renommé ResizableComponent.minimumEntitySize ResizableComponent.maximumSize, qui a été renommé ResizableComponent.maximumEntitySize. ResizableComponent.autoHideContent a été renommé ResizableComponent.shouldAutoHideContent. ResizableComponent.forceShowResizeOverlay a été renommé ResizableComponent.shouldAlwaysShowOverlay. (I97a2d)
Réduction de minSDK à 24 pour androidx.xr.scenecore et androidx.xr.compose. Les packages XR nécessitent toujours l'API 34 au moment de l'exécution. (I17224)
Suppression de la restriction RequiresApi(34) sur tous les packages Jetpack XR. Cette restriction était redondante, car Jetpack XR n'est actuellement disponible que sur les appareils avec le niveau d'API 34 ou supérieur. (Iae0f8)
L'artefact SceneCore principal (xr:scenecore:scenecore) ne contiendra que des API asynchrones de style Kotlin. Les développeurs Java peuvent s'appuyer sur la bibliothèque xr:scenecore:scenecore-guava pour accéder aux API compatibles. (If221b)
Les projets publiés avec Kotlin 2.0 nécessitent KGP 2.0.0 ou version ultérieure pour être utilisés (Idb6b5).
Cette bibliothèque utilise désormais les annotations de nullité JSpecify, qui sont de type "type-use". Les développeurs Kotlin doivent utiliser l'argument de compilateur suivant pour garantir une utilisation correcte : -Xjspecify-annotations=strict (il s'agit de la valeur par défaut à partir de la version 2.1.0 du compilateur Kotlin) (Ia8420).
Toutes les méthodes asynchrones qui renvoient ListenableFuture ont été remplacées par des fonctions de suspension Kotlin. Les développeurs Java qui souhaitent utiliser des méthodes asynchrones basées sur ListenableFuture au lieu de fonctions de suspension Kotlin doivent désormais utiliser des fonctions d'extension dans :xr:scenecore-scenecore-guava. Par exemple, GuavaExrImage contient les fonctions asynchrones ExrImage équivalentes à Guava, GuavaScenePose contient les fonctions asynchrones ScenePose équivalentes à Guava, GuavaGltfModel contient les fonctions asynchrones Guava-equivalent GltfModel, etc. (If7283) (I0af60) (If7283) (Ia8515) (I4efdf) (I54bbf) (I3467a) (I82a33)

Correction de bugs

Mise à jour de la règle Jetpack XR Scenecore ProGuard pour empêcher AbstractMethodError pour les clients minimisés. (I91a01)
Corrections supplémentaires pour prendre en charge la minification Proguard pour Jetpack XR SceneCore (I4f47e)
Correction d'un bug qui pouvait entraîner un plantage si le hitPosition sur le HitInfo du InputEvent pouvait planter si le hitPosition renvoyé par le système était nul (I7a695).InteractableComponent
Les valeurs Config *Mode ont été renommées pour refléter leur comportement. (I6d247)
Correction des problèmes liés au champ de vision et à HitTest dans l'application de test SceneCore. (I2c51e)
Correction d'un bug dans SpatialCapabilities.hasCapability(), qui renvoyait "true" si l'une des fonctionnalités transmises avec un OR bit à bit était "true", au lieu de ne renvoyer "true" que si elles étaient toutes "true". (I2cd40)
SurfaceEntity.StereoMode.TOP_BOTTOM a été mis à jour pour que la carte du haut soit à gauche et celle du bas à droite. (I4ae68)

Version 1.0.0-alpha04

7 mai 2025

Publication d'androidx.xr.scenecore:scenecore:1.0.0-alpha04 et d'androidx.xr.scenecore:scenecore-testing:1.0.0-alpha04. La version 1.0.0-alpha04 contient ces commits.

Nouvelles fonctionnalités

La gestion du retour fonctionne désormais sur les entités de panneau sans activités intégrées. Pour que la gestion du retour fonctionne, vous devez spécifier android:enableOnBackInvokedCallback= "true" dans le fichier manifeste Android.
StereoSurfaceEntity est désormais compatible avec la lecture MV-HEVC grâce à deux nouvelles valeurs StereoMode : MULTIVIEW_LEFT_PRIMARY et MULTIVIEW_RIGHT_PRIMARY.
PanelEntity.setSize et PanelEntity.getSize renvoient désormais des tailles dans l'espace parent.
Entity.setPose, Entity.getPose, Entity.setScale, Entity.getScale, Entity.setAlpha et Entity.getAlpha acceptent désormais un nouveau paramètre relativeTo, qui permet d'obtenir/de définir des valeurs relatives à différents espaces. Les valeurs acceptées sont "Parent", "Activity" et "Real World". La valeur par défaut de ce paramètre est "Parent".
Des méthodes d'extension de rappel de visibilité spatiale ont été ajoutées à SessionExt.kt pour surveiller le moment où le contenu de la scène se déplace à l'intérieur ou à l'extérieur du champ de vision de l'utilisateur.
setPointSourceParams a été ajouté à SpatialAudioTrack, ce qui permet de mettre à jour les paramètres une fois la piste créée.
Ajout d'une nouvelle classe, Scene, avec des références aux API Scenecore. La scène sera accessible en tant que propriété d'extension de la session. Les fonctions à l'intérieur de SessionExt ont été déplacées vers "Scene". Les importations devront donc être ajustées (par exemple, SessionExt.getScene(session)).addSpatialCapababilitiesChangedListener contre SessionExt.addSpatialCapabilitiesChangedListener.
ActivityPose.hitTestAsync a été ajouté, ce qui permet de hitTest le contenu virtuel.
Ajout du nouveau type de composant SpatialPointerComponent, permettant aux clients de spécifier l'icône affichée pour le pointeur ou de la désactiver. Ce composant ne peut actuellement être associé qu'à des instances PanelEntity.
Présentation de la nouvelle usine PanelEntity, qui prend en compte les dimensions du panneau en mètres ou en pixels. L'ancienne usine PanelEntity qui acceptait deux paramètres de type Dimension pour le panneau a été supprimée.

Modifications apportées à l'API

Suppression de la restriction RequiresApi(34) sur tous les packages Jetpack XR. Cette restriction était redondante, car Jetpack XR n'est actuellement disponible que sur les appareils avec le niveau d'API 34 ou supérieur. (Iae0f8)
Les projets publiés avec Kotlin 2.0 nécessitent KGP 2.0.0 ou version ultérieure pour être utilisés (Idb6b5).
La classe PermissionHelper a été supprimée.
Abandon de PanelEntity.getPixelDensity.
PanelEntity.setPixelDimensions et PanelEntity.getPixelDimension sont supprimés et remplacés par setSizeInPixels et getSizeInPixels.
Entity.getActivitySpaceAlpha supprimé. Peut être remplacé par Entity.getAlpha(Space.Activity).
Entity.getWorldSpaceScale supprimé. Peut être remplacé par Entity.getScale(Space.REAL\_WORLD).
La classe Session dans SceneCore a été supprimée au profit de la session dans XR Runtime.
Le compte de service (StereoSurfaceEntity) a été renommé SurfaceEntity.
Entity.setSize et Entity.getSize ont été supprimés, et les mêmes méthodes ont été ajoutées à PanelEntity.
Le compte de service (PointSourceAttributes) a été renommé PointSourceParams.
Le compte de service (SpatializerConstants.SOURCE\_TYPE\_BYPASS) a été renommé SpatializerConstants.SOURCE\_TYPE\_DEFAULT.
L'accès à l'entité PointSourceParams est désormais interne au lieu d'être public.
AnchorEntity.create nécessite désormais la configuration de PlaneTrackingMode dans Session.configure().
Les API SpatialUser nécessitent désormais la configuration de HeadTrackingMode dans Session.configure().
Lorsque ResizableComponent n'est pas associé, un journal de niveau INFO est généré au lieu d'un journal de niveau ERROR.
La classe Fov est désormais une classe Kotlin standard.
Divisez Entity.kt pour placer chaque type d'entité concrète dans son propre fichier.
Lorsque vous créez un PanelEntity, la plupart des vues sont reparentées à un FrameLayout. Cela facilite l'utilisation de LayoutInspector avec les panneaux spatiaux.
L'instance XrExtensions actuellement utilisée est désormais enregistrée auprès de la plate-forme, de la meilleure façon possible, pour faciliter le débogage de l'application.

Correction de bugs

Une correction a été ajoutée pour éviter un plantage qui pouvait se produire lorsqu'un PanelEntity avec MovableComponent et AnchorPlacement était déplacé.
Correction d'un problème qui empêchait ResizableComponent de fournir des tailles obsolètes dans le rappel onResizeStart.
Correction du plantage lorsque dispose() de JxrPlatformAdapterAxr était appelé plusieurs fois.

Version 1.0.0-alpha03

26 février 2025

Publication d'androidx.xr.scenecore:scenecore:1.0.0-alpha03 et d'androidx.xr.scenecore:scenecore-testing:1.0.0-alpha03. La version 1.0.0-alpha03 contient ces commits.

Nouvelles fonctionnalités

La minification Proguard est désormais compatible avec le code Jetpack XR

Correction de bugs

Corrections supplémentaires pour la compatibilité de la minification Proguard pour Jetpack XR SceneCore (I4f47e)
Mise à jour de la règle Jetpack XR Scenecore ProGuard pour empêcher AbstractMethodError pour les clients minimisés. (I91a01)

Version 1.0.0-alpha02

12 février 2025

Publication d'androidx.xr.scenecore:scenecore:1.0.0-alpha02 et d'androidx.xr.scenecore:scenecore-testing:1.0.0-alpha02. La version 1.0.0-alpha02 contient ces commits.

Modification destructive à venir affectant les applications créées avant la version 1.0.0-alpha02

Les méthodes de fabrique ont été déplacées de la classe Session vers une méthode associée sur chaque type respectif :
- Session.createActivityPanelEntity(Dimensions, String, Activity, Pose) a été supprimé et remplacé par ActivityPanelEntity.create(Session, Dimensions, String, Pose)
- Session.createAnchorEntity(Anchor) a été supprimé et remplacé par AnchorEntity.create(Session, Anchor)
- Session.createAnchorEntity(Dimensions, Int, Int, Duration) a été supprimé et remplacé par AnchorEntity.create(Session, Dimensions, Int, Int, Duration)
- Session.createEntity(String, Pose) a été supprimé et remplacé par ContentlessEntity.create(Session, String, Pose)
- Session.createExrImageResource(String) a été supprimé et remplacé par ExrImage.create(Session, String)
- Session.createGltfEntity(GltfModel, Pose) a été supprimé et remplacé par GltfModelEntity.create(Session, GltfModel, Pose)
- Session.createGltfModelResource(String) a été supprimé et remplacé par GltfModel.create(Session, String)
- Session.createInteractableComponent(Executor, InputEventListener) a été supprimé et remplacé par InteractableComponent.create(Session, Executor, InputEventListener)
- Session.createMovableComponent(Boolean, Boolean, Set<AnchorPlacement>, Boolean) a été supprimé et remplacé par MovableComponent.create(Session, Boolean, Boolean, Set<AnchorPlacement>, Boolean)
- Session.createPanelEntity(View, Dimensions, Dimensions, String, Pose) a été supprimé et remplacé par PanelEntity.create(Session, View, Dimensions, Dimensions, String, Pose)
- Session.createResizableComponent(Dimensions, Dimensions) a été supprimé et remplacé par ResizableComponent.create(Session, Dimensions, Dimensions)
- Session.createStereoSurfaceEntity(Int, Dimensions, Pose) a été supprimé et remplacé par StereoSurface.create(Session, Int, Dimensions, Pose)
Les méthodes obsolètes suivantes ont été supprimées :
- Session.canEmbedActivityPanel(Activity) a été supprimé. Utilisez getSpatialCapabilities.hasCapabilility(SPATIAL_CAPABILITY_EMBED_ACTIVITY) à la place.
- Session.hasSpatialCapability(Int) a été supprimé. Il a été remplacé par getSpatialCapabilities().hasCapability(), qui permet de vérifier la présence de fonctionnalités spatiales de manière plus compartimentée, car getSpatialCapabilities() renvoie un objet SpatialCapabilities.
- Session.requestFullSpaceMode() a été supprimé et remplacé par SpatialEnvironment.requestFullSpaceMode()
- Session.requestHomeSpaceMode() a été supprimé et remplacé par SpatialEnvironment.requestHomeSpaceMode()
Session.setFullSpaceMode(Bundle) et Session.setFullSpaceModeWithEnvironmentInherited(Bundle) ont été déplacés vers les fonctions d'extension. Les fichiers du développeur devront ajouter les nouvelles importations pour l'accès :
- import androidx.xr.scenecore.setFullSpaceMode
- import androidx.xr.scenecore.setFullSpaceModeWithEnvironmentInherited
Session.setPreferredAspectRatio(Activity, Float) a été déplacé vers une fonction d'extension. Les fichiers du développeur devront ajouter la nouvelle importation pour l'accès :
- import androidx.xr.scenecore.setPreferredAspectRatio
Session.getEntitiesOfType(Class<out T>) et Session.getEntityForRtEntity(RtEntity) ont été déplacés vers les fonctions d'extension. Les fichiers du développeur devront ajouter les nouvelles importations pour l'accès :
- import androidx.xr.scenecore.getEntitiesOfType
- import androidx.xr.scenecore.getEntityForRtEntity
Session.unpersistAnchor(Anchor) a été supprimée
Session.createPersistedAnchorEntity(UUID) a été supprimée

Problèmes connus

PanelEntity.setCornerRadius() et ActivityPanelEntity.setCornerRadius() ne prendront peut-être effet qu'au prochain déplacement du panneau. Pour éviter cela, déplacez le panneau à sa position actuelle.
Lorsque BoundsChanged est appelé sur ActivitySpace, il est possible que certains ActivityPose n'aient pas été correctement mis à jour. Il sera mis à jour lors du prochain appel OnSpaceUpdated le ActivitySpace.

Modifications destructives et de comportement

PanelEntity et ActivityPanelEntity auront un rayon d'angle par défaut de 32 dp ou moins si le panneau a une largeur ou une hauteur inférieure à 32 dp.

Nouvelles API et fonctionnalités

Présentation de StereoSurface.CanvasShape, qui permet de créer des canevas Spherical et Hemispherical pour le rendu de contenus multimédias immersifs.
StereoSurfaceEntity.create() accepte désormais un paramètre CanvasShape. (Ce paramètre est actuellement ignoré, mais sera utilisé dans une prochaine version.)
StereoSurfaceEntity.create() n'accepte plus le paramètre Dimensions. Les applications doivent contrôler la taille du canevas en définissant CanvasShape.
StereoSurfaceEntity comporte un membre CanvasShape qui peut être défini de manière dynamique.
StereoSurfaceEntity.dimensions est désormais une propriété en lecture seule. Les applications doivent définir CanvasShape pour modifier les dimensions.
StereoSurfaceEntity permet désormais de redéfinir StereoMode après la construction.

Autres modifications

La valeur minSDK de compilation est désormais de 24. Toutes les API Jetpack XR continueront de nécessiter l'API 34 au moment de l'exécution.
La fabrique de sessions de SceneCore (Session.create) ne lance plus d'intent pour acquérir l'autorisation SCENE_UNDERSTANDING. Au lieu de cela, l'application cliente doit demander explicitement les autorisations à l'utilisateur avant de tenter de créer les ancres. La création d'ancres échouera si l'utilisateur n'accorde pas l'autorisation.

Corrections de bugs

getActivitySpacePose() a été corrigé pour tenir compte de l'échelle ActivitySpace en renvoyant des valeurs de translation en mètres mis à l'échelle plutôt qu'en mètres non mis à l'échelle. transformPoseTo utilise désormais également les bonnes unités pour calculer les changements de coordonnées lorsque ActivitySpace est impliqué dans la source ou la destination.
La skybox sera désormais définie sur une skybox entièrement noire chaque fois qu'une préférence de skybox nulle est transmise à l'aide de setSpatialEnvironmentPreference(new SpatialEnvironmentPreference(null, geom)). Pour rétablir la skybox et la géométrie par défaut du système, utilisez setSpatialEnvironmentPreference(null)..

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 graphiques 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, ainsi que par rapport à vos environnements virtuels ou réels.

SpatialEnvironment : créez des expériences entièrement immersives avec une image skybox et/ou une géométrie de modèle 3D comme toile de fond pour la scène XR de votre environnement. Vous pouvez également activer le mode Passthrough pour que votre scène virtuelle s'intègre à 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 qui peuvent flotter ou être ancrés à des surfaces du monde réel.
GltfModelEntity : placez des modèles 3D dans votre scène, animez-les et interagissez avec eux. SceneCore est compatible avec le format de fichier glTF pour faciliter l'intégration aux modèles existants.
Son spatial : ajoutez des sources audio ambiantes et ponctuelles à votre scène 3D pour un son spatialisé totalement immersif.
StereoSurfaceEntity : SceneCore est compatible avec le routage du contenu rendu sur une surface Android pour l'œil gauche et l'œil droit. Il peut être utilisé pour afficher du contenu stéréoscopique au format côte à côte ou haut/bas, comme des photos stéréoscopiques, des vidéos 3D ou d'autres interfaces utilisateur rendues 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 associer des panneaux et des modèles à des surfaces réelles, ce qui permet aux utilisateurs d'intégrer facilement du contenu virtuel dans leur environnement réel.
Pose 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 capacités spatialisées lorsqu'elles sont disponibles, comme le positionnement 3D du contenu de l'UI. 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 minSDK de 30 est requis pour utiliser Jetpack SceneCore. Pour contourner ce problème, ajoutez l'entrée de fichier manifeste suivante <uses-sdk tools:overrideLibrary="androidx.xr.scenecore, androidx.xr.compose"/> afin de pouvoir compiler et exécuter avec un minSDK de 23.
Une session peut devenir non valide dans diverses situations qui recréent automatiquement l'activité, y compris le redimensionnement d'un panneau principal, la connexion de périphériques et le passage du mode clair au mode sombre. Si vous rencontrez des problèmes d'invalidation de session, vous pouvez, par exemple, rendre votre panneau principal non redimensionnable, utiliser une entité de panneau dynamique, désactiver la recréation d'activité pour des modifications de configuration spécifiques ou désactiver les changements de thème en mode clair/sombre.
Les composants déplaçables 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 autre qu'Android XR, vous obtiendrez une RuntimeException.
Définir la skybox sur "null" via `SpatialEnvironment.setSpatialEnvironmentPreference()` ne produit pas une skybox noire unie comme indiqué dans la documentation. Il peut en résulter la skybox par défaut du système ou aucune modification de la skybox actuelle.
Les clients SceneCore doivent ajouter implementation(“com.google.guava:listenablefuture-1.0”) à la 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 à tort com.google.guava:guava-31.1-android et com.google.protobuf:protobuf-javalite en tant que dépendances transitives. Si cela entraîne des erreurs de classe en double dans votre build, ces deux dépendances peuvent être exclues sans problème.
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.