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 urządzenia XR.

Więcej informacji o typach urządzeń XR →

Gogle XR

Przewodowe okulary XR

Okulary AI

Więcej informacji o typach urządzeń XR →

ARCore dla Jetpack XR udostępnia zaawansowane funkcje percepcji, które umożliwiają aplikacji rozpoznawanie ś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 rozszerzonej rzeczywistości 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łaskie, 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 opierają się na Session, która korzysta ze ś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:

Jeśli Twoja aplikacja wzbogaca wciągające wrażenia za pomocą przestrzennego interfejsu z użyciem Jetpack Compose na XR, uzyskaj dostęp do sesji z Jetpack Compose na XR.
W innych sytuacjach możesz uzyskać dostęp do sesji z Jetpack XR Runtime, co opisujemy w następnej sekcji na tej stronie.

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(this)) {
    is SessionCreateSuccess -> {
        val xrSession = result.session
        // ...
    }
    else ->
        TODO(/* A different unhandled exception was thrown. */)
}Session.kt

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: