XR-Laufzeit

Starten Sie Ihre benutzerdefinierte AR- oder 3D-Sitzung mit unserer nativen Laufzeit.
Letzte Aktualisierung Stabile Version Release-Kandidat Beta-Ausgabe Alphaversion
12. Februar 2025 - – - 1.0.0-alpha02

Abhängigkeiten deklarieren

Wenn Sie eine Abhängigkeit von der XR-Laufzeit 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 erforderlichen Artefakte hinzu:

Cool

dependencies {
    implementation "androidx.xr.runtime:runtime:1.0.0-alpha01"

    // Use in environments that do not support OpenXR
    testImplementation "androidx.xr.runtime:runtime-testing:1.0.0-alpha01"
}

Kotlin

dependencies {
    implementation("androidx.xr.runtime:runtime:1.0.0-alpha01")

    // Use in environments that do not support OpenXR
    testImplementation("androidx.xr.runtime:runtime-testing:1.0.0-alpha01")
}

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

Feedback

Ihr Feedback hilft uns, Jetpack zu verbessern. Bitte teilen Sie uns mit, wenn Sie neue Probleme feststellen oder Ideen zur Verbesserung dieser Bibliothek haben. Sehen Sie sich die vorhandenen Probleme in dieser Bibliothek an, bevor Sie ein neues erstellen. Sie können einem vorhandenen Problem Ihre Stimme geben, indem Sie auf die Schaltfläche mit dem Stern klicken.

Neues Problem erstellen

Weitere Informationen finden Sie in der Dokumentation zum Issue Tracker.

Version 1.0

Version 1.0.0-alpha02

12. Februar 2025

androidx.xr.runtime:runtime:1.0.0-alpha02, androidx.xr.runtime:runtime-openxr:1.0.0-alpha02 und androidx.xr.runtime:runtime-testing:1.0.0-alpha02 werden losgelassen. Version 1.0.0-alpha02 enthält diese Commits.

Nicht abwärtskompatible Änderungen und Verhaltensänderungen

  • OpenXR-Laufzeitfunktionen, die einen Anker zurückgeben, werfen jetzt AnchorResourcesExhaustedException, wenn ein Fehlercode auftritt, der darauf hinweist, dass das OpenXR-Ressourcenlimit erreicht wurde.
  • Die Berechtigung android.permission.HAND_TRACKING ist jetzt für Session.create und Session.resume erforderlich.

Neue Funktionen

  • Unterstützung für Handtracking hinzugefügt.

Fehlerkorrekturen

  • Das Erstellen von Markierungen ist bei der Ausführung in einem Emulator stabiler

Version 1.0.0-alpha01

12. Dezember 2024

androidx.xr.runtime:runtime-* 1.0.0-alpha01 wird veröffentlicht.

Funktionen der Erstversion

Erste Version der Jetpack XR-Laufzeit. Diese Bibliothek enthält grundlegende Funktionen für die Jetpack XR-Bibliotheken. Dazu gehören unter anderem die Funktionserkennung, die Lebenszyklusverwaltung und die Konfiguration. Die Runtime-Bibliothek bietet je nach Ausführungsplattform verschiedene Varianten (z.B. runtime-openxr oder runtime-testing). Außerdem bietet diese Bibliothek grundlegende mathematische Abstraktionsfunktionen wie Vector3 und Matrix4, die in der gesamten Jetpack XR API verwendet werden.

  • Session: Bietet detaillierte Einstellungen für das XR-System, einschließlich der Entscheidung, wann die Verarbeitung ausgeführt wird und wann nicht, sowie der Gesamtkonfiguration. Außerdem verwenden Sie diesen Handle für alle anderen APIs, um die zugrunde liegenden Systemfunktionen zu nutzen.

  • Pose: Ein Ort in einem beliebigen Koordinatensystem, dem eine Position und Orientierung zugeordnet ist. Mit dieser Klasse können Sie den Standort von Objekten mit ARCore für Jetpack XR und Jetpack SceneCore kommunizieren.

Bekannte Probleme

  • configure hat derzeit keine Funktion. In zukünftigen Releases werden neue Einstellungen hinzugefügt, mit denen Sie das Verhalten von Session steuern können.