Jetpack SceneCore

Mit 3D-Inhalten den Android XR-Szenengraphen erstellen und bearbeiten
Letzte Aktualisierung Stabile Release Releasekandidat Beta-Release Alpha-Release
07. Oktober 2026 - 1.0.0-rc02 - -

Abhängigkeiten deklarieren

Wenn Sie eine Abhängigkeit von XR SceneCore hinzufügen möchten, müssen Sie Ihrem Projekt das Google Maven-Repository hinzufügen. Weitere Informationen finden Sie im Google-Repository bei Maven.

Fügen Sie die Abhängigkeiten für die benötigten Artefakte der Datei build.gradle für Ihre App oder Ihr Modul hinzu:

Cool

dependencies {
    implementation "androidx.xr.scenecore:scenecore:1.0.0-rc02"

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

Kotlin

dependencies {
    implementation("androidx.xr.scenecore:scenecore:1.0.0-rc02")

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

Weitere Informationen zu Abhängigkeiten finden Sie unter Build-Abhängigkeiten hinzufügen.

Feedback

Ihr Feedback hilft uns, Jetpack zu verbessern. Wenn Sie neue Probleme entdecken oder Ideen zur Verbesserung dieser Bibliothek haben, lassen Sie es uns wissen. Bevor Sie ein neues Problem erstellen, sollten Sie sich jedoch die bereits gemeldeten Probleme in dieser Bibliothek ansehen. Wenn Sie sich einer Problemmeldung anschließen möchten, klicken Sie auf den Button mit dem Stern.

Neues Problem melden

Weitere Informationen finden Sie in der Dokumentation zum Issue Tracker.

Version 1.0

Version 1.0.0-rc02

07. Oktober 2026

androidx.xr.scenecore:scenecore-*:1.0.0-rc02 ist veröffentlicht. Version 1.0.0-rc02 enthält diese Commits.

Fehlerkorrekturen

  • Ein potenzielles Speicherleck wurde behoben, indem perceptionRuntimeCache in SessionExt entfernt und so umgestaltet wurde, dass PerceptionRuntime direkt aus der Session-Instanz abgerufen wird. (Ie35b1)
  • Ein potenzielles Kontextleck wurde behoben, indem applicationContext für OpenXR-native Handles verwendet wurde, um sicherzustellen, dass die native Laufzeit keine Verweise auf einen Activity-Kontext enthält. (Ie35b1)
  • Es wurden Race-Bedingungen in XrInstanceManager behoben, indem eine ordnungsgemäße Synchronisierung und Initialisierungssperre eingeführt wurde. (Ie35b1)
  • ReferenceCleaner wurde korrigiert, um die Deregistrierung von Bereinigungsaktionen zu unterstützen. Außerdem wurde dafür gesorgt, dass Entity-Bereinigungsaktionen explizit während dispose() ausgeführt werden, um eine doppelte Ausführung bei der automatischen Speicherbereinigung zu verhindern. (Ie35b1)
  • Ein Speicherleck in Scene wurde behoben, indem sceneCache in SessionExt entfernt und Scene so umgestaltet wurde, dass die Instanz direkt aus sessionConnectors abgerufen wird. (Ie35b1)

Version 1.0.0-rc01

9. September 2026

androidx.xr.scenecore:scenecore-*:1.0.0-rc01 ist veröffentlicht. Version 1.0.0-rc01 enthält diese Commits.

API-Änderungen

  • Die xr:scenecore:scenecore-openxr-Bibliothek wurde hinzugefügt. (Ic49f2)
  • Vor der stabilen Version 1.0.0 wurden mehrere eingestellte APIs entfernt.

Fehlerkorrekturen

  • Ein Fehler mit einem Speicherleck wurde behoben, bei dem die Aktivitätsreferenz vom System beibehalten werden konnte, wenn die Aktivität beendet wurde. (I6dcd7)

Änderungen beim Verhalten

  • Logcat-Ausgabe aus SceneCore entfernt. (I10c3c)

Version 1.0.0-beta02

12. August 2026

androidx.xr.scenecore:scenecore-*:1.0.0-beta02 ist veröffentlicht. Version 1.0.0-beta02 enthält diese Commits.

Diverse Fehlerkorrekturen

  • toMoveEvent() gibt null zurück, wenn die übergeordnete Entität gelöscht wurde. (Ia7a1b)

Version 1.0.0-beta01

15. Juli 2026

androidx.xr.scenecore:scenecore-*:1.0.0-beta01 ist veröffentlicht. Version 1.0.0-beta01 enthält diese Commits.

API-Änderungen

  • Die APIs GltfAnimation und SpatialGltfModelAnimation wurden als experimentell gekennzeichnet. Einige Eigenschaften wurden in Getter umgewandelt. (I8d689, b/524771027)
  • Die öffentliche Factory-Methode MovableComponent.createTrackingMovable wurde entfernt. (I00912, b/477169015)
  • „Session.create“ wurde in eine Suspend-Funktion umgewandelt. (I5d27f)
  • ActivitySpace und AnchorSpace erweitern jetzt eine gemeinsame SpaceEntity-Klasse, die gemeinsames Verhalten für Einheiten enthält, deren Positionen vom System gesteuert werden (I506ec, b/513619219).
  • AnchorEntity wurde in AnchorSpace umbenannt (Ifa95e, b/513619219)
  • Bietet die öffentliche Test-API SoundEffectPoolComponentTester. (I87df7, b/498104417)
  • Dem SurfaceEntity.Shape.Quad-Konstruktor wurde der optionale Parameter cornerRadius hinzugefügt und die cornerRadius-Property wurde öffentlich gemacht. Entwickler können jetzt beim Erstellen einer Quad-Form einen Eckenradius angeben, um SurfaceEntity-Leinwände mit abgerundeten Ecken zu rendern, und den Radius vorhandener Quads abfragen. (Ia7809, b/474681085)
  • Bietet öffentliche Test-API-Überladungen für SpatialAudioTrackBuilderTester, SpatialAudioTrackTester und SceneCoreTestRule.getTester. (I378c6, b/496333938)
  • Spezielle Überschreibungen von toString() für eine Reihe von ARCore-Typen hinzufügen. Diese Typen sollen Entwicklern zusätzliche Informationen für das Debugging liefern und sind nicht für die Verwendung in Produktions- oder ausgelieferten Anwendungen vorgesehen.

Version 1.0.0-alpha16

17. Juni 2026

androidx.xr.scenecore:scenecore-*:1.0.0-alpha16 ist veröffentlicht. Version 1.0.0-alpha16 enthält diese Commits.

API-Änderungen

  • Überladungen für addVertexData, setIndexData und addSubset zu CustomMesh.BuilderFromMeshData und CustomMesh.BuilderFromMeshBuffer hinzugefügt. Mit diesen Überladungen können Entwickler Rohdaten und Parameter direkt übergeben (z.B. ByteBuffer, offset, size, topology, indexOffset, indexCount), ohne sie in Zwischenobjekte wie ByteBufferRegion oder MeshSubset einbetten zu müssen. (I84d5c)
  • Scene.requestFullSpaceMode() und Scene.requestHomeSpaceMode() wurden in requestFullSpace() bzw. requestHomeSpace() umbenannt. Andere Methoden und Dokumentationen, die sich auf den „Home Space-Modus“ und den „Full Space-Modus“ beziehen, wurden ebenfalls aktualisiert. (I45751)
  • Stellt die öffentlichen Test-APIs PanelEntityTester und MainPanelEntityTester (I961e4) bereit.
  • Die Property pointSourceParams wird zu SoundEffectPoolComponent hinzugefügt. (I4a750)
  • Stellt eine öffentliche Test-API MovableComponentTester (I0c972) bereit.
  • Stellt die öffentliche Test-API PointerCaptureComponentTester (Ic0d4f) bereit.
  • Stellt die öffentliche Test-API ActivityPanelEntityTester (I837c4) bereit.
  • Stellt die öffentliche Test-API ResizableComponentTester (I0a3a4) bereit.
  • Stellt die öffentliche Test-API BoundsComponentTester. (Iefd53) bereit.
  • Stellt die öffentliche Test-API SpatialMediaPlayerTester (Ia3e09) bereit.
  • Stellt die öffentliche Test-API SpatialEnvironmentTester (Icf60f) bereit.
  • Bietet die öffentlichen Test-APIs GltfModelTester und SceneCoreTestRule.getGltfModelTester. (I33fcb)
  • Bietet die öffentliche Test-API InteractableComponentTester. (Ia7096)
  • Bietet die öffentliche Test-API SurfaceEntityTester. (Ic0740)
  • Stellt die öffentlichen Test-APIs GltfModelEntityTester, TestGltfModelNode und TestGltfAnimation bereit. (I72c4d)
  • Bietet die öffentlichen Test-APIs SceneTester und SceneCoreTestRule.sceneTester. (Ib4ec5)
  • Stellt die öffentlichen Test-APIs PerceptionSpaceTester und SceneCoreTestRule.perceptionSpaceTester bereit. (Icf739)
  • Bietet die öffentliche Test-API MeshEntityTester. (I63801)
  • Bietet öffentliche Test-API-Überladungen für ImageBasedLightingAssetTester und SceneCoreTestRule.getTester. (I57ec4)
  • Stellt die öffentliche Test-API TextureTester (Ia865b) bereit.
  • Stellt die öffentliche Test-API PositionalAudioComponentTester (Icd96e) bereit.
  • Stellt die öffentliche Test-API SpatialSoundPoolTester (Ia3531) bereit.
  • Bietet eine öffentliche Test-API SoundEffectPoolTester (If349a)
  • Stellt die öffentlichen Test-APIs ActivitySpaceTester und SceneCoreTestRule.activitySpaceTester bereit. (I2d5c2)
  • Stellt die öffentliche Test-API SpatialWindowTester bereit (I41837)
  • Stellt die öffentliche Test-API AnchorEntityTester bereit (I68404)
  • Stellt die öffentliche Test-API-Schnittstelle SceneCoreTestRule bereit. (Ic72d3)
  • Die Klasse PixelDensity wurde hinzugefügt und über Scene#virtualPixelDensity verfügbar gemacht, um ein hardwarebasiertes Pixel-pro-Meter-Verhältnis für die genaue Zuordnung physischer Dimensionen in ActivitySpace bereitzustellen. (I0e3ac)
  • Es wurden öffentliche APIs zum Erstellen und Rendern benutzerdefinierter Meshes hinzugefügt. (I7ad2f)
  • Die VertexLayout API wurde aktualisiert und verwendet jetzt eine Liste von VertexBufferLayouts, wobei jedes VertexBufferLayout die Attribute in einem einzelnen Vertex-Puffer beschreibt. Dies ermöglicht flexiblere Anordnungen von Vertex-Daten, einschließlich verschachtelter Attribute mit benutzerdefinierten Strides und Offsets. (Ic426b)
  • Bietet MovableComponent.createTrackingMovable, um ein ARCore-Trackable in eine Pose relativ zum Activity Space zu transformieren. (I12249)
  • Der Standardwert für das übergeordnete Element in Entity.create wurde auf „null“ aktualisiert. (Ic3145)
  • Entity wurde aktualisiert und ist jetzt eine Klasse statt einer Schnittstelle. Sie ist jetzt die Basisklasse für alle Entitätstypen. Im Rahmen dieser Änderung wurde BaseEntity entfernt. (I7fbc9)
  • GltfModel, ExrImage und ImageBasedLightingAsset implementieren jetzt AutoCloseable, um eine idiomatische Ressourcenverwaltung mit dem use-Block von Kotlin zu ermöglichen. (I1ac79)
  • Die Klasse ImageBasedLightingAsset wurde eingeführt, um ExrImage zum Definieren der Beleuchtung der räumlichen Umgebung zu ersetzen. ExrImage wurde eingestellt und aus der öffentlichen API entfernt. SpatialEnvironmentPreference wurde aktualisiert und verwendet jetzt ImageBasedLightingAsset. (I6c92a)
  • Der Parameter skybox in SpatialEnvironment wurde in imageBasedLightingAsset umbenannt, um seinen Zweck besser widerzuspiegeln. Außerdem wurde klargestellt, dass visuelle Skybox-Texturen im Geometrieparameter enthalten sein sollten. (I24d4a)
  • Für räumliche Einheiten wird jetzt eine stabile Gerätedichte für die Berechnung von Pixeln in Metern auf den Spatial API-Ebenen 1 und 2 verwendet. So wird eine konsistente Größe unabhängig von Änderungen der Systemanzeigedichte gewährleistet. (I37051)

Version 1.0.0-alpha15

19. Mai 2026

androidx.xr.scenecore:scenecore-*:1.0.0-alpha15 ist veröffentlicht. Version 1.0.0-alpha15 enthält diese Commits.

API-Änderungen

  • Entity.dispose() wurde als öffentliche API entfernt. Anstatt dispose() für Entity-Instanzen aufzurufen, können Apps Instanzen bereinigen, indem sie parent auf null setzen und alle starken Verweise auf diese Instanzen löschen. (I396c9)
  • Die set/clearOnLoadCompleteListener-Methoden von SoundEffectPool wurden gelöscht. Verwenden Sie stattdessen add/removeLoadCompleteListener. (Iae78d)
  • set/clearSpatialVisibilityChangedListener der Szene wurde durch add/removeSpatialVisibilityChangedListener ersetzt. (I67dff)
  • Alle SceneCore-Methoden add/removeOnFooListener wurden in add/removeFooListener umbenannt. On wurde aus dem Namen entfernt. (Ibe50b)
  • Die Methoden AnchorEntity.setOnOriginChangedListener und AnchorEntity.setOnStateChangedListener wurden durch add/removeFooListener-Methoden ersetzt, um mehrere gleichzeitige Listener zu unterstützen. (I13749)
  • AnchorEntity.State.TIMEDOUT wurde in State.TIMED_OUT umbenannt. (Id2b8d)
  • Die Component API wurde überarbeitet, um die Sicherheit und Erweiterbarkeit zu verbessern. Component ist jetzt eine abstrakte Klasse. Die Methoden onAttach() und onDetach() sind jetzt protected, um direkte Aufrufe zu verhindern. Verwenden Sie Entity.addComponent() und Entity.removeComponent(), um den Lebenszyklus von Komponenten zu verwalten. (Id04e8)
  • Die SceneCore-Konstanten PlaneSemanticType PlaneOrientation wurden von „Ints“ zu benutzerdefinierten Typen migriert. Die ANY-Konstanten werden entfernt. Clients sollten stattdessen alle gewünschten Konstanten explizit aufzählen oder die neuen unveränderlichen .ALL-Set-Konstanten verwenden. Die Factory-Methode AnchorEntity akzeptiert jetzt eine Menge dieser Typen anstelle eines einzelnen Werts. (Ib1033)
  • Die experimentelle Custom Mesh API unterstützt jetzt Skelettanimation (Skinning). Entwickler können jetzt benutzerdefinierte Meshes animieren, indem sie beim Erstellen eines MeshEntity ein boneCount angeben und die Animation in Echtzeit mit MeshEntity.setBoneTransforms() aktualisieren. (Id8ba2, b/496692490)
  • Die experimentelle CustomMesh API wurde eingeführt. Entwickler können jetzt mithilfe von CustomMesh, MeshBuffer und MeshEntity programmatisch 3D-Geometrie in ihren Szenen erstellen und rendern. (I94617)
  • androidx.xr.scenecore.SpatializerConstants.SourceType.SOURCE_TYPE_SOUND_FIELD wurde entfernt. Verwenden Sie stattdessen SourceType.SOUND_FIELD. (Ia68b9)
  • Hinzufügen von Spatial Audio-Komponenten: PositionalAudioComponent, SoundEffectPoolComponent und SoundFieldAudioComponent (Ieda89)
  • AnchorEntity.getAnchor wurde durch AnchorEntity.anchor ersetzt und gibt jetzt Anchor zurück, wenn AnchorEntity aus einem ARCore-Anchor (I5c7c8) erstellt wurde.
  • Der Standardwert für den Parameter parent in den Factory-Methoden ActivityPanelEntity, GltfModelEntity, GroupEntity, PanelEntity und SurfaceEntity wurde von ActivitySpace zu null geändert. Damit ein Objekt an den Szenengraphen angehängt und sichtbar gerendert werden kann, müssen Entwickler jetzt explizit das übergeordnete Element bei der Instanziierung oder über Entity.parent = ... (Ie7cc1) festlegen.

Fehlerkorrekturen

  • SceneCore fordert jetzt automatisch Entity-Instanzen zurück, wenn sie phantomreichbar werden. Entwickler müssen dispose() nicht mehr explizit aufrufen, um Ressourcen freizugeben. Damit eine [Entity]-Instanz ordnungsgemäß zurückgefordert wird, sollten Entwickler Folgendes tun:
    • Trennen Sie sie vom Szenengraphen, indem Sie parent auf null setzen.
    • Alle starken Verweise auf die Instanz in ihrem Code aufgeben.
    • Hinweis zu speziellen Entitätstypen: Für Entitäten, die nicht übergeordnet werden können (z. B. AnchorEntity), müssen Entwickler eine starke Referenz beibehalten, solange die Instanz verwendet wird. Wenn alle Verweise freigegeben werden, werden diese Instanzen zu Phantom-Reaches und werden automatisch zurückgefordert. (I83fe4)
  • Die ProGuard-Regeln für alle SceneCore-Bibliotheken wurden eingeschränkt. (I98447)

Bekannte Probleme

  • Wenn Sie ein PositionalAudioComponent an ein Entity mit einer inaktiven ExoPlayer-Instanz anhängen, kommt es zu einem Absturz. Rufen Sie setPointSourceParams nicht auf und hängen Sie die Spatial Audio-Komponenten nicht an oder ab, wenn ExoPlayer gestoppt ist. Dieses Problem wird mit dem nächsten Release behoben.

Version 1.0.0-alpha14

6. Mai 2026

androidx.xr.scenecore:scenecore-*:1.0.0-alpha14 ist veröffentlicht. Version 1.0.0-alpha14 enthält diese Commits.

API-Änderungen

  • TrackingState und VpsAvailabilityResult wurden in androidx.xr.arcore package verschoben und die Typen in androidx.xr.runtime sind jetzt veraltet. (Ic7930, b/480462213)
  • Plane.Type wurde in PlaneType umbenannt. (I8c90c, b/482675376)
  • Plane.Label wurde in PlaneLabel umbenannt. (Ic6b67, b/482675376)
  • androidx.xr.runtime.FieldOfView wurde verworfen. Verwenden Sie stattdessen androidx.xr.runtime.math.FieldOfView. (Ia01a0, b/480233045)
  • „Matrix4.pose“ wurde in „Matrix4.toPose()“ umbenannt. Das Attribut „pose“ wird nicht mehr unterstützt. (I329b4, b/493383490)
  • Die Enum-Werte HandJointType wurden umbenannt. (Ifbc83, b/482670596)
  • Component.onAttach und onDetach als öffentliche API verfügbar machen, um benutzerdefinierte Component-Implementierungen zu ermöglichen. (I0ca1f)
  • Spatial Audio-Komponenten hinzufügen (I39ddd, b/489421980, b/436642086, b/436642499)
  • Entfernen Sie die Entität aus PointSourceParams. Stattdessen wird die Entität direkt mit SpatialAudioTrack, SpatialSoundPool und SpatialMediaPlayer verwendet (Ib3685, b/489421980, b/436634048).
  • DeviceTrackingMode.LAST_KNOWN wurde in SPATIAL_LAST_KNOWN umbenannt (mit einem eingestellten Fallback), INERTIAL_LAST_KNOWN für das 3DoF-Tracking wurde hinzugefügt und TRACKING_DEGRADED wurde TrackingState hinzugefügt. (Ie661c, b/445466590)
  • GroupEntity eingestellt. Wenn Sie eine Entity mit nur der grundlegenden Entity-Funktionalität haben möchten, rufen Sie Entity.create auf. Dadurch wird eine Entity-Schnittstelle zurückgegeben. (I4c450, b/473867483)
  • Die XrLog API wurde hinzugefügt. Legen Sie XrLog.isEnabled auf true fest, um das Logging in JetpackXR zu aktivieren, und verwenden Sie XrLog.Level, um die Protokollierungsebene festzulegen. (I76a1f, b/463460895, b/487378441)

Fehlerkorrekturen

  • Der Standardwert für Scene.keyEntity ist jetzt mainPanelEntity. (I6a3ef)

Version 1.0.0-alpha13

25. März 2026

androidx.xr.scenecore:scenecore-*:1.0.0-alpha13 ist veröffentlicht. Version 1.0.0-alpha13 enthält diese Commits.

API-Änderungen

  • Das Flag unscaledGravityAlignedActivitySpace wurde aus Session.create entfernt. ActivitySpace ist jetzt immer unskaliert und an der Schwerkraft ausgerichtet. (If6f11, b/458173423)
  • Die eingestellten Funktionen setMaterialOverride und clearMaterialOverride wurden aus GltfModelEntity entfernt. Sie werden jetzt für die einzelnen GltfModelNode aufgerufen. (I2e5d2)
  • transformPixelCoordinatesToLocalPosition und transformNormalizedCoordinatesToLocalPosition wurden zu PanelEntity hinzugefügt. Entsprechende experimentelle Methoden, die bisher Posen anstelle von Vector3-Positionen zurückgegeben haben, wurden entfernt. (Ib6960, b/460123106, b/458333591)
  • Es wurden GltfAnimation-APIs zum Steuern von glTF-Animationen in SceneCore hinzugefügt. (I2c172, b/466065486, b/465819070, b/465818617)
  • ScenePose.activitySpacePose wurde in ScenePose.poseInActivitySpace umbenannt. (I8f175, b/427822261)
  • Implementierung der geschätzten Laufzeit für Scenecore hinzugefügt (I9c4ab, b/476440158)
  • Wenn Sie die Größe der Hauptbereichsentität ändern, wird sie möglicherweise an der Position ActivitySpace neu positioniert. Es gibt keine andere Lösung als das manuelle oder programmatische Zurücksetzen des Panels an seinen ursprünglichen Speicherort. Dieser Fehler wird in einer zukünftigen Version behoben. (b/489427007).
  • In einigen Fällen wird die Schaltfläche für MovableComponent für SurfaceEntity und andere Entitätstypen, die nicht in einem Infofeld angezeigt werden, möglicherweise nicht angezeigt. Wenn Sie MovableComponent.size explizit festlegen, wird die Aufforderung angezeigt. Dieser Fehler wird in einer zukünftigen Version behoben (b/490983469).

Version 1.0.0-alpha12

25. Februar 2026

androidx.xr.scenecore:scenecore-*:1.0.0-alpha12 ist veröffentlicht. Version 1.0.0-alpha12 enthält diese Commits.

Bekannte Probleme

  • Verankerte Objekte können nach einigen Sekunden von ihrer verankerten Position zum Ursprung des Aktivitätsbereichs springen.
  • Apps stürzen möglicherweise beim Erstellen von SurfaceEntity-Instanzen ab. Dieses Problem wurde in androidx.xr.scenecore:scenecore-*:1.0.0-alpha13 und nachfolgenden Releases behoben. Betroffene Apps sollten auf die neuesten Versionen aktualisiert werden.

API-Änderungen

  • ActivitySpace.addOnSpaceUpdatedListener und ActivitySpace.removeOnSpaceUpdatedListener wurden in addOnOriginChangedListener und removeOnOriginChangedListener umbenannt. AnchorEntity.setOnSpaceUpdatedListener wurde in setOnOriginChangedListener umbenannt. (I5d8fb)
  • Der Eigenschaft FakeEntity wurde der öffentliche Name hinzugefügt und die Ansicht wurde in FakePanelEntity öffentlich gemacht. (Ifa1f9)

Fehlerkorrekturen

  • Die Berechnung der Pixeldichte wurde in neueren System-Images (I57d04) korrigiert.

Version 1.0.0-alpha11

28. Januar 2026

androidx.xr.scenecore:scenecore-*:1.0.0-alpha11 ist veröffentlicht. Version 1.0.0-alpha11 enthält diese Commits.

API-Änderungen

  • Benennt PerceivedResolutionResult.InvalidCameraView in PerceivedResolutionResult.InvalidRenderViewpoint um, da die getPerceivedResolution APIs jetzt auf der RenderViewpoint API von ARCore anstelle von CameraViewScenePose basieren. Dieser Name spiegelt die neue Implementierung besser wider. (I8c967, b/446989745, b/419311998)
  • Die Methoden PanelEntity/SurfaceEntity.getPerceivedResolution akzeptieren jetzt ein vom Entwickler bereitgestelltes RenderViewpoint als Argument. Bisher wurde die RenderViewpoint, die für die Berechnung der wahrgenommenen Auflösung verwendet wurde, von der Laufzeitumgebung willkürlich ausgewählt. (I8c967, b/446989745, b/419311998)
  • SpatialUser, ScenePose.Head und ScenePose.CameraView wurden entfernt. Die Funktionen dieser APIs werden von den APIs ArDevice und RenderViewpoint in ARCore für Jetpack XR abgedeckt. Um einen ScenePose zu erhalten, der dem Kopf oder dem linken oder rechten Auge des Nutzers entspricht, können Entwickler PerceptionSpace.getScenePoseFromPerceptionPose mit der entsprechenden Pose verwenden, die mit ARCore-APIs abgerufen wurde. (I2f69c, b/446989745)

Version 1.0.0-alpha10

3. Dezember 2025

androidx.xr.scenecore:scenecore-*:1.0.0-alpha10 ist veröffentlicht. Version 1.0.0-alpha10 enthält diese Commits.

API-Änderungen

  • transformPixelCoordinatesToPose und transformNormalizedCoordinatesToPose wurden zu PanelEntity hinzugefügt (I462b3)
  • Eine Hilfsklasse namens „Utils“ wurde der SceneCore-Laufzeit basierend auf der Logik in SceneCore hinzugefügt (I570b9).

Fehlerkorrekturen

  • Ein potenzieller Absturz, der auftreten kann, wenn die Sitzung beendet wird und ein SpatialModeChangeEvent empfangen wird, wurde behoben (If44e8).
  • Ein Fehler wurde behoben, der beim Verlassen oder erneuten Aufrufen einer Aktivität zu einem IllegalStateException führen konnte. (Ibff1c)

Version 1.0.0-alpha09

19. November 2025

androidx.xr.scenecore:scenecore-*:1.0.0-alpha09 ist veröffentlicht. Version 1.0.0-alpha09 enthält diese Commits.

Neue Funktionen

  • Fügt eine API zum Abrufen eines ScenePose hinzu, der die Zusammensetzung der Ursprungspose des Wahrnehmungsbereichs und einer Pose in Bezug auf den Ursprung des Wahrnehmungsbereichs darstellt. (I5b50a)
  • Die Funktion getGravityAlignedPose wurde hinzugefügt. Bei der schwerkraftorientierten Ausrichtung werden die Neigung und die Drehung ignoriert. (I5ae21)
  • Die AnchorEntity.State-Konstantentypen wurden von „Ints“ in „State“-Untertypen geändert. (Ib0c49)
  • getChildren() wurde der Entitätsschnittstelle hinzugefügt. Der MainPanelEntity-Lebenszyklus wurde aktualisiert. (Ia69d6)

API-Änderungen

  • Die PointerCaptureComponent.PointerCaptureState-Konstantentypen wurden von „Ints“ in PointerCaptureState-Untertypen geändert. (Ic888a)
  • Scene.spatialCapabilities ist jetzt vom Typ Set<SpatialCapability> anstelle eines Int-Felds. Die SpatialCapability-Konstanten wurden umbenannt. (I9c109)
  • Die SurfaceEntity-Konstantentypen wurden umbenannt und von „Ints“ in SurfaceEntity-Untertypen geändert. (I419ed)
  • Die SpatializerConstant-Konstantentypen wurden umbenannt und von „Ints“ in SpatializerConstant-Untertypen geändert. (Ia0e18)
  • Die TextureSampler-Konstantentypen wurden umbenannt und von „Ints“ in TextureSampler-Untertypen geändert. (I44078)
  • Die SpatialVisibility-Konstantentypen wurden von „Ints“ in SpatialVisibility-Untertypen geändert. (I70739)
  • ResizeEvent.ResizeState-Konstantentypen wurden umbenannt und von „Ints“ in ResizeState-Untertypen geändert. (I384d5)
  • InputEvent-Konstantentypen wurden umbenannt und von „Ints“ in den jeweiligen einschließenden Typ geändert. (I82817)
  • Die GltfModelEntity.AnimationState-Konstantentypen wurden von „Ints“ in AnimationState-Untertypen geändert. (I24f4e)
  • Die AlphaMode-Konstantentypen wurden umbenannt und von „Ints“ in AlphaMode-Untertypen geändert. (I27b56)
  • Die Space-Konstantentypen wurden von „Ints“ zu „Space“-Untertypen geändert. (I9255b)
  • ScenePose.hitTest und zugehörige Methoden geben jetzt null zurück, wenn keine Überschneidung gefunden wurde, anstatt HitTestResult mit einem Nullwert für hitPosition. HitTestResult.hitPosition ist nicht mehr nullable. (I1400a)
  • Verweise auf ActivityPose wurden in ScenePose geändert. (I7fe43)

Version 1.0.0-alpha08

22. Oktober 2025

androidx.xr.scenecore:scenecore-*:1.0.0-alpha08 ist veröffentlicht. Version 1.0.0-alpha08 enthält diese Commits.

API-Änderungen

  • ActivityPanelEntity.moveActivity wurde in transferActivity umbenannt (I273c5, b/430332856)

Fehlerkorrekturen

  • :xr:scenecore:scenecore-spatial-rendering und :xr:scenecore:scenecore-spatial-core als Implementierungsabhängigkeit von :xr:scenecore:scenecore hinzugefügt (I6ab65, b/447000520)
  • Es wird eine Ausnahme ausgelöst, wenn nach dem Beenden der Sitzung auf session.scene zugegriffen wird. (I77e6f)

Version 1.0.0-alpha07

24. September 2025

androidx.xr.scenecore:scenecore:1.0.0-alpha07, androidx.xr.scenecore:scenecore-guava:1.0.0-alpha07 und androidx.xr.scenecore:scenecore-testing:1.0.0-alpha07 sind veröffentlicht. Version 1.0.0-alpha07 enthält diese Commits.

API-Änderungen

  • fixedAspectRatio wurde in isFixedAspectRatioEnabled umbenannt und ist jetzt eine boolesche Property (I5c4e8, b/440588971).
  • Scenecore-Fakes befinden sich jetzt im Modul xr:scenecore:scenecore-testing. (Idd951)
  • shouldAutoHideContent wurde in isAutoHideContentWhileResizingEnabled und shouldAlwaysShowOverlay in isAlwaysShowOverlayEnabled umbenannt (I97c36, b/432335421)
  • Die Konstanten SceneCore TextureSampler wurden zur besseren Lesbarkeit aktualisiert. TextureSampler.MinFilter.LINEAR ist jetzt beispielsweise TextureSampler.MIN_FILTER_LINEAR (Ib159c).
  • Der Setter für setKeyEntity der Szene wurde in die Variable keyEntity zusammengeführt. Wenn Sie keyEntity auf eine nicht verschiebbare Entität wie AnchorEntity festlegen, wird eine IllegalArgumentException ausgelöst, anstatt „false“ zurückzugeben. (I62080, b/428721695, b/422215745)
  • Die Variable SpatialModeChangeListener der Szene wurde durch setSpatialModeChangedListener ersetzt. Es wird ein Consumer<SpatialModeChangeEvent> anstelle eines SpatialModeChangedListener verwendet. setSpatialModeChangedListener kann jetzt optional einen Executor entgegennehmen. (I62080, b/428721695, b/422215745)
  • Der Parameter bundle wurde aus ActivityPanelEntity.startActivity entfernt (I64344, b/430332856, b/430333040).
  • SpatializerConstants.SOURCE_TYPE_BYPASS wurde in SpatializerConstants.SOURCE_TYPE_DEFAULT umbenannt. (Ifc7fe, b/422215565)
  • Die Konstante SpatialSoundPool.PLAY_FAILED wurde hinzugefügt. (Ifc7fe, b/422215565)
  • Den SpatialSoundPool.play-Methoden wurden Standardargumente hinzugefügt. (Ifc7fe, b/422215565)
  • Rückgabewert von Settern in SpatialAudioTrackBuilder entfernt (Ifc7fe, b/422215565)
  • Änderungen an SurfaceEntity
    • SurfaceEntity.CanvasShape wurde in Shape umbenannt
    • SurfaceEntity.CanvasShape.Vr180Hemisphere wurde in Hemisphere umbenannt
    • SurfaceEntity.CanvasShape.Vr360Sphere wurde in Sphere umbenannt
    • SurfaceEntity.EdgeFeatheringParams.SmoothFeather wurde in RectangleFeather umbenannt
    • SurfaceEntity.EdgeFeathingParams.SolidEdge wurde in NoFeathering umbenannt
    • SurfaceEntity.ContentSecurityLevel wurde in SurfaceProtection umbenannt
    • SurfaceEntity.ContentSecurityLevel.{values} hat ein SURFACE_PROTECTION_-Präfix hinzugefügt.
    • SurfaceEntity.SuperSampling.{$values} hat ein SUPER_SAMPLING_-Präfix hinzugefügt
    • SurfaceEntity.StereoMode.{values} hat ein STEREO_MODE_-Präfix hinzugefügt
    • SurfaceEntity.ContentColorMetadata.maxCLL wurde in maxContentLightLevel umbenannt (I7eb5f, b/422216050, b/427529950)
  • launchActivity wurde in startActivity umbenannt (I7db90, b/430332856)
  • Scene.activitySpaceRoot wurde entfernt. Verwenden Sie stattdessen Scene.activitySpace. (I05ee8, b/378706624, b/422215745)
  • configureBundleForFullSpaceModeLaunch und configureBundleForFullSpaceModeLaunchWithEnvironmentInherited wurden in createBundleForFullSpaceModeLaunch und createBundleForFullSpaceModeLaunchWithEnvironmentInherited umbenannt und als Methoden der obersten Ebene in die Datei LaunchUtils.kt verschoben. Außerdem wird „Session“ als erster Parameter verwendet (I64a2c, b/437186050).
  • Die GroupEntity-Factory gibt jetzt den Typ GroupEntity anstelle von „Entity“ zurück. (I66042)

Fehlerkorrekturen

  • Lösen Sie eine IllegalStateException aus, wenn eine Entitätsinstanz nach dem Schließen verwendet wird. (I90990, b/427314036, b/432063442)

Version 1.0.0-alpha06

13. August 2025

androidx.xr.scenecore:scenecore:1.0.0-alpha06, androidx.xr.scenecore:scenecore-guava:1.0.0-alpha06 und androidx.xr.scenecore:scenecore-testing:1.0.0-alpha06 sind veröffentlicht. Version 1.0.0-alpha06 enthält diese Commits.

API-Änderungen

  • Einschränkung der SceneCore-BaseEntity- und BaseScenePose-APIs aufheben (88c0ff6)

Version 1.0.0-alpha05

30. Juli 2025

androidx.xr.scenecore:scenecore-guava:1.0.0-alpha05, androidx.xr.scenecore:scenecore-testing:1.0.0-alpha05 und androidx.xr.scenecore:scenecore:1.0.0-alpha05 sind veröffentlicht. Version 1.0.0-alpha05 enthält diese Commits.

Neue Funktionen

  • Die API für die wahrgenommene Auflösung wurde den Panel-Entitäten und SurfaceEntities hinzugefügt. (I118f6)
  • PerceivedResolution Callback-Methoden, die Scene.kt hinzugefügt wurden, um die wahrgenommene Auflösung des Hauptbereichs der Aktivität im HSM zu überwachen. (I58084)
  • SurfaceEntity – Unterstützung für Anwendungen, die beim Erstellen von Inhalten Super-Sampling anfordern. Dadurch können Anwendungen den Super-Sampling-Filter für das Anti-Aliasing verwenden. (I06913)
  • Die Property recommendedContentBoxInFullSpace wurde zu ActivitySpace hinzugefügt. Gibt ein empfohlenes Feld für Inhalte zurück, die im Full Space Modus platziert werden sollen. (I4cd6f)
  • Es wurde ein überladener Konstruktor für den beweglichen Modifikator bereitgestellt, der das Verankern ermöglicht. (Ic0c70)

API-Änderungen

Für diesen Release wurden umfangreiche API-Änderungen an SceneCore vorgenommen. Mehrere Klassen wurden umbenannt und/oder in andere Module verschoben. Die meisten Getter-/Setter-Methoden wurden durch Kotlin-Properties ersetzt. Bis zur ersten Beta-Version werden voraussichtlich noch einige wichtige API-Änderungen vorgenommen, die jedoch nicht so störend oder zahlreich sein werden.

  • Die folgenden Klassen und Schnittstellen wurden umbenannt und/oder verschoben: 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)
  • Eine Reihe von Settern für die Eigenschaften von Scene wurde privat gemacht. Sie sollten nicht von SceneCore-Clients geändert werden: activitySpace, activitySpaceRoot, mainPanelEntity, perceptionSpace, spatialCapabilities, spatialEnvironment und spatialUser. (I2f506)
  • In Entity: Die folgenden Elemente wurden in Properties geändert: get/setParent(), setContentDescription; Entity.is/setHidden() wurde eingestellt, verwenden Sie stattdessen Entity.is/setEnabled. (Ibc4c6)
  • Die Klasse androidx.xr.scenecore.BasePanelEntity wurde entfernt. Verwenden Sie stattdessen direkt PanelEntity. Getter und Setter für PanelEntity wurden durch Attribute ersetzt. Die PanelEntity.size-Eigenschaft wurde von Float3dSize in Float2dSize geändert. Die verworfene Methode androidx.xr.scenecore.PanelEntity.getPixelDimensions wurde entfernt. Verwenden Sie stattdessen getSizeInPixels. (Icc174)
  • androidx.xr.scenecore.OnSpaceUpdatedListener wurde durch Runnable ersetzt. (I19308)
  • SpatialUser.getCameraViews() wurde durch ein Attribut ersetzt. (Ib0cc5) Für ExrImage und GltfModel:: Die create-Methoden wurden in Suspend-Funktionen geändert. Die Erstellungsparameter wurden so geändert, dass sie anstelle von String ein Uri oder Path akzeptieren. (Id8883) (I0d247), (I25706)
  • SpatialEnvironment.requestFullSpaceMode und SpatialEnvironment.requestHomeSpaceMode wurden in „Szene“ verschoben. Verwenden Sie beispielsweise session.scene.requestFullSpaceMode() anstelle von session.scene.spatialEnvironment.requestFullSpaceMode(). addOnPassthroughOpacityChangedListener und addOnSpatialEnvironmentChangedListener haben jetzt Überschreibungen, die optionale Executors akzeptieren. (I12fe0) (I6b21e)
  • Die folgenden verworfenen SpatialEnvironment-Methoden wurden entfernt: togglePassthrough, setPassthrough, setPassthroughOpacity, getPassthroughMode, getPassthroughOpacity, setSkybox und setGeometry. Die verworfene Klasse SpatialEnvironment.PassthroughMode (I927bd) (I927bd) (I927bd) wurde ebenfalls entfernt.
  • Die folgenden SpatialEnvironment-Getter und ‑Setter wurden durch Kotlin-Properties ersetzt: getCurrentPassthroughOpacity(), get/setPassthroughOpacityPreference(), get/setSpatialEnvironmentPreference(), isSpatialEnvironmentPreferenceActive() (I33a7b) (Ie06e2) (Ie06e2)
  • Der Typ von SpatialEnvironmentPreference.preferredPassthroughOpacity wurde von Float? in Float geändert. Nullwerte werden nicht mehr akzeptiert. Stattdessen wird SpatialEnvironment.NO_PASSTHROUGH_OPACITY_PREFERENCE verwendet, um anzugeben, dass keine Deckkraft bevorzugt wird. (I40107)
  • Der Parameter windowBoundsPx wurde in der Methode „create“ in pixelDimensions und sein Typ von „Rect“ in IntSize2d geändert. (I1926e)
  • Der SpatialEnvironment-Konstruktor ist jetzt intern (I75a51)
  • Die Klassen SpatialPointerIconNone und SpatialPointerIconCircle wurden durch die Companion-Objekte SpatialPointerIcon.NONE und SpatialPointerIcon.CIRCLE ersetzt (I416d2).
  • SpatialPointerIcon in SpatialPointerComponent ist nicht mehr nullable. Verwenden Sie SpatialPointerIcon.DEFAULT anstelle von „null“, um anzugeben, dass das Standardzeigersymbol des Systems verwendet werden soll. (I416d2)
  • androidx.xr.scenecore.AnchorEntity.getState() wurde durch ein schreibgeschütztes Attribut ersetzt. Die Parameter der Methode AnchorEntity.create() wurden zur besseren Übersichtlichkeit umbenannt. In den Methoden von AnchorEntity zum Festlegen und Hinzufügen von Listenern wurde der Listener zum Aktivieren von nachgestellten Lambdas in das letzte Argument verschoben. androidx.xr.scenecore.OnStateChangedListener für AnchorEntity wurde durch Consumer<AnchorEntity.State> ersetzt. (I472e0)
  • GltfModelEntity.getAnimationState() ist jetzt eine Property. (I10b29)
  • ActivitySpace.getBounds() wurde durch ein Attribut ersetzt. ActivitySpace.addBoundsChangedListener wurde in ActivitySpace.addOnBoundsChangedListener umbenannt. ActivitySpace.setOnSpaceUpdatedListener durch Methoden zum Hinzufügen/Entfernen ersetzt. (I4c956)
  • „AnchorPlacement: planeTypeFilter“ wurde in „anchorablePlaneOrientations“ umbenannt, „planeSemanticFilter“ wurde in „anchorablePlaneSemanticTypes“ umbenannt. Wenn Sie einer AnchorEntity oder ActivitySpace eine MovableComponent hinzufügen, wird „false“ zurückgegeben. MoveListener wurde in EntityMoveListener shouldDisposeParentAnchor umbenannt, wurde in disposeParentOnReAnchor systemMovable umbenannt und wurde aus der Funktion create entfernt und durch creeateCustomMovable, createSystemMovable und createAnchorable ersetzt (If11c4).
  • SurfaceEntity.featherRadiusX/Y wurde entfernt und ein EdgeFeatheringParams-Klassenkonzept wurde hinzugefügt. (Ic78fc)
  • Die PanelEntity.enablePanelDepthTest()-Methode wurde durch das Attribut panelClippingConfig ersetzt. Legen Sie Scene.panelClippingConfig = PanelClippingConfig(isDepthTestEnabled = true) fest, um den Tiefentest zu aktivieren, oder PanelClippingConfig(isDepthTestEnabled = false), um ihn zu deaktivieren. (I0cbe0)
  • Scene.mainPanelEntity hat jetzt den Typ MainPanelEntity anstelle von PanelEntity (I7125a)
  • Die Methode setFullSpaceMode der Szene wurde in configureBundleForFullSpaceModeLaunch und die Methode setFullSpaceModeWithEnvironmentInherited in configureBundleForFullSpaceModeLaunchWithEnvironmentInherited umbenannt. (I0cbe0) (I0cbe0)
  • Die Werte UNKNOWN, OUTSIDE_FOV, PARTIALLY_WITHIN_FOV und WITHIN_FOV von SpatialVisibility wurden in SPATIAL_VISIBILITY_UNKNOWN, SPATIAL_VISIBILITY_OUTSIDE_FIELD_OF_VIEW, SPATIAL_VISIBILITY_PARTIALLY_WITHIN_FIELD_OF_VIEW und SPATIAL_VISIBILITY_WITHIN_FIELD_OF_VIEW umbenannt (Ie7e8c).
  • Die Klasse SpatialVisibility wurde durch ein öffentliches Objekt mit konstanten Int-Werten ersetzt. setSpatialVisibilityChangedListener akzeptiert jetzt Consumer<Int> anstelle von Consumer<SpatialVisibility> (Ie7e8c)
  • PointerCaptureComponent-Konstanten umbenannt und in das PointerCaptureComponent.PointerCaptureState-Objekt verschoben (I9c7ac)
  • PointerCaptureComponents' StateListener wurde durch Consumer<Int> ersetzt. (I9c7ac)
  • InputEventListener wurde durch Consumer<InputEvent> ersetzt (I9c7ac)
  • setPreferredAspectRatio wurde von der Scene-Klasse in das SpatialWindow-Objekt verschoben und verwendet „Session“ als ersten Parameter. (I7b717)
  • Entity.setHidden() wurde durch Entity.setEnabled() ersetzt und Entity.isHidden() durch Entity.isEnabled(). setHidden(false) entspricht setEnabled(true) und isHidden() == !isEnabled(). (Icf0de)
  • Der Typ von Entity.contentDescription wurde von „String“ in „CharSequence“ geändert. (Ie59be)
  • Bei Session.create und Session.configure wird jetzt SecurityException ausgegeben, wenn nicht genügend Berechtigungen erteilt wurden, anstatt SessionCreatePermissionsNotGranted oder SessionConfigurePermissionsNotGranted zurückzugeben. (I7c488)
  • Für ResizableComponent.create ist jetzt ein Consumer<ResizeEvent> ResizeEventListener erforderlich. Consumer<ResizeEvent> ResizableComponent.size wurde durch ResizableComponent.affordanceSize ResizableComponent.minimumSize ersetzt. ResizableComponent.minimumEntitySize ResizableComponent.maximumSize wurde in ResizableComponent.maximumEntitySize umbenannt. ResizableComponent.autoHideContent wurde in ResizableComponent.shouldAutoHideContent umbenannt. ResizableComponent.forceShowResizeOverlay wurde in ResizableComponent.shouldAlwaysShowOverlay umbenannt. (I97a2d)
  • minSDK wurde für androidx.xr.scenecore und androidx.xr.compose auf 24 reduziert. Für XR-Pakete ist zur Laufzeit weiterhin API 34 erforderlich. (I17224)
  • Die Einschränkung RequiresApi(34) wurde für alle Jetpack XR-Pakete entfernt. Diese Einschränkung war überflüssig, da Jetpack XR derzeit nur auf Geräten mit API‑Level 34 oder höher verfügbar ist. (Iae0f8)
  • Das Hauptartefakt SceneCore (xr:scenecore:scenecore) enthält nur asynchrone APIs im Kotlin-Stil. Java-Entwickler können die xr:scenecore:scenecore-guava-Bibliothek verwenden, um auf kompatible APIs zuzugreifen. (If221b)
  • Für Projekte, die mit Kotlin 2.0 veröffentlicht wurden, ist KGP 2.0.0 oder höher erforderlich (Idb6b5).
  • In dieser Bibliothek werden jetzt JSpecify-Annotationen für Nullsicherheit verwendet, die typbezogen sind. Kotlin-Entwickler sollten das folgende Compiler-Argument verwenden, um die korrekte Verwendung zu erzwingen: -Xjspecify-annotations=strict (dies ist die Standardeinstellung ab Version 2.1.0 des Kotlin-Compilers) (Ia8420)
  • Alle asynchronen Methoden, die ListenableFuture zurückgeben, wurden durch Kotlin-Suspend-Funktionen ersetzt. Java-Entwickler, die ListenableFuture-basierte asynchrone Methoden anstelle von Kotlin-Suspend-Funktionen verwenden möchten, müssen jetzt Erweiterungsfunktionen in :xr:scenecore-scenecore-guava verwenden. GuavaExrImage enthält beispielsweise die asynchronen Funktionen von ExrImage, die Guava entsprechen, GuavaScenePose enthält die asynchronen Funktionen von ScenePose, die Guava entsprechen, GuavaGltfModel enthält die asynchronen Funktionen von Guava-equivalent GltfModel usw. (If7283) (I0af60) (If7283) (Ia8515) (I4efdf) (I54bbf) (I3467a) (I82a33)

Fehlerkorrekturen

  • Die Jetpack XR Scenecore-Regel ProGuard wurde aktualisiert, um AbstractMethodError für minimierte Clients zu verhindern. (I91a01)
  • Zusätzliche Korrekturen zur Unterstützung der Proguard-Minifizierung für Jetpack XR SceneCore (I4f47e)
  • Es wurde ein Fehler behoben, bei dem ein InteractableComponent zu einem Absturz führen konnte, wenn die hitPosition für die HitInfo des InputEvent abstürzen konnte, wenn die vom System zurückgegebene hitPosition null war (I7a695).
  • Die Werte für den Konfigurationsmodus wurden umbenannt, um ihr Verhalten besser widerzuspiegeln. (I6d247)
  • Probleme mit dem Sichtfeld und HitTest in der SceneCore-Test-App wurden behoben. (I2c51e)
  • Es wurde ein Fehler in SpatialCapabilities.hasCapability() behoben, bei dem „true“ zurückgegeben wurde, wenn eine der mit einem bitweisen ODER übergebenen Funktionen „true“ war, anstatt nur dann „true“ zurückzugeben, wenn alle „true“ waren. (I2cd40)
  • SurfaceEntity.StereoMode.TOP_BOTTOM wurde aktualisiert. Die obere Karte ist für das linke Auge und die untere Karte für das rechte Auge. (I4ae68)

Version 1.0.0-alpha04

7. Mai 2025

androidx.xr.scenecore:scenecore:1.0.0-alpha04 und androidx.xr.scenecore:scenecore-testing:1.0.0-alpha04 sind veröffentlicht. Version 1.0.0-alpha04 enthält diese Commits.

Neue Funktionen

  • Die Rückbearbeitung funktioniert jetzt auch für Bildbereichsentitäten ohne eingebettete Aktivitäten. Damit die Rücktaste funktioniert, müssen Sie android:enableOnBackInvokedCallback= "true" im Android-Manifest angeben.
  • StereoSurfaceEntity unterstützt jetzt die MV-HEVC-Wiedergabe über zwei neue StereoMode-Werte: MULTIVIEW_LEFT_PRIMARY und MULTIVIEW_RIGHT_PRIMARY.
  • PanelEntity.setSize und PanelEntity.getSize geben jetzt Größen im übergeordneten Bereich zurück.
  • Die Funktionen Entity.setPose, Entity.getPose, Entity.setScale, Entity.getScale, Entity.setAlpha und Entity.getAlpha haben jetzt einen neuen Parameter relativeTo, mit dem Werte relativ zu verschiedenen Bereichen abgerufen und festgelegt werden können. Die unterstützten Werte sind „Parent“, „Activity“ und „Real World“. Der Standardwert für diesen Parameter ist „Parent“.
  • SessionExt.kt wurden Erweiterungsmethoden für den Callback zur räumlichen Sichtbarkeit hinzugefügt, um zu überwachen, wann sich die Inhalte der Szene innerhalb oder außerhalb des Sichtfelds des Nutzers bewegen.
  • setPointSourceParams wurde SpatialAudioTrack hinzugefügt. Dadurch können die Parameter aktualisiert werden, nachdem der Track erstellt wurde.
  • Es wurde eine neue Klasse „Scene“ mit Verweisen auf Scenecore-APIs hinzugefügt. Die Szene ist als Erweiterungseigenschaft der Sitzung verfügbar. Funktionen in SessionExt wurden in „Scene“ verschoben. Daher müssen Importe angepasst werden, z. B. SessionExt.getScene(session).addSpatialCapababilitiesChangedListener im Vergleich zu SessionExt.addSpatialCapabilitiesChangedListener.
  • ActivityPose.hitTestAsync wurde hinzugefügt, wodurch eine hitTest für virtuelle Inhalte möglich ist.
  • Es wurde der neue Komponententyp SpatialPointerComponent hinzugefügt, mit dem Kunden das für den Zeiger gerenderte Symbol angeben oder das Symbol deaktivieren können. Diese Komponente kann derzeit nur an PanelEntity-Instanzen angehängt werden.
  • Wir führen die neue PanelEntity-Factory ein, die die Abmessungen des Panels entweder in Metern oder Pixeln entgegennimmt. Die alte PanelEntity-Factory, die zwei Parameter vom Typ „Dimension“ für den Bereich verwendet, wurde entfernt.

API-Änderungen

  • Die Einschränkung RequiresApi(34) wurde für alle Jetpack XR-Pakete entfernt. Diese Einschränkung war überflüssig, da Jetpack XR derzeit nur auf Geräten mit API‑Level 34 oder höher verfügbar ist. (Iae0f8)
  • Für Projekte, die mit Kotlin 2.0 veröffentlicht wurden, ist KGP 2.0.0 oder höher erforderlich (Idb6b5).
  • Die Klasse „PermissionHelper“ wurde entfernt.
  • PanelEntity.getPixelDensity wurde verworfen.
  • PanelEntity.setPixelDimensions und PanelEntity.getPixelDimension wurden entfernt und durch setSizeInPixels und getSizeInPixels ersetzt.
  • Entity.getActivitySpaceAlpha entfernt. Kann durch Entity.getAlpha(Space.Activity) ersetzt werden.
  • Entity.getWorldSpaceScale entfernt. Kann durch Entity.getScale(Space.REAL\_WORLD) ersetzt werden.
  • Die Session-Klasse in SceneCore wurde zugunsten der Session in XR Runtime gelöscht.
  • „StereoSurfaceEntity“ wurde in „SurfaceEntity“ umbenannt.
  • Entity.setSize und Entity.getSize wurden entfernt und dieselben Methoden wurden PanelEntity hinzugefügt.
  • „PointSourceAttributes“ wurde in „PointSourceParams“ umbenannt.
  • „SpatializerConstants.SOURCE\_TYPE\_BYPASS“ wurde in „SpatializerConstants.SOURCE\_TYPE\_DEFAULT“ umbenannt.
  • Die Entität „PointSourceParams“ wurde von „öffentlich“ zu „interner Zugriff“ geändert.
  • Für AnchorEntity.create muss jetzt PlaneTrackingMode in Session.configure() konfiguriert werden.
  • Für SpatialUser-APIs muss jetzt HeadTrackingMode in Session.configure() konfiguriert werden.
  • Wenn ResizableComponent nicht angehängt ist, wird ein Log auf INFO-Ebene anstelle eines Logs auf ERROR-Ebene ausgegeben.
  • Die Fov-Klasse ist jetzt eine reguläre Kotlin-Klasse.
  • Teilen Sie Entity.kt auf, um jeden konkreten Entitätstyp in einer eigenen Datei zu platzieren.
  • Wenn Sie ein neues PanelEntity erstellen, werden die meisten Ansichten dem FrameLayout untergeordnet. Dadurch wird die Verwendung von LayoutInspector mit räumlichen Bereichen erleichtert.
  • Die derzeit verwendete XrExtensions-Instanz wird jetzt nach bestem Wissen und Gewissen auf der Plattform registriert, um das Debuggen von Apps zu erleichtern.

Fehlerkorrekturen

  • Es wurde eine Korrektur hinzugefügt, um einen Absturz zu verhindern, der auftreten konnte, wenn ein PanelEntity mit MovableComponent und AnchorPlacement verschoben wurde.
  • Ein Problem wurde behoben, bei dem ResizableComponent veraltete Größen im onResizeStart-Callback bereitstellte.
  • Ein Absturz wurde behoben, der auftrat, wenn JxrPlatformAdapterAxrs dispose() mehrmals aufgerufen wurde.

Version 1.0.0-alpha03

26. Februar 2025

androidx.xr.scenecore:scenecore:1.0.0-alpha03 und androidx.xr.scenecore:scenecore-testing:1.0.0-alpha03 sind veröffentlicht. Version 1.0.0-alpha03 enthält diese Commits.

Neue Funktionen

  • Proguard-Minifizierung wird jetzt für Jetpack XR-Code unterstützt

Fehlerkorrekturen

  • Zusätzliche Korrekturen zur Unterstützung der Proguard-Minifizierung für Jetpack XR SceneCore (I4f47e)
  • Die Jetpack XR Scenecore-Regel ProGuard wurde aktualisiert, um AbstractMethodError für minimierte Clients zu verhindern. (I91a01)

Version 1.0.0-alpha02

12. Februar 2025

androidx.xr.scenecore:scenecore:1.0.0-alpha02 und androidx.xr.scenecore:scenecore-testing:1.0.0-alpha02 sind veröffentlicht. Version 1.0.0-alpha02 enthält diese Commits.

Anstehende wichtige Änderung für Apps, die vor Version 1.0.0-alpha02 erstellt wurden

  • Die Factory-Methoden wurden aus der Klasse Session in eine Companion-Methode für jeden jeweiligen Typ verschoben:
    • Session.createActivityPanelEntity(Dimensions, String, Activity, Pose) wurde gelöscht und durch ActivityPanelEntity.create(Session, Dimensions, String, Pose) ersetzt
    • Session.createAnchorEntity(Anchor) wurde gelöscht und durch AnchorEntity.create(Session, Anchor) ersetzt
    • Session.createAnchorEntity(Dimensions, Int, Int, Duration) wurde gelöscht und durch AnchorEntity.create(Session, Dimensions, Int, Int, Duration) ersetzt
    • Session.createEntity(String, Pose) wurde gelöscht und durch ContentlessEntity.create(Session, String, Pose) ersetzt
    • Session.createExrImageResource(String) wurde gelöscht und durch ExrImage.create(Session, String) ersetzt
    • Session.createGltfEntity(GltfModel, Pose) wurde gelöscht und durch GltfModelEntity.create(Session, GltfModel, Pose) ersetzt
    • Session.createGltfModelResource(String) wurde gelöscht und durch GltfModel.create(Session, String) ersetzt
    • Session.createInteractableComponent(Executor, InputEventListener) wurde gelöscht und durch InteractableComponent.create(Session, Executor, InputEventListener) ersetzt
    • Session.createMovableComponent(Boolean, Boolean, Set<AnchorPlacement>, Boolean) wurde gelöscht und durch MovableComponent.create(Session, Boolean, Boolean, Set<AnchorPlacement>, Boolean) ersetzt
    • Session.createPanelEntity(View, Dimensions, Dimensions, String, Pose) wurde gelöscht und durch PanelEntity.create(Session, View, Dimensions, Dimensions, String, Pose) ersetzt
    • Session.createResizableComponent(Dimensions, Dimensions) wurde gelöscht und durch ResizableComponent.create(Session, Dimensions, Dimensions) ersetzt
    • Session.createStereoSurfaceEntity(Int, Dimensions, Pose) wurde gelöscht und durch StereoSurface.create(Session, Int, Dimensions, Pose) ersetzt
  • Die folgenden veralteten Methoden wurden entfernt:
    • Session.canEmbedActivityPanel(Activity) wurde gelöscht. Verwenden Sie stattdessen getSpatialCapabilities.hasCapabilility(SPATIAL_CAPABILITY_EMBED_ACTIVITY).
    • Session.hasSpatialCapability(Int) wurde gelöscht. Es wurde durch getSpatialCapabilities().hasCapability() ersetzt, da dies eine besser abgegrenzte Möglichkeit ist, das Vorhandensein von räumlichen Funktionen zu prüfen, da getSpatialCapabilities() ein SpatialCapabilities-Objekt zurückgibt.
    • Session.requestFullSpaceMode() wurde gelöscht und durch SpatialEnvironment.requestFullSpaceMode() ersetzt
    • Session.requestHomeSpaceMode() wurde gelöscht und durch SpatialEnvironment.requestHomeSpaceMode() ersetzt
  • Session.setFullSpaceMode(Bundle) und Session.setFullSpaceModeWithEnvironmentInherited(Bundle) wurden in Erweiterungsfunktionen verschoben. In Entwicklerdateien müssen die neuen Importe für den Zugriff hinzugefügt werden:
    • import androidx.xr.scenecore.setFullSpaceMode
    • import androidx.xr.scenecore.setFullSpaceModeWithEnvironmentInherited
  • Session.setPreferredAspectRatio(Activity, Float) wurde in eine Erweiterungsfunktion verschoben. In Entwicklerdateien muss der neue Import für den Zugriff hinzugefügt werden:
    • import androidx.xr.scenecore.setPreferredAspectRatio
  • Session.getEntitiesOfType(Class<out T>) und Session.getEntityForRtEntity(RtEntity) wurden in Erweiterungsfunktionen verschoben. In Entwicklerdateien müssen die neuen Importe für den Zugriff hinzugefügt werden:
    • import androidx.xr.scenecore.getEntitiesOfType
    • import androidx.xr.scenecore.getEntityForRtEntity
  • „Session.unpersistAnchor(Anchor)“ wurde gelöscht
  • „Session.createPersistedAnchorEntity(UUID)“ wurde gelöscht

Bekannte Probleme

  • PanelEntity.setCornerRadius() und ActivityPanelEntity.setCornerRadius() werden möglicherweise erst wirksam, wenn das Feld das nächste Mal verschoben wird. Sie können das Problem beheben, indem Sie das Feld an seine aktuelle Position verschieben.
  • Wenn BoundsChanged für die ActivitySpace aufgerufen wird, wurden einige ActivityPoses möglicherweise nicht richtig aktualisiert. Sie wird beim nächsten OnSpaceUpdated-Anruf am ActivitySpace aktualisiert.

Funktionsgefährdende Änderungen und Änderungen beim Verhalten

  • PanelEntity und ActivityPanelEntity haben einen Standard-Eckenradius von 32 dp oder weniger, wenn der Bereich eine Breite oder Höhe von weniger als 32 dp hat.

Neue APIs und Funktionen

  • Mit StereoSurface.CanvasShape können Spherical- und Hemispherical-Arbeitsbereiche zum Rendern immersiver Medien erstellt werden.
  • StereoSurfaceEntity.create() akzeptiert jetzt einen CanvasShape-Parameter. Dieser Parameter wird derzeit ignoriert, wird aber in einem zukünftigen Release verwendet.
  • StereoSurfaceEntity.create() akzeptiert keinen Dimensions-Parameter mehr. Anwendungen sollten die Größe des Canvas durch Festlegen von CanvasShape steuern.
  • StereoSurfaceEntity hat ein CanvasShape-Element, das dynamisch festgelegt werden kann.
  • StereoSurfaceEntity.dimensions ist jetzt eine schreibgeschützte Eigenschaft. Anwendungen sollten CanvasShape festlegen, um die Abmessungen zu ändern.
  • Mit StereoSurfaceEntity kann StereoMode jetzt nach der Erstellung zurückgesetzt werden.

Sonstige Änderungen

  • Die compile-time-minSDK wurde auf 24 reduziert. Für alle Jetpack XR-APIs ist weiterhin API 34 zur Laufzeit erforderlich.
  • Die Sitzungsfactory von SceneCore (Session.create) startet keinen Intent mehr, um die Berechtigung SCENE_UNDERSTANDING zu erhalten. Stattdessen muss die Clientanwendung die Berechtigungen explizit vom Nutzer anfordern, bevor sie versucht, die Anker zu erstellen. Die Ankererstellung schlägt fehl, wenn der Nutzer die Berechtigung nicht erteilt.

Diverse Fehlerkorrekturen

  • Der Fehler in getActivitySpacePose() wurde behoben. Die Funktion berücksichtigt jetzt die ActivitySpace-Skalierung und gibt Übersetzungs-Werte in skalierten Metern zurück, anstatt immer nicht skalierte Meter zu verwenden. transformPoseTo verwendet jetzt auch die richtigen Einheiten, um Koordinatenänderungen zu berechnen, wenn ActivitySpace in der Quelle oder im Ziel enthalten ist.
  • Die Skybox wird jetzt auf eine komplett schwarze Skybox festgelegt, wenn mit setSpatialEnvironmentPreference(new SpatialEnvironmentPreference(null, geom)) eine Null-Skybox-Einstellung übergeben wird. Wenn Sie zur Standard-Skybox und ‑Geometrie des Systems zurückkehren möchten, verwenden Sie setSpatialEnvironmentPreference(null)..

Version 1.0.0-alpha01

12. Dezember 2024

androidx.xr.scenecore:scenecore-* 1.0.0-alpha01 ist veröffentlicht.

Funktionen der ersten Version Erste Entwicklerversion von Jetpack SceneCore, einer 3D-Szenengraph-Bibliothek zum Erstellen und Bearbeiten immersiver Szenen und Umgebungen. Mit dieser Bibliothek können Sie 3D-Modelle und Inhaltsbereiche relativ zueinander und zu Ihrer virtuellen oder realen Umgebung platzieren und anordnen.

  • SpatialEnvironment: Mit einem Skybox-Bild und/oder einer 3D-Modellgeometrie als Kulisse für Ihre XR-Szene können Sie vollständig immersive Erlebnisse schaffen. Oder Sie aktivieren den Passthrough-Modus, damit sich die virtuelle Szene in die reale Umgebung des Nutzers einfügen kann.
  • PanelEntity: Sie können Ihren 3D-Szenen 2D-Inhalte hinzufügen, indem Sie Standard-Android-Layouts und ‑Aktivitäten in räumlich angeordnete Bereiche einbetten, die frei schweben oder an Oberflächen in der realen Welt verankert werden können.
  • GltfModelEntity: Mit dieser Funktion können Sie 3D-Modelle in Ihrer Szene platzieren, animieren und mit ihnen interagieren. SceneCore unterstützt das glTF-Dateiformat, um die Integration mit vorhandenen Modellen zu vereinfachen.
  • Spatial Audio: Fügen Sie Ihrer 3D-Szene Umgebungs- und Punkt-Audioquellen hinzu, um einen vollständig immersiven, räumlichen Klang zu erzielen.
  • StereoSurfaceEntity: SceneCore unterstützt das Routing von Inhalten, die auf einer Android-Oberfläche gerendert werden, zum linken und rechten Auge. Damit können stereoskopische Inhalte im Side-by-Side- oder Top-Bottom-Format gerendert werden, z. B. Stereofotos, 3D-Videos oder andere dynamisch gerenderte Benutzeroberflächen. Anwendungen sollten MediaPlayer oder ExoPlayer für die Videodecodierung verwenden.
  • Komponentensystem: SceneCore bietet ein robustes und flexibles Komponentensystem zum Hinzufügen von Funktionen zu Ihren XR-Inhalten, einschließlich Affordanzen für Nutzer, um Modelle und Bereiche zu verschieben, ihre Größe zu ändern und mit ihnen zu interagieren.
  • Anker: Wenn Passthrough aktiviert ist, können Sie Panels und Modelle an realen Oberflächen anbringen. So können Nutzer virtuelle Inhalte nahtlos in ihre reale Umgebung einfügen.
  • Nutzerposition: Ermöglicht den Zugriff auf den Standort des Nutzers in der virtuellen Szene, um Inhalte an der Position des Nutzers auszurichten.
  • SpatialCapabilities: Entwickeln Sie vollständig adaptive Apps, die räumliche Funktionen nutzen, wenn sie verfügbar sind, z. B. die 3D-Positionierung von UI-Inhalten. Außerdem kann Ihre App während der Ausführung auf Änderungen der Funktionen achten, um die Nutzung basierend darauf anzupassen, wie der Nutzer sein Android XR-Gerät verwendet.

Bekannte Probleme

  • Derzeit ist ein minSDK von 30 erforderlich, um Jetpack SceneCore zu verwenden. Als Workaround fügen Sie den folgenden Manifesteintrag <uses-sdk tools:overrideLibrary="androidx.xr.scenecore, androidx.xr.compose"/> hinzu, um mit einem minSDK von 23 erstellen und ausführen zu können.
  • Sitzungen können in verschiedenen Situationen ungültig werden, in denen die Aktivität automatisch neu erstellt wird, z. B. beim Ändern der Größe eines Hauptbereichs, beim Anschließen von Peripheriegeräten und beim Wechseln zwischen hellem und dunklem Modus. Wenn Probleme mit der Sitzungsungültigkeit auftreten, können Sie das Hauptfenster nicht in der Größe ändern, eine dynamische Fensterentität verwenden, die Neuerstellung von Aktivitäten für bestimmte Konfigurationsänderungen deaktivieren oder Änderungen am hellen/dunklen Design deaktivieren.
  • Verschiebbare und in der Größe anpassbare Komponenten werden für GltfEntity nicht unterstützt.
  • Entity.getSize() wird für GltfEntity nicht unterstützt.
  • Jetpack XR-Apps müssen die Berechtigung android.permission.SCENE_UNDERSTANDING in AndroidManifest anfordern.
  • Das Erstellen einer Sitzung wird nur auf Android XR-Geräten unterstützt. Wenn Sie derzeit eine Sitzung erstellen und versuchen, sie auf einem Gerät zu verwenden, das kein Android XR-Gerät ist, erhalten Sie eine RuntimeException.
  • Wenn die Skybox über `SpatialEnvironment.setSpatialEnvironmentPreference()` auf „null“ gesetzt wird, wird nicht wie dokumentiert eine einfarbig schwarze Skybox angezeigt. Das kann dazu führen, dass die Standard-Skybox des Systems angezeigt wird oder sich die aktuelle Skybox nicht ändert.
  • SceneCore-Clients sollten implementation(“com.google.guava:listenablefuture-1.0”) in die Gradle-Konfiguration für die Abhängigkeiten ihrer App einfügen. In einer zukünftigen Version wird diese Bibliothek als api-Abhängigkeit in „scenecore“ enthalten sein, sodass Clients sie nicht explizit deklarieren müssen.
  • SceneCore enthält fälschlicherweise com.google.guava:guava-31.1-android und com.google.protobuf:protobuf-javalite als transitive Abhängigkeiten. Wenn dies zu Fehlern aufgrund doppelter Klassen in Ihrem Build führt, können diese beiden Abhängigkeiten problemlos ausgeschlossen werden.
  • Wenn Ihre App SceneCore verwendet und ProGuard aktiviert ist, stürzt sie beim Erstellen einer Sitzung ab. Als Workaround können Sie ProGuard deaktivieren. In diesem Leitfaden finden Sie weitere Informationen zum Aktivieren von ProGuard.