第一次在UE5里接到“把这片湖做得像真水”的需求我差点被Cesium插件劝退。客户说得轻松你已经用Cesium for Unreal把真实地形都加载出来了湖不就在那儿吗加个水面材质不就行了可当我把视角压低到湖面高度看到的只是影像贴图里一团糊在地形上的蓝色完全没有三维湖面该有的立体感、透明感和波纹。那一刻我意识到地形可以交给Cesium水面不行。这篇实战记录想写清楚我在数字孪生和虚拟仿真项目里摸出来的完整链路从Cesium插件加载真实地形到在真实经纬度坐标上放置一片“浮”在地球表面的水面再到把UE5材质节点里的波纹参数一点点调成经得起近景细看的湖面质感。核心就三个关键词UE5、Cesium插件、波纹参数调优。如果你正好在做智慧水利、智慧文旅或者大场景飞行模拟这篇文章应该能帮你少走两三天弯路。1. 在UE5里做湖泊为什么非要和Cesium死磕1.1 真实地理坐标才是湖泊的灵魂一开始我也尝试过“图省事”在普通UE5关卡里挖个地形拖一个水体效果确实不错但那只是“一个池塘”。数字孪生项目里用户要的是把现实中的湖区搬到数字地球上水位、岸线、周边建筑群、山体走向都必须和真实世界对得上。这种场景下湖泊的核心价值不是渲染得好看而是位置准确、形态真实、和周边地形的关系可信。Cesium插件的存在意义就是提供这一层“可信”。它在UE5里直接加载全球真实地形、影像和倾斜摄影模型用真实地理坐标把整个地球塞进引擎。于是湖不再是你手工捏出来的而是现实世界中确实存在于某个经纬度上的水域。你只需要在水体材质上把“三维感”补足整个场景就活了。1.2 Cesium插件的定位地形、影像、3D Tiles全包Cesium for Unreal并不是一个普通的水体插件它解决的是整个大场景的地基问题。它通过Cesium ion平台拉取全球级别的栅格地形、卫星影像还支持加载倾斜摄影扫描的3D Tiles数据。换句话说你不需要自己在UE5里用Landscape雕刻一周的山脉也不需要手工拼贴卫星图Cesium把这块全部吞掉了。我做过的项目基本都是这个套路先确定目标区域经纬度用Cesium加载真实地形和高清影像再把倾斜摄影模型定位到对应坐标上人物或车辆在山间穿行最后再加上动态水面。整套流程下来最花时间的反而不是地形和建筑而是水面——因为Cesium的地形网格和UE5原生水体系统之间存在一层“兼容层”不处理干净水永远飘在空中或者扎进地里。1.3 湖面不能直接拖一个平面进去很多初学者踩的第一个坑就是在场景里摆一个Plane压到湖面位置配个半透明蓝色材质觉得完事了。但在Cesium场景里你会发现普通Actor跟着的是UE的坐标系而Cesium的地形网格是跟着地球曲率走的。随便拖进去的平面要么悬空要么嵌进地形稍微一动摄像机角度水就穿帮。真正要做的是让水面也“活”在地球坐标系里。这也是我后面反复用CesiumGlobeAnchor的原因——先把水面锚定到真实经纬度再去谈波纹和颜色所有效果才有意义。还有一个必须想清楚的问题Cesium加载的地形不是UE5原生LandscapeUE5自带的Water系统在很多高级交互上依赖Landscape比如水流冲刷、岸线湿区、水面下的地形深度反馈跟Cesium的Tileset网格接起来非常费劲。所以我最终选择了一个折中方案用独立水面Actor加自定义材质牺牲一部分“物理交互”换来可控性和性能。2. 环境准备把Cesium地形跑通再锁住湖区2.1 插件安装与Ion令牌国内很多教程习惯直接从GitHub拉源码编译Cesium for Unreal但如果你用的不是定制引擎我更推荐从Epic商城安装官方打包版本。原因是源码编译要对应好UE5小版本有时候一换引擎版本就报错折腾半天连地形都加载不出来。装好之后插件不会自动激活。你要到项目设置的Plugins里搜索Cesium把勾打上重启编辑器。这时候视口上方会出现Cesium工具栏点击后会引导你登录或填入Cesium ion的Access Token。这个Token相当于是你访问真实地形和影像数据的钥匙没有它你只能看到一片网格灰模看不到任何卫星影像。我踩过的坑是Token是拿别人分享的临时令牌用着用着就过期排查半天还以为是网络问题。建议在自己项目里配置独立的Token并在代码注释里标明用途方便后接手的人维护。2.2 加载全球地形和影像图层拿到Token后下一步是往关卡里添加Cesium的Tileset。最稳妥的方式是在Cesium ion资产库里找到“Cesium World Terrain”和“Bing Maps Aerial”把它们的Asset ID填进去插件会自动拉取流送数据。这里要给一个性能上的建议不要一上来就追求最高画质。Cesium全球地形默认的Screen Space Error屏幕空间误差如果设置得很低那个瓦片加载量能把显存直接打穿。我一般先把最大屏幕空间误差调到16左右确认湖区范围内显示正常锁定视角后再下调细节参数只让湖区附近吃高精度地形。另外如果你的湖区周围有倾斜摄影模型建筑会和地形数据叠在一起。Cesium里可以同时挂多个3D Tileset一个管地形影像一个管实景模型两个互相独立后期管理起来很清爽。2.3 用经纬度锁定湖区Cesium场景的根节点通常会有一个CesiumGeoreference组件它的作用是把UE引擎的原点“钉”到地球的某个真实位置。很多教程会忽略它的重要性但我强烈建议你在制作湖泊前先把CesiumGeoreference的原点设置到湖区中心。这样做有两个好处。第一UE5的double精度再高如果原点离目标区域太远几十公里外照样会出现颤抖和精度丢失把原点放到湖区中心附近等于让引擎把注意力集中在目标区域。第二后续添加水面Actor、灯光和反射捕获时很多计算都基于原点附近的局部坐标越近越不容易出现奇怪的坐标偏移。实际操作时你把目标湖泊的经度、纬度、高度填进CesiumGeoreference的Origin相关项里然后在视口寻找蓝圈位置差不多就是湖中心了。再微调高度把Cesium地形的高程算进去就完成了“锁定湖区”这步。3. 用CesiumGlobeAnchor把水面钉在真实地球上3.1 为什么普通Actor在Cesium地形面前站不稳如果你只是把UE5的Plane拖进Cesium场景然后用移动旋转缩放去“手动对齐”湖面会遇到一个很诡异的现象明明视口里看着水刚好压在地形上一运行游戏或者拉远视角水要么穿帮扎进地里要么悬在天上飘着。原因是Cesium的地形瓦片是按需流送加载的LOD切换时高程会变化普通Actor的位置却固定在世界坐标里根本跟不上地形的变化。换句话说水面的位置不应该由固定的本地坐标决定而应该由“经纬度加高程”决定实时跟随Cesium的地球曲率和地形LOD。这正是CesiumGlobeAnchor这类组件的用途。3.2 创建水面Actor并绑定锚点我一般的做法是新建一个蓝图Actor命名为WaterLake在它身上挂两个组件一个是CesiumGlobeAnchor另一个是用于显示水面的静态网格体或自定义网格体。先在CesiumGlobeAnchor的配置面板里输入目标湖泊的经纬度然后设置一个合适的高度值。注意这里的高度是海平面以上高程不是地形表面高度。如果你不确定湖面高程可以先在地形表面放一个临时空Actor读取它的世界Z坐标反过来推算出近似的米制高度。水面网格体我建议用带足细分的圆面或矩形片不要用最原始的4个顶点平面。为什么因为后面如果要调顶点波纹或者做曲率补偿顶点数量太少根本不够用。我通常给直径500米的湖面准备64乘64的细分密度边缘密度可以再降。3.3 高度补偿、法线翻转和曲率问题水面刚放上去时最典型的故障是水面和地形之间出现闪烁也就是俗称的Z-Fighting。原因是水面网格和地形面片几乎处于同一高度两个深度反复穿插。解决办法不是精确调高度到0而是给水面整体抬高一点让水面实体明显悬浮在地形之上。这里有个经验值平静湖面比地形表面高0.2米到0.5米足够肉眼几乎看不出悬空但能彻底避开闪面。再配合水的透明度和岸边遮罩视觉上就会觉得水面是贴着岸线的。如果抬高超过1米湖岸边会出现明显的“白边”或者缝隙一定要克制度数。另一个容易忽略的是法线方向。CesiumGlobeAnchor虽然会把Actor的Z轴对准地球表面外法线但如果你换了静态网格体默认法线可能朝下。判断方法很简单把材质的法线强度调到极高如果看到波纹“凹”进去而不是“鼓”出来说明法线反了旋转网格体或者翻转法线即可。至于地球曲率湖泊直径在500米以内时用一个平面完全够用如果超过1公里平面的边缘一定会有悬空或穿地问题。我的做法是把湖面拆成4乘4或8乘8的小网格每一块都挂在同一个CesiumGlobeAnchor下中心点都在球面上边缘自然会被曲率“拉弯”。不需要写复杂的算法靠网格密度去拟合曲率就足够。4. 波纹材质的正确搭法三层Panner加法线扰动4.1 水为什么看起来是水在动手连材质节点之前必须明确一个底层逻辑人眼判断“这是不是水”第一反应不是颜色而是反射、折射、透明度和粗糙度这四件事的相互作用。蓝色半透明材质只是骗过了预期真正让水活过来的是反射天空和周围物体的轮廓以及水面自身波光粼粼的细节。所以你看到的那些高质量水面材质法线贴图只占其中一部分周围环境的反射捕获、光照强度和水的透射深度同样重要。我建议在湖区旁边至少放一个SphereReflectionCapture让水面有基本的天空反射和山体剪影反射否则调再细的波纹水面看起来也像一块磨砂玻璃。4.2 波纹的本质不是顶点上下动新手最容易误解波纹是水面网格顶点在上下运动。其实在绝大多数湖面表现里波纹的核心是法线扰动也就是让原本朝上的水面法线被人为地沿着波纹图案发生偏转从而改变高光反射的方向让水面出现波光闪烁的假象。这种做法成本极低因为不需要移动任何顶点只需要在材质里采样法线贴图叠加进最终法线输出。只要法线贴图足够好、叠加层次够多视觉上就会有“水在流动”的错觉。除非你需要的是一两米高的滚浪才需要考虑Gerstner波之类的顶点位移方案湖面场景基本用不上。4.3 搭建三层法线叠加的节点链路我自己的水面材质节点链路经过多次重做最后固定成三层Panner加法线扰动。第一层是主波浪负责整体湖面的大尺度起伏感。它使用一张低频水法线贴图UV平铺很小滚动速度也慢模拟的是风吹过湖面后大面积推进的波浪。第二层是中尺度波纹负责湖面中景的纹理细节。它使用同一张法线贴图或另一张中频法线贴图把UV平铺放大一些滚动速度稍快让法线方向出现更丰富的变化尤其逆光看时波动感更强。第三层是微观水纹负责近景和岸边的精细效果。它会使用高频法线贴图滚动速度最快强度最弱用来打破前两层叠加之后可能出现的“橡皮泥感”。每一层大致都是这样的结构UV坐标输入到Panner节点经过速度向量驱动后连接TextureSample的UV输入采样法线贴图输出Normal最后把三层法线用BlendAngleCorrectedNormals节点混合。这一节点能正确处理各层法线夹角避免简单相加导致细节互相抵消的问题效果远好于直接用Add加再Normalize。4.4 什么时候才需要上Gerstner顶点波如果你的需求是海面或者大湖面出现明显的浪涌、浪花拍岸那必须引入顶点波纹。UE5材质里可以用世界位置偏移WPO引脚接Gerstner波函数一组正弦波按波长、振幅、方向叠加让网格顶点真正动起来。但注意Gerstner波对网格细分密度要求很高细分数不足会出现顶点撕裂性能也直线上升。我做湖面时几乎不用它只有做空旷海域的开船场景才会考虑。如果你只想在湖泊近岸处加一点微弱的起伏感可以在第三层微观波纹之外加一个极低振幅的Gerstner波振幅压到0.02米以内专门用来做岸边湿区的动态效果。5. 波纹参数调优从“塑料水”到“能看的水”的关键数值5.1 调参顺序先大后小先动后静很多人在材质实例里看到二三十个参数马上从头到尾乱拧越拧越糟。我的经验是严格遵守“先大后小”的顺序。第一步只调主波浪。把后两层波纹的混合强度拉到接近0单独让主波浪显示出来调它的平铺大小和滚动速度直到湖面整体有大面积风吹动的感觉。这步调的是“湖面气质”如果大波浪频率不对后面叠加多少细节都救不回来。第二步打开中尺度波纹让湖面在平铺细密程度和速度上跟主波浪形成层次差。这个层次差是决定“塑料水”和“真水”的分水岭——两层波纹的频率不能太接近太接近会互相打架产生一种动画水纹的廉价感。第三步才是微观细节。微观水纹的强度一定要控制在很低的水平宁可弱到看不出也不要强到让湖面变得像沸腾的汤锅。5.2 我实测下来的一组基础参数下面这组参数以湖面直径约400米、UV按世界坐标计算作为参考适合做平静湖泊。波纹层作用平铺密度参考滚动速度参考混合强度参考第一层主波浪0.001-0.0050.002-0.0080.3-0.5第二层中尺度波纹0.01-0.030.01-0.030.2-0.3第三层微观水纹0.05-0.20.03-0.080.05-0.15注意这里的滚动速度单位不是绝对的“每秒多少米”而是Panner节点里UV滚动的速率。最终视觉速度还取决于你的平铺密度平铺越密同样的速度数值看起来滚得越快。所以我更建议每个参数都表达成材质实例的公开参数在游戏里用控制台实时调试肉眼确认后再固化数值。5.3 不同天气和风级下的参数调整逻辑湖面效果不是一套参数走天下。我做项目时通常会保存三套预设无风镜面、微风、大风。无风时主波浪强度降到0.1以下滚动速度几乎为零中尺度波纹保留微弱存在重点靠反射和透明度营造“水面静止如镜”的感觉。微风时主波浪强度0.3-0.4速度适中第二层层差拉开是大多数数字孪生项目要的“宜居湖面”。大风时主波浪强度加到0.6以上速度加快甚至可以引入一点点Gerstner波让岸边出现白色浪花痕迹。切换预设在蓝图上用动态材质实例Set Scalar Parameter即可不用重新编译材质。实际运行中只要根据天气系统的风力值做一个映射水面就会跟着自然变脸沉浸感提升非常明显。5.4 性能预算怎么分配三层法线采样在性能上并不贵真正贵的是反射和折射。我在几个项目里做过简单的GPU Profile水面材质本身可能只占半透明渲染开销的三成剩下的七成全在反射捕获更新和折射采样上。所以在不追求极致真实度的中远景我会用材质质量等级切换高画质开启三层波纹加SceneColor折射中画质只保留两层波纹低画质直接退化为基础颜色加静态法线。Cesium的大场景本身瓦片加载就吃性能水面这块一定要留出预算余地否则视角一拉高帧率就崩。还要注意半透明覆盖范围。水面半径越大半透明渲染的Overdraw越严重。我习惯在水面网格材质里做一个基于距离的透明度淡出让远景水面轻微透明减少半透明层对后面像素的遮挡影响。这个技巧在湖边看远山时尤其有用。6. Cesium场景里最容易踩的5个坑实测版6.1 水面在镜头远处突然消失这个坑我一开始完全没头绪。水面近看正常摄像机一拉远湖面就像蒸发了一样直接消失。排查了很久发现不是材质问题而是Cesium地形瓦片在远景加载时采用了更粗糙的LOD地形高度和近景差了一截原本贴着地面的水面就被吞到地形下方去了。解决方案有两个方向一是把水面高度稍微抬高让它超越远景地形LOD的最高偏移范围二是在材质里给透明度加一个远距离强制兜底即便水面穿插到地形之下也能透过地形看出来。第二种做法治标不治本我主力用的是第一种抬高量一般在0.5到1米之间近景看没啥毛病远景也不至于穿透。6.2 水岸线疯狂闪面这个问题的根源就是水面和地形贴得太近了。Cesium地形在LOD切换时同一位置的表面高度会有小幅度变化水面离地表只要贴近到厘米级闪面就不可避免。处理闪面的方法我前面提过抬高水面让两者永久脱开。但还有一个隐藏坑如果你用带深度的透明水材质水深计算依赖地形深度抬高太多会导致湖边“水深”显示不正确。这时候我会在材质里另外给岸边区域画一层专门的颜色遮罩用噪声或者距离场模拟岸边浅滩不依赖真实几何深度视觉上照样能骗过去。6.3 水发黑像是打翻了一瓶墨汁如果你的Cesium场景没有放足够强的反射捕获或天空光照半透明水面的表现会非常糟糕暗部死黑高光刺眼整体像一块黑色镜面玻璃。这种情况先别急着调波纹把场景里的SkyLight和反射捕获搞定再说。我通常在湖区中心放一个SphereReflectionCapture把它的影响范围覆盖整个水面并在Capture优先级上设置得高一点。这样水面至少会反射到天空颜色和周围山体剪影再去调透明度和颜色就会顺很多。Cesium的地形和影像在光照响应上本身比较“平”水面如果想要突出必须借助反射捕获补一道光。6.4 Cesium版权提示有时不显示但该守的规则不能丢有些人会问为什么Cesium for Unreal在某个版本或分辨率下默认的版权水印不显示。这里先说明白水印显示与否不影响你使用Cesium数据时应承担的署名和条款义务。Cesium ion提供了不同的使用计划很多真实地形和影像数据是有限制条件的商业项目里直接把水印隐藏或绕开很容易给自己埋雷。我的习惯是在美术交付前主动检查Cesium ion控制台里的资产授权范围确认项目可用再正常展示或按合同约定处理署名。这不是一句空话遇到过线上项目被数据方警告之后返工成本比想象中高得多。6.5 大湖面的材质参数不能一套打天下最后一个坑比较隐蔽。湖面跨度特别大时同一个Panner滚动速度在你的近景和远景感知上完全不同。近景水波在你脚下飞速流动远景水波却看起来几乎静止这种“速度失调”会让整个湖面非常假。解决方法是引入基于View坐标的距离渐变。用材质里的DistanceFade或者自定义的CameraDistance参数把近景的波纹速度放慢、强度提高远景的波纹速度加快以保持流动感再配合前面推荐的远距离透明淡出。这一步做完镜头从高空俯冲下来的整个过程中水面的动态感会保持连续不会出现“近处水波粼粼远处死水一潭”的割裂感。如果你刚开始做Cesium湖面建议在调波纹参数前花10分钟把水面位置、高度补偿、反射捕获这三件事彻底搞定。位置错乱时调材质就像盲人摸象越调越乱先把底子铺好波纹调优就会变成一个纯粹享受的过程。这个方法我后来在每个项目里都当成了固定步骤省下的时间远超想象。