Środowisko wykonawcze XR

Rozpocznij niestandardową sesję AR lub 3D za pomocą naszego natywnego środowiska wykonawczego.
Najnowsza aktualizacja Wersja stabilna Wersja kandydująca do publikacji Wersja beta Wersja alfa
7 października 2026 r. - 1.0.0-rc02 - 1.1.0-alpha01

Deklarowanie zależności

Aby dodać zależność od środowiska wykonawczego XR, musisz dodać do projektu repozytorium Maven Google. 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:

Odlotowe

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

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

Kotlin

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

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

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

Prześlij opinię

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 oddać głos na istniejący problem, klikając przycisk gwiazdki.

Tworzenie nowego problemu

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

Środowisko wykonawcze

Wersja 1.0

Wersja 1.0.0-rc02

7 października 2026 r.

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

Poprawki błędów

  • Naprawiono różne problemy w androidx.xr.runtime i androidx.xr.scenecore, aby zwiększyć bezpieczeństwo pamięci i poprawić zarządzanie cyklem życia zasobów. Obejmuje to aktualizacje logiki obsługi kontekstu i czyszczenia odwołań, które zapobiegają wyciekom pamięci. (Id61f8)

Wersja 1.1

Wersja 1.1.0-alpha01

9 września 2026 r.

Publikacja androidx.xr.runtime:runtime-*:1.1.0-alpha01 Wersja 1.1.0-alpha01 zawiera te zmiany.

Zmiany w interfejsie API

  • Dodaj SPATIAL_API_V4 do SpatialApiVersions (I71e7a)

Wersja 1.0

Wersja 1.0.0-rc01

9 września 2026 r.

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

Zmiany w zachowaniu

  • Ulepszona obsługa wewnętrznych zdarzeń związanych z cyklem życia. (I2f7b8, If1bc3, Ifa75e)

Wersja 1.0.0-beta02

12 sierpnia 2026 r.

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

Poprawki błędów

  • Ulepszono wykrywanie obsługi OpenXR w emulowanych środowiskach. (Ifec51)
  • Więcej zajęć z zastosowaniem kontenera toString() na potrzeby debugowania. (I67d83)
  • Naprawiono działanie funkcji XrDeviceTestRule, gdy XrDevice jest tworzony po zastosowaniu ustawień. (Ica32c)

Wersja 1.0.0-beta01

15 lipca 2026 r.

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

Zmiany w interfejsie API

  • Dodano SessionTestRule do testowania w czasie działania. Ten interfejs API (I672bc, b/516876144)
  • Zmieniliśmy funkcję Converted Session.create na funkcję zawieszającą. (I5d27f)
  • Dodano obsługę cyklu życia w przypadku XrDeviceTestRule (I2319c, b/512140272)
  • Usunięto nieużywaną adnotację ExperimentalXrDeviceLifecycleApi dotyczącą eksperymentalnego wyrażania zgody. (I46d95)
  • Dodaj specjalistyczne zastąpienia toString() dla różnych typów środowiska wykonawczego. Te typy mają na celu dostarczanie deweloperom dodatkowych informacji na potrzeby debugowania i nie są przeznaczone do używania w aplikacjach produkcyjnych ani w aplikacjach dostarczanych użytkownikom.

Poprawki błędów

  • Naprawiliśmy pozycję stałąfromLookAt, wyrównanie w kierunku do przodu, poprawiliśmy wyodrębnianie skali w Matrix3 i zapobiegliśmy numerycznemu NaNs w normalizacji, konwersji osi i kąta oraz obliczeniach angleBetween. (I7a3b5, b/367780918)

Wersja 1.0.0-alpha15

17 czerwca 2026 r.

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

Zmiany w interfejsie API

  • Dodano interfejs API testu dla isProjectedServiceAvailable() (I44ba1)
  • Udostępniliśmy interfejs DeviceTrackingMode.INERTIAL jako publiczny eksperymentalny interfejs API z nową adnotacją @ExperimentalInertialTrackingApi. (Ic3df3)
  • Dodano: Config.Builder. Aplikacje mogą tworzyć niestandardowe konfiguracje, wywołując funkcje ustawiające na obiekcie konstruktora, a następnie wywołując Builder.build. (I13142)
  • Usunięto androidx.xr.runtime.FieldOfView. Aplikacje powinny zamiast tego używać funkcji androidx.xr.runtime.math.FieldOfView. (I621ef)
  • Session.create musi być teraz uruchamiana na urządzeniu @WorkerThread. (I2169e)
  • Dodano isProjectedServiceAvailable() do XrDevice (I507e9)
  • Zmiana nazwy DeviceTrackingMode.SPATIAL_LAST_KNOWN na DeviceTrackingMode.SPATIAL i DeviceTrackingMode.INERTIAL_LAST_KNOWN na DeviceTrackingMode.INERTIAL (I96f8b)
  • Funkcje Vector3.angleBetween i Vector4.angleBetween zwracają teraz stopnie zamiast radianów. (Ica8bc)
  • Dodano QrCode API (Ia0bbe)

Wersja 1.0.0-alpha14

19 maja 2026 r.

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

Zmiany w interfejsie API

  • Wyłączamy GeospatialMode.VPS_AND_GPS na rzecz GeospatialMode.SPATIAL i wprowadzamy nowy tryb śledzenia o niższym zużyciu energii, GeospatialMode.INERTIAL, który korzysta tylko z IMU i GPS-a. (I1e6cd)
  • Usuwa tag wycofania z androidx.xr.runtime.FieldOfView. Sprawia, że androidx.xr.runtime.math.FieldOfView jest aliasem typu androidx.xr.runtime.FieldOfView w przygotowaniu do usunięcia tego drugiego w następnej wersji. Klienci muszą przejść na wersję androidx.xr.runtime.math wszędzie tam, gdzie używają wersji androidx.xr.runtime. (I6ce15)
  • Dodano adnotację PreviewProjectedApi (Ic49f6)
  • Usunięto AugmentedObjectCategory.allSupported (I08656)
  • Dodanie interfejsów API w XrDevice do określania obsługi przez urządzenie śledzenia dłoni, śledzenia wzroku, szacowania głębi, danych geoprzestrzennych i renderowania. (I00696)
  • Session.getNativeData zostało zastąpione przez XrDevice.getNativeInstanceData i Session.getNativeSessionData. (Ieb077)
  • Dodano adnotację DeviceTrackingMode.INERTIAL_LAST_KNOWN z użyciem @PreviewSpatialApi. (I99868)
  • Dodano XrDeviceTestRule do użycia w testach jednostkowych. (I87584)
  • Dodanie CATEGORY_XR_PROJECTED_LAUNCHER. Ta stała jest używana w pliku manifestu, aby wskazać, że system powinien wykrywać działanie jako program uruchamiający. (Ia3069)

Wkład zewnętrzny

  • Dodaj AugmentedImageMode do interfejsu Config API (I0cf09)

Wersja 1.0.0-alpha13

6 maja 2026 r.

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

