Tworzenie aplikacji za pomocą pakietu Jetpack XR SDK

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
Okulary audio i
wyświetlające obraz
Więcej informacji o typach urządzeń z XR →

Pakiet SDK Jetpack XR zawiera wszystkie narzędzia i biblioteki potrzebne do tworzenia immersyjnych i rozszerzonych projektów na urządzenia z Androidem XR.

Tworzenie w pełni immersyjnych projektów

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 projekty za pomocą modeli 3D i immersyjnych środowisk. Zalecenia dotyczące dodawania efektów przestrzennych do istniejącej aplikacji na Androida znajdziesz w naszych wytycznych dotyczących jakości.

Tworzenie rozszerzonych i przydatnych projektów

Twórz aplikacje na lekkie i stylowe okulary audio oraz okulary wyświetlające obraz. 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ą wyświetlanie aplikacji z telefonu na okularach.

Korzystanie z bibliotek Jetpack

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

  • Jetpack Compose for XR: deklaratywnie twórz przestrzenne układy interfejsu 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 dla Jetpack XR: wprowadzaj treści cyfrowe do świata rzeczywistego za pomocą funkcji percepcji.
  • Jetpack Compose Glimmer: zestaw narzędzi do tworzenia interfejsu użytkownika, który umożliwia tworzenie rozszerzonych projektów na Androida XR zoptymalizowanych pod kątem okularów wyświetlających obraz.
  • **Jetpack Projected**: interfejsy API, które ułatwiają wyświetlanie aplikacji z telefonu na okularach audio lub okularach wyświetlających obraz.

Tworzenie interfejsu API podczas 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 przestrzennych układów interfejsu 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 Compose w 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 SceneCoreEntity w podprzestrzeni, 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 XR: gogle XR, przewodowe okulary XR, okulary audio, okulary wyświetlające obraz

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 dostosowywać aplikacje.

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

Jetpack Compose Glimmer

Obsługiwane urządzenia XR: okulary wyświetlające obraz

Jetpack Compose Glimmer to zestaw narzędzi do tworzenia interfejsu użytkownika, który umożliwia tworzenie rozszerzonych projektów na Androida XR zoptymalizowanych pod kątem okularów wyświetlających obraz. Twórz piękne, minimalistyczne i wygodne interfejsy 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ą łatwe do odczytania, szybkie do przetworzenia i nie rozpraszają uwagi.
  • 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, które są zoptymalizowane pod kątem środowiska okularów.
Develop UI XR components orbiter generic example

Jetpack Projected

Obsługiwane urządzenia XR: okulary audio, okulary wyświetlające obraz

Gdy tworzysz aplikację na okulary audio i okulary wyświetlające obraz, działa ona na powiązanym urządzeniu hosta, takim jak telefon z Androidem, który wyświetla projekty XR aplikacji. Jetpack Projected umożliwia tym urządzeniom hosta z Androidem komunikowanie się z okularami audio lub okularami wyświetlającymi obraz, jeśli urządzenia hosta mają funkcje projekcji 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 wyświetlające obraz). Ten kontekst wyświetlany zapewnia dostęp do hardware urządzenia wyświetlającego, np. do aparatu. Aktywności utworzone specjalnie do wyświetlania na okularach audio lub okularach wyświetlających obraz działają już jako kontekst wyświetlany. 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świetlany.
  • Uproszczenie próśb o uprawnienia: okulary audio i okulary wyświetlające obraz korzystają z e standardowego modelu uprawnień Androida, z uprawnieniami specyficznymi dla okularów, o które trzeba poprosić w czasie działania aplikacji, zanim będzie ona mogła uzyskać dostęp do hardware urządzenia, np. do 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. Jeśli np. urządzenie nie ma wyświetlacza lub jest on wyłączony, możesz podać więcej kontekstu audio.
  • Dostęp do działań aparatu w aplikacji: aplikacja może uzyskiwać dostęp do działań aparatu użytkownika, np. włączać lub 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.