VR 合成层最多支持多少层?

单个场景最多支持 15 层 VR 合成层（超过 15 层将不予显示）。同时，每个场景中最多只能存在一个 Equirect 层和一个 Cylinder 层。考虑到对性能的影响，建议你将单个场景的 VR 合成层数量控制在 4 层左右。

VR 合成层（VR Compositor Layers）可以用来展示场景中的焦点对象，例如信息、文本、视频以及纹理，也可以用来展示简单的场景环境和背景。

通常来说，渲染 VR 内容时，左右眼摄像机首先将场景内容渲染到 Eye Buffer 上；绘制完成后，异步时间扭曲线程（Asynchronous Timewarp，ATW）对 Eye Buffer 进行畸变、采样、合成等处理；处理完毕后，场景内容最终被渲染到屏幕上。

若通过 VR 合成层技术进行场景渲染，则无需将场景内容绘制到 Eye Buffer 上，而是直接透传给 ATW 线程进行畸变、采样、合成等处理。因此，减少了一次额外的纹理采样，简化了整个渲染流程，同时可提升渲染质量。

注意事项

• 目前，单个场景最多支持添加 7 个 VR 合成层，建议不超过 4 个。
• 应该遵循近处物体遮挡远处物体的规则来使用合成层，否则可能会出现轻微晃动。
• 若你在项目中使用了 Vulkan 和通用渲染管线（URP），同时需使用 Underlay 层时，则需要禁用 HDR，否则 Underlay 层无法生效。

PXR_Over Lay 脚本参数说明

PXR_Over Lay 脚本用于配置合成层相关参数。

Type (合成层类型)

SDK 提供两种类型的合成层：Overlay 和 Underlay。

Shape (合成层形状)

SDK 提供五种形状的合成层：Quad、Cylinder、Equirect、Cubemap 和 Equi-Angular Cubemap (EAC)。具体说明如下：

Depth (合成层深度)

合成层深度（Depth）用于定义合成层在场景中的顺序。数值越小，越靠近 Eye Buffer。假设一个场景中添加了三层 Overlay 和三层 Underlay，深度值设定可以为[Camera](Overlay)2/1/0[EyeBuffer]0/1/2(Underlay)。

Texture Type (纹理类型)

SDK 提供三种纹理类型：外部纹理（External Surface）、动态纹理（Dynamic Texture）和静态纹理（Static Texture）。每个纹理都有最佳使用场景。

Texture (纹理)

Texture 参数用于指定左右眼透传的纹理。

Radius (半径)

将 Shape (合成层形状) 设置为 Equirect（球体纹理）时，需要配置 Radius 参数，指定圆柱的半径。

Texture Rects (纹理矩形)

勾选 Texture Rects 选框后，可配置 Source Rects 和 Destination Rects 相关参数。

Source Rects (源矩形)

Source Rects 参数用于设置被渲染到物体表面的纹理区域。选项说明如下：

Destination Rects (目标矩形)

Destination Rects 参数用于设置合成层所覆盖的目标区域。选项说明如下：

Layer Blend (图层混合)

Layer Blend 用于设置 Source 层和 Destination 层的颜色值和透明度值。

图层混合可将源图层颜色和目标图层颜色进行混合，常用来绘制透明或半透明的物体。合成层默认从后往前进行混合，若当前场景有合成层 1、2、3、4，则图层混合顺序为：

1. 合成层 4 和 3 优先被混合，作为 Destination 层 1。此时，合成层 2 将作为 Source 层。
2. Destination 层 1 与合成层 2 进行混合，作为 Destination 层 2。此时，合成层 1 将作为 Source 层。
3. Destination 层 2 与合成层 1 进行混合。

相关参数说明如下：

Override Color Scale (覆盖全局颜色设置)

若想覆盖该层的全局颜色设置，可勾选 Override Color Scale，然后配置以下参数：

通用使用步骤

此部分以 Overlay 类型的 Quad 层为例，介绍如何配置基本的合成层参数，并实现 World-Locked 和 Head-Locked 两种模式。

• World-Locked 模式

通常情况下，合成层为 World-Locked 模式。无论头戴位置如何移动，合成层都不会随着头戴移动，而是保持其在世界中的固定位置。

• Head-Locked 模式

在 Head-Locked 模式中，合成层会随着头戴的移动而移动。若想达到此效果，需将合成层作为摄像机的的子节点。

配置 World-Locked 模式

第一步，为场景添加 XR Origin 并为其挂载 PXR_Manager 脚本，然后将 XR Origin 下的摄像机设置为主摄像机。步骤如下：

1. 在 Unity 编辑器中打开项目。
2. 在 Hierarchy 窗口中，点击 + > XR > XR Origin (VR) 。

XR Origin 将被添加至场景中。XR Origin 下的 Main Camera 将默认成为场景内容捕捉摄像机。若未升级 XR Interaction Toolkit 至最新版本，则 XR Origin 的名称为 XR Rig。XR Interaction Toolkit 升级步骤可参考《快速开始》指南。

        3.选中 XR Origin 节点下的 Main Camera。

        4.在 Inspector 窗口中，将 Main Camera 的 Tag 设置为 MainCamera。一般已默认为该设置。

        5.删除场景自带的 Main Camera。

        6.选中 XR Origin。

Inspector 窗口展示 XR Origin 挂载的组件和脚本。

        7.点击 Inspector 窗口底部的 Add Component 按钮。

        8.搜索 PXR_Manager 脚本，然后双击添加。

第二步，为场景添加一个 3D 对象并为其挂载 PXR_Over Lay 脚本，该脚本用来配置合成层参数。步骤如下：

1. 在上方菜单栏处，选择 GameObject > 3D Object。
2. 创建一个 3D 对象，例如：Cube。
3. 调整 3D 对象的位置，使其处于摄像机可见位置。
4. 在 Hierarchy 窗口中，选中该 3D 对象。

Inspector 窗口中将展示该 3D 对象挂载的配置脚本和组件。

        5.点击 Inspector 窗口底部的 Add Component 按钮。

        6.搜索 PXR_Over Lay 脚本，然后双击添加。脚本界面如下：

第三步，配置合成层基础参数。步骤如下：

1. 将 Type 设置为 Overlay。
2. 将 Shape 设置为 Quad。
3. 将 Depth 设置为 0。

最后，选择纹理类型并按需配置参数。步骤：

1. 将 Texture Type 设置为 Dynamic Texture 或 Static Texture。

PXR_Over Lay 脚本界面转换如下：

        2.在 Texture 参数处，选择左右眼透传的纹理。

至此，合成层基础配置完成。你可以在设备上运行该场景，将体验到“效果展示”中的效果。此外，可根据实际需求，进行以下配置：

        3.(可选) 勾选 Texture Rects，然后配置 Source Rects 和 Destination Rects 相关参数。

        4.(可选) 勾选 Layer Blend，然后设置 Source 层和 Destination 层的颜色值和透明度值。

        5.(可选) 若想覆盖该层的全局颜色设置，可勾选 Override Color Scale，然后配置相关参数。

配置 Head-Locked 模式

1. 添加 XR Origin 并为其挂载 PXR_Manager 脚本，然后将 XR Origin 下的摄像机设置为主摄像机。
2. 在 Hierarchy 窗口中，展开 XR Origin （或 XR Rig）> Camera Offset。
3. 右击 Main Camera，然后选择 3D Object，为摄像机节点创建一个子 3D 对象（例如：Cube）。

        4.将 Cube 移动至摄像机可见位置。

        5.选中 Cube。

        6.在 Inspector 窗口中，点击底部的 Add Component 按钮，为 Cube 添加 PXR_Over Lay 脚本。

        7.参考 World-Locked 模式，配置相关参数。

Equirect 层使用说明

Equirect 层为球体纹理，通常用于显示 180/360 全景图像和视频。配置步骤如下：

1. 参考 使用 Quad 层，为场景添加 XR Origin 和 3D 对象，并分别为它们添加 PXR_Manager 和 PXR_Over Lay 脚本。
2. 在 PXR_Over Lay 面板处，进行以下参数配置：
   1. 选择 Type。
   2. 将 Shape 设置为 Equirect。
   3. 按需设置 Depth。
   4. 按需选择 Texture Type。
   5. 将 Texture 指定为 360 全景纹理。
3. 按需配置 Texture Rects，Layer Blend，和 Override Color Scale 参数。参数说明参考 使用 Quad 层。
4. 将场景打包安装至设备上运行。效果如下：

EAC 层使用说明

等角立方体贴图（Equi-Angular Cubemap，EAC）是一种用于展示 180 度或 360 度全景图片和视频的投影技术，是等距投影和立方体投影的结合体。

SDK 提供四种 EAC 模式，将 Overlay Settings 部分的 Shape 参数设置为 Eac 后，可以在 Model Type 参数处进一步选择 EAC 模式。

EAC 各模式的说明如下：

EAC 层相关参数说明如下：

Blurred Quad 层使用说明

Blurred Quad 层用于渲染空间图片或空间视频。

若想使用 Blurred Quad 层，需要在 PXR_Over Lay (Script) 组件中将 Shape 参数设置为 Blurred Quad，将 Texture Type 设置为 External Surface（目前仅支持此类型），然后配置相关参数。

Blurred Quad 层相关参数说明如下。

除了在 Unity 编辑器内的 PXR_Over Lay (Script) 组件中设置参数外，你也可以直接修改 PXR_OverLay.cs 文件中的值（如下所示），设置后会每帧生效。

#region Blurred Quad
public BlurredQuadMode blurredQuadMode = BlurredQuadMode.SmallWindow;

public float blurredQuadScale = 0.5f;
public float blurredQuadShift = 0.01f;
public float blurredQuadFOV = 70.0f;
public float blurredQuadIPD = 0.064f;
#endregion

播放 HDR 视频

External Surface 类型的纹理支持播放 HDR 视频。播放视频时，根据视频类型动态设置 HDR 类型（HDRFlags）。HDRFlags 枚举值如下：

public HDRFlags hdr = HDRFlags.None;
public enum HDRFlags
{
    None, // 关闭 HDR 视频透传
    HdrPQ, // PQ 兼容显示模式，支持将符合 ST.2084 标准的 HDR 源重映射成 SDR，以得到正确的显示效果
    HdrHLG, // HLG 兼容显示模式，支持将符合 HLG 标准的 HDR 源重映射成 SDR，以得到正确的显示效果
 }

外部纹理补充说明

若使用外部纹理，可按需配置以下参数：

参数说明如下：

已知问题

Unity 2023 中，若在多视图渲染（Multiview Rendering）模式下使用 Overlay 合成层，会导致 Overlay 合成层不显示或显示异常。待后续引擎更新解决。