Środowisko wykonawcze XR

Rozpocznij niestandardową sesję AR lub 3D za pomocą naszego natywnego środowiska wykonawczego.
Ostatnia aktualizacja Wersja stabilna Wersja kandydująca Wersja Beta Wersja alfa
12 lutego 2025 r. - - - 1.0.0-alpha02

Deklarowanie zależności

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

Dodaj zależności dla artefaktów, których potrzebujesz, w pliku build.gradle aplikacji lub modułu:

Groovy

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")
}

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 zauważysz nowe problemy lub masz pomysły na ulepszenie tej biblioteki, daj nam znać. Zanim utworzysz nowy problem, zapoznaj się z dotychczasowymi problemami w tej bibliotece. Możesz oddać głos w sprawie istniejącego problemu, klikając przycisk z gwiazdką.

Tworzenie nowego zgłoszenia

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

Wersja 1.0

Wersja 1.0.0-alpha02

12 lutego 2025 r.

Funkcje 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 komity.

Zmiany w zakresie zmian w funkcjonalności i zachowaniu

  • Funkcje OpenXR środowiska uruchomieniowego, które zwracają element Anchor, teraz zgłaszają 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 punktów kotwiczenia jest bardziej stabilne podczas działania na emulatorze.

Wersja 1.0.0-alpha01

12 grudnia 2024 r.

androidx.xr.runtime:runtime-* 1.0.0-alpha01 został zwolniony.

Funkcje wersji początkowej

Pierwsza wersja Jetpack XR Runtime. Ta biblioteka zawiera podstawowe funkcje pakietu bibliotek Jetpack XR. Obejmuje to m.in. wykrywanie możliwości, zarządzanie cyklem życia i konfigurację. Biblioteka Runtime udostępnia różne wersje (np. runtime-openxr lub runtime-testing) w zależności od platformy wykonania. Dodatkowo biblioteka ta udostępnia 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ść określania, kiedy ma być wykonywane przetwarzanie, a kiedy nie, oraz ogólną konfigurację. Jest to też uchwyt, którego użyjesz we wszystkich innych interfejsach API, aby odblokować podstawowe funkcje systemu.

  • Pose: lokalizacja w dowolnym układzie współrzędnych, która ma powiązaną pozycję i orientację. Użyjesz tej klasy, aby przekazywać lokalizację obiektów za pomocą ARCore dla Jetpack XR i Jetpack SceneCore.

Znane problemy

  • configure jest obecnie nieaktywna. W przyszłych wersjach dodamy nowe ustawienia, które pozwolą Ci kontrolować działanie Session.