Merge pull request #223774 from jloehr/UpdateUnityRenderPipelines

Remove URP setup step from Tutorial

Author: ttorble

articles/remote-rendering/how-tos/unity/install-remote-rendering-unity-package.md

@@ -35,8 +35,8 @@ To update your local package, just select a newer version from the Mixed Reality
 
 To install the Remote Rendering package manually, you need to:
 
-1. Download the package from the Mixed Reality Packages NPM feed at `https://pkgs.dev.azure.com/aipmr/MixedReality-Unity-Packages/_packaging/Unity-packages/npm/registry`.
-    * You can either use [NPM](https://www.npmjs.com/get-npm) and run the following command to download the package to the current folder.
+1. Download the package from the Mixed Reality Packages npm feed at `https://pkgs.dev.azure.com/aipmr/MixedReality-Unity-Packages/_packaging/Unity-packages/npm/registry`.
+    * You can either use [npm](https://www.npmjs.com/get-npm) and run the following command to download the package to the current folder.
 
       ```cmd
       npm pack com.microsoft.azure.remote-rendering --registry https://pkgs.dev.azure.com/aipmr/MixedReality-Unity-Packages/_packaging/Unity-packages/npm/registry
@@ -94,11 +94,10 @@ To update a local package, just repeat the respective download steps you used an
 
 ## Unity render pipelines
 
-Remote Rendering works with both the **:::no-loc text="Standard render pipeline":::** ("built-in render pipeline") and the **:::no-loc text="Universal render pipeline":::** ("URP"). For performance reasons, it's recommended to use the built-in render pipeline, unless there are strong reasons that require URP.
-
-To use the **:::no-loc text="Universal render pipeline":::**, its package has to be installed in Unity. The installation can either be done in Unity's **Package Manager** UI (package name **Universal RP**, version 7.3.1 or newer), or through the `Packages/manifest.json` file, as described in the [Unity project setup tutorial](../../tutorials/unity/view-remote-models/view-remote-models.md#include-the-azure-remote-rendering-and-openxr-packages).
+Supported Unity render pipelines are documented in this dedicated article: [Unity Render Pipelines](unity-render-pipelines.md)
 
 ## Next steps
 
+* [Unity Render Pipelines](unity-render-pipelines.md)
 * [Unity game objects and components](objects-components.md)
 * [Tutorial: View Remote Models](../../tutorials/unity/view-remote-models/view-remote-models.md)

articles/remote-rendering/tutorials/unity/view-remote-models/media/hybrid-rendering-pipeline.png renamed to articles/remote-rendering/how-tos/unity/media/hybrid-rendering-pipeline.png

@@ -1,5 +1,7 @@
 - name: Install the Remote Rendering package for Unity
   href: install-remote-rendering-unity-package.md
+- name: Unity Render Pipelines
+  href: unity-render-pipelines.md
 - name: Set up Remote Rendering for Unity
   href: unity-setup.md
 - name: Interact with Unity game objects and components

articles/remote-rendering/tutorials/unity/view-remote-models/media/settings-graphics-render-pipeline.png renamed to articles/remote-rendering/how-tos/unity/media/settings-graphics-render-pipeline.png

@@ -0,0 +1,33 @@
+---
+title: Unity Render Pipelines
+description: How to set up the Universal Render Pipeline for Remote Rendering
+author: jloehr
+ms.author: julianlohr
+ms.date: 01/12/2022
+ms.topic: how-to
+---
+
+# Unity Render Pipelines
+
+Remote Rendering works with both the **:::no-loc text="Standard render pipeline":::** ("built-in render pipeline") and the **:::no-loc text="Universal render pipeline":::** ("URP"). For performance reasons, it's recommended to use the built-in render pipeline, unless there are strong reasons that require URP.
+
+## Setup Universal Render Pipeline
+
+To use the **:::no-loc text="Universal render pipeline":::**, its package has to be installed in Unity, and the *HybridRenderingPipeline* asset must be added to the Graphics settings.
+
+1. Install the **Universal RP** package (version 7.3.1 or newer) using Unity's **Package Manager** UI, as described in the [Unity - Manual:  Installing from a registry](https://docs.unity3d.com/Manual/upm-ui-install.html).
+1. Open *Edit > Project Settings...*
+1. Select **Graphics** from the left list menu
+    1. Change the **Scriptable Rendering Pipeline** setting to *HybridRenderingPipeline*.\
+        ![Screenshot of the Unity Project Settings dialog. The Graphics entry is selected in the list on the left. The button to select a Universal Render Pipeline asset is highlighted.](./media/settings-graphics-render-pipeline.png)\
+        Sometimes the UI doesn't populate the list of available pipeline types from the packages. If this issue occurs, the *HybridRenderingPipeline* asset must be dragged onto the field manually:\
+        ![Screenshot of the Unity asset browser and Project Settings dialog. The HybridRenderingPipeline asset is highlighted in the asset browser. An arrow points from the asset to the UniversalRenderPipelineAsset field in project settings.](./media/hybrid-rendering-pipeline.png)
+
+        > [!NOTE]
+        > If you're unable to drag and drop the *HybridRenderingPipeline* asset into the Render Pipeline Asset field (possibly because the field doesn't exist!), ensure your package configuration contains the `com.unity.render-pipelines.universal` package.
+
+## Next steps
+
+* [Install the Remote Rendering package for Unity](install-remote-rendering-unity-package.md)
+* [Unity game objects and components](objects-components.md)
+* [Tutorial: View Remote Models](../../tutorials/unity/view-remote-models/view-remote-models.md)

articles/remote-rendering/how-tos/unity/toc.yml

@@ -75,5 +75,6 @@ For an example how to set up and use `ARRServiceUnity` see [Tutorial: Viewing re
 
 ## Next steps
 
+* [Unity Render Pipelines](unity-render-pipelines.md)
 * [Install the Remote Rendering package for Unity](install-remote-rendering-unity-package.md)
 * [Tutorial: Viewing remotely rendered models](../../tutorials/unity/view-remote-models/view-remote-models.md)

articles/remote-rendering/how-tos/unity/unity-render-pipelines.md

@@ -150,9 +150,9 @@ Azure Remote Rendering hooks into the Unity render pipeline to do the frame comp
 ![Unity render pipeline](./media/troubleshoot-unity-pipeline.png)
 
 To fix, make sure the provided _HybridRenderingPipeline_ asset is used:
-![Screenshot of the Unity asset browser and Project Settings dialog. The HybridRenderingPipeline asset is highlighted in the asset browser. An arrow points from the asset to the UniversalRenderPipelineAsset field in project settings.](./../tutorials/unity/view-remote-models/media/hybrid-rendering-pipeline.png)
+![Screenshot of the Unity asset browser and Project Settings dialog. The HybridRenderingPipeline asset is highlighted in the asset browser. An arrow points from the asset to the UniversalRenderPipelineAsset field in project settings.](./../how-tos/unity/media/hybrid-rendering-pipeline.png)
 
-..as described in more detail in the [Unity tutorial to set up the project](./../tutorials/unity/view-remote-models/view-remote-models.md#adjust-the-project-settings).
+..as described in more detail in the [Unity Render Pipelines](./../how-tos/unity/unity-render-pipelines.md#setup-universal-render-pipeline).
 
 ## Checkerboard pattern is rendered after model loading
 

articles/remote-rendering/how-tos/unity/unity-setup.md

@@ -75,14 +75,8 @@ Follow the instructions on how to [add the Azure Remote Rendering and OpenXR pac
 
         ![Screenshot of the Unity Project Settings dialog. The Quality entry is selected in the list on the left. The context menu for the default quality level is opened on the right. The low entry is selected.](./media/settings-quality.png)
 
-1. Select **Graphics** from the left list menu
-    1. Change the **Scriptable Rendering Pipeline** setting to *HybridRenderingPipeline*.\
-        ![Screenshot of the Unity Project Settings dialog. The Graphics entry is selected in the list on the left. The button to select a Universal Render Pipeline asset is highlighted.](./media/settings-graphics-render-pipeline.png)\
-        Sometimes the UI does not populate the list of available pipeline types from the packages. If this occurs, the *HybridRenderingPipeline* asset must be dragged onto the field manually:\
-        ![Screenshot of the Unity asset browser and Project Settings dialog. The HybridRenderingPipeline asset is highlighted in the asset browser. An arrow points from the asset to the UniversalRenderPipelineAsset field in project settings.](./media/hybrid-rendering-pipeline.png)
-
-        > [!NOTE]
-        > If you're unable to drag and drop the *HybridRenderingPipeline* asset into the Render Pipeline Asset field (possibly because the field doesn't exist!), ensure your package configuration contains the `com.unity.render-pipelines.universal` package.
+    > [!NOTE]
+    > In the scope of this tutorial, we stick with the Unity built-in render pipeline. If you would like to use the Universal Render Pipeline, see [Unity Render Pipelines](../../../how-tos/unity/unity-render-pipelines.md) for additional setup steps.
 
 1. Select **XR Plugin Management** from the left list menu
     1. Click the **Install XR Plugin Management** button.