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 Twoja aplikacja może 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 dla 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ń, 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 z 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:

Dostęp do sesji z Jetpack XR Runtime

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

Aby utworzyć sesję, przekaż Context do metody create(). Ten Context może być Activity na urządzeniach z imersyjną rzeczywistością rozszerzoną lub urządzeniach mobilnych albo kontekstem projekcji.

Utworzenie sesji ARCore może być kosztownym zadaniem, dlatego należy je przetwarzać w tle, jak pokazano w tym przykładzie:

lifecycleScope.launch {
    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 Twoja 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: