Unity HDRP水体渲染：从Shader Graph到屏幕空间反射的轻量级实现

1. 项目概述：为什么我们需要一个“简单”的水效果方案？

在Unity HDRP（高清渲染管线）项目中实现一个令人信服的水体效果，对于很多开发者来说，一直是个既向往又头疼的挑战。向往是因为水是构建沉浸式自然环境（无论是开阔海洋、静谧湖泊还是山间溪流）不可或缺的元素；头疼则是因为，一个“真实”的水效果背后，往往涉及复杂的着色器编程、物理模拟、性能优化和美术资源整合。市面上有Aquas、Crest Ocean System等强大的专业插件，但它们要么价格不菲，要么学习曲线陡峭，要么对项目架构有特定要求。对于快速原型开发、小型项目、特定风格化需求，或者只是想学习水体渲染核心原理的开发者来说，一个轻量、易用、可快速集成并具备良好基础效果的开源方案，就显得尤为珍贵。

“UnityHDRPSimpleWater”这个项目标题，精准地击中了这个痛点。它明确指出了三个核心要素：Unity（平台）、HDRP（渲染管线）和SimpleWater（核心目标）。这意味着它不是一个通用方案，而是专门为HDRP管线设计，旨在提供一个“简单”的起点。这里的“简单”并不意味着效果简陋，而是指架构清晰、集成便捷、参数直观、易于理解和二次开发。它应该能让你在几分钟内就在场景中放置一片具有基础视觉品质（如波动、折射、反射、高光）的水面，而不是让你从零开始研究GerstenWave函数或FFT（快速傅里叶变换）。

从网络热词来看，大量搜索集中在Unity的安装、配置、打包、性能优化以及特定问题排查（如黑屏、SDK关联错误）上。这反映出一个庞大的、正在入门或处于项目中期的开发者群体，他们需要的是稳定、可复现的解决方案，而不是充满“黑科技”但难以驾驭的复杂系统。一个设计良好的SimpleWater项目，不仅能提供即插即用的水效果，其代码本身也应该是一份高质量的学习资料，帮助开发者理解HDRP下着色器的编写规范、如何与摄像机深度/颜色纹理交互、如何管理渲染状态等核心知识。

因此，这个项目的价值在于降低高质量水体效果的技术门槛和集成成本，为独立开发者、小型团队和教育目的提供了一个绝佳的跳板。接下来，我将深入拆解实现这样一个“简单”但有效的水效果所需的核心技术点、设计思路、实操步骤以及避坑指南。

2. 核心设计思路与方案选型

要构建一个HDRP下的SimpleWater，我们首先需要明确“真实感”水面的几个关键视觉特征，并决定用何种技术方案以“简单”的方式去实现它们。这里的“简单”是相对于电影级离线渲染或AAA游戏中的全动态流体模拟而言的，我们的目标是在实时渲染的约束下，用性价比最高的技术组合达到视觉可接受的效果。

2.1 视觉特征拆解与技术映射

