1. 背景：混乱的 API

Unity 2023+ 的版本实现 XR 后处理有一些挑战，主要是历史遗留问题。

RT有三套 API：

RenderTexture
RenderTargetIdentifier
RTHandle

SetRenderTarget有四个：

CoreUtils.SetRenderTarget
ScriptableRenderer.SetRenderTarget
CommandBuffer.SetRenderTarget
Graphics.SetRenderTarget

Blit 有五个：

Graphics.Blit
CommandBuffer.Blit
ScriptableRenderPass.Blit
RenderingUtils.Blit
Blitter.BlitTexture

问题来了，哪些 Unity 2023+ 能用？哪些 XR 能用？真的让人头秃。

Github 上很多代码版本比较老，都无法直接使用在 URP + XR 条件下，因此需要一些特殊的技巧移植代码。

2. Single-Pass Stereo Rendering

这是一种 XR 设备中目前比较主流的渲染技术，在 Unity 官方文档中有所描述，但不太形象。

https://docs.unity3d.com/2023.1/Documentation/Manual/SinglePassInstancing.html

一般 VR 设备有两块屏幕（左右眼），两眼有视差，因此双眼所见内容并不完全一致。

如果两个屏幕的内容分开渲染会有一些浪费，因为二者的几何数据是一致的。

Stereo Rendering 的简化是：两个屏幕一起用 Instancing 的方式渲染，左右有相同的几何数据，而只是 View Matrix 有所不同。

对我们实现 Custom Render Feature 的影响时，这时候 RenderTarget 实际上是一个 Texture2DArray！Array中有两个 ID，分别对应左右眼。

从 Frame Debugger 中也可以看到，uniform buffer 放的数据有两个 matrix，分别对应双眼。

可以想象，API 调用的 DrawMeshInstanced，在 shader 内部按 instanceId 选择 matrix 计算 v2f，之后在 fragment shader 中按照 stereo id 拿到需要的顶点数据。

因此，在 XR 模式下，Shader 的写法，Blit 的方式等都必须要特殊处理，不然无法在Stereo Rendering 模式下工作，这也是 XR 模式下，很多古老的代码挂掉的原因。

3. API 到底用哪个

个人的一个简单的结论是：用 RTHandle，CoreUtils.SetRenderTarget 和 Blitter.BlitTexture。主要是观摩学习了 URP 官方代码，然后自己测试下来能跑就行。也不不排除别的 API 能用。但有些 API 是肯定用不了了。

官方原文

Avoid using the CommandBuffer.Blit API in URP projects.
The CommandBuffer.Blit API is the legacy API. It implicitly runs extra operations related to changing states, binding textures, and setting render targets. Those operations happen under the hood in SRP projects and are not transparent to the user.
The API has compatibility issues with the URP XR integration. Using cmd.Blit might implicitly enable or disable XR shader keywords, which breaks XR SPI rendering.
The CommandBuffer.Blit API is not compatible with NativeRenderPass and RenderGraph.
Similar considerations apply to any utilities or wrappers relying on cmd.Blit internally, RenderingUtils.Blit is one such example.

总之就是说 commandBuffer.Blit 在 XR 跑不了，然后依赖于这个 API 的也不行。

3.1 RTHandles

最早 builtin 管线中，大多数时候需要手动分配 RenderTexture 并自行绑定。后面 Unity 引入了 RenderTargetIdentifier 系统，对 RT 做了一些抽象。而在 Unity 2022 / URP 13 中，这套Identifier 直接被废弃了，改为使用新的 RTHandles 系统。可以详见这个 2021年11月的 PR

https://github.com/Unity-Technologies/Graphics/pull/5346

一些 API 如 SetRenderTarget，Blit 等只能接收 RTHandles，一些古早的代码会直接无法使用。这个也是官方比较推荐的 RenderTexture 使用方式。

正确的使用方式：

RenderPass 初始化时，使用 RTHandles.Alloc()，这时可能还没有实际分配 RT，只是给了个标识符。
void Execute(ScriptableRenderContext context, ref RenderingData renderingData) 方法中使用 RenderingUtils.Reallocate 。这个方法内部比较了 RenderTextureDescriptor 是否有变化，如果需要的话会自动重新创建 RT
RenderPass Dispose 时 RTHandle.Release()

3.2 CoreUtils.SetRenderTarget

1
2
3

void SetRenderTarget(CommandBuffer cmd, RenderTargetIdentifier buffer, ClearFlag clearFlag, Color clearColor, int miplevel = 0, CubemapFace cubemapFace = CubemapFace.Unknown, int depthSlice = -1)
void SetRenderTarget(CommandBuffer cmd, RenderTargetIdentifier buffer, RenderBufferLoadAction loadAction, RenderBufferStoreAction storeAction, ClearFlag clearFlag, Color clearColor)
void SetRenderTarget(CommandBuffer cmd, RenderTargetIdentifier colorBuffer, RenderBufferLoadAction colorLoadAction, RenderBufferStoreAction colorStoreAction, RenderTargetIdentifier depthBuffer, RenderBufferLoadAction depthLoadAction, RenderBufferStoreAction depthStoreAction, ClearFlag clearFlag, Color clearColor, int miplevel = 0, CubemapFace cubemapFace = CubemapFace.Unknown, int depthSlice = -1)

这个方法有 26 个重载方法，可以设定 color buffer， depth buffer， load action，store action，clear color 等等很多，就不一一叙述了，以上是几个常用的。读者可以自行阅读源码学习。

3.3 Blitter

总之是使用 Blitter 类。

// 以下会自动先设置 RenderTarget，再执行 Blitter.BlitTexture
void BlitCameraTexture(CommandBuffer cmd, RTHandle source, RTHandle destination, float mipLevel = 0, bool bilinear = false)
void BlitCameraTexture(CommandBuffer cmd, RTHandle source, RTHandle destination, Material material, int pass)
void BlitCameraTexture(CommandBuffer cmd, RTHandle source, RTHandle destination, RenderBufferLoadAction loadAction, RenderBufferStoreAction storeAction, Material material, int pass)

// 以下需要手动提前设置 rendertarget
void BlitTexture(RasterCommandBuffer cmd, RTHandle source, Vector4 scaleBias, Material material, int pass)

读者可以自行阅读源码学习。

早先一些的版本中，官方建议用 cmd.DrawMesh 画一个全屏方块，如 https://docs.unity3d.com/Packages/com.unity.render-pipelines.universal@13.0/manual/renderer-features/how-to-fullscreen-blit-in-xr-spi.html

但最新版本中这一实现直接被 Blitter 类封装，因此直接使用 Blitter 就可以了。

3.4 Shader 的修改

注释写在下面代码中。

一定需要注意的是， Blitter 类会默认把输入图叫做 _BiltTexture，而不是 builtin 管线中的 _MainTex, 因此代码中一定要确认引用/声明是对应的。

// 如果这是一个 Blit Shader，建议直接 include 这个
// 里面定义了 _BlitTexture，是会被 Blitter 类直接置的
#include "Packages/com.unity.render-pipelines.core/Runtime/Utilities/Blit.hlsl"

// 如果 _AnotherTex 是从 Framebuffer 生成的（比如只是降采样），需要用 TEXTURE2D_X 来定义
// 这样 XR 模式下，它是一个 Texture2DArray；非 XR 模式下，它还是一个 Texture2D
TEXTURE2D_X(_AnotherTex);
SAMPLER(sampler_AnotherTex);

// 想用 texel size 就声明一下
float4 _BlitTexture_TexelSize;

struct Attributes
{
    float4 positionOS : POSITION;
    float2 uv : TEXCOORD0;
    UNITY_VERTEX_INPUT_INSTANCE_ID // 无论是 Blit Shader 还是 普通 Shader，只要是想在 XR 利用，都要添加
};

struct Varyings
{
    float4 positionCS : SV_POSITION;
    float2 uv : TEXCOORD0;
    UNITY_VERTEX_OUTPUT_STEREO // 无论是 Blit Shader 还是 普通 Shader，只要是想在 XR 利用，都要添加
};

Varyings Vert(Attributes input)
{
    Varyings output;
    UNITY_SETUP_INSTANCE_ID(input); // 想在 XR 模式用就加上
    UNITY_INITIALIZE_VERTEX_OUTPUT_STEREO(output); // 想在 XR 模式用就加上

    output.positionCS = TransformObjectToHClip(input.positionOS.xyz);
    output.uv = input.uv;
    return output;
}

half4 FragmentSimple(Varyings i) : SV_Target
{
    UNITY_SETUP_STEREO_EYE_INDEX_POST_VERTEX(i);
    float2 uv = UnityStereoTransformScreenSpaceTex(i.uv);  // 这行和上一行，如果需要屏幕空间 uv 需要这么计算
    float3 color1 = SAMPLE_TEXTURE2D_X(_AnotherTex, sampler_AnotherTex, uv).rgb; // 采样 TEXTURE2D_X 需要用这套 API
    uint2 uvCoord = uv * _BlitTexture_TexelSize.zw;
    float3 color2 = LOAD_TEXTURE2D_X(_BlitTexture, uvCoord).rgb; // 示意一下 LOAD_TEXTURE2D_X 用法
    return half4(color1  * color2, 1);
}