Tworzenie aplikacji za pomocą pakietu Jetpack XR SDK

Obsługiwane urządzenia XR
Te wskazówki pomogą Ci tworzyć aplikacje na te typy urządzeń XR.
Gogle XR
Przewodowe okulary XR
Okulary z wyświetlaczem i funkcjami
audio

Pakiet SDK Jetpack XR zawiera wszystkie narzędzia i biblioteki potrzebne do tworzenia immersyjnych i rozszerzonych doświadczeń na urządzeniach z Androidem XR.

Tworzenie w pełni immersyjnych doświadczeń

Twórz aplikacje na urządzenia o wysokiej jakości, takie jak gogle XR i przewodowe okulary XR. Używaj nowoczesnych narzędzi do tworzenia aplikacji na Androida, takich jak Kotlin i Compose, a także narzędzi poprzedniej generacji, takich jak Java i Views. Możesz dodawać efekty przestrzenne do interfejsu, wczytywać i renderować modele 3D oraz semantycznie rozumieć świat rzeczywisty.

Jeśli masz już aplikację mobilną lub aplikację na duży ekran na Androida, pakiet SDK Jetpack XR przeniesie ją w nowy wymiar dodając efekty przestrzenne do istniejących układów i ulepszając wrażenia dzięki modelom 3D i immersyjnym środowiskom. Nasze zalecenia dotyczące dodawania efektów przestrzennych do istniejącej aplikacji na Androida znajdziesz w wskazówkach dotyczących jakości.

Tworzenie rozszerzonych i przydatnych doświadczeń

Twórz aplikacje na lekkie i stylowe okulary audio i okulary z wyświetlaczem. Używaj nowoczesnych narzędzi do tworzenia aplikacji na Androida, takich jak Kotlin i Jetpack Compose Glimmer. Korzystaj z interfejsów API, które ułatwiają tworzenie aplikacji wyświetlanych na okularach z telefonu.

Korzystanie z bibliotek Jetpack

Biblioteki pakietu SDK Jetpack XR zapewniają kompleksowy zestaw narzędzi do tworzenia bogatych, immersyjnych doświadczeń, lekkich, rozszerzonych doświadczeń i wszystkiego pomiędzy. Te biblioteki są częścią pakietu SDK Jetpack XR:

  • Jetpack Compose dla XR: deklaratywnie twórz układy interfejsu przestrzennego które wykorzystują możliwości przestrzenne Androida XR.
  • Material Design for XR: twórz aplikacje za pomocą komponentów i układów Material które dostosowują się do XR.
  • Jetpack SceneCore: twórz i modyfikuj wykres sceny Androida XR za pomocą treści 3D.
  • ARCore for Jetpack XR: Wprowadzaj treści cyfrowe do świata rzeczywistego dzięki możliwościom percepcji.
  • Jetpack Compose Glimmer: zestaw narzędzi do tworzenia interfejsu użytkownika na potrzeby rozszerzonych doświadczeń na Androidzie XR, zoptymalizowany pod kątem okularów z wyświetlaczem.
  • Jetpack Projected: interfejsy API, które ułatwiają tworzenie aplikacji wyświetlanych na okularach audio lub okularach z wyświetlaczem z telefonu.

Tworzenie interfejsu API w wersji przedpremierowej dla programistów

Biblioteki pakietu SDK Jetpack XR są częścią wersji przedpremierowej Androida XR dla programistów, a te interfejsy API są nadal w trakcie opracowywania. Znane problemy znajdziesz w informacjach o wersji biblioteki:

Jeśli napotkasz problem, którego nie ma na żadnej z tych list, zgłoś błąd lub prześlij opinię.

Jetpack Compose for XR

Obsługiwane urządzenia XR: gogle XR, przewodowe okulary XR

Dzięki Jetpack Compose for XR możesz używać znanych koncepcji Compose takich jak wiersze i kolumny do tworzenia układów interfejsu przestrzennego w XR, niezależnie od tego, czy przenosisz istniejącą aplikację 2D do XR, czy tworzysz nową aplikację XR od podstaw.

Ta biblioteka udostępnia komponenty podprzestrzeni, takie jak panele przestrzenne i orbitery, które umożliwiają umieszczenie istniejącego interfejsu 2D opartego na Compose lub Views w układzie przestrzennym.

Szczegółowe wskazówki znajdziesz w artykule Tworzenie interfejsu za pomocą Jetpack Compose for XR.

Develop UI XR components orbiter generic example

Compose for XR wprowadza komponent podprzestrzeni SceneCoreEntity, który umożliwia umieszczanie elementów, takich jak modele 3D, względem interfejsu.

Dowiedz się, jak dodać efekty przestrzenne do istniejącej aplikacji na Androida, lub zapoznaj się z dokumentacją interfejsu API , aby uzyskać więcej informacji.

Material Design for XR

Obsługiwane urządzenia XR: gogle XR, przewodowe okulary XR

Material Design udostępnia komponenty i układy, które dostosowują się do XR. Jeśli tworzysz aplikację z układami adaptacyjnymi. Dowiedz się więcej o implementowaniu Material Design for XR.

Jetpack SceneCore

Obsługiwane urządzenia XR: gogle XR, przewodowe okulary XR

Biblioteka Jetpack SceneCore umożliwia umieszczanie i rozmieszczanie treści 3D, zdefiniowanych przez elementy, względem siebie i otoczenia. Dzięki SceneCore możesz:

Biblioteka Jetpack SceneCore obsługuje też dodawanie efektów przestrzennych do aplikacji utworzonych za pomocą Views. Więcej informacji znajdziesz w naszym przewodniku dotyczącym pracy z widokami.

Więcej informacji znajdziesz w dokumentacji API.

ARCore for Jetpack XR

Obsługiwane urządzenia z XR: gogle XR, przewodowe okulary XR, okulary audio, okulary z wyświetlaczem

Biblioteka ARCore for Jetpack XR, inspirowana istniejącą biblioteką ARCore, umożliwia łączenie treści cyfrowych ze światem rzeczywistym. Ta biblioteka obejmuje śledzenie ruchu, trwałe kotwice, testowanie trafień i identyfikację płaszczyzn z etykietami semantycznymi (np. podłoga, ściany i blaty). Ta biblioteka wykorzystuje podstawowy stos percepcji oparty na OpenXR, co zapewnia zgodność z szeroką gamą urządzeń i pomaga w przyszłości zabezpieczyć aplikacje.

Więcej informacji znajdziesz w artykule Praca z ARCore for Jetpack XR.

Jetpack Compose Glimmer

Obsługiwane urządzenia XR: okulary z wyświetlaczem

Jetpack Compose Glimmer to zestaw narzędzi do tworzenia interfejsu użytkownika na potrzeby rozszerzonych doświadczeń na Androidzie XR, zoptymalizowany pod kątem okularów z wyświetlaczem. Twórz piękne, minimalistyczne i wygodne interfejsy użytkownika na urządzenia, które są noszone przez cały dzień.

  • Stworzone z myślą o czytelności i przejrzystości: w przeciwieństwie do telefonów głównym obszarem roboczym jest optyczny wyświetlacz przezroczysty. Jetpack Compose Glimmer zapewnia motywy dostosowane do okularów, uproszczone palety kolorów i typografię, dzięki czemu treści są czytelne, szybko się przetwarzają i nie rozpraszają.
  • Zoptymalizowane pod kątem interakcji specyficznych dla urządzeń do noszenia: zoptymalizowaliśmy modele interakcji pod kątem sposobu korzystania z okularów. Komponenty Jetpack Compose Glimmer mają wyraźne stany fokusu, takie jak zoptymalizowane kontury zamiast rozpraszających efektów falowania, i są przystosowane do obsługi typowych danych wejściowych, takich jak kliknięcia, przesunięcia na ramce i oczywiście głos.
  • Używaj znanych deklaratywnych wzorców interfejsu: ponieważ Jetpack Compose Glimmer jest w całości oparty na Jetpack Compose, możesz używać wszystkich znanych Ci informacji o tworzeniu deklaratywnego interfejsu w Androidzie. Udostępniamy pełny zestaw podstawowych, gotowych funkcji Composable, takich jak Text, Icon, Button i specjalistyczne komponenty, np. TitleChip, zoptymalizowane pod kątem środowiska okularów.
Develop UI XR components orbiter generic example

Jetpack Projected

Obsługiwane urządzenia z XR: okulary audio, okulary z wyświetlaczem

Gdy tworzysz aplikację na okulary z funkcjami audio i wyświetlaczem, działa ona na powiązanym urządzeniu hosta, takim jak telefon z Androidem, który wyświetla aplikacje XR. Jetpack Projected umożliwia tym urządzeniom hosta z Androidem komunikowanie się z okularami z funkcjami audio lub wyświetlaczem, jeśli urządzenia hosta mają funkcje wyświetlania XR.

  • Dostęp do hardware urządzenia wyświetlającego: kontekst urządzenia powiązany z urządzeniem wyświetlającym (okulary audio lub okulary z wyświetlaczem). Ten kontekst wyświetlania zapewnia dostęp do hardware urządzenia wyświetlającego, np. aparatu. Aktywności utworzone specjalnie do wyświetlania na okularach z funkcjami audio lub wyświetlaczem działają już jako kontekst wyświetlania. Jeśli inna część aplikacji (np. aktywność na telefonie lub usługa) musi mieć dostęp do hardware okularów' , może uzyskać kontekst wyświetlania.
  • Uproszczenie próśb o uprawnienia: okulary audio i okulary z wyświetlaczem korzystają ze standardowego modelu uprawnień Androida, z uprawnieniami specyficznymi dla okularów, o które trzeba poprosić w czasie działania, zanim aplikacja będzie mogła uzyskać dostęp do sprzętu urządzenia, np. aparatu. Pomocnik uprawnień upraszcza te mechanizmy próśb o uprawnienia zarówno w interfejsie telefonu, jak i okularów, aby zapewnić spójne działanie.
  • Sprawdzanie możliwości urządzenia i wyświetlacza: sprawdź, czy urządzenie wyświetlające ma wyświetlacz i jaki jest jego stan, aby wyświetlać obrazy. Dostosuj aplikację do możliwości urządzenia. Na przykład możesz podać więcej kontekstu audio, jeśli urządzenie nie ma wyświetlacza lub jest on wyłączony.
  • Dostęp do działań aparatu aplikacji: aplikacja może uzyskiwać dostęp do działań aparatu użytkownika, np. włączać i wyłączać aparat w aplikacji do odtwarzania strumieniowego wideo.

OpenXR™ i logo OpenXR są znakami towarowymi należącymi do The Khronos Group Inc. i są zarejestrowane jako znaki towarowe w Chinach, Unii Europejskiej, Japonii i Wielkiej Brytanii.