经纬志
首页 / Cesium / 使用示例

自定义数据源

数据源是 Cesium 管理一批实体的方式。自己写一个数据源,就能让外部数据像 CZML 一样被统一加载、卸载和更新。

CesiumJS 1.121 · 更新 2026-10-28
源码与运行效果
运行效果

三个方法

load 负责解析数据并往 entities 里加实体,update 每帧被调用,用来推进动画。entities 由父类维护,直接 add 即可。

为什么要包一层

直接往 viewer.entities 里塞数据也能显示,但卸载时要自己清。包成数据源后,viewer.dataSources.remove 就能整批移除。

可以直接改的地方

位置改什么效果
load(data)解析逻辑加载行为
update(time)每帧逻辑动画推进
viewer.dataSources.add换成 remove整批卸载

update 要轻:update 每帧都会调用,里面的计算要尽量轻,重活放到 load 里一次做完。