Change URP asset settings at runtime

注意

To change a property of the URP asset with a C# script, the property must have a

set

method. For more information on these properties, refer to Universal Render Pipeline asset API.

1. Open the QualityControls script.
2. At the top of the script add

   using UnityEngine.Rendering

   and

   using UnityEngine.Rendering.Universal

   .
3. Add a method with the name

   ChangeAssetProperties

   and the type

   void

   to the

   QualityControls

   class as shown below.

   using System.Collections;using System.Collections.Generic;using UnityEngine;using UnityEngine.Rendering;using UnityEngine.Rendering.Universal;public class QualityController : MonoBehaviour{    void Start()    {        // Select the appropriate Quality Level first        SwitchQualityLevel();    }    private void SwitchQualityLevel()    {        // Code from previous example    }    private void ChangeAssetProperties()    {        // New code is added to this method    }}

4. Retrieve the active Render Pipeline asset with

   GraphicsSettings.currentRenderPipeline

   as shown below.

   注意

   You must use the

   as

   keyword to cast the Render Pipeline asset as the

   UniversalRenderPipelineAsset

   type for the script to work correctly.

   using System.Collections;using System.Collections.Generic;using UnityEngine;using UnityEngine.Rendering;using UnityEngine.Rendering.Universal;public class QualityController : MonoBehaviour{    void Start()    {        // Select the appropriate Quality Level first        SwitchQualityLevel();    }    private void SwitchQualityLevel()    {        // Code from previous example    }    private void ChangeAssetProperties()    {        // Locate the current URP asset        UniversalRenderPipelineAsset data = GraphicsSettings.currentRenderPipeline as UniversalRenderPipelineAsset;        // Do nothing if Unity can't locate the URP asset        if (!data) return;    }}

5. Add a

   switch

   statement in the ChangeAssetProperties method to set the value of the URP asset properties.

   using System.Collections;using System.Collections.Generic;using UnityEngine;using UnityEngine.Rendering;using UnityEngine.Rendering.Universal;public class QualityController : MonoBehaviour{    void Start()    {        // Select the appropriate Quality Level first        SwitchQualityLevel();    }    private void SwitchQualityLevel()    {        // Code from previous example    }    private void ChangeAssetProperties()    {        // Locate the current URP asset        UniversalRenderPipelineAsset data = GraphicsSettings.currentRenderPipeline as UniversalRenderPipelineAsset;        // Do nothing if Unity can't locate the URP asset        if (!data) return;        // Change URP asset settings based on the size of the device's graphics memory        switch (SystemInfo.graphicsMemorySize)        {            case <= 1024:                data.renderScale = 0.7f;                data.shadowDistance = 50.0f;                break;            case <= 3072:                data.renderScale = 0.9f;                data.shadowDistance = 150.0f;                break;            default:                data.renderScale = 0.7f;                data.shadowDistance = 25.0f;                break;        }    }}

6. Add a call to the

   ChangeAssetProperties

   method in the

   Start

   method. This ensures that the URP asset only changes when the scene first loads.

   using System.Collections;using System.Collections.Generic;using UnityEngine;using UnityEngine.Rendering;using UnityEngine.Rendering.Universal;public class QualityController : MonoBehaviour{    void Start()    {        // Select the appropriate Quality Level first        SwitchQualityLevel();        // Fine tune performance with specific URP asset properties        ChangeAssetProperties();    }    private void SwitchQualityLevel()    {        // Code from previous example    }    private void ChangeAssetProperties()    {        // Locate the current URP asset        UniversalRenderPipelineAsset data = GraphicsSettings.currentRenderPipeline as UniversalRenderPipelineAsset;        // Do nothing if Unity can't locate the URP asset        if (!data) return;        // Change URP asset settings based on the size of the device's graphics memory        switch (SystemInfo.graphicsMemorySize)        {            case <= 1024:                data.renderScale = 0.7f;                data.shadowDistance = 50.0f;                break;            case <= 3072:                data.renderScale = 0.9f;                data.shadowDistance = 150.0f;                break;            default:                data.renderScale = 0.7f;                data.shadowDistance = 25.0f;                break;        }    }}