Questa pagina è stata tradotta dall'API Cloud Translation.

Jetpack SceneCore

Riferimento API
androidx.xr.scenecore
androidx.xr.scenecore.testing

Crea e manipola il grafico della scena Android XR con contenuti 3D.

Ultimo aggiornamento	Release stabile	Candidato per la release	Versione beta	Alpha Release
30 luglio 2025	-	-	-	1.0.0-alpha05

Dichiarazione di dipendenze

Per aggiungere una dipendenza da XR SceneCore, devi aggiungere il repository Maven di Google al tuo progetto. Per saperne di più, consulta il repository Maven di Google.

Aggiungi le dipendenze per gli artefatti che ti servono nel file build.gradle per la tua app o il tuo modulo:

Alla moda

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")
}

Per ulteriori informazioni sulle dipendenze, consulta Aggiungere dipendenze di build.

Feedback

Il tuo feedback ci aiuta a migliorare Jetpack. Facci sapere se riscontri nuovi problemi o hai idee per migliorare questa libreria. Prima di crearne uno nuovo, dai un'occhiata ai problemi esistenti in questa libreria. Puoi aggiungere il tuo voto a un problema esistente facendo clic sul pulsante a forma di stella.

Creare un nuovo problema

Per ulteriori informazioni, consulta la documentazione di Issue Tracker.

Versione 1.0

Versione 1.0.0-alpha05

30 luglio 2025

androidx.xr.scenecore:scenecore-guava:1.0.0-alpha05, androidx.xr.scenecore:scenecore-testing:1.0.0-alpha05 e androidx.xr.scenecore:scenecore:1.0.0-alpha05 sono rilasciati. La versione 1.0.0-alpha05 contiene questi commit.

Nuove funzionalità

API Perceived Resolution aggiunta a Entità pannello e SurfaceEntities. (I118f6)
PerceivedResolution Metodi di callback aggiunti a Scene.kt per monitorare la risoluzione percepita del pannello principale dell'attività in HSM. (I58084)
SurfaceEntity - Aggiunto il supporto per l'applicazione per richiedere il super campionamento al momento della creazione. Ciò consente alle applicazioni di utilizzare il filtro di sovracampionamento per l'anti-aliasing. (I06913)
Aggiunta della proprietà recommendedContentBoxInFullSpace a ActivitySpace. Restituisce una casella consigliata in cui inserire i contenuti in modalità Spazio completo. (I4cd6f)
È stato fornito un costruttore di overload per il modificatore mobile che consente l'ancoraggio. (Ic0c70)

Modifiche alle API

Per questa release sono state apportate modifiche estese all'API SceneCore. Diverse classi sono state rinominate e/o spostate in moduli diversi e la maggior parte dei metodi getter/setter è stata sostituita da proprietà Kotlin. Sebbene prevediamo future modifiche alle API che causano interruzioni fino alla nostra prima release beta, queste non saranno così dirompenti o numerose.

