Configuration du pipeline de rendu universel (URP)

Ce document explique comment configurer la fonctionnalité EasyAR dans un projet utilisant Universal Render Pipeline (URP).

Avant de commencer

• Comprenez comment utiliser URP dans Unity.
• Référez-vous à Activer EasyAR dans Unity pour importer le plugin EasyAR Unity.

Création des assets du pipeline de rendu universel

Note

Si le projet Unity a été créé avec un modèle URP, ou si des assets UniversalRenderPipelineAsset et Universal Renderer existent déjà, vous pouvez passer directement à Confirmer que le projet est basculé vers URP.

Dans la fenêtre Project, via le menu contextuel Create > Rendering > URP Asset (with Universal Renderer), créez les assets nécessaires :

Trouver l'asset URP utilisé par la plateforme cible

1. Cliquez sur Edit > Project Settings > Graphics.

   Le champ Default Render Pipeline en haut doit déjà avoir un Universal Render Pipeline Asset assigné.

   

   Astuce

   Cette option s'appelait Scriptable Render Pipeline Settings dans les anciennes versions d'Unity.

2. Cliquez sur Project Settings > Quality.

   Sélectionnez le niveau de qualité pour la plateforme cible. L'asset Render Pipeline Asset en dessous est l'asset URP utilisé. S'il est vide, l'asset configuré dans la fenêtre Graphics sera utilisé.

   

   Astuce

   Si les paramètres dans Quality et Graphics diffèrent, le système utilisera en priorité l'asset de Quality.

Configurer l'asset du pipeline de rendu universel

Important

Les assets URP utilisés dans l'éditeur Unity et sur les appareils (Android/iOS, etc.) sont souvent différents. Ils doivent être configurés séparément.

1. Sélectionnez le Universal Render Pipeline Asset utilisé par la plateforme cible, puis choisissez le Universal Renderer Data qu'il utilise.

   

   Astuce

   Si plusieurs Renderers sont configurés, assurez-vous de choisir celui utilisé par la caméra AR. Vérifiez l'index actuel dans le composant Camera de la caméra de scène : Rendering > Renderer.

2. Dans le panneau Inspector du Universal Renderer Data, cliquez sur Add Renderer Feature et ajoutez EasyARCameraImageRendererFeature.

   

Considérations pour les exemples EasyAR

Les scènes d'exemple fournies avec le plugin EasyAR Unity utilisent par défaut des matériaux et shaders compatibles avec le pipeline Built-in. Unity convertit automatiquement ces ressources en versions compatibles URP, mais certaines peuvent s'afficher incorrectement. Reportez-vous à Convert assets using the Render Pipeline Converter pour une conversion manuelle.

Cliquez sur Window > Rendering > Render Pipeline Converter, sélectionnez Built-in to URP pour ouvrir la fenêtre de conversion. Cochez Material Upgrade et Readonly Material Converter > cliquez sur Convert Assets.

Après conversion, les matériaux d'exemple s'afficheront normalement.

Problèmes courants

Une configuration incorrecte peut entraîner l'absence d'image de la caméra (écran noir), bien que les contenus ajoutés sous les cibles suivies soient visibles.

À partir de la version 4000, la session passera à l'état Broken. Le rapport BrokenReason indiquera URP RenderPipeLineAsset not properly setup :

Pour résoudre ce problème, configurez correctement le Universal Render Pipeline Asset comme décrit ici.

Sujets connexes

• Compatibilité Unity