Środowisko wykonawcze XR

Aby dodać zależność od środowiska wykonawczego XR, musisz dodać repozytorium Google Maven do projektu. Więcej informacji znajdziesz w repozytorium Maven Google.

Dodaj zależności dotyczące potrzebnych artefaktów w pliku build.gradle aplikacji lub modułu:

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

    // Optional dependencies for asynchronous conversions
    implementation "androidx.xr.runtime:runtime-guava:1.0.0-alpha08"
    implementation "androidx.xr.runtime:runtime-rxjava3:1.0.0-alpha08"

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

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

    // Optional dependencies for asynchronous conversions
    implementation("androidx.xr.runtime:runtime-guava:1.0.0-alpha08")
    implementation("androidx.xr.runtime:runtime-rxjava3:1.0.0-alpha08")

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

Więcej informacji o zależnościach znajdziesz w artykule Dodawanie zależności kompilacji.

Opinia

Twoja opinia pomoże nam ulepszyć Jetpacka. Jeśli odkryjesz nowe problemy lub masz pomysły na ulepszenie tej biblioteki, daj nam znać. Zanim utworzysz nową kartę, zapoznaj się z dotychczasowymi problemami w tej bibliotece. Możesz dodać swój głos do istniejącego problemu, klikając przycisk gwiazdki.

Tworzenie nowego problemu

Więcej informacji znajdziesz w dokumentacji narzędzia Issue Tracker.

Wersja 1.0

Wersja 1.0.0-alpha08

19 listopada 2025 r.

Publikacja androidx.xr.runtime:runtime-*:1.0.0-alpha08 Wersja 1.0.0-alpha08 zawiera te zmiany.

Nowe funkcje

• XrDevice dodano, aby podać informacje o możliwościach urządzenia. (Ic9d1f)
• Dodano nowy ConfigMode.isSupported interfejs API do wysyłania zapytań o możliwości sesji. (Iff7af)
• Dodano interfejs XrDisplay.BlendMode API. (I484e4)

Zmiany w interfejsie API

• Zmieniono nazwę [XrDevice.getPreferredBlendMode] na [XrDevice.getPreferredDisplayBlendMode]. (I7e48f)

Wersja 1.0.0-alpha07

22 października 2025 r.

Publikacja androidx.xr.runtime:runtime-*:1.0.0-alpha07 Wersja 1.0.0-alpha07 zawiera te zmiany.

Zmiany w interfejsie API

• Usuń SessionConfigureConfigureNotSupported i zastąp go elementem UnsupportedOperationException. (I7680f)

Wersja 1.0.0-alpha06

24 września 2025 r.

Publikacja androidx.xr.runtime:runtime-*:1.0.0-alpha06 Wersja 1.0.0-alpha06 zawiera te zmiany.

Zmiany w interfejsie API

• HandJointType został przeniesiony z xr:runtime:runtime do xr:arcore:arcore. (Iadb9c, b/409058039)
• Zmiana operatora mnożenia × na ⋅, ×, × w celu skalowania i usunięcie symbolu operatora w celu zachowania spójności z innymi bibliotekami matematycznymi.componentWiseMultiplicationVector2Vector3Vector4 Usuwamy też componentWiseDivision z klas Vector i zastępujemy go elementem Vector.scale(otherVector.inverse()). (I8e1f6, b/399146447)
• Dodanie [unscaled] spowoduje zwrócenie macierzy ze skalą równą 1. (I6381d, b/434928658)
• :xr:runtime:runtime-guava zostanie usunięty, ponieważ Coroutines.kt został zastąpiony przez SuspendtoFutureAdapter. (I0cd3c, b/406597902)

Wersja 1.0.0-alpha05

30 lipca 2025 r.

Publikacja androidx.xr.runtime:runtime-*:1.0.0-alpha05 Wersja 1.0.0-alpha05 zawiera te zmiany.

Nowe funkcje

• Dodaj HandJointType i TrackingState. (I55880, b/334645808)
• Udostępnij implementację konfiguracji publicznie. (I95860, b/334645808)
• Wprowadziliśmy nowe typy SessionCreateResult i SessionConfigureResult. (Icb8cb, b/334645808)
• Dodaj nową klasę BoundingBox, która reprezentuje prostopadłościenny obszar ograniczający w przestrzeni 3D, zdefiniowany przez minimalne i maksymalne punkty narożne. (Ic68c5, b/423073468)

Zmiany w interfejsie API

