1. 为什么我们需要运行时动态挂载3DTiles?
想象一下,你正在用虚幻引擎5和Cesium构建一个数字孪生城市平台。项目启动时,你加载了城市的基础地形和建筑白模。这时,用户A想查看实时的交通流量热力图,用户B想叠加昨晚的暴雨积水模拟数据,而用户C需要调取某个重点区域的倾斜摄影模型。如果这些数据都需要在编辑器里预先摆好、烘焙进关卡,那这个应用就太“笨”了。不仅启动慢,内存占用高,而且根本无法响应用户实时、多变的请求。
这就是运行时动态挂载与刷新3DTiles服务的价值所在。它让你的应用从一个静态的“展示厅”,变成一个活的、会“呼吸”的数据容器。核心目标很明确:在应用运行起来之后,根据程序逻辑或用户交互,实时地创建新的3DTileset,并让它立刻从指定的网络地址加载三维地理空间数据,呈现在Cesium地球上。
我遇到过不少项目,初期为了图省事,把所有可能用到的3DTiles都做成静态Actor放在关卡里,只是默认隐藏。结果就是,项目一打开,几十个GB的数据就在后台默默请求,客户端卡顿不说,服务器带宽也被无谓地消耗。后来我们改用动态挂载,需要什么加载什么,用完还能销毁,整个应用的性能和用户体验提升了好几个档次。
所以,这个技术特别适合这几类场景:
- 交互式GIS应用:用户点选哪个区域,就加载哪个区域的高精度模型。
- 多数据源切换:比如在“卫星影像”、“电子地图”、“地形渲染”等不同图层间切换,每个图层对应不同的3DTiles服务地址。
- 时序数据可视化:加载不同时间点的数据,如城市发展变迁、台风路径模拟,每个时间点都是一个独立的服务。
- 云端数据协同:数据服务部署在云端,客户端只需一个“空壳”,所有内容都根据权限动态拉取。
接下来,我们就抛开复杂的C++代码,用最直观的蓝图系统,一步步拆解如何实现这个“即插即用”的能力。你会发现,整个过程就像搭积木一样清晰。
2. 核心蓝图节点:从生成到刷新的完整链路
蓝图的可视化编程让我们可以绕过代码,直接操作游戏对象。实现动态挂载3DTiles,核心就是几个关键节点的串联。我们先从整体上把握这个流程,后面再深入每个环节的细节。
整个链路的骨架,可以概括为以下四步:
- 生成容器:在运行时,凭空“变”出一个
Cesium3DTilesetActor,作为数据的承载者。 - 切换水源:告诉这个新生的Tileset:“你别去Cesium官方仓库(Ion)找水喝了,我告诉你一个特定的水龙头(URL)。”
- 指定地址:把那个具体的“水龙头”地址(服务URL)交给它。
- 开水龙头:发出指令,让它立刻开始从指定地址接水(加载数据)。
在蓝图中,这对应着一条清晰的节点链:Spawn Actor from Class -> Set Source -> Set Url -> Refresh Tileset。下面这张表帮你快速理解每个节点的角色:
| 蓝图节点 | 作用类比 | 关键参数/操作 |
|---|---|---|
| Spawn Actor from Class | 工厂制造。在游戏世界中创建一个指定类型的“空壳”Actor。 | Class:选择 Cesium3DTileset;Spawn Transform:决定它生成的位置和旋转。 |
| Set Source | 切换水源。改变Tileset获取数据的模式。 | 将 Source 属性从默认的 From Cesium Ion 改为 From Url。 |
| Set Url | 配置地址。告诉Tileset具体去哪个网络地址获取数据。 | 输入一个有效的3DTiles服务URL,例如 https://your-server.com/tileset.json。 |
| Refresh Tileset | 执行加载。触发Tileset立即根据新配置的源和URL开始加载数据。 | 无输入参数,是一个执行动作。 |
在实际操作中,你可能会在一个事件(比如玩家按下键盘“1”、点击UI按钮、或者程序逻辑判断满足某个条件)后,触发这条节点链。这样,数据的加载就完全由你的游戏逻辑来驱动了。
3. 第一步:创建可动态生成的Cesium3DTileset蓝图类
虽然我们可以直接用原生的 Cesium3DTileset 类来生成,但我强烈建议你先创建一个它的蓝图子类。这就像你先定制一个标准的“数据容器模版”,以后所有动态生成的容器都基于这个模版,管理起来会方便得多。
操作步骤:
- 在内容浏览器中右键,选择
蓝图类。 - 在弹窗的搜索框里输入
Cesium3DTileset,选中它作为父类。 - 给你的新蓝图起个名字,比如
BP_Dynamic_Tileset,然后双击打开。
打开后,你可能会觉得这个蓝图编辑器里空荡荡的,没什么好设置的。别急,这一步的核心目的有两个:
- 身份标识:你有了一个专属的、易于识别的类。在后续生成Actor时,你选择的是
BP_Dynamic_Tileset,而不是泛泛的Cesium3DTileset。这在大型项目中非常利于管理和排查问题。 - 预留扩展接口:你可以在这个蓝图里预先设置一些默认属性。比如,在事件图表里,你可以为它添加一个自定义事件
InitializeFromURL,把设置URL和刷新的逻辑封装进去。这样,外部蓝图只需要生成它并调用这个初始化事件,传入URL参数即可,代码更整洁。
踩坑提醒: 创建这个蓝图子类时,不要在它的细节面板里直接填写 URL。因为我们的目标是运行时动态设置,如果这里填了,所有用它生成的实例都会默认加载同一个地址,反而失去了动态性。这里我们只需要一个“干净的模版”。
创建好后,记得编译并保存。这个 BP_Dynamic_Tileset 就是我们接下来要“召唤”的对象。
4. 第二步:在事件中生成Tileset Actor
有了容器模版,我们就要在游戏运行时把它“召唤”到场景里。这个操作通常会在某个关卡蓝图或者一个玩家控制器/游戏模式的蓝图里完成。
我们以一个最简单的场景为例:玩家按下键盘“L”键,动态加载一个3DTiles服务。
- 打开关卡蓝图:在你需要触发加载的关卡编辑器中,点击工具栏的
蓝图->打开关卡蓝图。 - 创建键盘事件:在事件图表中右键,搜索
L,选择键盘事件 L。这会创建一个当L键被按下时触发的事件节点。 - 生成Actor:从事件节点的输出执行引脚拖出连线,搜索
Spawn Actor from Class。 - 选择类:点击
Spawn Actor from Class节点上Class参数的下拉箭头,搜索并选择我们上一步创建的BP_Dynamic_Tileset。 - 设置生成参数:
Spawn Transform:这个参数决定了你的Tileset在场景中生成的位置、旋转和缩放。这里有个关键技巧:对于Cesium地球上的数据,Tileset的位置通常由它自带的tileset.json中的地理信息决定。所以,我们生成时的世界位置(Location)可以简单地设为(0,0,0)。更常见的做法是,将这个Transform连接到一个Get Actor Transform节点上,获取场景中某个“锚点”空Actor的位置,方便统一管理。Collision Handling Override:如果生成的位置可能与其他物体重叠,可以在这里设置碰撞处理方式,比如Always Spawn。
此时,你的蓝图应该类似这样:按下L键 -> 生成 BP_Dynamic_Tileset。如果你运行游戏并按下L,你会在世界大纲视图中看到一个名为 BP_Dynamic_Tileset 的新Actor被创建出来,但场景里可能还看不到任何数据,因为它还是个“空壳”,不知道去哪里加载。
Spawn Actor from Class 节点有一个非常重要的输出引脚叫 Return Value。它返回的就是刚刚生成的这个 BP_Dynamic_Tileset Actor对象的引用。后续所有针对这个特定Tileset的操作,都要基于这个引用。
5. 第三步:关键配置——将数据源切换为“From Url”
生成了Actor,我们拿到了它的引用(Return Value)。接下来就要对它进行配置。首先必须做的一步是:切换数据源模式。
如果你在编辑器里手动拖入一个 Cesium3DTileset,查看其细节面板,会发现 Source 属性默认是 From Cesium Ion。这意味着它期望你配置一个Cesium Ion的资产ID(Asset ID)来加载Cesium官方平台上的数据。但我们的需求是从自定义的URL加载,所以必须把这个模式改掉。
在蓝图中如何修改一个对象的属性呢?使用 Set 节点。
- 引出Set节点:从
Spawn Actor节点的Return Value输出引脚拖出连线。 - 搜索属性:在搜索框中输入
set source。你应该能看到一个名为Set Source (Cesium 3D Tileset)的节点。注意,这个节点是Cesium插件专门为Cesium3DTileset类提供的,不是通用的Set节点。 - 连接并设置:将这个
Set Source节点的目标(Target)引脚连接到Return Value(或者将Return Value拖到Target输入框)。然后,点击节点上Source参数的下拉菜单,将其从默认的From Cesium Ion改为From Url。
这一步至关重要,是很多新手会忽略的坑。 如果你不切换Source,直接去设置URL,系统会认为你仍在Ion模式下,你设置的URL字符串会被当作一个Asset ID去解析,结果当然是加载失败,控制台会报出令人困惑的错误。
6. 第四步:传递并设置3DTiles服务URL
数据源模式切换好了,现在可以告诉Tileset具体地址了。同样,我们使用Cesium插件提供的专用节点。
- 引出Set Url节点:从
Set Source节点的输出执行引脚拖出连线,搜索set url。选择Set Url (Cesium 3D Tileset)。 - 连接目标:确保该节点的Target指向的仍然是我们的Tileset Actor引用。
- 输入URL:在
Url输入参数中,填入你的3DTiles服务地址。这个地址必须指向一个有效的tileset.json文件。- 远程服务示例:
http://your-domain.com/data/my-city/tileset.json - 本地文件示例(开发阶段):
file:///D:/ProjectData/3DTiles/terrain/tileset.json(注意是三个斜杠)
- 远程服务示例:
URL从哪里来? 这里有几种灵活的传递方式,让你的蓝图更强大:
- 直接输入:像上面一样,直接把字符串写死在节点里。简单但不灵活。
- 蓝图变量:在关卡蓝图中创建一个字符串类型的变量,比如
Tileset_URL。在Set Url节点中,将这个变量拖出来,选择Get,然后连接到Url引脚。这样,你可以在游戏运行前,或者通过其他逻辑来改变这个变量的值。 - 函数参数:如果你把整个动态加载的逻辑封装成一个自定义函数或宏,那么URL可以作为这个函数的输入参数传入,复用性极高。
- 从外部数据源读取:结合HTTP请求节点,从服务器配置接口动态获取需要加载的URL列表。
我个人的习惯是,在项目初期使用蓝图变量,方便调试;在项目稳定后,会将URL配置放在游戏实例(GameInstance)或数据管理器中,作为全局配置来调用。
7. 第五步:执行刷新,让数据加载生效
完成了Source和URL的设置,数据并不会自动开始加载。你需要手动下达“开始加载”的指令。这就是 Refresh Tileset 节点的作用。
- 引出刷新节点:从
Set Url节点的输出执行引脚拖出连线,搜索refresh tileset。选择Refresh Tileset (Cesium 3D Tileset)。 - 连接目标:同样,确保Target指向正确的Tileset引用。
当这个节点的执行引脚被触发后,Cesium插件内部会启动数据加载流程:解析你提供的URL,下载 tileset.json,然后根据其中的空间索引结构,逐步请求和渲染不同层级的瓦片数据。你会在场景中看到数据从无到有、从模糊到清晰地加载出来。
至此,一个最基础的动态挂载流程就完成了。你的完整节点链应该是:键盘事件 -> Spawn Actor (BP_Dynamic_Tileset) -> Set Source (From Url) -> Set Url (你的地址) -> Refresh Tileset。运行游戏,按下L键,你应该能看到指定的3DTiles数据成功加载到Cesium地球上。
8. 进阶技巧与实战避坑指南
掌握了基本流程,我们来看看如何让它更健壮、更实用,并避开我踩过的那些坑。
8.1 封装成函数或宏,实现一键调用
每次都拖这么一串节点太麻烦了。我们可以把它封装起来。
- 封装成函数:在关卡蓝图或一个工具类蓝图中,右键创建新函数,命名为
SpawnDynamicTileset。将核心节点链移入函数内,并将Tileset Class和Service URL设置为函数的输入参数。这样,在任何需要的地方,你只需要调用这个函数,传入URL,就能生成并加载一个Tileset。 - 封装成宏:如果逻辑更复杂,涉及多个步骤和临时变量,可以封装成宏(Macro)。宏在组织复杂节点流时更清晰。
8.2 管理生成后的Actor引用
动态生成的对象,如果你不保存它的引用,之后就很难再控制它(比如卸载、修改属性)。生成后,立即将 Return Value 存储到一个变量中是个好习惯。
- 在关卡蓝图中创建一个
Object Reference类型的变量,命名为SpawnedTilesetRef。 - 在
Spawn Actor节点后,添加一个Set节点,将Return Value赋值给SpawnedTilesetRef。 这样,你之后就可以通过这个变量来控制这个特定的Tileset,例如在另一个事件中调用Destroy Actor节点来卸载它,以释放内存。
8.3 处理加载状态与错误
动态加载是网络操作,可能成功,也可能失败(网络错误、URL无效、数据格式不对)。CesiumForUnreal的Tileset提供了一些事件和属性可以帮助我们。
- 检查
Ready属性:Tileset有一个Is Ready属性。你可以用Get Is Ready节点获取其状态,或者用On Tileset Ready Changed事件来监听状态变化。在数据完全加载好之前,避免进行依赖于此数据的操作。 - 错误处理:目前蓝图层面对加载错误的直接回调支持有限。一个实用的方法是,在调用
Refresh Tileset后,延迟几秒,然后检查Is Ready是否为false,并且场景中依然看不到数据,则可以判定为加载失败,并执行清理和错误提示逻辑。
8.4 性能优化:卸载与内存管理
只生成不销毁,内存很快就会爆炸。一定要配套实现卸载功能。
- 简单销毁:保存了Actor引用后,在需要时(如切换图层、关闭应用模块),使用
Destroy Actor节点,并将引用传递给它。这会立即从场景和内存中移除该Tileset及其加载的所有瓦片数据。 - 批量管理:如果需要同时管理多个动态Tileset,建议使用一个数组变量(Array of Object References)来存储所有生成的引用。卸载时遍历数组,统一销毁。
8.5 一个常见的坑:坐标与位置
动态生成的Tileset,其在地球上的位置完全由数据本身的 tileset.json 中定义的 transform 或地理范围决定。你在Spawn时设置的 Spawn Transform 中的 Location,在Cesium地理坐标系下通常不会影响其在地球上的经纬度位置。它主要影响的是这个Actor在虚幻世界原点(0,0,0)附近的局部位置。如果你的Tileset数据没有正确的地理配准,它可能会出现在错误的位置。确保你的3DTiles数据生产流程是坐标系正确的。
9. 完整蓝图示例与场景应用
让我们结合一个具体场景,把上面的知识串起来。假设我们要做一个功能:点击UI上的三个按钮,分别加载“地形”、“建筑”、“植被”三个不同的3DTiles服务。
实现步骤:
- 创建UI:使用虚幻引擎的UMG创建一个简单的界面,放置三个按钮,分别命名为
Btn_Terrain,Btn_Building,Btn_Vegetation。 - 创建数据管理器:新建一个Actor蓝图,命名为
BP_DataManager,放在场景中。这个管理器负责所有数据加载逻辑。 - 在管理器中封装加载函数:
- 打开
BP_DataManager的事件图表。 - 创建一个自定义事件,命名为
LoadTileset,添加一个String类型的输入参数InURL。 - 将之前我们练习的节点链(Spawn -> Set Source -> Set Url -> Refresh)放入这个事件中。将
Set Url节点的输入连接到InURL参数。 - 将生成的Actor引用存储到管理器的一个数组变量
CurrentTilesets中。 - 在加载新数据前,可以先遍历
CurrentTilesets数组,销毁所有旧的Tileset(实现切换效果)。
- 打开
- 连接UI与逻辑:
- 在关卡蓝图中,获取
BP_DataManager实例的引用。 - 为每个UI按钮的
On Clicked事件创建绑定。 - 在按钮事件中,调用
BP_DataManager实例的LoadTileset函数,并传入对应的服务URL字符串。
- 在关卡蓝图中,获取
这样,一个具备动态数据切换能力的应用原型就搭建好了。用户点击按钮,场景中的数据会动态更新,整个过程无需重启应用或重新加载关卡。
回过头看,你会发现整个动态挂载机制的核心思想,其实就是用蓝图节点去模拟我们在编辑器细节面板里的手动操作。插件开发者将那些可编辑的属性(如Source、Url)和按钮(如Refresh Tileset)都暴露成了蓝图节点,让我们可以在运行时通过逻辑来驱动它们。理解了这个本质,你就能举一反三,用同样的思路去操作Cesium插件的其他功能,比如动态修改 Show Credits Display(是否显示数据版权)、Maximum Screen Space Error(渲染细节精度)等属性,让你的应用交互更加丰富和动态。
299



被折叠的 条评论
为什么被折叠?



