Configurare l'anteprima diretta per Unreal Engine

L'anteprima diretta ti consente di testare e perfezionare interazioni complesse direttamente all'interno di 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 la finestra di visualizzazione visiva 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.1 o versioni successive.
• Configurazione del progetto: completa tutti i passaggi della guida alla configurazione del progetto Unreal Engine.

• Android XR Engine Hub: completa tutti i passaggi della sezione Guida introduttiva della guida di Android XR Engine Hub 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 per la codifica video Vulkan.

Configurare i plug-in Android XR

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

1. Segui i passaggi della guida rapida Estensioni Android XR per Unreal Engine.

   In un secondo momento, se crei un nuovo progetto o apri un progetto che non hai utilizzato con l'anteprima diretta, segui di nuovo gli stessi passaggi.

2. Per ogni progetto, assicurati che abbia un link simbolico alla cartella dei plug-in del fornitore.

Configurare le impostazioni del progetto

Configura le impostazioni progetto per lo streaming dell'anteprima diretta:

1. Vai a Impostazioni progetto > Piattaforme > Windows.
2. Per RHI a Vulkan.
3. Vai a Modifica > Plug-in.
4. Attiva il plug-in AndroidXRStreaming.
5. Vai a Modifica > Impostazioni progetto > Descrizione.
6. Attiva Avvia in VR.

Abilitare il runtime di streaming

Ora che il plug-in AndroidXRStreaming è attivato nel progetto, verifica se è presente il runtime di streaming Android XR:

1. Vai a Impostazioni progetto > Plug-in > AndroidXRStreaming.

2. Fai clic su Abilita streaming AndroidXR.

   

3. Riavvia Unreal Engine per applicare queste modifiche.

Configurare il client di streaming

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

1. Vai a Impostazioni progetto > Plug-in.

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

   • Avvio automatico del 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.
   • Arresto automatico del client in anteprima: se attivata, termina il client di anteprima quando l'anteprima VR dall'editor viene interrotta.
   • Selezione automatica del 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 attivata, mostra finestre di dialogo di errore aggiuntive (ad esempio, una finestra di dialogo di errore viene visualizzata se provi ad avviare un'anteprima VR senza selezionare un dispositivo client). Disattiva questa opzione per nascondere queste finestre di dialogo.
   • Aggiorna: se attivata, il pulsante Aggiorna cerca i dispositivi connessi ed elenca quelli compatibili (determinati dalla presenza dell'app client di anteprima diretta in Android XR Engine Hub).

Avviare l'anteprima diretta

Avvia l'anteprima diretta per eseguire lo streaming direttamente da Unreal Engine:

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

2. Se non hai mai utilizzato questo dispositivo con l'anteprima diretta, collegalo e configurarlo per l'anteprima diretta in Android XR Engine Hub prima di avviare l'anteprima diretta tramite il motore grafico.

3. In Unreal Editor, fai clic su Riproduci livello in VR. Non utilizzare la solita opzione Riproduci nell'editor quando avvii l'anteprima diretta.