1. 项目概述与核心价值

最近在做一个移动端的开放世界项目，美术同学把场景搭得特别漂亮，各种动态光源和复杂材质都用上了，在编辑器里跑起来效果杠杠的。结果一打包到手机上，帧率直接掉到二十几，发热还特别严重。排查了一圈，发现环境光（Ambient Light）和全局光照（Global Illumination）相关的计算是性能大头。尤其是那些需要实时计算、动态变化的间接光照，在移动端的GPU上简直就是“帧率杀手”。相信很多做移动端3D项目的朋友都遇到过类似的问题：想要好的画面，又得保住帧率，两头为难。

这时候，球谐光照（Spherical Harmonics， 简称SH）就该登场了。这玩意儿不是什么新东西，但在移动端优化环境光渲染上，它绝对是一把被严重低估的“瑞士军刀”。简单来说，SH是一种数学工具，它能把一个球面上复杂的光照信息（比如来自天空盒的环境光、场景的间接反射光）压缩成几个简单的系数。在运行时，我们不需要再去采样复杂的高动态范围图像（HDR）或者做昂贵的光线追踪，只需要用这几个系数，结合物体的法线方向，就能快速计算出当前点接收到的环境光颜色和强度。

它的核心价值就体现在“预计算”和“运行时轻量”这两个词上。我们把复杂的光照信息“烘焙”成SH系数，存在内存里。在手机运行时，只需要做几次向量点乘和加法，开销极低，却能换来非常柔和的、方向性的环境光效果，告别那种平板、虚假的均匀环境光。这对于移动端上追求画面表现又受限于性能的项目，比如开放大世界、高品质的AR应用或者需要动态昼夜变化的手游，提升是立竿见影的。接下来，我就结合自己趟过的坑，详细拆解一下在Unity里怎么把SH用起来，以及怎么避开那些新手和老手都可能栽进去的陷阱。

2. 球谐光照（SH）核心原理与移动端适配性拆解

在深入代码之前，我们必须先搞明白SH到底是怎么工作的，以及为什么它特别适合移动端。如果你只关心怎么用Unity的API，这部分可以快速浏览，但理解原理能帮你更好地调试和解决那些玄学问题。

2.1 SH的数学直觉：从“函数拟合”到“光照编码”

你可以把SH想象成一种高级的“压缩算法”。我们想记录的场景环境光照，本质上是一个定义在球面各个方向上的函数：给定一个方向（比如物体表面法线指向的方向），函数就返回从这个方向来的光照颜色和强度。这个函数通常很复杂，像一张高精度的HDR环境贴图。

SH提供了一组标准的“基础波形”（基函数），就像傅里叶变换里的正弦波和余弦波。这些基函数在球面上有固定的形状，有的在顶部亮底部暗（类似一个帽子），有的在左右两侧亮度相反（类似一个哑铃）。SH光照的核心思想是：我们用这些标准波形的不同组合（加权求和），去尽可能逼近原始那个复杂的光照函数。

这个“组合的权重”，就是我们最终要存储的SH系数。通常，我们使用3阶（Order 3）的SH，这意味着我们需要9个基函数（对于RGB三个颜色通道，就是9*3=27个系数）来近似光照。为什么是3阶？这是一个经典的权衡：2阶（4个基函数）太粗糙，捕捉不到足够的方向性细节，比如来自侧上方的主要光源；4阶（16个基函数）虽然更精确，但系数数量暴增，运行时计算量也增加，而带来的视觉提升在移动端的小屏幕上往往不明显。3阶SH在视觉质量和性能开销上取得了最佳平衡，因此成为游戏行业的实际标准。

在Unity中，一个3阶SH系数通常用一个UnitySHAr、UnitySHAg、UnitySHAb、UnitySHBr…这样的7个float4向量来表示（具体结构后面会讲），它们共同编码了场景中某一点（或某一区域）来自各个方向的环境光信息。

2.2 移动端为什么爱SH：性能优势量化分析

我们来算一笔账，对比几种常见的环境光方案：

