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

Obsługiwane urządzenia XR
Ten przewodnik pomoże Ci tworzyć aplikacje na te typy urządzeń XR.
Gogle XR
Przewodowe okulary XR

ARCore for Jetpack XR udostępnia zaawansowane funkcje percepcji, które pozwalają aplikacji rozumieć świat rzeczywisty za pomocą różnych interfejsów API. Niektóre z tych interfejsów API pomagają ulepszać imersyjne wrażenia na urządzeniach takich jak gogle XR i przewodowe okulary XR, inne pomagają ulepszać wrażenia rozszerzonej rzeczywistości na urządzeniach takich jak okulary AI, a jeszcze inne pomagają ulepszać wrażenia z aplikacji na wszystkich typach urządzeń z Androidem XR.

Możesz na przykład użyć ARCore for Jetpack XR, aby pobierać dane płaszczyzn, zakotwiczać treści w stałej lokalizacji 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 typu wrażeń z aplikacji, które chcesz ulepszyć za pomocą AR.

Uzyskiwanie dostępu do sesji

Funkcje percepcji w ARCore for Jetpack XR opierają się na Session, która korzysta z Jetpack XR Runtime.

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

Uzyskiwanie dostępu do sesji z Jetpack XR Runtime

Aby uzyskać dostęp do sesji z Jetpack XR Runtime, musisz ją utworzyć:

Aby utworzyć sesję, przekaż aktywność do create() metody, 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 stanie się nieważna.

Konfigurowanie sesji

Niektóre funkcje mogą być domyślnie wyłączone i aby działały, trzeba je skonfigurować. Aby skonfigurować sesję, użyj configure() i określ opcje konfiguracji , których potrzebuje Session. Szczegółowe informacje o wymaganej konfiguracji różnych funkcji AR znajdziesz na odpowiednich stronach dotyczących poszczególnych funkcji AR.

Dalsze kroki

Gdy aplikacja będzie miała sesję, dowiedz się, jak możesz jej używać do ulepszania wrażeń z aplikacji na różnych urządzeniach XR: