ARCore für Jetpack XR

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

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

dependencies {
    implementation "androidx.xr.arcore:arcore:1.0.0-alpha13"

    // Optional dependencies for asynchronous conversions
    implementation "androidx.xr.arcore:arcore-guava:1.0.0-alpha13"
    implementation "androidx.xr.arcore:arcore-rxjava3:1.0.0-alpha13"
}

dependencies {
    implementation("androidx.xr.arcore:arcore:1.0.0-alpha13")

    // Optional dependencies for asynchronous conversions
    implementation("androidx.xr.arcore:arcore-guava:1.0.0-alpha13")
    implementation("androidx.xr.arcore:arcore-rxjava3:1.0.0-alpha13")
}

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

6. Mai 2026

androidx.xr.arcore:arcore-*:1.0.0-alpha13 ist veröffentlicht. Version 1.0.0-alpha13 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)
• Hand.HandSide wurde in HandSide umbenannt. (Ica562, b/482675376)
• Plane.Label wurde in PlaneLabel umbenannt. (Ic6b67, b/482675376)
• Geospatial.Surface wurde in GeospatialSurface umbenannt. (I1a8be, b/482675376)
• Geospatial.State wurde in GeospatialState umbenannt. (I203fa, b/482675376)
• Die NativeData API wurde in die xr:runtime:runtime-Bibliothek verschoben. (I87954, b/494251500)
• Session.create und Session.configure sind jetzt nicht mehr erschöpfend und erfordern „else“-Klauseln in „when“-Anweisungen. (I9885e, b/495805998, b/495805998)
• androidx.xr.runtime.FieldOfView wurde eingestellt. Verwenden Sie stattdessen androidx.xr.runtime.math.FieldOfView. (Ia01a0, b/480233045)
• Orbiter verwendet jetzt entweder ein OrbiterAnchorPoint + VolumeOffset oder ein OrbiterPoseProvider anstelle von „position“, „offset“, „offsetType“, „alignment“ und „elevation“. Außerdem wurde der Parameter shouldRenderInNonSpatial entfernt. Wenn der Entwickler nicht möchte, dass der Orbiter in nicht räumlichen Umgebungen gerendert wird, sollte er den Orbiter in eine if-Anweisung einfügen und SpatialCapabilities prüfen. (I9fbb3, b/462428503)
• Es wurden verschiebbare Modifikatoren hinzugefügt. Diese Modifikatoren funktionieren derzeit gut für SpatialPanels und SpatialExternalSurface. Bald werden sie auch für SpatialGltfModels unterstützt. Wir möchten jedoch, dass diese für alle SubspaceComposables gut unterstützt werden. (I9a3cd, b/479530787, b/478935063, b/478935063)
• Entwickler müssen den ArDevice.state-Flow zur Überwachung von State.trackingState einhalten und das Rendern oder die Warnungen ihrer Anwendung entsprechend der Tracking-Genauigkeit anpassen. (Ic00f0, b/445466590)
• Die HandJointType-Enum-Werte wurden umbenannt. (Ifbc83, b/482670596)
• FaceConfidenceRegion-Konstanten umbenannt. (Ia62d5, b/482670596)
• FaceBlendShapeType-Konstanten umbenannt. (I33b8b, b/482670596)
• CreatePoseFromGeospatialPoseErrorInternal und CreateGeospatialPoseFromPoseErrorInternal wurden hinzugefügt. (I4bcf1, b/482666615)
• DeviceTrackingMode.LAST_KNOWN wurde in SPATIAL_LAST_KNOWN umbenannt (mit einem eingestellten Fallback), INERTIAL_LAST_KNOWN für 3DoF-Tracking wurde hinzugefügt und TRACKING_DEGRADED wurde zu TrackingState hinzugefügt. (Ie661c, b/445466590)
• GroupEntity ist veraltet. Wenn Sie eine Entität mit nur der grundlegenden Entitätsfunktionalität haben möchten, rufen Sie Entity.create auf. Dadurch wird eine Entitätsschnittstelle zurückgegeben. (I4c450, b/473867483)
• Die XrLog API wurde hinzugefügt. Legen Sie für XrLog.isEnabled den Wert true fest, um das Logging in JetpackXR zu aktivieren, und verwenden Sie XrLog.Level, um die Protokollebene festzulegen. (I76a1f, b/463460895, b/487378441)

Fehlerkorrekturen

• Füge den Support für den Gerätestatus „Tracking“ zu den OpenXR-Geräten hinzu. (I91485, b/445466590)

Version 1.0.0-alpha12

25. März 2026

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

API-Änderungen

• Config.augmentedObjectCategories wurde von einer Liste in eine Menge geändert. (I25a64, b/487376359)
• Die Typen androidx.xr.arcore.Eye und androidx.xr.arcore.Hand. (I42438, b/449032900)
• Es wurde eine Session.create-Überladung hinzugefügt, um die Übergabe eines Android-Kontexts für die Ressourcenbereichsbegrenzung zu ermöglichen. (I7d3fe, b/415805990, b/477386334)
• Ändert FakeRuntimeAnchor.ANCHOR_RESOURCE_LIMIT in FakeRuntimeAnchor.anchorResourceLimit. (I90841, b/431992235)
• Die TiltGesture API wird als experimentell eingestuft, da sie in Zukunft geändert oder entfernt werden kann. Wenn Sie diese API verwenden möchten, müssen Sie @ExperimentalGesturesApi (Ic9858) aktivieren.
• Es wurde die Möglichkeit hinzugefügt, Kategorien für das AugmentedObject-Tracking in der Konfiguration festzulegen (I1f6e4, b/480220930).

Fehlerkorrekturen

• Der Chrome-Build wurde korrigiert, indem die Datei META-INF/services/ mit dem tatsächlichen Speicherort von PerceptionRuntimeFactory aktualisiert wurde. (I7a801, b/481288291)

Version 1.0.0-alpha11

25. Februar 2026

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

Version 1.0.0-alpha10

28. Januar 2026

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

Neue Funktionen

• Die TiltGesture API wird eingeführt, die eine reaktive Flow für die stabile Erkennung des Neigungszustands (UP/DOWN) des Geräts mit Übergangsprozess bietet. (Ic269f, b/448152779)
• ARCore für Jetpack XR verwendet jetzt den XR-Laufzeitprotokollierungsmechanismus. Weitere Informationen finden Sie unter androidx.xr.runtime.Log. (l52735, b/448697662)

API-Änderungen

• Geospatial.createPoseFromGeospatialPose funktioniert jetzt auf OpenXR-kompatiblen Geräten. (l362c6)

Version 1.0.0-alpha09

3. Dezember 2025

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

Version 1.0.0-alpha08

19. November 2025

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

Neue Funktionen

• ARCore für Jetpack XR unterstützt jetzt Geräte, auf denen Google Play-Dienste für AR verfügbar sind.
• Geospatial APIs für VPS-Verfügbarkeit und Pose-Konvertierung hinzugefügt (I144dc)

Version 1.0.0-alpha07

22. Oktober 2025

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

Fehlerkorrekturen

• :xr:arcore:arcore-openxr wurde als Implementierungsabhängigkeit zu :xr:arcore:arcore hinzugefügt (I47315, b/446999229).

Version 1.0.0-alpha06

24. September 2025

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

API-Änderungen

• Die Unterstützung für Tests für ARCore wurde zum xr:arcore:arcore-testing-Modul migriert. (I25469)
• ArDevice und RenderViewpoint wurden hinzugefügt, damit Anwendungen die Geräteausrichtung und die Displaykonfiguration für das Rendern abrufen können. (Ib7e3f)
• Benennen Sie HandJointType-Enums mit dem Präfix HAND_JOINT_TYPE_ um. (I3f7cd)
• HandJointType wurde von xr:runtime:runtime nach xr:arcore:arcore verschoben. (Iadb9c, b/409058039)
• Hand.State stellt jetzt eine java.nio.FloatBuffer mit den Gelenk-Posen in einem Format bereit, das einen einfachen Zugriff auf leistungsbezogene Anwendungen ermöglicht. (I55e27)

Version 1.0.0-alpha05

30. Juli 2025

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

Neue Funktionen

• Füge getPrimaryHandSide hinzu, damit der Entwickler die Informationen auf der rechten Seite (I270bd) erhält.
• Geospatial Check VPS Availability API hinzufügen (I58573)
• ARCore API für checkVpsAvailability (Idbded) hinzufügen
• stateFlowable-Erweiterungsfunktionen, die :xr:arcore:arcore-rxjava3 hinzugefügt wurden, damit sie von Java-Entwicklern verwendet werden können. (I083aa, b/427247794)

API-Änderungen

• Die Konfigurationswerte für *Mode wurden umbenannt, um ihr Verhalten besser widerzuspiegeln. (I6d247, b/414648065)
• Das Haupt-ARCore-Artefakt (xr:arcore:arcore) enthält nur asynchrone APIs im Kotlin-Stil. Java-Entwickler können die xr:arcore:arcore-rxjava3-Bibliothek verwenden, um auf kompatible APIs zuzugreifen. (Ia525e, b/422794329)
• Das Haupt-ARCore-Artefakt (xr:scenecore:scenecore) enthält nur asynchrone APIs im Kotlin-Stil. Java-Entwickler können die xr:arcore:arcore-guava-Bibliothek verwenden, um auf kompatible APIs zuzugreifen. (Iffcb4, b/422773524)
• Anchor.persistAsync() wurde AnchorGuava zur Verwendung durch Java-Entwickler hinzugefügt. (I4af1c, b/425984631)
• Earth.createAnchorOnSurfaceAsync(Session, Double, Double, Double, Quaternion, Surface) wurde EarthGuava zur Verwendung durch Java-Entwickler hinzugefügt. (I66357, b/425992992)
• Java-Entwickler verwenden die Erweiterungsfunktionen für GltfModel.createAsync in GltfModel.kt. Asynchrone Funktionen in GltfModel werden gelöscht. (I0af60)
• 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, b/326456246)
• subscribeAsFlowable-Erweiterungsfunktionen, die :xr:arcore:arcore-rxjava3 hinzugefügt wurden, damit sie von Java-Entwicklern verwendet werden können. (Id3e49, b/427277298)

Version 1.0.0-alpha04

7. Mai 2025

androidx.xr.arcore:arcore:1.0.0-alpha04 ist veröffentlicht. Version 1.0.0-alpha04 enthält diese Commits.

API-Änderungen

• Für Projekte, die mit Kotlin 2.0 veröffentlicht wurden, ist KGP 2.0.0 oder höher erforderlich. (Idb6b5)
• TrackingState und HandJointType wurden von ARCore zur Laufzeit verschoben.
• Hand.State.isActive (boolean) wurde in Hand.State.trackingState (androidx.xr.runtime.TrackingState) geändert.
• Anchor.load gibt Anchor.AnchorLoadInvalidUuid zurück, wenn die UUID ungültig ist.

Version 1.0.0-alpha03

26. Februar 2025

androidx.xr.arcore:arcore:1.0.0-alpha03 wird ohne nennenswerte Änderungen seit der letzten Alphaversion veröffentlicht. Version 1.0.0-alpha03 enthält diese Commits.

Version 1.0.0-alpha02

12. Februar 2025

androidx.xr.arcore:arcore:1.0.0-alpha02 ist veröffentlicht. Version 1.0.0-alpha02 enthält diese Commits.

Neue Funktionen

• Unterstützung für Handtracking hinzugefügt. Verwenden Sie Hand.left und Hand.right, um auf die Tracking-Informationen zuzugreifen.
• APIs, die einen Anker generieren (Anchor.create, Anchor.load, Plane.createAnchor), geben jetzt alle AnchorCreateResult zurück und implementieren AnchorCreateResourcesExhausted korrekt.

Diverse Fehlerkorrekturen

• Anchor.detach führt nicht mehr zu einem schwerwiegenden Absturz aufgrund einer Race-Bedingung mit dem Thread für die Sitzungsaktualisierung.
• Anchor.create ist stabiler, wenn es auf einem Emulator ausgeführt wird

Version 1.0.0-alpha01

12. Dezember 2024

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

Funktionen der Erstveröffentlichung

Die ARCore for Jetpack XR-Bibliothek ist von der vorhandenen ARCore-Bibliothek inspiriert und bietet Funktionen zum Einblenden digitaler Inhalte in die reale Welt. Diese Bibliothek umfasst Funktionen wie Bewegungserkennung, persistente Anker, Treffertests und die Identifizierung von Ebenen mit semantischer Kennzeichnung (z. B. Boden, Wände und Tischplatten). Weitere Informationen zur Verwendung von ARCore für Jetpack XR finden Sie im Entwicklerleitfaden.

• Session: ARCore für Jetpack XR nutzt die Jetpack XR-Laufzeit im Hintergrund, um seine Funktionen zu ermöglichen. Sie verwenden eine Sitzung für die Interaktion mit den meisten ARCore für Jetpack XR-APIs. Sehen Sie sich daher die Dokumentation dazu an.

• Plane: Mit Ebenen können Sie die Welt um sich herum besser verstehen. Jede Ebene hat ein Label, das sie semantisch beschreibt. Mit subscribe können Sie sich über die zuletzt erkannten Flugzeuge benachrichtigen lassen und mit state über Änderungen an einem bestimmten Flugzeug.

• Anchor: Eine Verknüpfung zwischen einem virtuellen Objekt und einem realen Ort. Anker können an einem bestimmten Ort im Raum (mit create) oder an einem Trackable (mit createAnchor) angebracht werden.

  • Anker können sitzungsübergreifend wiederverwendet werden. Sie können persist verwenden, um sie zu speichern, getPersistedAnchorUuids, um sie aufzulisten, und load, um sie abzurufen. unpersist Sie sie, sobald sie nicht mehr verwendet werden.

  • Anker sind zwischen ARCore für Jetpack XR und Jetpack SceneCore interoperabel. Sie können ein AnchorEntity mit einem Anker erstellen. Wenn Sie bereits eine AnchorEntity haben, können Sie mit getAnchor den zugehörigen Anker abrufen.

  • Bieten Sie natürliche Nutzerinteraktionen mit hitTest. Bei einem Hit-Test wird ein Ray verwendet, um zu ermitteln, welche Inhalte es schneidet, und um an dieser Stelle ein Anchor zu erstellen. Führen Sie einen Hit-Test über ein InputEvent aus.

Bekannte Probleme

• Zwischen dem Aufrufen von unpersist und dem Entfernen der zugehörigen UUID aus den Ergebnissen, die von getPersistedAnchorUuids zurückgegeben werden, kann es zu einer Verzögerung kommen.

• Mit create wird nicht geprüft, ob das System genügend Ressourcen hat, um neue Anker zurückzugeben. Wenn Sie zu viele Anker erstellen, kann es zu einem Absturz kommen.

• Das Speichern eines Ankers, der zuvor gespeichert und dann wieder entfernt wurde, wird derzeit nicht unterstützt.

• Die Verwendung im Emulator wird unterstützt, das Verhalten ist jedoch möglicherweise nicht so stabil wie auf einem echten Gerät. Insbesondere Aufrufe von create können mit einem nativen Codefehler fehlschlagen und die Aktivität sofort beenden.

• Unter bestimmten Umständen kann beim Aufrufen von persist mit der Meldung „Anchor was not persisted“ (Anker wurde nicht gespeichert) fälschlicherweise eine RuntimeException ausgelöst werden. In diesen Fällen ist die Funktion jedoch weiterhin erfolgreich und der Anker wird gespeichert. Als Workaround empfehlen wir, den Aufruf von persist in einen try-Block einzuschließen.