Sono state rinominate e/o spostate le seguenti classi e interfacce: androidx.xr.scenecore.PixelDimensions in androidx.xr.runtime.math.IntSize2d; androidx.xr.scenecore.Dimensions in androidx.xr.runtime.math.FloatSize3d; androidx.xr.scenecore.ActivityPose in ScenePose, androidx.xr.scenecore.ContentlessEntity in GroupEntity, androidx.xr.scenecore.PlaneType in PlaneOrientation; androidx.xr.scenecore.PlaneSemantic in PlaneSemanticType. (Ifd405)(I3b622) (If534d)
Un certo numero di setter per le proprietà di Scene sono stati resi privati; non era previsto che venissero modificati dai client SceneCore: activitySpace, activitySpaceRoot, mainPanelEntity, perceptionSpace, spatialCapabilities, spatialEnvironment e spatialUser. (I2f506)
In Entità: sono state modificate le seguenti proprietà: get/setParent(), setContentDescription; è stata ritirata la proprietà Entity.is/setHidden(), utilizza Entity.is/setEnabled. (Ibc4c6)
È stata rimossa la classe androidx.xr.scenecore.BasePanelEntity. Utilizza invece direttamente PanelEntity. Getter e setter per PanelEntity sostituiti con proprietà. La proprietà PanelEntity.size è stata modificata da Float3dSize a Float2dSize. È stato rimosso il metodo deprecato androidx.xr.scenecore.PanelEntity.getPixelDimensions. Utilizza getSizeInPixels. (Icc174)
androidx.xr.scenecore.OnSpaceUpdatedListener sostituito con Runnable. (I19308)
SpatialUser.getCameraViews() è stato sostituito con una proprietà. (Ib0cc5) Per ExrImage e GltfModel: I metodi create sono stati modificati in modo che siano funzioni di sospensione; i parametri di creazione sono stati modificati in modo che accettino un Uri o un Path anziché un String. (Id8883) (I0d247), (I25706)
SpatialEnvironment.requestFullSpaceMode e SpatialEnvironment.requestHomeSpaceMode sono stati spostati in Scena. Ad esempio, utilizza session.scene.requestFullSpaceMode() anziché session.scene.spatialEnvironment.requestFullSpaceMode(). addOnPassthroughOpacityChangedListener e addOnSpatialEnvironmentChangedListener ora hanno override che accettano esecutori facoltativi. (I12fe0) (I6b21e)
Sono stati rimossi i seguenti metodi SpatialEnvironment ritirati: togglePassthrough, setPassthrough, setPassthroughOpacity, getPassthroughMode, getPassthroughOpacity, setSkybox e setGeometry. È stata rimossa anche la classe obsoleta SpatialEnvironment.PassthroughMode (I927bd) (I927bd) (I927bd)
Sono stati sostituiti i seguenti getter e setter SpatialEnvironment con proprietà Kotlin: getCurrentPassthroughOpacity(), get/setPassthroughOpacityPreference(), get/setSpatialEnvironmentPreference(), isSpatialEnvironmentPreferenceActive() (I33a7b) (Ie06e2) (Ie06e2)
Il tipo di SpatialEnvironmentPreference.preferredPassthroughOpacity è cambiato da Float? a Float. Non accetta più valori nulli. Al suo posto, SpatialEnvironment.NO_PASSTHROUGH_OPACITY_PREFERENCE viene utilizzato per indicare che non è presente alcuna preferenza di opacità. (I40107)
È stato aggiornato il parametro windowBoundsPx a pixelDimensions e il relativo tipo da Rect a IntSize2d nel metodo create. (I1926e)
Il costruttore SpatialEnvironment ora è interno (I75a51)
Le classi SpatialPointerIconNone e SpatialPointerIconCircle sono state sostituite con gli oggetti complementari SpatialPointerIcon.NONE e SpatialPointerIcon.CIRCLE (I416d2)
SpatialPointerIcon in SpatialPointerComponent non è più annullabile. Utilizza SpatialPointerIcon.DEFAULT anziché null per indicare che deve essere utilizzata l'icona del puntatore predefinita del sistema. (I416d2)
androidx.xr.scenecore.AnchorEntity.getState() è stata sostituita con una proprietà di sola lettura. Rinomina i parametri del metodo AnchorEntity.create() per maggiore chiarezza. Nei metodi di AnchorEntity per impostare e aggiungere listener, il listener è stato spostato nell'argomento finale per abilitare le espressioni lambda finali. androidx.xr.scenecore.OnStateChangedListener per AnchorEntity sostituito con Consumer<AnchorEntity.State>. (I472e0)
GltfModelEntity.getAnimationState() ora è una proprietà. (I10b29)
ActivitySpace.getBounds() è stato sostituito con una proprietà. ActivitySpace.addBoundsChangedListener rinominato in ActivitySpace.addOnBoundsChangedListener. Sostituito ActivitySpace.setOnSpaceUpdatedListener con i metodi di aggiunta/rimozione. (I4c956)
AnchorPlacement: planeTypeFilter è stato rinominato in anchorablePlaneOrientations, planeSemanticFilter è stato rinominato in anchorablePlaneSemanticTypes. L'aggiunta di un MovableComponent a un AnchorEntity o a un ActivitySpace restituirà false, MoveListener è stato rinominato in EntityMoveListener shouldDisposeParentAnchor è stato rinominato in disposeParentOnReAnchor systemMovable è stato rimosso dalla funzione create a favore di creeateCustomMovable, createSystemMovable e createAnchorable (If11c4)
Rimosso SurfaceEntity.featherRadiusX/Y e aggiunge un concetto di classe EdgeFeatheringParams. (Ic78fc)
Il metodo PanelEntity.enablePanelDepthTest() è stato sostituito dalla proprietà panelClippingConfig. Imposta Scene.panelClippingConfig = PanelClippingConfig(isDepthTestEnabled = true) per attivare il test di profondità o impostalo su PanelClippingConfig(isDepthTestEnabled = false) per disattivarlo. (I0cbe0)
Scene.mainPanelEntity ora è di tipo MainPanelEntity invece di PanelEntity (I7125a)
Il metodo setFullSpaceMode di Scene è stato rinominato in configureBundleForFullSpaceModeLaunch e il metodo setFullSpaceModeWithEnvironmentInherited in configureBundleForFullSpaceModeLaunchWithEnvironmentInherited. (I0cbe0) (I0cbe0)
Rinominate le costanti UNKNOWN, OUTSIDE_FOV, PARTIALLY_WITHIN_FOV e WITHIN_FOV di SpatialVisibility in SPATIAL_VISIBILITY_UNKNOWN, SPATIAL_VISIBILITY_OUTSIDE_FIELD_OF_VIEW, SPATIAL_VISIBILITY_PARTIALLY_WITHIN_FIELD_OF_VIEW e SPATIAL_VISIBILITY_WITHIN_FIELD_OF_VIEW, rispettivamente (Ie7e8c)
SpatialVisibility class sostituita con un oggetto pubblico con valori const Int. setSpatialVisibilityChangedListener ora accetta un Consumer<Int> invece di Consumer<SpatialVisibility> (Ie7e8c)
Costanti PointerCaptureComponent rinominate e spostate nell'oggetto PointerCaptureComponent.PointerCaptureState (I9c7ac)
PointerCaptureComponents' StateListener sostituito con Consumer<Int>. (I9c7ac)
InputEventListener sostituito con Consumer<InputEvent> (I9c7ac)
setPreferredAspectRatio è stato spostato dalla classe Scene all'oggetto SpatialWindow e accetta Session come primo parametro. (I7b717)
Entity.setHidden() sostituito da Entity.setEnabled() e Entity.isHidden() sostituito da Entity.isEnabled(). setHidden(false) è uguale a setEnabled(true) e isHidden() == !isEnabled(). (Icf0de)
Il tipo Entity.contentDescription è cambiato da String a CharSequence. (Ie59be)
Session.create e Session.configure ora generano SecurityException quando non sono state concesse autorizzazioni sufficienti anziché restituire SessionCreatePermissionsNotGranted o SessionConfigurePermissionsNotGranted. (I7c488)
ResizableComponent.create ora richiede un Consumer<ResizeEvent> ResizeEventListener è stato sostituito da Consumer<ResizeEvent> ResizableComponent.size è stato rinominato in ResizableComponent.affordanceSize ResizableComponent.minimumSize è stato rinominato in ResizableComponent.minimumEntitySize ResizableComponent.maximumSize è stato rinominato in ResizableComponent.maximumEntitySize, ResizableComponent.autoHideContent è stato rinominato in ResizableComponent.shouldAutoHideContent ResizableComponent.forceShowResizeOverlay è stato rinominato in ResizableComponent.shouldAlwaysShowOverlay (I97a2d)
Ridotto minSDK a 24 per androidx.xr.scenecore e androidx.xr.compose. I pacchetti XR richiedono comunque l'API 34 in fase di runtime. (I17224)
Rimossa la limitazione RequiresApi(34) su tutti i pacchetti Jetpack XR. Questa limitazione era ridondante in quanto Jetpack XR è attualmente disponibile solo sui dispositivi con livello API 34 o superiore. (Iae0f8)
L'artefatto SceneCore principale (xr:scenecore:scenecore) conterrà solo API asincrone in stile Kotlin. Gli sviluppatori Java possono fare affidamento sulla libreria xr:scenecore:scenecore-guava per accedere alle API compatibili. (If221b)
I progetti rilasciati con Kotlin 2.0 richiedono l'utilizzo di KGP 2.0.0 o versioni successive (Idb6b5)
Questa libreria ora utilizza le annotazioni di nullabilità JSpecify, che sono di tipo use. Gli sviluppatori Kotlin devono utilizzare il seguente argomento del compilatore per garantire un utilizzo corretto: -Xjspecify-annotations=strict (questo è il valore predefinito a partire dalla versione 2.1.0 del compilatore Kotlin) (Ia8420)
Tutti i metodi asincroni che restituiscono ListenableFuture sono stati sostituiti con funzioni di sospensione Kotlin. Gli sviluppatori Java che vogliono utilizzare metodi asincroni basati su ListenableFuture anziché funzioni di sospensione Kotlin ora devono utilizzare le funzioni di estensione in :xr:scenecore-scenecore-guava. Ad esempio, GuavaExrImage contiene le funzioni asincrone ExrImage equivalenti a Guava, GuavaScenePose contiene le funzioni asincrone ScenePose equivalenti a Guava, GuavaGltfModel contiene le funzioni asincrone Guava-equivalent GltfModel e così via. (If7283) (I0af60) (If7283) (Ia8515) (I4efdf) (I54bbf) (I3467a) (I82a33)