Zmiany w interfejsie API

  • TrackingState i VpsAvailabilityResult zostały przeniesione do androidx.xr.arcore package, a typy w androidx.xr.runtime są teraz wycofane. (Ic7930, b/480462213)
  • Session.getNativeData() jest teraz zdefiniowany w module xr:runtime:runtime i zapewnia [nativeFunctionTablePointer] dla środowisk wykonawczych opartych na OpenXR. (Ifa862)
  • Przeniesiono interfejs API NativeData do biblioteki xr:runtime:runtime. (I87954, b/494251500)
  • Funkcje Session.create i Session.configure nie są już wyczerpujące i wymagają klauzul else w instrukcjach when. (I9885e, b/495805998, b/495805998)
  • Środowisko wykonawcze androidx.xr.runtime.FieldOfView zostało wycofane. Zamiast niej użyj zasady androidx.xr.runtime.math.FieldOfView. (Ia01a0, b/480233045)
  • Nazwę konta usługi Matrix4.pose zmieniono na Matrix4.toPose(). Właściwość pose została wycofana. (I329b4, b/493383490)
  • Dodano interfejs API XrServiceAvailability (If379e, b/493558010)
  • Dodano adnotację ExperimentalXrServiceAvailabilityApi (Icab49, b/491069725)
  • Usuń sufiks dla @PreviewSpatialApi (If5242, b/491939311)
  • Zmieniono nazwę DeviceTrackingMode.LAST_KNOWN na SPATIAL_LAST_KNOWN (z wycofanym elementem zastępczym), dodano INERTIAL_LAST_KNOWN do śledzenia 3DoF i dodano TRACKING_DEGRADED do TrackingState. (Ie661c, b/445466590)
  • Dodano interfejs API XrLog. Ustaw wartość XrLog.isEnabled na true, aby włączyć rejestrowanie w JetpackXR, i użyj [XrLog.Level], aby ustawić poziom rejestrowania. (I76a1f, b/463460895, b/487378441)
  • Dodanie DISPLAY_CATEGORY_XR_PROJECTED. Ta stała jest używana w pliku manifestu, aby wskazać, że działanie jest przeznaczone dla wyświetlacza projekcyjnego XR (I26d8b).

Wersja 1.0.0-alpha12

25 marca 2026 r.

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

Zmiany w interfejsie API

  • Zmieniono typ Config.augmentedObjectCategories z List na Set (I25a64, b/487376359)
  • Usunięto flagę unscaledGravityAlignedActivitySpace z konta Session.create. ActivitySpace jest teraz zawsze nieskalowany i wyrównany do grawitacji. (If6f11, b/458173423)
  • Dodano przeciążenie Session.create, aby umożliwić przekazywanie kontekstu Androida na potrzeby określania zakresu zasobów. (I7d3fe, b/415805990, b/477386334)
  • Dodano JvmOverloads do FloatSize2d.to3d, Matrix3.copy i Matrix4.copy (I69586, b/481371562)
  • Dodano możliwość ustawiania kategorii śledzenia AugmentedObject w konfiguracji (I1f6e4, b/480220930).
  • Dodano moduł xr:runtime:runtime-interfaces. (I52ac6, b/461561664)

Wersja 1.0.0-alpha11

25 lutego 2026 r.

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

Zmiany w interfejsie API

  • Ograniczenie interfejsu ConfigMode do użytku wewnętrznego (Ibfb87)
  • Przeniesiono androidx.xr.runtime.Config.GeospatialMode na poziom pakietu (Ibe682)
  • Przeniesiono androidx.xr.runtime.Config.FaceTrackingMode na poziom pakietu (Iac501)
  • Przeniesiono androidx.xr.runtime.Config.AnchorPersistenceMode na poziom pakietu (I0360f)
  • Przeniesiono androidx.xr.runtime.Config.DepthEstimationMode na poziom pakietu (I7e3e9)
  • Przeniesiono androidx.xr.runtime.Config.DeviceTrackingMode na poziom pakietu (I3aacd)
  • Przeniesiono androidx.xr.runtime.Config.HandTrackingMode na poziom pakietu (I658f3)
  • Przeniesiono androidx.xr.runtime.Config.PlaneTrackingMode na poziom pakietu (Ia251b)
  • Przeniesiono androidx.xr.runtime.XrDevice.DisplayBlendMode na poziom pakietu (I6f333)
  • Dodaliśmy metodę fabryczną do tworzenia obiektu XrDevice za pomocą obiektu Context, Session i CoroutineContext. (I139c5)
  • Dodano SpatialApiVersionHelper, aby ułatwić wysyłanie zapytań o wersję środowiska wykonawczego Androida XR dostępną na platformie. (I7c53c)
  • Dodano moduł xr:runtime:runtime-openxr (Ib42ea)

Wersja 1.0.0-alpha10

28 stycznia 2026 r.

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