1. Uniform Ambient（均匀环境光）：最简单，就是一个全局颜色。开销为0，但效果也最假，物体没有体积感。
2. Skybox/Environment Probe采样：使用反射探针或直接采样天空盒纹理。这需要一次或多次纹理采样，可能还需要进行HDR解码和滤波。在复杂的PBR着色器中，这会增加显存带宽和ALU开销，尤其是在低端移动GPU上，纹理采样是主要瓶颈之一。
3. 实时光照追踪（如Vulkan/GLES的Ray Query）：效果最好，但移动端目前基本无法承受其性能开销。
4. 球谐光照（SH）：运行时计算是什么？对于每个像素，假设我们已经有了预计算好的SH系数（存储在常量缓冲区或顶点数据中），计算光照的伪代码大致是：

   // 将法线n编码到SH基函数值（这组值是固定的，可以预计算或查表） float4 shAr, shAg, shAb, shBr, shBg, shBb, shC; // ... 从Uniform或顶点数据中获取SH系数 ... // 核心计算：一系列点乘和加法 half3 x1, x2, x3; // 这部分计算非常轻量，通常10条指令以内 half3 ambient = shAr.rgb * x1.r + shAg.rgb * x1.g + shAb.rgb * x1.b + shBr.rgb * x2.r + shBg.rgb * x2.g + shBb.rgb * x2.b + shC.rgb * x3;

   可以看到，完全没有纹理采样，全部是标量和向量的乘加运算（MAD），这是GPU最擅长、开销最低的操作。实测在Adreno 6系列或Mali-G7x系列的GPU上，使用SH替代一张环境贴图采样，帧时间能有5%-10%的提升，同时发热和功耗也会有所改善。

更重要的是，SH数据量很小。一个3阶SH Probe（9个系数 * RGB * float精度）也就108字节。你可以把整个场景划分成网格，在每个格点存储一套SH系数，运行时根据物体位置进行插值，从而实现动态变化的、高质量的环境光。这种“光照场”技术，正是很多3A手游实现动态全局光照的基石。

3. Unity中SH光照的完整工作流与实操

理解了原理，我们来看在Unity里怎么把它用起来。Unity引擎其实已经为我们封装好了大部分功能，我们需要做的是正确地触发、获取和使用SH数据。

3.1 数据来源：烘焙、探针与动态生成

SH系数不是凭空产生的，它们需要从一个高质量的光照表示中“烘焙”出来。在Unity中，主要有三种来源：

1. Lightmapping（光照贴图）烘焙过程：这是最常用、最自动化的方式。当你在Window -> Rendering -> Lighting Settings中开启Baked Global Illumination，并进行光照烘焙时，Unity不仅会生成光照贴图，还会为场景中的光照探针组（Light Probe Group）计算SH系数。这些系数被编码到光照探针数据中。确保你的场景中放置了足够密集的光照探针，特别是在光照变化剧烈的区域（如墙角、门窗附近）。

2. 反射探针（Reflection Probe）的衍生：反射探针捕获的是全方向的HDR环境立方体贴图。Unity可以在运行时，从这个立方体贴图动态生成一套SH系数。这是实现动态物体（如角色、车辆）接收动态环境光的关键。在反射探针的Inspector面板中，确保Type设置为Baked或Custom，并且勾选了相关的烘焙选项，它就会在烘焙时生成SH数据。

3. 手动编码与设置：对于特殊需求，比如从程序化生成的天空盒中提取SH，或者通过网络同步光照环境，你可以通过C#脚本调用RenderSettings.ambientProbe或LightProbes.GetInterpolatedProbe来获取和设置SphericalHarmonicsL2对象。这是一个高级用法，后面会结合动态昼夜变化来举例。

关键避坑点1：探针密度与烘焙质量很多新手以为放了几个探针就能有好的效果，结果发现物体上的环境光斑驳不堪。SH插值依赖于探针之间的平滑过渡。规则是：探针的间距应该小于场景中光照发生显著变化的最小距离。比如，在一面被窗户照亮、另一面是阴影的墙附近，探针需要更密集。一个实用的技巧是，在复杂区域手动添加探针，并使用探针组的“Visualize Light Probes”功能来检查覆盖情况。

3.2 在Shader中接收与使用SH

Unity通过一系列内置的Uniform变量，将当前渲染物体所对应的SH系数传递给Shader。我们不需要自己传递，只需要在Shader中正确声明和使用它们。

对于表面着色器（Surface Shader）或内置渲染管线，过程几乎是全自动的。你只需要在Input结构体中声明SH数据，并在surf函数中使用ShadeSH9或ShadeSHPerPixel函数。

// 表面着色器示例 struct Input { float3 worldNormal; // 需要世界空间法线 INTERNAL_DATA // 内部数据，用于支持法线贴图等 }; void surf (Input IN, inout SurfaceOutputStandard o) { // ... 其他材质计算 ... // 计算基于SH的环境光贡献 half3 shColor = ShadeSH9(float4(IN.worldNormal, 1.0)); // 将SH环境光加到最终输出上，通常与直接光照结果相加 o.Emission = shColor * o.Albedo; // 一种简单的叠加方式，更复杂的PBR需要结合BRDF // 或者影响环境光遮蔽(AO)后的间接光 o.IndirectDiffuse = shColor; }

对于更可控的URP（Universal Render Pipeline）或自定义Shader，我们需要明确地包含核心的SH计算函数和声明Uniform。在URP中，通常通过包含Packages/com.unity.render-pipelines.universal/ShaderLibrary/Lighting.hlsl来获取相关函数。

// URP 片元着色器示例 #include "Packages/com.unity.render-pipelines.universal/ShaderLibrary/Lighting.hlsl" struct Varyings { float3 normalWS : TEXCOORD1; // ... }; half4 frag(Varyings IN) : SV_Target { // 构建InputData结构体，用于URP的通用光照函数 InputData inputData = (InputData)0; inputData.normalWS = normalize(IN.normalWS); // ... 填充其他InputData字段 ... // URP提供了CalculateSH函数来获取SH环境光 half3 bakedGI = SampleSHPixel(inputData.normalWS, inputData.positionWS); // 或者使用更通用的方法 // half3 bakedGI = SampleSH(inputData.normalWS); // 在计算间接光时使用它 half3 indirectDiffuse = bakedGI * _MainTex.rgb; // ... 结合直接光照进行计算 ... }

关键避坑点2：法线向量归一化传给ShadeSH9或SampleSH的法线必须是归一化的世界空间法线。如果法线没有归一化，点积计算会出错，导致SH光照强度异常，可能出现奇怪的色块或过暗/过亮。在顶点着色器中计算并传递给片元着色器的法线，务必在片元着色器中再次进行归一化，因为顶点插值会破坏其单位长度。

3.3 动态物体的SH插值：Light Probe Proxy Volume (LPPV)

对于静态物体，Unity使用其所在位置最近的光照探针的SH数据。但对于动态物体（标记为Dynamic的GameObject），如果它在一个放置了光照探针组的区域内移动，Unity会自动在相邻的探针间进行插值，为物体提供平滑变化的环境光。这是默认且最常用的行为。

然而，对于体积很大的动态物体（比如一辆大巴车、一个巨型BOSS），只用一个点（通常是物体的原点或包围盒中心）来采样SH是不准确的。车头和车尾所处的光照环境可能完全不同。这时就需要Light Probe Proxy Volume (LPPV)。

LPPV可以理解为在动态物体内部创建一个3D的探针网格。Unity会为这个网格的每个角点计算插值后的SH系数。在渲染该物体的每个像素时，会根据像素在物体局部空间内的位置，在这个3D网格中进行三次线性插值，获取更精确的SH数据。

启用步骤：

1. 给动态物体添加Light Probe Proxy Volume组件。
2. 在组件上设置Resolution（网格分辨率，如3x3x3）和Bounds Mode（通常用Automatic Local根据Renderer的包围盒自动计算）。
3. 确保该物体所在的区域有足够密集的光照探针覆盖。

启用LPPV后，物体会在局部空间内拥有更细腻的环境光变化，尤其是对于大型动态物体，效果提升非常明显。

关键避坑点3：LPPV的性能与精度权衡LPPV的网格分辨率（如3x3x3）会显著影响性能。每个额外的采样点都意味着更多的插值计算和可能的数据获取开销。不要盲目使用高分辨率。对于大多数中型物体，3x3x2或3x3x3已经足够。在移动端，务必在真机上测试开启LPPV后的性能变化。一个经验法则是：只有当你明显看到大型动态物体表面环境光不连续、出现明显色块时，才考虑启用LPPV，并从最低分辨率开始测试。

4. 实战进阶：实现动态昼夜环境光切换

静态烘焙的SH很美，但我们的世界是动态的。如何让SH环境光随着时间（比如从正午到黄昏）平滑变化？这就需要我们动态地混合两套或多套SH系数。

核心思路是：我们预先烘焙好不同时间点的光照探针数据（例如，中午一套SH系数，黄昏一套SH系数）。在运行时，根据游戏内时间，对这两套系数进行线性插值，然后将插值后的结果设置给渲染环境。

步骤详解：

1. 烘焙多套光照数据：

   • 在Unity编辑器中，调整主方向光（太阳）的角度、颜色和强度，以及天空盒材质，模拟出“中午”的光照状态。
   • 确保场景中光照探针组已放置好。在Lighting窗口，执行一次Bake（烘焙）。烘焙完成后，将整个光照探针组（Light Probe Group）保存为一个Prefab，命名为“Probes_Noon”。
   • 同理，调整光照和天空盒到“黄昏”状态，再次烘焙，并将新的光照探针组保存为Prefab“Probes_Dusk”。

   • 注意：每次烘焙前，最好先删除场景中现有的光照探针组，再从Prefab实例化一个新的，避免数据混淆。

