Configure Universal Render Pipeline (URP)

This document introduces how to configure EasyAR features when integrating them into a Universal Render Pipeline (URP) project.

Before you begin

• Learn how to use URP in Unity.
• Refer to enable EasyAR in Unity to import the EasyAR Unity plugin.

Create Universal Render Pipeline Asset

Note

If the Unity project is created using the URP project template, or if the UniversalRenderPipelineAsset and Universal Renderer already exist in the project, you can skip directly to Confirm the project has switched to URP rendering pipeline.

In the Project window, use the right-click menu Create > Rendering > URP Asset(with Universal Renderer) to create the required assets:

Find the universal render pipeline asset used by the target platform

1. Click Edit > Project Settings > Graphics in the menu bar.

   The Default Render Pipeline slot at the top should already have a Universal Render Pipeline Asset assigned.

   

   Tip

   This option was named Scriptable Render Pipeline Settings in older versions of Unity.

2. Click Project Settings > Quality in the menu bar.

   Select the quality level for the target platform. The Render Pipeline Asset below is the Universal Render Pipeline asset used by the target platform. If empty, the asset configured in the Graphics window is used.

   

   Tip

   If the settings in Quality conflict with those in Graphics, the system will prioritize the Asset in Quality.

Configure Universal Render Pipeline Asset

Important

The Universal Render Pipeline Asset used in the Unity Editor is often different from that used on devices such as Android/iOS. Separate configurations are required for the Editor and devices.

1. Select the Universal Render Pipeline Asset for the target platform, then select the Universal Renderer Data it uses.

   

   Tip

   If multiple Renderers are configured in the project, ensure the one selected is the one being used by the AR camera. You can check the current index value in the Camera component > Rendering > Renderer option of the scene camera.

2. Click Add Renderer Feature at the bottom of the Universal Renderer Data Inspector panel, and add EasyARCameraImageRendererFeature.

   

Notes on using EasyAR samples

The sample scenes included with the EasyAR Unity plugin use materials and shaders compatible with the Built-in rendering pipeline by default. Unity automatically converts these materials and shaders to URP-compatible versions, but a few resources may render incorrectly and require manual conversion by referring to Convert assets using the Render Pipeline Converter.

Click the menu Window > Rendering > Render Pipeline Converter, select Built-in to URP to open the conversion window. Check Material Upgrade and Readonly Material Converter > click Convert Assets at the bottom.

After the conversion is complete, the sample materials will display normally.

Common issues

If the configuration is incorrect, there will be no camera feed during runtime, often appearing as a black screen. However, when tracking a target, the content added under the tracking target will display normally.

In version 4000 and above, the session will enter the Broken state. At this time, the screen or logs will display BrokenReason as URP RenderPipeLineAsset not properly setup:

To resolve this issue, correctly configure the Universal Render Pipeline Asset as described in this document.

Related topics

• Unity compatibility