1. 项目概述：为什么UE5数字孪生需要动态环境？

如果你正在用Unreal Engine 5（UE5）做数字孪生项目，无论是智慧城市、智慧园区还是工业仿真，你肯定遇到过这样的问题：导入的Cesium全球地形和建筑模型，在默认的UE5天空下显得死气沉沉，光照角度固定，天空盒一片惨白，毫无真实世界的动态感。这直接导致你的数字孪生体缺乏沉浸感和时间维度上的可信度。一个真实的孪生世界，其环境必须是“活”的——太阳会东升西落，天空会根据时间变换色彩，云层会流动，天气会变化。

这正是“从Cesium SunSky动态光照到自定义天气系统”这个主题要解决的核心痛点。它不是一个简单的插件使用教程，而是一套在UE5数字孪生框架下，构建高保真、可交互动态环境的核心工作流。Cesium for Unreal插件自带的CesiumSunSky组件，为我们提供了基于真实世界经纬度、时间的精准太阳位置和天空外观计算，这是动态环境的基石。但仅有太阳和基础天空还不够，一个完整的、可用于业务演示或分析的环境，还需要雨、雪、雾、风等天气效果的动态切换与融合。

我最近在一个大型园区数字孪生项目中完整实践了这套流程。从最初手动调太阳旋转的笨办法，到集成CesiumSunSky实现真实日照，再到开发一套可蓝图控制、支持平滑过渡的天气系统，踩了不少坑，也总结出一套稳定可靠的搭建方法。本文将带你一步步拆解这个过程，不仅告诉你“怎么做”，更重点解释“为什么这么做”，以及那些官方文档里不会写的实操细节和避坑指南。

2. 核心组件解析：CesiumSunSky与动态光照基石

2.1 CesiumSunSky组件深度剖析

CesiumSunSky是Cesium for Unreal插件提供的核心环境组件。它的强大之处在于，将虚幻引擎的SkyAtmosphere（天空大气）和DirectionalLight（定向光源，即太阳）与真实世界的地理坐标和时间进行了绑定。

工作原理简述：当你在地球上某个特定位置（通过CesiumGeoreference组件设定）放置一个CesiumSunSky Actor时，它会根据你设定的“日期”和“时间”（可以是真实世界UTC时间，也可以是模拟时间），利用天文计算公式，精确计算出此时此地太阳的高度角和方位角。然后，它驱动DirectionalLight旋转到对应角度，并同步调整SkyAtmosphere的大气散射参数，使得天空的颜色、亮度、太阳光晕等视觉效果与真实情况高度吻合。

关键参数与配置经验：

• Georeference：必须正确关联场景中的CesiumGeoreference Actor，这是所有地理空间计算的参考原点。
• Date / Time：支持手动设置静态时间，也支持绑定到“Cesium Subsystem”的“Current Time”上，实现全局的动态时间流逝。在数字孪生中，我们常需要模拟一天24小时的光照变化，或者快速切换到某个特定时刻（如正午、黄昏）进行分析。
• Sun Intensity：太阳光强度。这里有个重要技巧：在结合了SkyAtmosphere后，太阳光的实际照明效果是DirectionalLight的Intensity和SkyAtmosphere的Multiplier共同作用的结果。如果觉得场景过亮或过暗，不要只调DirectionalLight，也要检查SkyAtmosphere的“Light Disk Scale”和“Multiplier”。
• 启用“Dynamic Sky”：这是实现天空动态变化的关键。启用后，天空云层（如果使用了Volumetric Cloud）会随风向移动，天空颜色过渡更加自然。

实操心得：初次使用CesiumSunSky，最容易出现的问题是“太阳位置对了，但场景一片漆黑或曝光过度”。这通常是因为SkyAtmosphere的“Ground Albedo”（地面反照率）和“Height Fog”（高度雾）参数与你的场景不匹配。对于城市数字孪生场景，建议适当调高Ground Albedo（0.2-0.5），让建筑和地面反射更多天光，提升暗部细节。同时，谨慎使用Height Fog，它虽然能增加大气透视感，但过度使用会让远处建筑模型“消失”在雾中。

2.2 与UE5天空系统的融合与取舍

UE5自身拥有强大的天空渲染系统，主要包括SkyAtmosphere（天空大气）、Volumetric Cloud（体积云）和Exponential Height Fog（指数高度雾）。CesiumSunSky本质上是这些系统的“智能控制器”。

融合策略：

1. SkyAtmosphere：必须启用，并由CesiumSunSky完全驱动。无需手动调整其太阳方向等参数。
2. Volumetric Cloud：这是提升真实感的大杀器。你可以启用CesiumSunSky中的“Enable Volumetric Cloud”选项，它会自动配置一个基础的体积云层。但为了获得更精细的控制（如云层类型、密度、覆盖度），我强烈建议单独放置一个“Volumetric Cloud” Actor，并通过蓝图或材质参数集（Material Parameter Collection）来让CesiumSunSky的时间变化影响云层颜色。
3. Exponential Height Fog：独立于CesiumSunSky。它的颜色可以尝试绑定到天空的Zenith Color（天顶颜色）上，以实现雾色随早晚变化的效果。这需要通过蓝图动态获取CesiumSunSky的SkyAtmosphere颜色输出，并设置给Fog的Color参数。

性能取舍：Volumetric Cloud虽然效果惊艳，但对GPU性能消耗较大。在需要大规模展示或硬件配置有限的数字孪生项目中，可以考虑：

• 使用简化的平面云卡片（Cloud Layer）替代。
• 降低Volumetric Cloud的渲染分辨率（在项目设置中调整）。
• 仅在重点观察区域或特定演示模式下开启。

3. 自定义天气系统的设计与蓝图实现

有了动态的日照和天空，天气系统就是让环境“讲故事”的关键。一个基本的天气系统需要支持多种天气状态（晴、阴、雨、雪、雾等），并能实现状态间的平滑过渡。

3.1 天气状态定义与数据资产

首先，我们需要定义天气系统的数据结构。在UE5中，使用“枚举”（Enum）和“数据资产”（Data Asset）来管理非常高效。

1. 创建天气枚举：在蓝图或C++中创建一个EWeatherType枚举，包含Clear,Cloudy,Rain,Snow,Fog等状态。
2. 创建天气参数数据资产：新建一个继承自PrimaryDataAsset的蓝图类，例如BP_WeatherPreset。在这个资产中，为每种天气类型定义一组参数：
   • 云层参数：云密度、云覆盖度、云移动速度。
   • 降水参数：雨/雪粒子系统的发射强度、粒子大小、下落速度。
   • 大气参数：雾气密度、雾气颜色、能见度。
   • 后期处理参数：曝光补偿、对比度、饱和度（阴雨天通常饱和度降低、对比度减小）。
   • 音频参数：对应的环境音效（雨声、风声）。

这样，设计师可以在编辑器里直观地配置不同天气的视觉效果，而无需程序员修改代码。

3.2 天气管理器蓝图核心逻辑

接下来，创建一个BP_WeatherManagerActor作为天气系统的总控中心。它的核心逻辑包括：

状态管理：

• 拥有一个当前CurrentWeather变量（EWeatherType类型）和一个目标TargetWeather变量。
• 提供接口函数（如SetWeather(EWeatherType NewWeather, float TransitionTime)）供外部（如UI控件、定时器、数据接口）触发天气切换。

平滑过渡（Lerp）实现： 这是体验好坏的关键。直接硬切天气状态会非常突兀。管理器需要存储当前天气参数值和目标天气参数值，并在过渡时间内，每一帧对每一个参数进行线性插值（Lerp）。

// 伪代码逻辑，在Tick或定时器中进行 float Alpha = ElapsedTransitionTime / TotalTransitionTime; Alpha = FMath::Clamp(Alpha, 0.0f, 1.0f); CurrentCloudDensity = FMath::Lerp(StartCloudDensity, TargetCloudDensity, Alpha); CurrentFogDensity = FMath::Lerp(StartFogDensity, TargetFogDensity, Alpha); // ... 对其他所有参数进行同样的Lerp操作 // 将插值后的参数应用到对应的系统 VolumetricCloudActor.SetDensity(CurrentCloudDensity); ExponentialHeightFogActor.SetDensity(CurrentFogDensity); PostProcessVolume.SetSettings(...); // 应用插值后的后期参数

参数驱动：

• 云：通过动态材质实例（Dynamic Material Instance）修改Volumetric Cloud材质的相关参数（如Density,Coverage）。
• 雾：直接设置Exponential Height Fog Actor的属性。
• 雨/雪：控制粒子系统（Niagara）的发射器生成速率（Spawn Rate）和粒子数量。在过渡时，可以同时存在雨和雪的粒子，通过调整两者的发射率来实现雨转雪的渐变效果。
• 后期：将插值后的颜色、对比度等参数，通过“场景捕获”或直接设置给主后期处理体积（Post Process Volume）。

3.3 与CesiumSunSky的联动

天气系统不应孤立运行，它需要与CesiumSunSky联动以增强真实感。

• 阴天/雨天光照：当切换到Cloudy或Rain状态时，可以动态降低CesiumSunSky中太阳光的强度（Sun Intensity），并略微增加天空光的贡献（Sky Light Intensity），模拟日光被云层削弱的效果。
• 天气影响天空色：可以通过修改SkyAtmosphere的Mie Scattering等参数，在沙尘、雾霾天气下让天空呈现土黄色。

4. 核心环节实现：从蓝图到视觉效果的完整流程

4.1 场景搭建与初始配置

1. 基础场景创建：新建一个UE5项目（建议选择“游戏”模板，空白项目即可）。通过Epic Games启动器安装“Cesium for Unreal”插件并启用。
2. 添加Cesium内容：将“CesiumSunSky”和“Cesium World Terrain + Bing Maps Aerial imagery”拖入场景。设置好CesiumGeoreference的位置（通常是园区中心点的经纬度）。
3. 配置基础光照：确保CesiumSunSky的DirectionalLight是主光源，禁用或删除默认的SkyLight，使用CesiumSunSky自带的或新建一个SkyLight并设置为“从场景捕获”。
4. 放置后期体积：添加一个Post Process Volume，设置为“无限范围”，在这里配置基础的色调、曝光，为后续天气控制留出接口。

4.2 天气粒子系统（Niagara）制作要点

雨雪效果使用Niagara系统实现性能更好、控制更灵活。

降雨系统：

• 发射器：使用GPU粒子，一个“Box Location”发射器，覆盖整个需要下雨的区域。
• 外观：使用简单的条带（Ribbon）渲染器模拟雨丝，或者使用朝向相机的面片（Sprite）配合雨滴纹理。
• 物理：添加“重力”和“速度”模块，让粒子下落。添加“碰撞”模块，让雨滴与地形、建筑屋顶、地面发生碰撞并溅起水花粒子（次级发射器）。
• 性能优化：通过WeatherManager控制粒子的Spawn Rate。在远处可以使用更低分辨率的粒子或减少发射量。利用Niagara的“LOD”系统根据距离调整粒子数量。

降雪系统：

• 与雨类似，但重力更小，下落速度慢。添加“噪声力”模块，让雪花有飘忽不定的下落轨迹。
• 渲染器使用柔软的面片，并开启“SubUV”动画，让雪花有旋转和闪烁的感觉。
• 积雪模拟（进阶）：这是一个更复杂的效果。简单的做法是，在切换到雪天时，通过蓝图动态修改场景中主要地表材质的“雪覆盖”贴图混合权重（通过材质参数集控制）。更复杂的方案需要运行时虚拟纹理（Runtime Virtual Texture, RVT）来动态绘制积雪。

4.3 动态材质与参数传递

为了实现天气参数对场景物体的影响（如潮湿的地面、积雪的屋顶），需要大量使用动态材质实例和材质参数集。

1. 创建材质参数集（MPC）：命名为MPC_Weather，在其中定义全局标量参数，如Rain_Wetness（湿润度，0-1）、Snow_Coverage（积雪覆盖度，0-1）、Wind_Intensity（风力强度）。
2. 修改场景材质：为地面、建筑外墙、屋顶等材质创建材质函数或使用材质层，使其能够读取MPC_Weather中的参数。例如，在基础颜色上，根据Rain_Wetnesslerp 干燥和湿润的贴图；根据Snow_Coverage，在表面法线上lerp一层积雪法线贴图。
3. 在WeatherManager中驱动MPC：在天气过渡的Lerp循环中，不仅更新Actor属性，也同步更新MPC_Weather中的对应参数值。这样，场景中所有使用了该MPC的材质都会自动更新，无需逐个修改。

5. 常见问题、性能优化与排查技巧

5.1 常见问题速查表

5.2 性能优化实战心得

数字孪生场景通常面数高、范围大，动态天气是锦上添花，绝不能成为性能瓶颈。

1. 分级细节（LOD）无处不在：

   • 粒子LOD：Niagara和传统的Cascade粒子系统都支持基于距离的LOD，务必配置。
   • 云LOD：在项目设置中降低Volumetric Cloud的Tracing Sample Count和Shadow Sample Count可以显著提升帧率。
   • 材质复杂度LOD：为建筑和地面材质制作简化版本，在远距离时通过材质LOD或HLOD（分层细节级别）切换。

2. 控制更新频率：

   • 天气参数（如雾气密度、云层移动）不需要每帧都剧烈变化。可以将WeatherManager的更新逻辑放在一个定时器（Timer）中，比如每0.1秒（100ms）更新一次参数，而不是每帧（Tick）更新。这对性能影响微乎其微，但能减少不必要的计算。

3. 善用剔除（Culling）：

   • 雨雪粒子发射器，将其Bounds（边界）设置为刚好覆盖活动区域。当相机远离该区域时，整个粒子系统会被视锥剔除，不参与渲染计算。
   • 对于室内或地下的数字孪生应用，可以通过触发器（Trigger Volume）在进入室内时完全关闭天气效果。

4. 后期处理开销：

   • 天气切换常伴随后期参数（如泛光、色相）变化。确保你的Post Process Volume只启用了必要的效果。例如，景深（Depth of Field）和镜头光晕（Lens Flares）在大型场景中通常可以关闭。

5.3 进阶调试技巧

• 使用控制台命令：在编辑器运行时，按“~”键打开控制台，输入r.VolumetricCloud 0可以快速关闭体积云查看性能变化；r.SkyAtmosphere 0可以关闭天空大气。
• 可视化调试：在WeatherManager蓝图中，使用Print String节点临时输出当前的天气状态、过渡进度Alpha值等，便于逻辑调试。
• 性能分析器（Profiler）：当帧率下降时，使用Unreal Insights或内置的GPU/CPU Profiler，锁定是粒子渲染、材质计算还是Cesium流送占用了主要时间，从而进行针对性优化。

搭建这样一套系统，从原型到稳定运行，我花了大约两周时间。最大的体会是：规划优于编码。在动手写第一行蓝图之前，先在白板上明确好数据流（天气状态 -> 管理器 -> 各类参数）、定义清楚所有的接口（MPC参数名、蓝图函数名），能节省大量后期联调和修改的时间。另外，不要追求一次性实现所有酷炫效果，先从“晴-雨”两种状态的平滑切换做起，确保核心框架稳定，再逐步加入雪、雾、风等复杂效果。这样迭代开发，风险可控，每一步都有可见的成果。