Sviluppare con l'SDK Jetpack XR

Dispositivi XR applicabili
Queste indicazioni ti aiutano a creare esperienze per questi tipi di dispositivi XR.
Visori XR
Occhiali XR con cavo
AI Glasses

L'SDK Jetpack XR include tutti gli strumenti e le librerie necessari per creare esperienze immersive e aumentate per i dispositivi Android XR.

Creare esperienze completamente immersive

Prendi di mira dispositivi dedicati ad alta fedeltà come visori XR e occhiali XR con cavo. Utilizza strumenti di sviluppo Android moderni come Kotlin e Compose, nonché strumenti di generazione precedente come Java e Views. Puoi spazializzare la tua UI, caricare ed eseguire il rendering di modelli 3D e comprendere semanticamente il mondo reale.

Se hai già un'app mobile o per schermi di grandi dimensioni su Android, l'SDK Jetpack XR porta la tua app in una nuova dimensione spazializzando i layout esistenti e migliorando le tue esperienze con modelli 3D e ambienti immersivi. Consulta le nostre linee guida sulla qualità per i nostri consigli su come spazializzare la tua app per Android esistente.

Creare esperienze aumentate e utili

Target occhiali AI leggeri ed eleganti. Utilizza strumenti di sviluppo Android moderni come Kotlin e Jetpack Compose Glimmer. Utilizza API che facilitano le esperienze di app proiettate da uno smartphone agli occhiali AI.

Utilizzare le librerie Jetpack

Le librerie dell'SDK Jetpack XR forniscono un toolkit completo per creare esperienze ricche, immersive, leggere, aumentate e tutto ciò che si trova nel mezzo. Le seguenti librerie fanno parte dell'SDK Jetpack XR:

  • Jetpack Compose per XR: crea in modo dichiarativo layout di UI spaziali che sfruttano le funzionalità spaziali di Android XR.
  • Material Design per XR: crea con componenti e layout Material che si adattano all'XR.
  • Jetpack SceneCore: crea e manipola il grafico della scena di Android XR con contenuti 3D.
  • ARCore per Jetpack XR: porta i contenuti digitali nel mondo reale con funzionalità di percezione.
  • Jetpack Compose Glimmer: un toolkit UI per la creazione di esperienze Android XR di realtà aumentata, ottimizzato per gli occhiali AI con display.
  • Jetpack Projected: API che facilitano le esperienze delle app proiettate da uno smartphone a occhiali AI.

Sviluppo di API durante l'anteprima per gli sviluppatori

Le librerie dell'SDK Jetpack XR fanno parte dell'anteprima per gli sviluppatori di Android XR e queste API sono ancora in fase di sviluppo. Consulta le note di rilascio della libreria per i problemi noti:

Se riscontri un problema non presente in uno di questi elenchi, segnala un bug o invia un feedback.

Jetpack Compose per XR

Dispositivi XR applicabili: visori XR, occhiali XR con cavo

Con Jetpack Compose per XR, puoi utilizzare i concetti di Compose che conosci, come righe e colonne, per creare layout della UI spaziali in XR, sia che tu stia portando un'app 2D esistente in XR o creando una nuova app XR da zero.

Questa libreria fornisce componenti di composizione dello spazio secondario, come pannelli spaziali e orbiter, che ti consentono di posizionare la tua UI 2D esistente basata su Compose o Views in un layout spaziale.

Per indicazioni dettagliate, consulta Sviluppare UI con Jetpack Compose per XR.

Sviluppare un esempio generico di componente XR dell'orbiter dell'interfaccia utente

Compose for XR introduce il componente componibile dello spazio secondario Volume, che ti consente di posizionare entità SceneCore, come modelli 3D, rispetto alla tua UI.

Scopri come spazializzare la tua app per Android esistente o consulta il riferimento API per informazioni più dettagliate.

Material Design per XR

Dispositivi XR applicabili: visori XR, occhiali XR con cavo

Material Design fornisce componenti e layout che si adattano all'XR. Ad esempio, se crei con layout adattivi e aggiorni l'ultima alpha della dipendenza utilizzando un wrapper EnableXrComponentOverrides, ogni riquadro viene inserito in un SpatialPanel e una barra di navigazione viene inserita in un Orbiter. Scopri di più sull'implementazione di Material Design per XR.

Jetpack SceneCore

Dispositivi XR applicabili: visori XR, occhiali XR con cavo

La libreria Jetpack SceneCore ti consente di posizionare e disporre contenuti 3D, definiti da entità, l'uno rispetto all'altro e all'ambiente. Con SceneCore, puoi:

La libreria Jetpack SceneCore fornisce anche il supporto per la spazializzazione delle applicazioni create utilizzando Views. Per maggiori dettagli, consulta la nostra guida all'utilizzo delle visualizzazioni.

Per informazioni più dettagliate, consulta il Riferimento API.

ARCore per Jetpack XR

Dispositivi XR applicabili: visori XR, occhiali XR con cavo, occhiali AI

Ispirata alla libreria ARCore esistente, la libreria ARCore per Jetpack XR offre funzionalità per combinare contenuti digitali con il mondo reale. Questa libreria include il monitoraggio del movimento, gli ancoraggi persistenti, il test di hit e l'identificazione del piano con etichettatura semantica (ad esempio, pavimento, pareti e piani dei tavoli). Questa libreria sfrutta lo stack di percezione sottostante basato su OpenXR, che garantisce la compatibilità con un'ampia gamma di dispositivi e contribuisce a rendere le app a prova di futuro.

Per informazioni più dettagliate, consulta Utilizzare ARCore per Jetpack XR.

Jetpack Compose Glimmer

Dispositivi XR applicabili: occhiali AI

Jetpack Compose Glimmer è un toolkit UI per la creazione di esperienze Android XR aumentate, ottimizzato per gli occhiali AI con display. Crea interfacce utente belle, minimaliste e comode per i dispositivi indossati tutto il giorno.

  • Progettati per essere visibili e leggibili: a differenza degli smartphone, il canvas principale è un display ottico trasparente. Jetpack Compose Glimmer offre temi specifici per gli occhiali, palette di colori semplificate e tipografia per rendere i tuoi contenuti facili da leggere, veloci da elaborare e mai distraenti.
  • Ottimizzato per interazioni specifiche per i dispositivi indossabili: abbiamo ottimizzato i modelli di interazione per il modo in cui le persone usano gli occhiali. I componenti Glimmer di Jetpack Compose sono caratterizzati da stati di messa a fuoco chiari, come contorni ottimizzati anziché effetti ripple che distraggono, e sono progettati per gestire input fisici comuni come tocchi, scorrimenti sul frame e, naturalmente, la voce.
  • Utilizza pattern di UI dichiarativi familiari: poiché Jetpack Compose Glimmer è basato interamente su Jetpack Compose, puoi utilizzare tutto ciò che già sai sulla creazione di UI dichiarative in Android. Forniamo un insieme completo di funzioni componibili di base predefinite, come Text, Icon, Button e componenti specializzati come TitleChip, tutti ottimizzati per l'ambiente degli occhiali.
Sviluppare un esempio generico di componente XR dell'orbiter dell'interfaccia utente

Jetpack Projected

Dispositivi XR applicabili: occhiali AI

Quando crei app per occhiali con AI, la tua app viene eseguita su un dispositivo host complementare, come uno smartphone Android, che proietta le esperienze XR della tua app. Jetpack Projected consente a questi dispositivi host Android di comunicare con gli occhiali AI se i dispositivi host hanno funzionalità di proiezione XR.

  • Accesso all'hardware del dispositivo proiettato: un contesto del dispositivo collegato al dispositivo proiettato (occhiali AI). Questo contesto proiettato fornisce l'accesso all'hardware del dispositivo proiettato, come la videocamera. Le attività dedicate create appositamente per essere visualizzate sugli occhiali AI funzionano già come un contesto proiettato. Se un'altra parte dell'app (ad esempio un'attività telefonica o un servizio) deve accedere all'hardware degli occhiali AI, può ottenere un contesto proiettato.
  • Semplificare le richieste di autorizzazione: gli occhiali AI seguono il modello di autorizzazioni Android standard, con autorizzazioni specifiche per gli occhiali che devono essere richieste al runtime prima che l'app possa accedere all'hardware del dispositivo, ad esempio la fotocamera. L'helper per le autorizzazioni semplifica questi meccanismi di richiesta di autorizzazione nelle interfacce dello smartphone e degli occhiali AI per fornire un'esperienza di richiesta coerente.
  • Controlla le funzionalità del dispositivo e del display: verifica che il dispositivo proiettato abbia un display e lo stato del display per presentare le immagini. Adatta la tua app in base alle funzionalità del dispositivo. Ad esempio, potresti voler fornire più contesto audio se il dispositivo non ha un display o se il display è spento.
  • Accedere alle azioni della videocamera dell'app: la tua app può accedere alle azioni della videocamera dell'utente, ad esempio per attivare o disattivare la videocamera in un'app di streaming video.

OpenXR™ e il logo OpenXR sono marchi di proprietà di The Khronos Group Inc. e sono registrati come marchi in Cina, nell'Unione Europea, in Giappone e nel Regno Unito.