2. 运行时插值与设置：

   • 在游戏运行时，我们无法直接修改已烘焙到场景中的探针数据。但我们可以通过脚本，动态计算插值后的SH系数，并将其赋给RenderSettings.ambientProbe。这个全局变量会影响所有使用SH的物体。
   • 我们需要从两个Prefab中提取出SphericalHarmonicsL2对象。一种方法是将这些系数预先导出为数组存储在ScriptableObject或配置文件中。更动态的方法是在运行时实例化两个隐藏的GameObject，分别挂载“Probes_Noon”和“Probes_Dusk”的Light Probe Group组件，然后从LightmapSettings.lightProbes属性中读取系数，但这种方法管理起来较复杂。

// 简化示例代码，展示插值逻辑 using UnityEngine; using UnityEngine.Rendering; public class DynamicSHManager : MonoBehaviour { // 假设我们已通过某种方式加载了这两套系数 public SphericalHarmonicsL2 shProbesNoon; public SphericalHarmonicsL2 shProbesDusk; [Range(0f, 1f)] public float timeOfDayLerp = 0.5f; // 0=中午， 1=黄昏 void Update() { // 插值SH系数 SphericalHarmonicsL2 interpolatedSH = new SphericalHarmonicsL2(); for (int i = 0; i < 3; i++) // RGB通道 { for (int j = 0; j < 9; j++) // 9个系数 { // 对每个系数进行线性插值 interpolatedSH[i, j] = Mathf.Lerp(shProbesNoon[i, j], shProbesDusk[i, j], timeOfDayLerp); } } // 将插值后的SH设置给全局环境光探针 RenderSettings.ambientProbe = interpolatedSH; // 强制更新所有受影响物体的光照 DynamicGI.UpdateEnvironment(); } }

调用DynamicGI.UpdateEnvironment()会触发Unity更新动态物体的GI（全局光照）数据，这是一个相对较耗的操作，切忌每帧调用。在实际项目中，你需要根据时间变化的频率进行节流，比如每0.5秒或当timeOfDayLerp变化超过某个阈值时才更新一次。

关键避坑点4：SH系数插值的有效性SH系数是浮点数，直接进行线性插值在数学上是合理的，但视觉上的线性插值不一定等于物理上的线性过渡。特别是当两套光照的色温和方向差异极大时（比如从冷色调的月光切换到暖色调的日光），简单的Lerp可能会导致中间状态出现不自然的灰色或色彩饱和度丢失。对于要求极高的项目，可能需要烘焙更多中间状态的光照探针（如黎明、上午、下午），或者探索在球谐域内更复杂的混合算法，但这已属于高级课题。对于大多数移动端项目，线性插值加上适当的时间平滑（如使用Mathf.SmoothStep）已经能获得足够好的效果。

5. 移动端专属优化策略与深度避坑指南

将SH应用到移动端，除了通用技巧，还有一些针对移动平台硬件的特殊优化和陷阱需要警惕。

5.1 精度与带宽优化：Half vs Float

SH系数在Unity内部通常以float精度存储。但在移动端GPU上，片元着色器中的大量float计算可能成为瓶颈，尤其是对于低端设备。我们可以考虑将SH系数从float精度转换为half精度。

如何操作？在Shader中，Unity传递给我们的SH系数Uniform变量（如unity_SHAr）是float4类型。我们可以在Shader的开头，将它们重新声明为half精度，或者在使用时进行强制转换。但要注意，降低精度可能会带来细微的颜色偏差和banding（色带）问题，特别是在低光照区域。

// 在URP Shader中，可以尝试在片元着色器入口处转换 half4 shAr = (half4)unity_SHAr; half4 shAg = (half4)unity_SHAg; // ... 使用half精度的系数进行计算 ...

一个更安全、更常见的优化是：确保SH计算在顶点着色器中进行，而非片元着色器。这就是ShadeSH9和ShadeSHPerVertex函数的区别。ShadeSHPerVertex在顶点着色器中计算SH光照，然后将结果作为颜色变量插值到片元。这能极大减少片元着色器的计算量，但代价是光照在三角形内部是线性插值的，对于大三角形或法线变化剧烈的表面，可能会丢失细节。移动端上，对于远处物体或非主角的物体，使用顶点级别的SH通常是性能收益远大于视觉损失的。

5.2 纹理烘焙与SH的冲突管理

移动端项目常常会使用烘焙光照贴图（Lightmap）来存储静态物体的直接和间接光照。这里有一个关键的协同与冲突问题：光照贴图里已经包含了烘焙的间接光信息，而SH也提供了间接光信息。如果两者同时启用，会导致物体被照亮两次，结果过曝。

正确的设置流程：

1. 在Unity的Lighting设置中，确保你的混合光照模式（Mixed Lighting Mode）设置正确。对于完全静态的物体，使用Baked Indirect模式，此时光照贴图包含间接光，动态物体和SH用于补充。
2. 对于参与烘焙的静态物体（Static），在它们的材质Shader中，通常应该禁用或忽略SH贡献，因为间接光已经烘焙到光照贴图里了。Unity的标准着色器（Standard Shader）或URP Lit Shader内部会自动处理这个逻辑：如果检测到物体有有效的光照贴图UV，就会减少或忽略SH计算。
3. 对于动态物体（Dynamic）或仅接受实时光照的静态物体，它们没有光照贴图，SH就是它们接收环境间接光的唯一或主要来源。确保这些物体的材质能够正确接收SH。

关键避坑点5：烘焙后SH效果“消失”或“错误”这是最常见的问题之一。烘焙完光照贴图后，发现场景中的动态物体变黑了，或者静态物体的环境光很奇怪。排查步骤：

1. 检查Light Probe Group：烘焙后，确保场景中的Light Probe Group没有被意外禁用或删除。它的Gizmo应该显示为许多黄色的小球。
2. 检查动态物体设置：确认动态物体的MeshRenderer组件上Contribute Global Illumination和Receive Global Illumination设置是否正确。通常动态物体不贡献GI，但需要接收GI（来自光照探针）。
3. 检查Shader Feature：如果你使用自定义Shader，确保它包含了接收和计算SH光照所需的代码分支和变体（Shader Variants）。有时烘焙后，Unity会使用不同的Shader变体，可能遗漏了SH相关的计算。
4. 使用Frame Debugger：这是最强大的调试工具。在Game视图下，打开Window -> Analysis -> Frame Debugger。逐帧、逐个Draw Call查看渲染状态。找到渲染你目标物体的那个Draw Call，查看其渲染状态（Render State）。检查传递给Shader的Uniform变量，特别是unity_SHAr等SH相关变量，看它们的值是否非零、是否合理。同时查看该物体的光照模式（Lightmode）是否正确。

5.3 性能分析与调试工具

优化离不开测量。在移动端优化SH，你需要以下工具：

1. Unity Profiler (GPU)：在真机连接调试时，使用Profiler的GPU模块，观察使用SH的Shader Pass的耗时。对比关闭SH（如用固定颜色替代）时的耗时，可以量化SH带来的开销。
2. RenderDoc 或 Snapdragon Profiler：这些图形调试器可以捕获一帧完整的渲染调用。你可以精确地看到SH系数是如何被传入Shader的，以及在片元着色器中执行SH计算的具体指令数和耗时。这对于诊断精度转换带来的问题或复杂的插值错误至关重要。
3. Unity Frame Debugger：如上所述，用于调试SH数据是否正确传递和启用。
4. 自定义调试视图：在Shader中创建一个调试模式，将计算出的SH颜色直接输出为片元颜色（return half4(bakedGI, 1.0);）。这样可以直观地在游戏画面中看到SH环境光的分布和强度，快速定位问题区域是数据问题还是计算问题。

6. 常见问题排查速查表与终极技巧

最后，我把项目中遇到的那些“坑”和解决方案浓缩成一张表，方便大家快速对照排查。

终极技巧：分层混合策略对于超大型的移动端开放世界，全部使用高密度光照探针是不现实的。一个有效的策略是分层混合：

• 远景和背景：使用一套低分辨率（稀疏）的全局光照探针，甚至可以用一个统一的RenderSettings.ambientProbe。
• 中景（玩家活动主要区域）：使用中等密度的光照探针组，确保视觉核心区域的光照质量。
• 近景和交互物体：对关键动态物体（主角、NPC）使用LPPV，或者在其周围布置更高密度的探针。 通过这种分层处理，可以在有限的性能预算内，将最高的视觉保真度集中在玩家最关注的地方。

球谐光照不是一个“用了就万事大吉”的黑盒，而是一个需要理解、调试和精心配置的强大工具。它在移动端环境光渲染上的性价比极高，但需要你清楚地知道数据从何而来、如何计算、以及如何与现有的光照体系协同工作。希望这篇从原理到踩坑的完整指南，能帮你把项目的画面和性能再提升一个档次。