Zmiany w interfejsie API

  • ConfigMode.HeadTrackingMode zostanie zastąpiony tekstem ConfigMode.DeviceTrackingMode. (le273e, b/467150206)
  • Usunięto metody kwaternionu toNormalized, times(float), div(float). Te metody są zbędne, ponieważ wszystkie kwaterniony są normalizowane w momencie tworzenia, a klasa jest niezmienna. (l558fc, b/460210457)

Poprawki błędów

  • Dodaliśmy dokumentację Session.create, która pokazuje, jak uniknąć tworzenia sesji w głównym wątku aplikacji. (le5554, b/463687170)
  • Uniemożliwia aplikacjom tworzenie BoundingBox z wartością NaN. (l58c14, b/464025895)

Wersja 1.0.0-alpha09

3 grudnia 2025 r.

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

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 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 API XrDisplay.BlendMode. (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 je wartością 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 dla componentWiseMultiplication na Vector2, Vector3, Vector4 w celu skalowania i usunięcie symbolu operatora w celu zachowania spójności z innymi bibliotekami matematycznymi. Usunięcie componentWiseDivision z klas Vector na rzecz używania Vector.scale(otherVector.inverse()). (I8e1f6, b/399146447)
  • Dodanie [unscaled] spowoduje zwrócenie macierzy o skali 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 publicznie implementację konfiguracji. (I95860, b/334645808)
  • Wprowadziliśmy nowe typy robotów 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. Użyj w zamian zasady androidx.xr.runtime.FieldOfView. (I9ae27)
  • Dodano dodatkowe przeciążenie dla Session.create, które może udostępniać 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)
  • Zmieniono nazwę FakeRuntimeAnchor.anchorsCreated 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żywania KGP w wersji 2.0.0 lub nowszej (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 używa teraz 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 interfejsy API asynchroniczne w stylu Kotlin. Programiści Java mogą korzystać z :xr:runtime:runtime-guava, aby uzyskać 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ś coroutines do :xr:runtime:runtime-guava, a flows do :xr:runtime:runtime-rxjava3. (I60ae9)
  • Funkcje Session.create i Session.configure zgłaszają teraz błąd SecurityException, gdy nie przyznano wystarczających uprawnień, zamiast zwracać wartości 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ą udostępnione. 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 znaków manifestu dla Androida XR są określone i udokumentowane tutaj.
  • Dodano metody rozszerzenia Spatial Visibility Callback, aby monitorować, kiedy zawartość sceny przesuwa się w obrębie pola widzenia użytkownika lub poza nie.
  • Dodaliśmy wersję szkieletową JxrPlatformAdapter (i wszystkie powiązane z nią klasy).
  • Zamiast sesji w SceneCore w SceneCore i w czasie działania będzie używana sesja.
  • 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 momencie wykonania zostanie wczytany tylko jeden 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 publicznie implementację konfiguracji. (I95860)
  • Dodaj HandJointType i TrackingState. (I55880)
  • Projekty wydane w Kotlinie 2.0 wymagają 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 dotyczące 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 konfigurowalnej funkcji środowiska wykonawczego.
  • Funkcję Session.configure można teraz wywołać za pomocą parametru Config, aby skonfigurować dostępne funkcje środowiska wykonawczego.
  • Session.create obsługuje teraz przekazywanie CoroutineContext zamiast CoroutineDispatcher.
  • Session.create obsługuje wczytywanie ARCore w przypadku Jetpack XR lub SceneCore. Musisz podać co najmniej 1 wartość (dostępne są wersje testowe).
  • FakePerceptionManager zgłasza wyjątek 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 środowiska wykonawczego.

Wersja 1.0.0-alpha03

26 lutego 2025 r.

Wersje 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ą udostępnione. Wersja 1.0.0-alpha02 zawiera te zmiany.

Zmiany powodujące niezgodność i zmiany w działaniu

  • 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

  • Dodaliśmy 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. Ta biblioteka 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 możliwości systemu.

  • Pose: lokalizacja w dowolnym układzie współrzędnych, która ma przypisane położenie i orientację. Będziesz używać tej klasy do przekazywania informacji o lokalizacji obiektów do ARCore na potrzeby 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.