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.
Więcej informacji o typach urządzeń z XR →
Gogle XR
Przewodowe okulary XR
Więcej informacji o typach urządzeń z XR →

ARCore dla Jetpack XR zapewnia zaawansowane możliwości percepcji, dzięki którym aplikacja może rozpoznawać ś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 rozszerzone 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 dla Jetpack XR, aby pobierać dane płaskie, 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ń, które chcesz ulepszyć za pomocą AR.

Uzyskiwanie dostępu do sesji

Funkcje percepcji w ARCore dla Jetpack XR korzystają z Session, która używa Jetpack XR Runtime.

Sposób, w jaki aplikacja powinna uzyskiwać dostęp do sesji, zależy od typów wrażeń, 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(this)) {
    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: