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

Odpowiednie urządzenia XR
Te wskazówki pomogą Ci tworzyć aplikacje na te typy urządzeń XR.
Gogle XR
Okulary XR z przewodem

ARCore w Jetpacku XR udostępnia aplikacjom zaawansowane funkcje percepcji, które pozwalają im rozpoznawać świat rzeczywisty za pomocą różnych interfejsów API. Niektóre z tych interfejsów API pomagają ulepszać wciągające wrażenia na urządzeniach takich jak gogle XR i przewodowe okulary XR, inne pomagają ulepszać wrażenia związane z rozszerzoną rzeczywistością na urządzeniach takich jak okulary AI, a jeszcze inne pomagają ulepszać wrażenia związane z aplikacjami 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ż aktywność do metody create(), 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: