Skip to main content
Version: 20 Mar 2024

Render Pipeline Settings

This section assumes you created a new project using the URP template. The URP template project includes a collection of various URP assets, each pre-configured with different settings to represent different levels of quality. However, for Android apps running on our platform, the default configuration does not allow for a smooth 60 FPS experience in even the simplest scene. Follow these steps to configure the URP settings in your project to improve performance.

Universal Render Pipeline is Optional

Unity's Universal Render Pipeline (URP) supports many platforms and tools, but is not required for Magic Leap 2 applications to function properly. Developers can also use the Standard Render Pipeline (SRP), which offers compatibility with older effects and shaders.

Prerequisites

Delete the starter URP assets

To begin, simplify your project by removing the Pipeline and Renderer assets provided by the template. To do this, select the existing Render Pipeline assets, right-click, and choose Delete.

Delete the starter URP assets

Create a new pair of URP assets

From the Unity menu, select Assets > Create > Rendering > URP Asset (With Universal Renderer)

Configure Render Pipeline asset

Select the Pipeline asset you just created and tweak the Rendering, Quality, Lighting, and Shadows settings, removing or reducing things unnecessary for the look and feel of your project.

HDR Not Supported

HDR needs to remain disabled, otherwise the global / segmented dimmer will not work properly and automatically and render the dimmer layer across the entire Magic Leap's display reducing the display's transparency.

URP asset in the examples project

Set the default Scriptable Pipeline

Open your Project's Graphics settings (Edit > Project Settings then select Graphics), and set the Scriptable Render Pipeline Settings to the URP pipeline asset you created in the previous step.

The Scriptable Render Pipeline Settings field