Correzioni di bug

Aggiornamento della regola ProGuard di Jetpack XR Scenecore per impedire AbstractMethodError per i client ridotti. (I91a01)
Correzioni aggiuntive per supportare la minimizzazione Proguard per Jetpack XR SceneCore (I4f47e)
È stato corretto un bug per cui un InteractableComponent potrebbe causare un arresto anomalo se il hitPosition in HitInfo di InputEvent potrebbe arrestarsi in modo anomalo se il hitPosition restituito dal sistema era nullo (I7a695)
I valori della modalità di configurazione sono stati rinominati per riflettere il loro comportamento. (I6d247)
Sono stati risolti i problemi relativi al campo visivo e a HitTest in SceneCore TestApp. (I2c51e)
È stato corretto un bug in SpatialCapabilities.hasCapability() che restituiva true se una delle funzionalità trasmesse con un OR bit a bit era true, anziché restituire true solo se erano tutte true. (I2cd40)
SurfaceEntity.StereoMode.TOP_BOTTOM è stato aggiornato in modo che la mappa in alto sia visualizzata dall'occhio sinistro e quella in basso dall'occhio destro. (I4ae68)

Versione 1.0.0-alpha04

7 maggio 2025

androidx.xr.scenecore:scenecore:1.0.0-alpha04 e androidx.xr.scenecore:scenecore-testing:1.0.0-alpha04 sono stati rilasciati. La versione 1.0.0-alpha04 contiene questi commit.

