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

视频贴到球面

用 canvas 生成视频流,把 video 元素直接交给实体材质贴到球体表面。

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

视频材质怎么接

entity.ellipsoid.material 可以直接接收一个播放中的 video 元素,Cesium 内部按图像材质处理,每帧把当前画面上传成纹理。视频未播放或跨域受限时球体会显示为黑色。

示例替代了什么

官方示例播放的是远程视频文件。这里用 canvas 的 captureStream 生成视频流,画面内容不同,材质接法与播放机制一致,且不需要外部视频资源。

对象用途说明
canvas.captureStream(fps)生成视频流浏览器支持即可
video 元素材质输入交给 material
VideoSynchronizer音视频与时钟同步有音轨时需要

视频纹理每帧都要上传,分辨率越高越吃带宽;演示用 640×360,实际项目不建议超过 1080p。