Istruzioni

Inizia a utilizzare Unity e Android XR

Tempo di lettura: 6 min
Visualizza il profilo di Luke Hopkins
Luke Hopkins Developer Relations Engineer, Android

Samsung Galaxy XR è arrivato, con tecnologia Android XR. Questo blog post fa parte della nostra Android XR Spotlight Week, in cui forniamo risorse (blog post, video, codice campione e altro ancora) progettate per aiutarti a imparare, creare e preparare le tue app per Android XR. 

Non c'è mai stato momento migliore per iniziare a sviluppare per XR. Lo scorso dicembre abbiamo annunciato Android XR, la nuova piattaforma Android di Google basata su standard aperti come OpenXR e Vulkan, che rende lo sviluppo XR più accessibile che mai.


Inoltre, se combinato con gli strumenti XR esistenti di Unity, ottieni uno stack di sviluppo potente e maturo. In questo modo è possibile creare ed eseguire il deployment di app XR che funzionano su più dispositivi.

openxr_face_tracking2.webp

Che tu abbia già esperienza con lo sviluppo XR o meno, vogliamo aiutarti a iniziare.

Questo blog ti aiuterà a iniziare a sviluppare con Android XR e Unity. Ci concentreremo sui passaggi pratici per configurare l'ambiente, comprendere l'ecosistema dei pacchetti e iniziare a creare.

Al termine di questo blog, avrai una buona comprensione di:

  • L'ecosistema dei pacchetti
  • Passaggi di configurazione essenziali
  • Metodi di immissione
  • Privacy e autorizzazioni
  • Livelli di composizione

Unity per lo sviluppo di Android XR

Puoi scegliere Unity per la sua compatibilità multipiattaforma, che ti consente di creare una sola volta ed eseguire il deployment su Android XR e altri dispositivi XR.

Quando utilizzi Unity, puoi usufruire del suo ecosistema e dei suoi strumenti XR maturi. Dispone già di pacchetti consolidati come XR Interaction Toolkit, plug-in OpenXR, XR Composition Layers, XR Hands, un ampio asset store ricco di componenti e modelli pronti per XR e strumenti di simulazione e test XR. Inoltre, con il rilascio di Unity 6 lo scorso novembre, potrai usufruire di prestazioni migliorate della Universal Render Pipeline (URP), di un migliore supporto della grafica Vulkan e di profili di build ottimizzati.

Ecco alcuni progetti di esempio per farti un'idea di cosa è possibile fare:

Configurazione di base: le fondamenta dello sviluppo

Requisiti e installazione di Unity 6

Per creare la tua app, devi avere Unity 6, poiché le versioni precedenti non supportano Android XR. Installa prima Unity Hub, poi Unity 6 con il modulo Android Build Support, seguendo questi passaggi.

unity6.png

Profili di build di Android XR: semplificazione della configurazione

I profili di build di Unity sono asset di progetto che memorizzano le impostazioni e le configurazioni specifiche della piattaforma. Quindi, anziché dover configurare manualmente 15-20 impostazioni diverse in più menu, puoi utilizzare un profilo di build per farlo automaticamente.
Puoi creare i tuoi profili di build, ma per il momento ti consigliamo di utilizzare il profilo di build Android XR dedicato che abbiamo creato.

Puoi selezionare il profilo di build selezionando File > Build Profile (Profilo di build) dal tuo progetto Unity. Per istruzioni complete, consulta la pagina del workflow Sviluppa per Android XR.

Se apporti modifiche, puoi creare un nuovo profilo di build da condividere con il tuo team. In questo modo, garantisci un'esperienza di build coerente su tutta la linea.

buildprofiles.png

Dopo questi passaggi, puoi creare ed eseguire l'APK per i dispositivi Android XR.

API Graphics: perché Vulkan è importante

Una volta configurato il progetto Unity con un profilo di build Android XR, ti consigliamo di assicurarti che Vulkan sia impostato come API grafica. Android XR è una piattaforma basata su Vulkan. A marzo 2025, Google ha annunciato che Vulkan è ora l'API grafica ufficiale per Android. Si tratta di un'API grafica moderna di basso livello che aiuta gli sviluppatori a massimizzare le prestazioni delle GPU moderne e sblocca funzionalità avanzate come il ray tracing e il multithreading per immagini di gioco realistiche e immersive.

Questi standard offrono la migliore compatibilità per le applicazioni esistenti e riducono i problemi e i costi di portabilità. Inoltre, consente di attivare funzionalità avanzate di Android XR, come URP Application Space Warp e rendering foveated. 

Unity 6 gestisce Vulkan automaticamente, quindi quando utilizzi il profilo di build di Android XR, Unity configurerà Vulkan come API grafica. In questo modo, avrai accesso a tutte le funzionalità avanzate di Android XR senza alcuna configurazione manuale.

Puoi verificare le impostazioni dell'API Graphics andando su "Edit" > "Project Settings" > "Player" > "Android tab" > "Other settings" > "Graphics APIs".

graphics-api.png
appentrypoint.png

Informazioni sull'ecosistema dei pacchetti

Esistono due pacchetti diversi che puoi utilizzare per Android XR in Unity. Uno consiste nell'utilizzare le estensioni Android XR per Unity, l'altro nell'utilizzare il pacchetto Unity OpenXR: Android XR.

Potrebbero sembrare la stessa cosa, ma non è così.

Il pacchetto Unity OpenXR: Android XR è il pacchetto Unity ufficiale per il supporto di Android XR. Fornisce la maggior parte delle funzionalità di Android XR, rese disponibili tramite gli standard OpenXR. Inoltre, consente l'integrazione di AR Foundation per le funzionalità di realtà mista. Il vantaggio principale dell'utilizzo del pacchetto Unity OpenXR: Android XR è che offre un'API unificata per il supporto dei dispositivi XR.


Le estensioni Android XR per Unity sono invece il pacchetto XR di Google, progettato specificamente per lo sviluppo per i dispositivi Android XR. Integra il pacchetto Unity OpenXR con funzionalità aggiuntive come modalità di fusione dell'ambiente, mesh della scena, tracciamento delle immagini e tracciamento del corpo. Il compromesso è che puoi sviluppare solo per i dispositivi Android XR.


La scelta dipende dalle tue esigenze specifiche, ma in genere consigliamo di utilizzare Unity OpenXR: Android XR, in quanto offre una maggiore flessibilità per i dispositivi con cui l'app sarà compatibile. In base ai requisiti dell'applicazione, puoi aggiungere Android XR Extensions per Unity.

Come installare i pacchetti

Per aggiungere un nuovo pacchetto, con il progetto aperto in Unity, seleziona "Window" (Finestra) > "Package Management" (Gestione pacchetti) > "Package Manager" (Gestione pacchetti).

Da qui puoi installare questi pacchetti dalla scheda "Unity Registry":

packagemanager.png

Puoi installare il pacchetto Android XR per Unity tramite GitHub selezionando l'icona ➕, selezionando "Installa pacchetto da URL Git" e inserendo "https://github.com/android/android-xr-unity-package.git".

packagemanager2.png

Funzionalità OpenXR richieste

Ora che hai installato i pacchetti necessari, attiviamo alcune funzionalità principali per far funzionare il progetto.

Puoi attivare l'impostazione OpenXR per Android: "Edit" -> "Project Settings" -> "XR Plugin Management" -> fai clic su Android e attiva OpenXR

xrpluginmgmt.png

Ora dobbiamo attivare il supporto per "Android XR support". Tratteremo altre funzionalità di OpenXR man mano che ne avremo bisogno. Per ora, dobbiamo solo attivare il supporto di Android XR.

Input

Android XR supporta l'input per mani, voce, tracciamento oculare, tastiera e controller. Ti consigliamo di installare XR Interaction Toolkit e XR Hands, poiché contengono i migliori prefab per iniziare. Utilizzando questi prefab, avrai tutto ciò che ti serve per supportare mani e controller nella tua app.

xrinteractiontoolkit.png

Una volta installati sia XR Hands che XR Interactive Toolkit, ti consiglio di importare gli asset iniziali e la demo di interazione con le mani. Poi devi attivare i profili Hand Interaction e Khronos Simple Controller, e attivare le funzionalità Tracciamento delle mani Subsystem e Meta Hand Tracking Aim.

Puoi modificare queste impostazioni andando su "Edit" > "Project Settings" > "XR Plug-in Management" > "OpenXR".

profiles.png

Consigliamo anche il prefab di Unity, XR Origin, che rappresenta la posizione e l'orientamento dell'utente nello spazio XR. Contiene i componenti di tracking e della fotocamera necessari per eseguire il rendering dell'esperienza XR dal punto di vista corretto.

Il modo più semplice per aggiungere questo prefab è importarlo dalla demo di integrazione delle mani che abbiamo importato in precedenza, disponibile qui: "Hands Integration Toolkit" > "Hand Interaction" > "Prefabs" > "XR Origin"

prefabs.png

Ti consigliamo di utilizzare questo prefab anziché l'opzione "XR Origin" nei tuoi oggetti di gioco, in quanto utilizza XR Input Modality Manager, che passa automaticamente dalle mani ai controller degli utenti. In questo modo, potrai passare dalle mani ai controller e viceversa nel modo migliore.

Privacy e autorizzazioni: creare fiducia negli utenti

Indipendentemente da ciò che crei, dovrai acquisire le autorizzazioni di runtime dagli utenti. Questo perché la comprensione della scena, il tracciamento oculare, il tracciamento facciale e il tracciamento delle mani forniscono l'accesso a dati che potrebbero essere più sensibili per l'utente.

Queste funzionalità forniscono informazioni personali più approfondite rispetto alle tradizionali app desktop o mobile, pertanto le autorizzazioni di runtime garantiscono agli utenti il pieno controllo sui dati che scelgono di condividere. Pertanto, per rispettare le norme sulla sicurezza e sulla privacy di Android, Android XR dispone di autorizzazioni per ciascuna di queste funzionalità.

Ad esempio, se utilizzi il pacchetto XR Hands per i gesti con le mani personalizzati, dovrai richiedere l'autorizzazione per il tracciamento delle mani (vedi di seguito), poiché questo pacchetto deve monitorare molte informazioni sulle mani dell'utente. Sono inclusi, ad esempio, il monitoraggio delle posizioni delle articolazioni della mano e delle velocità angolari e lineari;

Nota: per un elenco completo delle estensioni che richiedono autorizzazioni, consulta le informazioni sul sito web per sviluppatori XR.

const string k_Permission = "android.permission.HAND_TRACKING";

#if UNITY_ANDROID
void Start()
{
    if (!Permission.HasUserAuthorizedPermission(k_Permission))
    {
        var callbacks = new PermissionCallbacks();
        callbacks.PermissionDenied += OnPermissionDenied;
        callbacks.PermissionGranted += OnPermissionGranted;
        
        Permission.RequestUserPermission(k_Permission, callbacks);
    }
}

void OnPermissionDenied(string permission)
{
    // handle denied permission
}


void OnPermissionGranted(string permission)
{
    // handle granted permission
}

#endif // UNITY_ANDROID

Migliorare la qualità visiva con i livelli di composizione

Un livello di composizione è il modo consigliato per eseguire il rendering degli elementi UI. Consentono di visualizzare gli elementi con una qualità molto più elevata rispetto alla pipeline di rendering standard di Unity, poiché tutto viene visualizzato direttamente nel compositore della piattaforma.

Ad esempio, se mostri del testo, il rendering standard di Unity ha maggiori probabilità di avere testo sfocato, bordi morbidi e artefatti visivi. Con i livelli di composizione, invece, il testo sarà più chiaro, i contorni più nitidi e l'esperienza complessiva migliore.


Oltre al testo, esegue il rendering di video, immagini ed elementi UI con una qualità molto più elevata. A questo scopo, utilizza il supporto nativo per i livelli del compositore del runtime.

Per attivare i livelli di composizione, apri Gestione pacchetti, seleziona "Unity Register", quindi installa "XR Composition Layers".

Crea ed esegui

Ora che hai installato i pacchetti OpenXR e attivato le funzionalità, oltre a un prefab configurato per i movimenti delle mani e della testa, puoi creare la scena ed eseguire il deployment direttamente sul visore per i test.

Passaggi successivi: espandi le tue competenze

Ora che hai configurato l'ambiente di sviluppo Android XR e compreso i concetti chiave, ecco i passaggi successivi per continuare il tuo percorso di sviluppo XR:

Risorse essenziali per l'apprendimento continuo:

Progetti di esempio da esplorare:

Scritto da:
Continua a leggere