KmlCamera

KmlCamera是Cesium中用于控制相机的一个类。它可以被用于在KML文档中指定相机的位置、方向、焦点位置等的逐帧动画，可以使Cesium地球的演示更加生动。

构造函数

new Cesium.KmlCamera(options)

• 参数:
  • options (Object) - 初始化KmlCamera的选项。
• options的属性:
  • flight (Cesium.Camera.Flight) - 逐帧动画
  • source (Cesium.KmlCamera.ViewRefreshMode) - 视图刷新模式
  • duration (Cesium.KmlCamera.Duration) - 持续时间
  • viewFormat (String) - 视图格式字符串
  • endToEndAnimation (Boolean) - 是否播放结束回到开始的动画
  • smooth (Boolean) - 是否平滑过渡
  • camera (Cesium.Camera) - 操作的相机实例

方法

setOptions(options)

重新设置选项。

• 参数:
  • options (Object) - 初始化KmlCamera的选项。

play(time)

开始播放逐帧动画。

• 参数:
  • time (Number) - 动画播放时间。

pause()

暂停播放逐帧动画。

resume(time)

恢复播放逐帧动画。

• 参数:
  • time (Number) - 从暂停的时间恢复播放。

cancel()

取消所有动画操作。

注意事项

• KmlCamera不支持在3D模式下进行平面模式播放。
• KmlCamera不支持非线性行进动画，但KML文件中可能导致相机位置、姿态跳变的非线性动画将被Cesium播放器忽略。
• KmlCamera只支持KML文件中逐帧动画（gx:Tour, gx:FlyTo）定义的相机操作，其它通过动态变化相机位置的技术不能与KmlCamera协同工作。

示例

// 创建球体
var viewer = new Cesium.Viewer('cesiumContainer', {});

// 加载KML文件
var sampleKml = 'MySample.kml'
var kmlPromise = viewer.dataSources.add(Cesium.KmlDataSource.load(sampleKml));

// 显示第一帧 KmlCamera 动画
kmlPromise.then(function(dataSources) {
   var dataSource = dataSources[0];
   var entity = dataSource.entities.getById('gx_01');
   var kmlCamera = entity.camera;
   kmlCamera.flight.complete.then(function() {
       // 在动画开始前等待 3 秒
       setTimeout(function() {
           kmlCamera.play();
       }, 3000);
   });
});

参考

• Cesium官方文档