一片看起来真实的水面，通常具备以下特征，我们可以为每个特征选择对应的实现技术：

  1. 表面几何波动：水不是静止的平面。这是水体动态感的根本来源。

    • 简单方案：在顶点着色器或曲面细分着色器中使用正弦波（GerstenWave）叠加。这是最经典、性能消耗最低的方法。通过组合多个不同方向、振幅、频率的正弦波，可以模拟出复杂的波面。相较于基于FFT的海面模拟，正弦波叠加计算量小，可控性强，非常适合中小范围水域（如池塘、河流、小湖）。
    • 进阶考量：为了增加细节，可以在像素着色器中使用法线贴图扰动。使用一张或两张（用于流动混合）水法线贴图，根据时间和方向进行滚动，在像素级别精细地扰动水面法线，从而影响光照和反射，这能极大地丰富表面细节而几乎不增加几何复杂度。

  2. 光学特性：折射与反射

    • 折射：水下物体看起来扭曲、偏移。在HDRP中，我们可以通过抓取摄像机深度和颜色纹理来实现。
      • 原理：在着色器中，根据水面像素的屏幕坐标和扰动后的法线，对深度纹理进行采样，计算出水下世界的屏幕坐标偏移量，再用这个偏移后的坐标去采样颜色纹理，从而模拟光线弯曲的效果。
      • HDRP集成：HDRP提供了Builtin.DepthTexture和Builtin.ColorTexture节点（在Shader Graph中）或对应的HLSL宏，方便我们获取这些缓冲区。
    • 反射：水面像镜子一样映出天空和周围环境。
      • 简单方案：使用屏幕空间反射（SSR）或平面反射探针（Planar Reflection Probe）。
      • SSR：HDRP内置了高质量的屏幕空间反射。只需在水材质上开启相应的属性，并确保场景的反射探针设置得当，就能获得动态的、基于屏幕内容的反射。这是最“省心”的方案，但对于水面边缘或视角较平时可能失效。
      • 平面反射探针：可以专门为水面创建一个平面反射探针，它能渲染一个特定角度的反射摄像机图像，效果比立方体贴图反射更准确，但性能开销更大。对于静止或移动缓慢的水体，这是一个效果很好的选择。

  3. 表面外观：高光与颜色

    • 高光：水面对光源（如太阳）的镜面反射高光。这直接由材质的光滑度（Smoothness）和法线信息决定。我们通过波动画和法线贴图扰动的法线，结合HDRP的基于物理的照明模型，自然就能计算出逼真的高光。
    • 颜色：水的颜色由吸收和散射决定。浅水区透出水底颜色，深水区呈现深蓝/绿色。
      • 简单实现：可以使用基于深度的颜色渐变。在着色器中，计算水面某点的深度（摄像机到水底的距离），用这个深度值在预定义的颜色渐变纹理（Ramp）或函数中进行插值。深度小（浅）时接近水底颜色或自定义的浅水色，深度大（深）时接近深水色。

  4. 边缘效果：泡沫与焦散（可选，提升细节）

    • 泡沫：波浪破碎处、岸边或物体周围的白色泡沫。
      • 简单方案：使用一张泡沫纹理，根据波浪高度（通过顶点偏移的导数近似计算）或与岸边/物体的距离（通过深度差或自定义贴图）来混合显示。
    • 焦散：水底因水面波动而形成的光斑。实现成本较高，在“Simple”版本中通常可以省略，或用简化的投影贴图模拟。

2.2 技术栈与工具选型

基于以上拆解，一个典型的UnityHDRPSimpleWater技术栈如下：

  • 渲染管线：Unity HDRP。这意味着我们的着色器必须基于HDRP的Lit Shader框架或直接使用Shader Graph构建，以兼容其光照、阴影和后期处理系统。
  • 着色器编写方式：推荐使用Shader Graph。对于“SimpleWater”的目标，可视化编程的Shader Graph比手写HLSL/CG代码更友好，能快速搭建和迭代效果，参数调整直观，更符合“简单”的定位。当然，核心的波浪计算函数可能需要以Custom Function节点的方式引入。
  • 核心算法：多正弦波叠加用于几何波动，法线贴图滚动用于表面细节，深度纹理采样偏移用于折射，基于深度的颜色混合用于水体着色。
  • 反射方案：优先依赖HDRP内置的屏幕空间反射（SSR）。这是性能和效果平衡的最佳选择。在Shader Graph中，只需将材质的Smoothness设置得足够高（例如0.9以上），并确保场景中有良好的反射源（如天空盒、反射探针），SSR就会自动工作。
  • 辅助工具：可能需要编写简单的C#脚本，用于控制全局的水体参数（如风速、波高）或驱动基于距离的泡沫效果。

这个选型方案的核心思想是：最大化利用HDRP内置的强大功能（如SSR、物理光照、深度纹理），我们只专注于实现HDRP没有直接提供的、水体特有的动态行为（波动、折射、颜色）。这样既能保证效果，又能极大地减少工作量并确保兼容性。

3. 分步实现：从零搭建SimpleWater材质

假设我们使用Shader Graph在HDRP中创建这个水材质。以下是详细的步骤和每个节点背后的原理。

