Configurazione universal render pipeline (urp)

Questo documento spiega come configurare la funzionalità EasyAR quando si utilizza il progetto Universal Render Pipeline (URP).

Prima di iniziare

• Comprendere come utilizzare URP in Unity.
• Fare riferimento a Abilitare EasyAR in Unity per importare il plugin EasyAR Unity.

Creazione asset universal render pipeline

Nota

Se il progetto Unity è stato creato utilizzando un modello di progetto URP, o se nel progetto esistono già UniversalRenderPipelineAsset e Universal Renderer, si può passare direttamente a Conferma che il progetto è passato alla pipeline di rendering URP.

Nella finestra Project, creare gli asset necessari tramite il menu contestuale Create > Rendering > URP Asset (with Universal Renderer):

Individuare l'asset universal render pipeline utilizzato dalla piattaforma di destinazione

1. Fare clic su Edit > Project Settings > Graphics nella barra dei menu.

   Lo slot Default Render Pipeline in alto dovrebbe già avere assegnato un Universal Render Pipeline Asset.

   

   Consiglio

   Questa opzione era chiamata Scriptable Render Pipeline Settings nelle versioni precedenti di Unity.

2. Fare clic su Project Settings > Quality nella barra dei menu.

   Selezionare il livello di qualità della piattaforma di destinazione; l'Render Pipeline Asset in basso è l'asset Universal Render Pipeline utilizzato dalla piattaforma di destinazione. Se è vuoto, l'asset Universal Render Pipeline utilizzato è quello configurato nella finestra Graphics.

   

   Consiglio

   Se le impostazioni in Quality non corrispondono a quelle in Graphics, il sistema utilizzerà prioritariamente l'asset in Quality.

Configurazione asset universal render pipeline

Importante

L'asset Universal Render Pipeline utilizzato nell'editor Unity e su dispositivi come Android/iOS è spesso diverso; è necessario configurarlo separatamente per l'uso nell'editor e sui dispositivi.

1. Selezionare l'Universal Render Pipeline Asset utilizzato dalla piattaforma di destinazione, quindi selezionare il Universal Renderer Data che utilizza.

   

   Consiglio

   Se nel progetto sono configurati più Renderer, assicurarsi di selezionare quello utilizzato dalla telecamera AR. È possibile verificare l'indice corrente nell'opzione Renderer di Rendering nel componente Camera della telecamera di scena.

2. Nel pannello Inspector del Universal Renderer Data, fare clic su Add Renderer Feature in basso e aggiungere EasyARCameraImageRendererFeature.

   

Considerazioni sull'utilizzo degli esempi di easyar

Le scene di esempio incluse nel plugin Unity EasyAR utilizzano per impostazione predefinita materiali e shader della pipeline di rendering Built-in. Unity converte automaticamente questi materiali e shader in versioni compatibili con URP, ma alcune risorse potrebbero non essere renderizzate correttamente e richiedere una conversione manuale come descritto in Convert assets using the Render Pipeline Converter.

Fare clic su Window > Rendering > Render Pipeline Converter nel menu, selezionare Built-in to URP per aprire la finestra di conversione. Selezionare Material Upgrade e Readonly Material Converter > fare clic su Convert Assets in basso.

Dopo la conversione, la visualizzazione dei materiali di esempio tornerà normale.

Problemi comuni

Se la configurazione non è corretta, durante l'esecuzione non ci sarà alcuna immagine della telecamera, spesso visualizzata come schermo nero, ma quando si rilevano target, i contenuti aggiunti sotto i target di rilevamento verranno visualizzati normalmente.

Nella versione 4000 e successive, la sessione entrerà nello stato Broken; in questo caso, nell'immagine o nei log verrà visualizzato BrokenReason come URP RenderPipeLineAsset not properly setup:

Per risolvere questo problema, configurare correttamente l'Universal Render Pipeline Asset come descritto in questo documento.

Argomenti correlati

• Compatibilità Unity