• Zmieniono nazwę i przeniesiono androidx.xr.scenecore.PixelDimensions do androidx.xr.runtime.math.IntSize2d. Zmieniono nazwę i przeniesiono androidx.xr.scenecore.Dimensions do androidx.xr.runtime.math.FloatSize3d. Zmieniono nazwę androidx.xr.scenecore.PlaneType na androidx.xr.scenecore.PlaneOrientation. Zmieniono nazwę androidx.xr.scenecore.PlaneSemantic na androidx.xr.scenecore.PlaneSemanticType. (Ifd405, b/416456228)
• Usunięto zajęcia androidx.xr.runtime.FoV. Zamiast niej użyj zasady androidx.xr.runtime.FieldOfView. (I9ae27)
• Dodano dodatkowe przeciążenie dla Session.create, które może zapewnić LifecycleOwner dla sesji do dołączenia. Pamiętaj, że w przypadku własności zasobu nadal musisz podać aktywność, a właściwość LifecycleOwner musi być ograniczona do tej aktywności. (I1690b)
• Nazwa FakeRuntimeAnchor.anchorsCreated została zmieniona na anchorsCreatedCount (I96df9, b/424441218)
• Nazwy wartości konfiguracji *Mode zostały zmienione, aby odzwierciedlały ich działanie. (I6d247, b/414648065)
• Projekty wydane w Kotlinie 2.0 wymagają użycia KGP 2.0.0 lub nowszego (Idb6b5, b/344563182).
• Interfejsy API powiązane z ciągami znaków w pliku manifestu zostały przeniesione z :xr:runtime:runtime do :xr:runtime:runtime-manifest. Nazwa pakietu zmieniła się z androidx.xr.runtime na androidx.xr.runtime.manifest. (I610ad, b/418800249)
• Session.resume(), Session.pause() i Session.destroy() zostały usunięte z interfejsu API. Sesja nie jest już LifecycleOwner. Cykl życia sesji będzie teraz powiązany z cyklem życia aktywności przekazanej w parametrze Session.create(). (I28a03)
• Ta biblioteka korzysta teraz z adnotacji o wartości null JSpecify, które są używane w typie. Deweloperzy Kotlin powinni używać tego argumentu kompilatora, aby wymusić prawidłowe użycie: -Xjspecify-annotations=strict (jest to domyślne ustawienie od wersji 2.1.0 kompilatora Kotlin) (Ia8420, b/326456246)
• Główny artefakt środowiska wykonawczego (:xr:runtime:runtime) będzie zawierać tylko asynchroniczne interfejsy API w stylu Kotlin. Programiści Java mogą korzystać z :xr:runtime:runtime-guava, aby uzyskiwać dostęp do zgodnych interfejsów API. (I05d4a, b/426639315)
• Główny artefakt środowiska wykonawczego (:xr:runtime:runtime) będzie zawierać tylko asynchroniczne interfejsy API w stylu Kotlin. Programiści Java mogą korzystać z biblioteki xr:runtime:runtime-rxjava3, aby uzyskiwać dostęp do zgodnych interfejsów API. (I64122, b/426639775)
• Przenieś korutyny do :xr:runtime:runtime-guava, a Flow do :xr:runtime:runtime-rxjava3. (I60ae9)
• Session.create i Session.configure zwracają teraz SecurityException, gdy nie przyznano wystarczających uprawnień, zamiast zwracać SessionCreatePermissionsNotGranted lub SessionConfigurePermissionsNotGranted. (I7c488, b/430651879)

Wersja 1.0.0-alpha04

7 maja 2025 r.

androidx.xr.runtime:runtime:1.0.0-alpha04, androidx.xr.runtime:runtime-openxr:1.0.0-alpha04 i androidx.xr.runtime:runtime-testing:1.0.0-alpha04 są dostępne. Wersja 1.0.0-alpha04 zawiera te zmiany.

Nowe funkcje

• Sesja implementuje teraz androidx.lifecycle.LifecycleOwner, co zapewnia większą interoperacyjność z dotychczasowymi paradygmatami cyklu życia Androida.
• Ciągi tekstowe manifestu dla Androida XR są określone i udokumentowane tutaj.
• Dodano metody rozszerzenia wywołania zwrotnego widoczności przestrzennej, aby monitorować, kiedy zawartość sceny przesuwa się w obrębie pola widzenia użytkownika lub poza nie.
• Dodano wersję szkieletową JxrPlatformAdapter (i wszystkich powiązanych z nią klas).
• Sesja będzie używana zarówno w przypadku SceneCore, jak i czasu działania zamiast sesji w SceneCore.
• Dodano emotikon ActivityPose.hitTest, który umożliwia hitTest w przypadku treści wirtualnych.
• Określanie wielu implementacji środowiska wykonawczego w czasie kompilacji jest teraz obsługiwane. W czasie wykonywania zostanie wczytana tylko jedna z nich, w zależności od zestawu funkcji bieżącego urządzenia.
• Dodano nowy typ komponentu SpatialPointerComponent, który umożliwia klientom określenie ikony renderowanej dla wskaźnika lub wyłączenie ikony. Ten komponent można obecnie dołączać tylko do instancji PanelEntity.

Zmiany w interfejsie API

• Udostępnij implementację konfiguracji publicznie. (I95860)
• Dodaj HandJointType i TrackingState. (I55880)
• Projekty wydane w Kotlinie 2.0 wymagają do użycia KGP 2.0.0 lub nowszego (Idb6b5).
• Wartość Hand.isActive (boolean) została zmieniona na Hand.trackingState. Implementacja usługi OpenXR została odpowiednio zmodyfikowana.
• Wymaganie uprawnień android.permission.SCENE_UNDERSTANDING w Session.configure zostało zmienione na android.permission.SCENE_UNDERSTANDING_COARSE.
• LifecycleManager.configure jest zaimplementowana i teraz przekazuje obiekt Config, który zawiera właściwość dla każdej funkcji środowiska wykonawczego, którą można skonfigurować.
• Session.configure można teraz wywołać za pomocą Config, aby skonfigurować dostępne funkcje środowiska wykonawczego.
• Session.create obsługuje teraz przekazywanie CoroutineContext zamiast CoroutineDispatcher.
• Session.create obsługuje ładowanie ARCore w przypadku Jetpack XR lub SceneCore. Musisz podać co najmniej 1 wersję (dostępne są wersje testowe).
• FakePerceptionManager zgłasza AnchorInvalidUuidException, gdy do funkcji Anchor.load i Anchor.unpersist przekazywany jest nieprawidłowy identyfikator UUID.
• CoreState nie jest już klasą danych.

Poprawki błędów

• Naprawiono konfiguracje ProGuard w środowisku wykonawczym.

Wersja 1.0.0-alpha03

26 lutego 2025 r.

androidx.xr.runtime:runtime:1.0.0-alpha03, androidx.xr.runtime:runtime-openxr:1.0.0-alpha03 i androidx.xr.runtime:runtime-testing:1.0.0-alpha03 zostały udostępnione bez istotnych zmian w porównaniu z ostatnią wersją alfa. Wersja 1.0.0-alpha03 zawiera te zmiany.

Wersja 1.0.0-alpha02

12 lutego 2025 r.

androidx.xr.runtime:runtime:1.0.0-alpha02, androidx.xr.runtime:runtime-openxr:1.0.0-alpha02 i androidx.xr.runtime:runtime-testing:1.0.0-alpha02 są dostępne. Wersja 1.0.0-alpha02 zawiera te zmiany.

Zmiany w zachowaniu i łamanie zasad

• Funkcje środowiska wykonawczego OpenXR, które zwracają element Anchor, zgłaszają teraz błąd AnchorResourcesExhaustedException, jeśli napotkają kod błędu informujący o osiągnięciu limitu zasobów OpenXR.
• Uprawnienie android.permission.HAND_TRACKING jest teraz wymagane w przypadku Session.create i Session.resume.

Nowe funkcje

• Dodano obsługę śledzenia rąk.

Poprawki błędów

• Tworzenie kotwic jest bardziej stabilne podczas korzystania z emulatora.

Wersja 1.0.0-alpha01

12 grudnia 2024 r.

Publikacja androidx.xr.runtime:runtime-* 1.0.0-alpha01

Funkcje pierwszej wersji

Pierwsza wersja środowiska wykonawczego Jetpack XR. Ta biblioteka zawiera podstawowe funkcje pakietu bibliotek Jetpack XR. Obejmuje to wykrywanie funkcji, zarządzanie cyklem życia, konfigurację i inne działania. Biblioteka środowiska wykonawczego udostępnia różne warianty (np. runtime-openxr lub runtime-testing) w zależności od platformy wykonawczej. Biblioteka ta oferuje też podstawowe abstrakcje matematyczne, takie jak Vector3 i Matrix4, które są używane w całym interfejsie Jetpack XR API.

• Session: zapewnia precyzyjną kontrolę nad systemem XR, w tym możliwość decydowania, kiedy przetwarzanie jest wykonywane, a kiedy nie, oraz ogólną konfigurację. Jest to też uchwyt, którego będziesz używać we wszystkich innych interfejsach API, aby odblokować podstawowe funkcje systemu.

• Pose: lokalizacja w dowolnym układzie współrzędnych, z którą powiązane są pozycja i orientacja. Będziesz używać tej klasy do przekazywania ARCore informacji o lokalizacji obiektów w przypadku Jetpack XR i Jetpack SceneCore.

Znane problemy

• configure nie ma obecnie żadnego działania. W przyszłych wersjach dodamy nowe ustawienia, których możesz używać do kontrolowania działania Session.