3.1 创建基础材质与着色器图

  1. 在Project窗口中右键，选择Create > Shader Graph > HDRP下的Lit Shader Graph。命名为WaterShaderGraph。
  2. 基于此Shader Graph创建一个材质，命名为Mat_Water。
  3. 将材质拖到场景中的一个平面（Plane）或自定义网格上，作为水面。

注意：确保你的Unity项目使用的是HDRP模板，或者已正确安装并配置了HDRP包。在Graphics Settings中需指定HDRP Asset。

3.2 实现顶点波浪动画

这是水动态的核心。我们将在Vertex Shader阶段修改顶点位置。

  1. 在Shader Graph中，添加一个Custom Function节点。将其模式设置为“String”，并输入一个包含波浪计算函数的HLSL代码块。我们将其命名为GerstenWave。

  2. 编写波浪函数：这个函数输入世界坐标、时间、以及多个波的参数（方向、振幅、波长、速度），输出偏移后的世界坐标和法线（或仅输出偏移量，再与原始法线混合）。一个简单的单一正弦波函数示例如下（在实际应用中需要叠加多个波）：

    void GerstenWave_float(float3 InWorldPos, float Time, float WaveAmplitude, float WaveLength, float2 WaveDirection, float WaveSpeed, out float3 OutWorldPos, out float3 OutNormal) { // 计算波数 float k = 2 * UNITY_PI / WaveLength; // 计算相位 float phase = k * dot(WaveDirection, InWorldPos.xz) - WaveSpeed * Time; // 计算高度偏移 (y轴) float height = WaveAmplitude * sin(phase); // 计算偏移后的世界坐标 OutWorldPos = InWorldPos; OutWorldPos.y += height; // 计算法线（简化版，通过对高度函数求偏导） float derivative = k * WaveAmplitude * cos(phase); float3 tangent = normalize(float3(1.0, derivative * WaveDirection.x, 0.0)); float3 binormal = normalize(float3(0.0, derivative * WaveDirection.y, 1.0)); OutNormal = cross(binormal, tangent); // 注意叉乘顺序，确保法线朝上 }
    • 参数解释：
      • WaveAmplitude：波的高度。
      • WaveLength：两个波峰之间的距离。
      • WaveDirection：一个二维向量，表示波传播的方向（如(1,0)表示沿x轴传播）。
      • WaveSpeed：波移动的速度。
    • 实际操作：为了效果更自然，你需要创建多个这样的Custom Function节点，每个设置不同的参数（例如，一个长波、一个短波、方向略有不同），然后将它们的height输出相加，最终应用到顶点位置。OutNormal也需要进行加权平均或更复杂的混合。

  3. 连接节点：

    • 将Position节点（设置为World空间）连接到Custom Function的InWorldPos。
    • 将Time节点的Time输出连接到Time输入。
    • 创建多个Vector4或分开的Float属性，作为波的参数暴露给材质面板。
    • 将Custom Function输出的OutWorldPos连接到主Master节点的Vertex Position输入（可能需要先转换为Object空间，取决于你的设置）。
    • 将计算出的OutNormal与后续的法线贴图扰动结果进行混合。

3.3 实现法线贴图扰动

这一步在Fragment Shader中进行，用于增加高频细节。

  1. 导入一张高质量的水体法线贴图（可以在Asset Store找到免费资源或自己制作）。
  2. 添加一个Sample Texture 2D节点，采样这张法线贴图。
  3. 创建两个Tiling And Offset节点，分别用于模拟两个不同方向和速度的流动。将Time乘以一个速度系数后作为Offset的输入，方向由Vector2属性控制。
  4. 将两个Tiling And Offset节点的输出分别连接到两个Sample Texture 2D节点的UV输入。
  5. 使用Blend Normals节点将两个采样得到的法线混合。这能创造出更复杂、不规则的表面细节，避免明显的纹理重复感。
  6. 将混合后的法线与之前顶点波浪计算出的宏观法线（如果有）再次用Blend Normals节点混合。
  7. 最终的法线向量连接到Master节点的Normal输入。

实操心得：法线贴图的滚动速度不宜过快，且两个层的速度和方向最好有细微差别。Tiling（平铺）值要设置得足够大，以避免在近距离观察时看到明显的纹理重复。通常，基础层用较大的Tiling（如(5,5)），细节层用更大的Tiling（如(10,10)）和更慢的速度。

3.4 实现基于深度的折射与颜色

这是实现水体透明感和深度感的关键。

  1. 获取屏幕空间深度与颜色：

    • 添加Scene Depth节点和Scene Color节点。在HDRP的Shader Graph中，它们通常可以直接使用。
    • 重要：需要确保材质的“Surface Type”设置为Transparent，并且渲染队列和混合模式设置正确，才能正确读取背后的场景信息。

  2. 计算折射偏移：

    • 使用上一步得到的最终法线（切线空间或世界空间，需注意转换）。取其XZ分量，并乘以一个可调节的Refraction Strength强度参数。
    • 将当前像素的屏幕空间UV，加上这个法线XZ分量构成的偏移向量，得到折射采样UV。
    • 用这个偏移后的UV去采样Scene Color纹理，得到折射颜色。

  3. 计算基于深度的颜色：

    • 用当前像素的屏幕空间UV（未偏移）采样Scene Depth，得到深度值A。
    • 假设水面是一个平面，我们可以通过简单的射线-平面相交或使用一个近似值来估算水体的深度。一个更简单但有效的近似方法是：将顶点波浪计算出的高度变化也考虑进去，但作为Simple版，我们可以先使用一个由美术控制的颜色渐变。
    • 添加一个Sample Gradient节点，创建一个从浅水色到深水色的渐变。
    • 将采样到的深度值A（或经过转换的线性深度/实际距离）重映射到一个[0,1]的范围，作为Sample Gradient的输入Time。
    • 输出就是基于深度的水体基础色。

  4. 混合颜色：

    • 最终的表面颜色是折射颜色、基于深度的水体色以及可能有的高光颜色的混合。
    • 通常，我们会让折射颜色与水体色进行某种程度的混合。例如，可以使用深度值作为混合因子：水越浅，水体基础色占比越大（能看到水底颜色）；水越深，折射颜色占比越大（看起来更清澈）。
    • 公式可以简化为：FinalColor = lerp(WaterColor, RefractionColor, saturate(Depth * DepthInfluence))。其中DepthInfluence是一个控制深度对混合影响程度的参数。

3.5 配置材质与反射

  1. 材质表面设置：

    • 在材质的Inspector面板或Shader Graph的Master节点中，将Surface Type设为Transparent。
    • 将Blending Mode设为Alpha（传统透明）或Premultiply（对于某些折射效果可能更合适）。
    • 将Smoothness调高，例如0.95。高光滑度是产生清晰反射和高光的前提。
    • Metallic通常设为0，除非你想要金属质感的水（如汞）。
    • 调整Alpha值控制整体透明度。

  2. 启用屏幕空间反射：

    • 在HDRP的Volume配置中，确保添加了Screen Space Reflectionoverride。
    • 调整SSR的质量和距离参数。对于水，通常需要较高的质量和最大距离。
    • 在水材质上，高光滑度会自动让SSR生效。你可能会看到一个Receive SSR的选项，确保它是开启的。

  3. 添加辅助纹理：

    • 泡沫纹理：可以添加一张黑白泡沫贴图。在Shader Graph中，根据波浪的“陡度”（可以通过计算波浪函数在水平方向的变化率来近似）或岸边距离（通过比较水面顶点高度和场景深度得到的“水深”图）来采样这张贴图，并将其颜色叠加到最终输出上，同时影响高光和粗糙度（泡沫区域粗糙度更高）。

4. 性能优化与参数调校心得

一个“Simple”的方案也必须考虑性能。以下是关键的优化和调校点：

4.1 性能优化要点

  1. 波浪计算精度：顶点波浪的计算量随顶点数线性增长。如果水面网格很密集（例如用了曲面细分），计算多个复杂正弦波可能成为瓶颈。
    • 优化：对于远距离或非焦点区域的水面，可以使用简化的波浪计算（减少波的数量）甚至完全关闭顶点动画，仅保留法线贴图扰动。这可以通过LOD（细节层次）系统或根据摄像机距离动态调整材质参数来实现。
  2. 折射采样：对Scene Color纹理进行偏移采样，如果偏移量过大，可能会采样到屏幕边界外或不同深度的错误像素，导致视觉瑕疵。
    • 优化：对偏移量进行钳制（Clamp），或使用Scene Color节点提供的Linear Eye Depth来辅助进行深度比较，实现更精确的折射（即仅在“水下”部分进行偏移采样）。但这会增加着色器复杂度。
  3. 透明渲染排序：透明物体渲染顺序敏感，且通常无法写入深度缓冲区（ZWrite Off），可能导致过度绘制和排序错误。
    • 优化：确保水材质在所有不透明物体之后渲染。在Shader中正确设置Render Queue（例如Transparent+100）。尽量避免大面积、多层重叠的透明水体。
  4. SSR性能：屏幕空间反射本身开销较大，尤其是高分辨率和高采样数时。
    • 优化：在HDRP的SSR设置中，适当降低Ray Max Iterations（最大步进次数）和Depth Tolerance（深度容差）。对于移动平台或低端PC，可以考虑为水材质使用一个低精度的Planar Reflection Probe作为备选，或者完全关闭反射，仅依靠天空盒的反射立方体贴图。

4.2 视觉参数调校技巧

调出一个“好看”的水，参数调整至关重要。以下是一些经验性的起点值和建议：

  • 波浪：
    • 使用至少2-3个波进行叠加。
    • 主波：Amplitude=0.3,Wavelength=10, 速度适中，方向与风向一致。
    • 次波（细节波）：Amplitude=0.1,Wavelength=3, 速度稍快，方向与主波略有夹角（如15度）。
    • 涟漪波：Amplitude=0.05,Wavelength=1, 速度快，方向随机或与主波垂直。
  • 法线贴图：
    • 基础层：Tiling (8,8), 速度慢 (Time * 0.05)。
    • 细节层：Tiling (20,20), 速度稍快 (Time * 0.1)。
    • 混合时，细节层的权重可以低一些（如0.3）。
  • 折射：
    • Refraction Strength：起始值可以设为0.05到0.1。值太大会导致严重的扭曲和视觉混乱。
    • 深度影响因子DepthInfluence：根据场景尺度调整，通常0.1到0.5之间。
  • 颜色：
    • 渐变设置：Time=0处，使用浅蓝绿色（RGB约(0.6, 0.9, 0.8)）。Time=1处，使用深蓝色（RGB约(0.1, 0.3, 0.6)）。
    • 可以加入第二个渐变，用于控制不同深度的吸收程度，让深水区更快地变暗。
  • 高光与反射：
    • Smoothness: 0.9 - 1.0。
    • Metallic: 0。
    • 在HDRP的天空盒或Volume中，确保有一个明亮的光源（Directional Light）和一张具有丰富细节的HDRI天空盒，这样反射和高光才会漂亮。

5. 常见问题与排查实录

在实际集成和使用过程中，你几乎一定会遇到下面这些问题。这里记录了排查思路和解决方案。

5.1 水看起来是纯黑色或不反射

  • 可能原因1：着色器编译错误或资源缺失。
    • 排查：检查Console窗口是否有着色器编译错误。确保所有引用的纹理（法线贴图、渐变纹理）都已正确导入并分配给材质球。
  • 可能原因2：渲染管线不匹配。
    • 排查：确认你的材质球使用的Shader是基于HDRP Lit Shader Graph生成的。在Built-in RP或URP中，这个Shader无法工作。检查Graphics Settings中的Scriptable Render Pipeline Settings是否指定了正确的HDRP Asset。
  • 可能原因3：屏幕空间反射未启用或配置不当。
    • 排查：
      1. 在场景中或全局Volume中，检查是否有Screen Space Reflection覆盖组件，并确保其为Enabled。
      2. 检查HDRP Asset的质量设置（Quality > HDRP Asset），确保SSR是开启的。
      3. 尝试临时增加Ray Max Iterations和Ray Max Length，看反射是否出现。
      4. 确保水面材质有足够高的Smoothness（>0.8）。
  • 可能原因4：光照设置问题。
    • 排查：场景中是否有有效的Directional Light（主光源）？HDRP的天空盒是否设置？尝试在场景中放置一个默认的HDRP天空和光照预制体。

5.2 折射效果扭曲错误或出现硬边

  • 可能原因1：折射偏移量过大。
    • 解决：降低材质上Refraction Strength参数的值。过大的偏移会导致采样到完全无关的像素。
  • 可能原因2：深度纹理精度或采样问题。
    • 排查：在Shader Graph中，检查Scene Depth节点的设置。确保其Mode设置正确（通常为Eye或Linear Eye）。尝试对深度值进行简单的可视化输出（例如，连接到颜色输出），看深度图是否正常。
    • 注意：透明物体默认不写入深度缓冲区。水面前的物体深度是正确的，但水面后的物体深度可能因为水的透明而被跳过。复杂的折射需要处理这种深度剥离问题，这在Simple方案中可能难以完美解决，适当调整透明度混合模式和折射强度可以缓解。
  • 可能原因3：水面网格分辨率过低。
    • 解决：增加水面网格的细分程度。波浪计算和法线在低模上会显得很粗糙，导致折射采样UV不连续，产生块状扭曲。可以给平面添加Subdivide修改器，或使用曲面细分着色器（如果Shader Graph支持并开启了）。

5.3 水面边缘有锯齿或闪烁

  • 可能原因：深度比较引起的Z-fighting或透明排序问题。
    • 解决：
      1. Z-fighting：轻微抬高水面网格的Y轴位置，使其略微浮在视觉上的“水面”之上，避免与地面或其他物体表面完全共面。
      2. 透明排序：确保所有透明物体（包括水）的渲染队列设置合理，水通常应在最后渲染。可以尝试调整材质的Render Queue偏移。
      3. 抗锯齿：在HDRP的Camera或抗锯齿设置中，开启TAA（ Temporal Anti-Aliasing）或SMAA，能有效减少边缘闪烁。

5.4 性能开销过大

  • 可能原因1：波浪计算过于复杂。
    • 解决：减少叠加的正弦波数量，或者在Shader中使用更简化的波浪函数。考虑将部分计算从Vertex Shader移到Fragment Shader（但这会增加像素开销，需权衡）。
  • 可能原因2：全屏效果开销。
    • 解决：SSR和透明渲染本身就是性能大户。在低端设备上，考虑降低SSR质量，或为水材质使用一个低分辨率的平面反射探针（设置为每几帧更新一次）。限制使用大面积水域。
  • 排查工具：使用Unity的Profiler（特别是Render区域）和Frame Debugger，精确分析是哪一部分（绘制调用、着色器复杂度、Overdraw）导致了性能瓶颈。

5.5 打包后效果消失或变差

  • 可能原因：着色器变体缺失。
    • 解决：这是Unity项目打包的经典问题。在Player Settings的Graphics设置中，确保包含了项目用到的所有着色器变体。更可靠的方法是，在Edit > Project Settings > Graphics下的Shader Stripping中，为HDRP相关功能（如Transparent, Screen Space Reflections）取消不必要的剥离，或者直接创建一个Resources/ShaderGraphVariants文件来显式包含所需变体。
    • 打包前检查：始终在目标平台（如Android, iOS）的Development Build模式下进行测试，以便查看可能出现的着色器编译错误日志。

通过以上五个部分的拆解，我们从设计理念到具体实现，从参数调校到问题排查，完整地覆盖了创建一个“UnityHDRPSimpleWater”方案的全过程。这个方案虽然“简单”，但已经具备了真实水体的核心视觉特征：动态波动、折射、反射、基于深度的颜色变化以及表面细节。它为你提供了一个坚实且可扩展的起点，你可以在此基础上，继续探索添加泡沫线、焦散、水下雾效、与物理对象的交互（如船只尾迹）等更高级的特性，逐步将其打磨成更适合你项目需求的专属水体解决方案。记住，好的技术方案总是在“效果”、“性能”和“复杂度”之间寻找最佳平衡点，而这个“SimpleWater”的定位，正是为了帮你快速找到那个起点。