ARCore w Jetpack XR

Przenoszenie cyfrowych treści do świata rzeczywistego dzięki funkcjom percepcji.
Ostatnia aktualizacja Wersja stabilna Wersja kandydująca Wersja Beta Wersja alfa
12 grudnia 2024 r. - - - 1.0.0-alpha01

Deklarowanie zależności

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

Odlotowe

dependencies {
    implementation "androidx.xr.arcore:arcore:1.0.0-alpha01"
}

Kotlin

dependencies {
    implementation("androidx.xr.arcore:arcore: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 dodać swój głos do 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-alpha01

12 grudnia 2024 r.

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

Funkcje dostępne w pierwszej wersji

Biblioteka ARCore dla Jetpacka XR, która powstała na podstawie dotychczasowej biblioteki ARCore, umożliwia łączenie treści cyfrowych ze światem rzeczywistym. Biblioteka ta obejmuje śledzenie ruchu, trwałe kotwy, testowanie uderzeń oraz identyfikację płaszczyzny z oznaczeniem semantycznym (np. podłoga, ściany i blaty). Aby dowiedzieć się więcej o ARCore w Jetpack XR, zapoznaj się z przewodnikiem dla programistów.

  • Session: ARCore dla Jetpacka XR korzysta z biblioteki Jetpack XR Runtime, aby obsługiwać swoje funkcje. Sesji używa się do interakcji z większą liczbą interfejsów ARCore dla Jetpack XR API, dlatego zapoznaj się z ich dokumentacją.

  • Plane: użyj samolotów, aby poznać świat wokół siebie. Każdy samolot ma Label, który opisuje go semantycznie. Możesz użyć subscribe, aby otrzymywać powiadomienia o ostatnio wykrytych samolotach, lub state, aby otrzymywać powiadomienia o zmianach dotyczących konkretnego samolotu.

  • Anchor: połączenie między obiektem wirtualnym a lokalizacją w świecie rzeczywistym. Kotwy można przyczepiać do określonej lokalizacji w przestrzeni (za pomocą create) lub do Trackable (za pomocą createAnchor).

    • Kotwic można używać ponownie w różnych sesjach. Możesz ich używać za pomocą funkcji persist (do przechowywania), getPersistedAnchorUuids (do zliczania) i load (do pobierania). Pamiętaj, aby unpersist je usunąć, gdy przestaną być używane.

    • Punkty kotwiczenia są kompatybilne między ARCore dla Jetpacka XR i Jetpacka SceneCore. Możesz utworzyć AnchorEntity za pomocą zakotwiczenia lub, jeśli masz już obiekt AnchorEntity, możesz użyć metody getAnchor, aby pobrać jego zakotwiczenie.

    • Zapewnij użytkownikom naturalne interakcje za pomocą hitTest. Funkcja hitTest używa Ray, aby określić, z czym się przecina, i utworzyć Anchor z tego miejsca. Rozważ przeprowadzenie testu hitTest z urządzenia InputEvent.

Znane problemy

  • Pomiędzy wywołaniem funkcji unpersist a usunięciem z wyników zwracanych przez funkcję getPersistedAnchorUuids identyfikatora UUID może minąć pewien czas.

  • create nie sprawdza, czy system ma wystarczające zasoby, aby zwrócić nowe kotwy. Utworzenie zbyt dużej liczby kotwic może spowodować awarię.

  • Zapisywanie punktu odniesienia, który został wcześniej zapisany i usuwany, nie jest obecnie obsługiwane.

  • Aplikacja może być używana w emulatorze, ale jej działanie może nie być tak stabilne jak na rzeczywistym urządzeniu. W szczególności wywołania funkcji create mogą zakończyć się błędem kodu natywnego i natychmiast zakończyć działanie.

  • W pewnych okolicznościach podczas wywoływania funkcji persist może zostać błędnie wyrzucony błąd RuntimeException z komunikatem „An anchor was not persisted” („Nie udało się zapisać kotwicy”). W takich przypadkach funkcja i tak zostanie wykonana, a kotwica zostanie zapisana. Jako rozwiązanie zalecamy umieszczenie wywołania funkcji persist w bloku try.