Configurazione del progetto Unity

Questa guida illustra in dettaglio le versioni dell'editor, le impostazioni grafiche, le impostazioni URP e le impostazioni del progetto Android consigliate per lo sviluppo di un'applicazione Unity per Android XR.

Prerequisiti

Per sviluppare con Unity, devi scaricare e installare Unity Hub.

Installa la versione 6000.0.23f1 o successive di Unity Editor e del supporto per la compilazione Android, che include:

  • OpenJDK
  • SDK Android
  • Strumenti Android NDK

Seleziona un motore di rendering

Ti consigliamo di utilizzare l'API Vulkan Graphics per il rendering delle app Android XR. Per selezionare Vulkan come API grafica:

  1. In Unity, vai a Modifica > Impostazioni progetto > Player.
  2. Seleziona la scheda Android e vai a Altre impostazioni > Rendering.
  3. Se l'API grafica automatica è attivata, disattiva questa impostazione per visualizzare la sezione API grafiche.

  4. Nella sezione API di grafica, seleziona il pulsante Aggiungi (+) e seleziona Vulkan dal menu a discesa.

    Esempio che mostra come modificare le impostazioni dell'API Graphics nell'interfaccia utente

  5. Riordina le API di grafica utilizzando i handle (=) in modo che Vulkan sia elencata prima.

  6. Se vuoi, seleziona altre API di grafica e fai clic sul pulsante Rimuovi (-) per rimuoverle.

Universal Render Pipeline

Android XR è compatibile con la pipeline di rendering universale (URP). Se prevedi di utilizzare il passthrough, devi aggiornare le impostazioni predefinite dell'URP per ottenere il miglior rendimento del passthrough su Android XR.

La tabella seguente contiene un elenco delle impostazioni URP consigliate di Unity, che sono descritte in modo più dettagliato nelle sezioni seguenti.

Impostazione

Posizione

Valore consigliato

HDR

Asset Universal Render Pipeline

Disattivata

Post-elaborazione

Dati del renderer universale

Disattivata

Impostazioni degli asset della pipeline di rendering universale

Per ottimizzare la risorsa Universal Render Pipeline per Android VR:

  1. Individua l'asset Universal Render Pipeline del progetto. Un modo per farlo è digitare t:UniversalRenderPipelineAsset nella barra di ricerca della finestra Progetto.

  2. Sotto l'intestazione Qualità, disattiva HDR.

    Asset della pipeline di rendering universale mostrato con le impostazioni consigliate

Impostazioni dei dati del renderer universale

Per ottimizzare i dati del renderer universale per Android XR:

  1. Individua l'asset dati del renderer universale del progetto. Un modo per farlo è digitare t:UniversalRendererData nella barra di ricerca della finestra Progetto.

  2. In Ispettore, deseleziona Attivato sotto l'intestazione Post-elaborazione.

    Dati del visualizzatore universale mostrati con le impostazioni consigliate

Livello API Android minimo

Imposta il progetto su un livello API minimo pari a 24, richiesto da OpenXR loader. In caso contrario, le build potrebbero non riuscire.

Completa questi passaggi per impostare il livello API Android minimo.

  1. Vai a Modifica > Impostazioni progetto > Player.
  2. Seleziona la scheda Android e apri Altre impostazioni.
  3. Nella sezione Identificazione, per Livello API minimo, seleziona 24 o superiore.

Punto di ingresso dell'applicazione

Configura le seguenti impostazioni per il punto di contatto dell'applicazione:

  1. Vai a Modifica > Impostazioni progetto > Player.
  2. Seleziona la scheda Android e apri Altre impostazioni.
  3. Nella sezione Punto di contatto dell'applicazione, assicurati che l'opzione GameActivity sia selezionata e che l'opzione Attività non sia selezionata.

Finestre popup

La maggior parte delle app per Android XR richiede finestre ridimensionabili, in quanto sono necessarie per visualizzare popup come le richieste di autorizzazione di sistema.

Segui questi passaggi per assicurarti che le finestre popup vengano visualizzate correttamente.

  1. Vai a Modifica > Impostazioni progetto > Player.
  2. Seleziona la scheda Android e attiva Attività ridimensionabile.

Vedi anche