Nuove funzionalità

La gestione del backhandling ora funzionerà sulle entità del riquadro senza attività incorporate. Per il funzionamento della gestione del pulsante Indietro, devi specificare android:enableOnBackInvokedCallback= "true" nel manifest Android.
StereoSurfaceEntity ora supporta la riproduzione MV-HEVC tramite due nuovi valori StereoMode: MULTIVIEW_LEFT_PRIMARY e MULTIVIEW_RIGHT_PRIMARY.
PanelEntity.setSize e PanelEntity.getSize ora restituiscono le dimensioni nello spazio principale.
Entity.setPose, Entity.getPose, Entity.setScale, Entity.getScale, Entity.setAlpha e Entity.getAlpha ora accettano un nuovo parametro relativeTo, che consente di ottenere/impostare valori relativi a spazi diversi. I valori supportati sono Spazi genitore, Attività e Mondo reale e il valore predefinito per questo parametro è Genitore.
Metodi di estensione di callback della visibilità spaziale aggiunti a SessionExt.kt per monitorare quando i contenuti della scena si spostano all'interno o all'esterno del campo visivo dell'utente.
setPointSourceParams è stato aggiunto a SpatialAudioTrack, consentendo l'aggiornamento dei parametri dopo la creazione della traccia.
È stata aggiunta una nuova classe, Scena, con riferimenti alle API Scenecore. La scena sarà accessibile come proprietà di estensione della sessione. Le funzioni all'interno di SessionExt sono state spostate in Scena, quindi gli importazioni dovranno essere modificate. Ad esempio, SessionExt.getScene(session).addSpatialCapababilitiesChangedListener contro SessionExt.addSpatialCapabilitiesChangedListener.
È stato aggiunto ActivityPose.hitTestAsync, che consente di hitTest contro i contenuti virtuali.
È stato aggiunto il nuovo tipo di componente SpatialPointerComponent, che consente ai clienti di specificare l'icona visualizzata per il puntatore o di disattivarla. Questo componente può essere collegato attualmente solo a PanelEntity istanze.
Introduzione della nuova fabbrica PanelEntity, che accetta le dimensioni del pannello in metri o pixel. Rimozione della fabbrica PanelEntity precedente che accettava due parametri di tipo Dimension per il pannello.

Modifiche alle API

Rimossa la limitazione RequiresApi(34) su tutti i pacchetti Jetpack XR. Questa limitazione era ridondante in quanto Jetpack XR è attualmente disponibile solo sui dispositivi con livello API 34 o superiore. (Iae0f8)
I progetti rilasciati con Kotlin 2.0 richiedono l'utilizzo di KGP 2.0.0 o versioni successive (Idb6b5)
Il corso PermissionHelper è stato rimosso.
PanelEntity.getPixelDensity è deprecato.
PanelEntity.setPixelDimensions e PanelEntity.getPixelDimension vengono rimossi e sostituiti da setSizeInPixels e getSizeInPixels.
Lingua Entity.getActivitySpaceAlpha rimossa. Può essere sostituito con Entity.getAlpha(Space.Activity).
Lingua Entity.getWorldSpaceScale rimossa. Può essere sostituito con Entity.getScale(Space.REAL\_WORLD).
La classe Session in SceneCore è stata eliminata a favore di Session in XR Runtime.
StereoSurfaceEntity è stato rinominato in SurfaceEntity.
Entity.setSize e Entity.getSize vengono rimossi e gli stessi metodi sono stati aggiunti a PanelEntity.
PointSourceAttributes è stato rinominato in PointSourceParams.
SpatializerConstants.SOURCE\_TYPE\_BYPASS è stato rinominato in SpatializerConstants.SOURCE\_TYPE\_DEFAULT.
L'entità PointSourceParams è stata modificata da accesso pubblico ad accesso interno.
Ora AnchorEntity.create richiede la configurazione di PlaneTrackingMode in Session.configure().
Le API SpatialUser ora richiedono la configurazione di HeadTrackingMode in Session.configure().
Quando ResizableComponent non è allegato, viene fornito un log a livello INFO anziché a livello ERROR.
La classe Fov è ora una normale classe Kotlin.
Dividi Entity.kt per inserire ogni tipo di entità concreta nel proprio file.
Quando crei un nuovo PanelEntity, la maggior parte delle visualizzazioni viene riassegnata a un FrameLayout. Ciò facilita l'utilizzo di LayoutInspector con i riquadri spaziali.
L'istanza XrExtensions attualmente in uso è ora registrata sulla piattaforma, nel miglior modo possibile, per facilitare il debug dell'app.

Correzioni di bug

È stata aggiunta una correzione per evitare un arresto anomalo che poteva verificarsi quando veniva spostato un PanelEntity con MovableComponent e AnchorPlacement
È stato risolto un problema per cui ResizableComponent forniva dimensioni obsolete nel callback onResizeStart.
È stato risolto il problema di arresto anomalo quando dispose() di JxrPlatformAdapterAxr veniva chiamato più volte.

Versione 1.0.0-alpha03

26 febbraio 2025

androidx.xr.scenecore:scenecore:1.0.0-alpha03 e androidx.xr.scenecore:scenecore-testing:1.0.0-alpha03 sono stati rilasciati. La versione 1.0.0-alpha03 contiene questi commit.

Nuove funzionalità

La riduzione Proguard è ora supportata per il codice Jetpack XR

Correzioni di bug

Correzioni aggiuntive per supportare la minimizzazione Proguard per Jetpack XR SceneCore (I4f47e)
Aggiornamento della regola ProGuard di Jetpack XR Scenecore per impedire AbstractMethodError per i client ridotti. (I91a01)

Versione 1.0.0-alpha02

12 febbraio 2025

androidx.xr.scenecore:scenecore:1.0.0-alpha02 e androidx.xr.scenecore:scenecore-testing:1.0.0-alpha02 sono stati rilasciati. La versione 1.0.0-alpha02 contiene questi commit.

Modifica che causa interruzioni imminenti che interessano le app create prima della versione 1.0.0-alpha02

I metodi di fabbrica sono stati spostati dalla classe Session a un metodo complementare su ogni tipo rispettivamente:
- Session.createActivityPanelEntity(Dimensions, String, Activity, Pose) è stato eliminato e sostituito con ActivityPanelEntity.create(Session, Dimensions, String, Pose)
- Session.createAnchorEntity(Anchor) è stato eliminato e sostituito con AnchorEntity.create(Session, Anchor)
- Session.createAnchorEntity(Dimensions, Int, Int, Duration) è stato eliminato e sostituito con AnchorEntity.create(Session, Dimensions, Int, Int, Duration)
- Session.createEntity(String, Pose) è stato eliminato e sostituito con ContentlessEntity.create(Session, String, Pose)
- Session.createExrImageResource(String) è stato eliminato e sostituito con ExrImage.create(Session, String)
- Session.createGltfEntity(GltfModel, Pose) è stato eliminato e sostituito con GltfModelEntity.create(Session, GltfModel, Pose)
- Session.createGltfModelResource(String) è stato eliminato e sostituito con GltfModel.create(Session, String)
- Session.createInteractableComponent(Executor, InputEventListener) è stato eliminato e sostituito con InteractableComponent.create(Session, Executor, InputEventListener)
- Session.createMovableComponent(Boolean, Boolean, Set<AnchorPlacement>, Boolean) è stato eliminato e sostituito con MovableComponent.create(Session, Boolean, Boolean, Set<AnchorPlacement>, Boolean)
- Session.createPanelEntity(View, Dimensions, Dimensions, String, Pose) è stato eliminato e sostituito con PanelEntity.create(Session, View, Dimensions, Dimensions, String, Pose)
- Session.createResizableComponent(Dimensions, Dimensions) è stato eliminato e sostituito con ResizableComponent.create(Session, Dimensions, Dimensions)
- Session.createStereoSurfaceEntity(Int, Dimensions, Pose) è stato eliminato e sostituito con StereoSurface.create(Session, Int, Dimensions, Pose)
Sono stati rimossi i seguenti metodi deprecati:
- Session.canEmbedActivityPanel(Activity) è stato eliminato. Utilizza invece getSpatialCapabilities.hasCapabilility(SPATIAL_CAPABILITY_EMBED_ACTIVITY).
- Session.hasSpatialCapability(Int) è stato eliminato. È stato sostituito a favore dell'utilizzo di getSpatialCapabilities().hasCapability() come modo più compartimentato per verificare la presenza di funzionalità spaziali, poiché getSpatialCapabilities() restituisce un oggetto SpatialCapabilities.
- Session.requestFullSpaceMode() è stato eliminato e sostituito con SpatialEnvironment.requestFullSpaceMode()
- Session.requestHomeSpaceMode() è stato eliminato e sostituito con SpatialEnvironment.requestHomeSpaceMode()
Session.setFullSpaceMode(Bundle) e Session.setFullSpaceModeWithEnvironmentInherited(Bundle) sono state spostate nelle funzioni di estensione. I file dello sviluppatore dovranno aggiungere i nuovi import per l'accesso:
- import androidx.xr.scenecore.setFullSpaceMode
- import androidx.xr.scenecore.setFullSpaceModeWithEnvironmentInherited
Session.setPreferredAspectRatio(Activity, Float) è stato spostato in una funzione di estensione. I file dello sviluppatore dovranno aggiungere il nuovo import per l'accesso:
- import androidx.xr.scenecore.setPreferredAspectRatio
Session.getEntitiesOfType(Class<out T>) e Session.getEntityForRtEntity(RtEntity) sono state spostate nelle funzioni di estensione. I file dello sviluppatore dovranno aggiungere i nuovi import per l'accesso:
- import androidx.xr.scenecore.getEntitiesOfType
- import androidx.xr.scenecore.getEntityForRtEntity
Session.unpersistAnchor(Anchor) è stato eliminato
Session.createPersistedAnchorEntity(UUID) è stato eliminato

Problemi noti

PanelEntity.setCornerRadius() e ActivityPanelEntity.setCornerRadius() potrebbero non avere effetto fino al successivo spostamento del pannello. Questo problema può essere risolto spostando il pannello nella sua posizione attuale.
Quando viene chiamato BoundsChanged su ActivitySpace, alcuni ActivityPose potrebbero non essere stati aggiornati correttamente. Verrà aggiornato nella seguente chiamata OnSpaceUpdated il giorno ActivitySpace

Modifiche che provocano un errore e comportamentali

PanelEntity e ActivityPanelEntity avranno un raggio d'angolo predefinito di 32 dp o inferiore se il pannello ha una larghezza o un'altezza inferiore a 32 dp

Nuove API e funzionalità

Introduce StereoSurface.CanvasShape, che consente la creazione di canvas Spherical e Hemispherical per il rendering di contenuti multimediali immersivi.
StereoSurfaceEntity.create() ora accetta un parametro CanvasShape. (Questo parametro viene attualmente ignorato, ma verrà utilizzato in una versione futura)
StereoSurfaceEntity.create() non accetta più un parametro Dimensions. Le applicazioni devono controllare le dimensioni del canvas impostando CanvasShape
StereoSurfaceEntity ha un membro CanvasShape che può essere impostato in modo dinamico.
StereoSurfaceEntity.dimensions è ora una proprietà di sola lettura; le applicazioni devono impostare CanvasShape per modificare le dimensioni.
StereoSurfaceEntity ora consente di reimpostare StereoMode dopo la costruzione.

Altre modifiche

Riduzione della minSDK in fase di compilazione a 24. Tutte le API Jetpack XR continuano a richiedere l'API 34 in fase di runtime.
La Session factory di SceneCore (Session.create) non avvia più un intent per acquisire l'autorizzazione SCENE_UNDERSTANDING. L'applicazione client deve invece richiedere esplicitamente le autorizzazioni all'utente prima di tentare di creare gli ancoraggi. La creazione di ancore non riuscirà se l'autorizzazione non viene concessa dall'utente.

Correzioni di bug

getActivitySpacePose() è stato corretto per tenere conto della scala ActivitySpace restituendo i valori di conversione in metri scalati anziché restituire sempre metri non scalati. transformPoseTo ora utilizza anche le unità corrette per calcolare le modifiche alle coordinate quando ActivitySpace è coinvolto nell'origine o nella destinazione.
La skybox verrà ora impostata su una skybox completamente nera ogni volta che viene trasmessa una preferenza di skybox nulla utilizzando setSpatialEnvironmentPreference(new SpatialEnvironmentPreference(null, geom)). Per ripristinare la skybox e la geometria predefinite del sistema, utilizza setSpatialEnvironmentPreference(null).

Versione 1.0.0-alpha01

12 dicembre 2024

androidx.xr.scenecore:scenecore-* 1.0.0-alpha01 viene ritirata.

Funzionalità della versione iniziale Versione iniziale per sviluppatori di Jetpack SceneCore, una libreria di grafici di scene 3D per creare e manipolare scene e ambienti immersivi. Questa libreria ti consente di posizionare e disporre modelli 3D e pannelli di contenuti l'uno rispetto all'altro e ai tuoi ambienti virtuali o reali.

SpatialEnvironment: crea esperienze completamente immersive con un'immagine skybox e/o una geometria del modello 3D come sfondo per la scena XR del tuo ambiente. In alternativa, attiva il passthrough, in modo che la scena virtuale possa integrarsi con l'ambiente reale dell'utente.
PanelEntity: aggiungi contenuti 2D alle tue scene 3D incorporando layout e attività Android standard in pannelli spazializzati che possono fluttuare o essere ancorati a superfici del mondo reale.
GltfModelEntity: posiziona, anima e interagisci con i modelli 3D nella tua scena. SceneCore supporta il formato di file glTF per facilitare l'integrazione con i modelli esistenti.
Audio spaziale: aggiungi sorgenti audio ambientali e puntiformi alla tua scena 3D per un suono spazializzato e completamente immersivo.
StereoSurfaceEntity: SceneCore supporta il routing dei contenuti renderizzati su una superficie Android per l'occhio sinistro/destro. Può essere utilizzato per il rendering di contenuti stereoscopici in formato side-by-side o top-bottom, come foto stereoscopiche, video 3D o altre UI sottoposte a rendering dinamico. Le applicazioni devono utilizzare MediaPlayer o ExoPlayer per la decodifica video.
Sistema di componenti: SceneCore offre un sistema di componenti solido e flessibile per aggiungere funzionalità ai tuoi contenuti XR, tra cui la possibilità per gli utenti di spostare, ridimensionare e interagire con modelli e pannelli.
Ancoraggio: con il passthrough attivato, puoi collegare pannelli e modelli a superfici reali, consentendo agli utenti di integrare perfettamente i contenuti virtuali nel loro ambiente reale.
Posizione dell'utente: accedi alla posizione dell'utente nella scena virtuale per orientare i contenuti in base alla sua posizione.
SpatialCapabilities: crea app completamente adattive che sfruttano le funzionalità spazializzate quando disponibili, ad esempio il posizionamento 3D dei contenuti dell'interfaccia utente. Inoltre, la tua app può monitorare le modifiche alle funzionalità durante l'esecuzione, per modificare l'esperienza in base a come l'utente utilizza il proprio dispositivo Android XR.

Problemi noti

Al momento è necessario un minSDK di 30 per utilizzare Jetpack SceneCore. Come soluzione alternativa, aggiungi la seguente voce del manifest <uses-sdk tools:overrideLibrary="androidx.xr.scenecore, androidx.xr.compose"/> per poter eseguire la build ed eseguire l'app con un minSDK di 23.
La sessione può diventare non valida in varie situazioni che ricreano automaticamente l'attività, tra cui il ridimensionamento di un pannello principale, il collegamento di periferiche e il passaggio dalla modalità Chiaro alla modalità Buio. Se riscontri problemi di invalidazione della sessione, le soluzioni alternative includono la non ridimensionabilità del pannello principale, l'utilizzo di un'entità pannello dinamico, la disattivazione della ricreazione dell'attività per modifiche specifiche alla configurazione o la disattivazione delle modifiche al tema della modalità Chiaro/Scuro.
I componenti Movable e Resizable non sono supportati in GltfEntity.
Entity.getSize() non è supportato su GltfEntity.
Le app Jetpack XR devono richiedere l'autorizzazione android.permission.SCENE_UNDERSTANDING in AndroidManifest.
La creazione di una sessione è supportata solo su un dispositivo Android XR. Al momento, se crei una sessione e provi a utilizzarla su un dispositivo XR non Android, riceverai un'eccezione RuntimeException.
L'impostazione della skybox su null tramite `SpatialEnvironment.setSpatialEnvironmentPreference()` non comporta una skybox nera solida come documentato. Potrebbe essere visualizzata la skybox predefinita del sistema o non essere apportata alcuna modifica alla skybox attuale.
I client SceneCore devono aggiungere implementation(“com.google.guava:listenablefuture-1.0”) alla configurazione Gradle per le dipendenze dell'app. In una release futura, scenecore includerà questa libreria come dipendenza api, quindi i client non dovranno dichiararla esplicitamente.
SceneCore include erroneamente com.google.guava:guava-31.1-android e com.google.protobuf:protobuf-javalite come dipendenze transitive. Se ciò comporta errori di classe duplicati nella build, queste due dipendenze possono essere escluse in modo sicuro.
Se la tua app utilizza SceneCore e attiva ProGuard, si arresterà in modo anomalo quando crei una sessione. Come soluzione alternativa, disattiva ProGuard. Per ulteriori informazioni su come attivare ProGuard, consulta questa guida.