Configurare l'anteprima diretta per Unreal Engine

Dispositivi XR applicabili

Queste indicazioni ti aiutano a creare esperienze per questi tipi di dispositivi XR.

Scopri di più sui tipi di dispositivi XR →

Visori XR

Occhiali XR con cavo

Scopri di più sui tipi di dispositivi XR →

Direct Preview ti consente di testare e ripetere interazioni complesse direttamente nell'Unreal Editor utilizzando i dati in tempo reale del dispositivo Android XR. Con l'Anteprima diretta, la macchina host esegue il rendering e il debug dei contenuti, trasmette in streaming l'area visibile direttamente al tuo dispositivo Android XR fisico e trasmette in streaming le estensioni OpenXR supportate all'host in tempo reale.

Segui questa guida per configurare l'Anteprima diretta per il tuo progetto in Unreal Engine.

Prerequisiti

Prima di iniziare, assicurati che il tuo ambiente di sviluppo soddisfi i seguenti requisiti:

• Versione di Unreal Engine: Unreal Engine 5.6.x o 5.8.x.
• Configurazione del progetto: completa tutti i passaggi della guida alla configurazione del progetto Unreal Engine.

• Hub motore Android XR: completa tutti i passaggi della sezione Inizia della guida dell'hub motore Android XR per installare e configurare la macchina host per l'Anteprima diretta.

• Hardware:

  • Utilizza una macchina host con Windows 11.
  • Utilizza una scheda grafica moderna con supporto della codifica video Vulkan.
  Importante: aggiorna i driver della GPU alle versioni più recenti prima di verificare tutte le funzionalità Vulkan.

Configura i plug-in Android XR

Configura Unreal Engine con i plug-in Android XR richiesti:

1. Segui i passaggi descritti nella guida Guida rapida alle estensioni Android XR per Unreal Engine.

   In seguito, se crei un nuovo progetto o ne apri uno che non hai utilizzato con Anteprima diretta, segui di nuovo gli stessi passaggi.

2. Assicurati che ogni progetto abbia un collegamento simbolico alla cartella dei plug-in del fornitore.

Configura le impostazioni del progetto

Configura le impostazioni del progetto per lo streaming di Direct Preview:

1. Vai a Project Settings > Platforms > Windows (Impostazioni progetto > Piattaforme > Windows).
2. Da RHI a Vulkan.
3. Vai a Edit > Plugins (Modifica > Plug-in).
4. Attiva il plug-in AndroidXRStreaming.
5. Vai a Modifica > Impostazioni progetto > Descrizione.
6. Attiva Avvia in VR.

Attiva il runtime di streaming

Ora che il progetto ha il plug-in AndroidXRStreaming abilitato, verifica se il runtime di Android XR Streaming è presente:

1. Vai a Project Settings > Plugins > AndroidXRStreaming (Impostazioni progetto > Plug-in > AndroidXRStreaming).

2. Fai clic su Attiva lo streaming di Android XR.

   

   Nota: questa operazione imposta una variabile di ambiente basata sulla sessione per il processo di Unreal Engine, quindi non è necessario modificare le voci del registry anche se sulla macchina sono presenti più runtime.

3. Riavvia Unreal Engine per applicare queste modifiche.

Configura il client di streaming

Configura il client di streaming con diverse opzioni per il tuo progetto:

1. Vai a Project Settings > Plugins (Impostazioni progetto > Plug-in).

2. Nella sezione AndroidXRStreamingClient, esamina ciascuna delle seguenti opzioni e attivala o disattivala in base alle esigenze del tuo progetto:

   • Avvia automaticamente il client in anteprima: se attivata, avvia l'app client di anteprima su qualsiasi dispositivo valido selezionato quando fai clic su Avvia anteprima VR dall'editor.
   • Auto Stop Client On Preview (Arresta automaticamente il client durante l'anteprima): se attivata, termina il client di anteprima quando l'anteprima VR dall'editor viene interrotta.
   • Seleziona automaticamente il dispositivo compatibile: se attivata, seleziona automaticamente il primo dispositivo compatibile connesso alla macchina durante la ricerca dei dispositivi.
   • Mostra finestre di dialogo di errore: se questa opzione è attiva, vengono visualizzate finestre di dialogo di errore aggiuntive (ad esempio, viene visualizzata una finestra di dialogo di errore se provi ad avviare un'anteprima VR senza selezionare un dispositivo client). Disattiva questa opzione per nascondere queste finestre di dialogo.
   • Aggiorna: se attivato, il pulsante Aggiorna cerca i dispositivi connessi ed elenca quelli compatibili (determinati dalla presenza dell'app client Anteprima diretta nell'Hub motore Android XR).

Avvia l'anteprima diretta

Avvia l'anteprima diretta per trasmettere in streaming direttamente da Unreal Engine:

1. Collega il dispositivo Android XR alla macchina host utilizzando un cavo USB-C di alta qualità.

   Nota: devi attivare le opzioni sviluppatore e il debug sul dispositivo Android XR in modo che la macchina host possa inviare comandi ADB (Android Debug Bridge).

2. Se non hai mai utilizzato questo dispositivo con l'Anteprima diretta, connettilo e configuralo per l'Anteprima diretta nell'Hub motore Android XR prima di avviare l'Anteprima diretta tramite il motore grafico.

3. Nell'editor Unreal, fai clic su Play level in VR (Riproduci livello in VR). Non utilizzare la consueta opzione Play in Editor (Riproduci nell'editor) quando avvii l'Anteprima diretta.