Ulepszanie aplikacji dzięki funkcji percepcji za pomocą ARCore dla Jetpack XR

Odpowiednie urządzenia XR
Te wskazówki pomogą Ci tworzyć treści na te typy urządzeń XR.
Więcej informacji o typach urządzeń z XR
Gogle XR
Okulary XR z przewodem
Więcej informacji o typach urządzeń z XR

ARCore dla Jetpack XR zapewnia aplikacjom zaawansowane funkcje percepcji, które umożliwiają poznawanie świata rzeczywistego za pomocą różnych interfejsów API. Niektóre z tych interfejsów API pomagają ulepszać funkcje immersyjne na urządzeniach takich jak gogle XR i przewodowe okulary XR, inne pomagają ulepszać funkcje rozszerzone na urządzeniach takich jak okulary AI, a jeszcze inne pomagają ulepszać funkcje aplikacji na wszystkich typach urządzeń z Androidem XR.

Możesz na przykład użyć ARCore w Jetpacku XR, aby pobierać dane płaszczyzny, zakotwiczać treści w stałym miejscu w przestrzeni lub używać pozycji geoprzestrzennej do zakotwiczania treści w rzeczywistej lokalizacji.

Dodawanie zależności biblioteki

Zanim zaczniesz korzystać z funkcji percepcji w aplikacji XR, dodaj niezbędne zależności w zależności od rodzaju aplikacji, które chcesz ulepszyć za pomocą AR.

Dostęp do sesji

Funkcje percepcji w ARCore dla Jetpack XR korzystają z Session, który używa środowiska wykonawczego Jetpack XR.

Sposób, w jaki aplikacja powinna uzyskiwać dostęp do sesji, zależy od typów funkcji aplikacji, które chcesz ulepszyć za pomocą funkcji percepcji:

Dostęp do sesji z poziomu środowiska wykonawczego Jetpack XR

Aby uzyskać dostęp do sesji z poziomu środowiska wykonawczego Jetpack XR, musisz ją utworzyć:

Aby utworzyć sesję, przekaż [Context] do metody create(). Może to być ContextActivity na urządzeniach XR lub urządzeniach mobilnych albo projeksja kontekstu.

Tworzenie sesji ARCore może być kosztownym zadaniem, dlatego powinno być przetwarzane w tle, jak pokazano w tym przykładzie:

when (val result = Session.create(context)) {
    is SessionCreateSuccess -> {
        val xrSession = result.session
        // ...
    }
    else ->
        TODO(/* A different unhandled exception was thrown. */)
}

Gdy aktywność sesji zostanie zniszczona, wszystkie treści AR powiązane z tą sesją zostaną zniszczone, a sesja przestanie być ważna.

Konfigurowanie sesji

Niektóre funkcje mogą być domyślnie wyłączone i muszą zostać skonfigurowane, aby działać. Aby skonfigurować sesję, użyj configure() i określ opcje konfiguracji, których potrzebuje Session. Szczegółowe informacje o konfiguracji wymaganej w przypadku różnych funkcji AR znajdziesz na odpowiednich stronach poświęconych poszczególnym funkcjom AR.

Dalsze kroki

Gdy aplikacja będzie miała sesję, sprawdź, jak możesz jej używać, aby zwiększać komfort korzystania z aplikacji na różnych urządzeniach XR: