Configurazione del progetto Unity

Questa guida descrive in dettaglio le versioni dell'editor, le impostazioni grafiche, le impostazioni URP e le impostazioni del progetto Android consigliate durante 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.58f2 o successive di Unity Editor e Android Build Support, 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'opzione API grafiche automatiche è attivata, disattiva questa impostazione per visualizzare la sezione API grafiche.
  4. Nella sezione API grafiche, seleziona il pulsante Aggiungi (+) e seleziona Vulkan dal menu a discesa.

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

  5. Riordina le API grafiche utilizzando i punti di manipolazione (=) in modo che Vulkan sia elencato per primo.

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

Universal Render Pipeline

Android XR è compatibile con la Universal Render Pipeline (URP). Se prevedi di utilizzare il passthrough, devi aggiornare le impostazioni URP predefinite per ottenere le migliori prestazioni di passthrough su Android XR.

La tabella seguente riporta un elenco delle impostazioni URP consigliate di Unity, che sono spiegate in modo più dettagliato nelle sezioni successive.

Impostazione

Posizione

Valore consigliato

HDR

Asset della pipeline di rendering universale

Disattivata

Post-elaborazione

Universal Renderer Data

Disattivata

Impostazioni dell'asset della pipeline di rendering universale

Segui questi passaggi per ottimizzare l'asset Universal Render Pipeline per Android XR:

  1. Individua l'asset della pipeline di rendering universale del tuo progetto. Un modo per farlo è digitare t:UniversalRenderPipelineAsset nella barra di ricerca della finestra Progetto.

  2. Nella sezione Qualità, disattiva HDR.

    Asset Universal Render Pipeline 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 di dati del renderer universale del tuo progetto. Un modo per farlo è digitare t:UniversalRendererData nella barra di ricerca della finestra Progetto.

  2. In Inspector, nella sezione Post-elaborazione, deseleziona Attivato.

    Dati del renderer universale mostrati con le impostazioni consigliate

Livello API Android minimo

Imposta il progetto su un livello API minimo di 24, richiesto dal caricatore OpenXR. 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 un valore superiore.

Punto di ingresso dell'applicazione

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

  1. Vai a Modifica > Impostazioni progetto > Player.
  2. Seleziona la scheda Android e apri Altre impostazioni.
  3. Nella sezione Configurazione, assicurati che Punto di ingresso dell'applicazione abbia GameActivity selezionato e Activity deselezionato.

Finestre popup

La maggior parte delle app Android XR richiede finestre ridimensionabili, in quanto devono eseguire il rendering di 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 apri Risoluzione e presentazione.
  3. Nella sezione Risoluzione, attiva Attività ridimensionabile.

Vedi anche


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.