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

帧率与图元统计

右上角是 Cesium 自带的帧率显示,左侧面板列出顶层图元数、 实体数、后处理阶段数与相机高度,每二十帧刷新一次。

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

内置帧率先打开

scene.debugShowFramesPerSecond = true 会在画面上叠加一个 帧率计数器,开发阶段用它判断当前视角是否吃力。 它会持续刷新,需要上报时再关掉。

几个容易读的数字

scene.primitives.length 是顶层图元数量,包含粒子系统、 Primitive 与模型;viewer.entities.values.length 是实体数量。两者互不包含,加材质、加标签时实体数会涨, 加 Primitive 时图元数会涨。

scene.postProcessStages.length 统计后处理阶段, 没启用泛光或自定义阶段时通常是 0。

可调参数

位置改什么效果
帧率按钮点击内置计数显示或隐藏
雾按钮点击远景朦胧或通透
frame % 20改成 5面板刷新更快
箱体循环次数8 改成 40实体数增加,帧率可能下降

帧率受垂直同步限制。多数浏览器把渲染锁在屏幕刷新率上, 画面只有几个物体时帧率也不会超过 60。判断性能时看是否稳定在刷新率附近, 掉到 30 上下才说明有压力。