Cesium官⽅教程7--三维模型
原⽂地址：
三维模型（3D Models）
这篇教程给⼤家介绍，如何在Cesium中通过Primitive API来转换、加载、使⽤三维模型。如果你是新⼿，建议你先看下这篇的三维模型部分。
Cesium⽀持包含关键帧（key-frame）动画、⾻骼（skinning）动画的glTF格式的三维模型，并且⽀持模型节点（node）的拾取。是Khronos Group 定义的⼀个基于web上的新兴三维模型格式⾏业标准。Khronos Group是WebGL和的背后财团。Cesium提供了⼀个，可以把COLLADA(.dae)模型转换为专为Cesium优化的glTF格式。
快速开始
Cesium内置了⼀些随时可⽤的glTF模型：
带螺旋桨动画的飞机模型
带轮⼦动画的汽车模型
带⾏⾛⾻骼动画的⼈物模型
热⽓球模型
中国汽车模型网
⽜奶卡车
飞机
汽车
⼈物
⽜奶车
这些模型都在Apps/SampleData/models⽬录下有各⾃的存放⽬录。⼀部分还包含⼀个COLLADA (.dae)格式的源⽂件（Cesium中不需要），⼀个glTF格式(.gltf)、⼀个⼆进制glTF格式 (.glb)。
下来我们写⽰例代码. 打开Sandcastle ⽰例。在var viewer = ...之后第4⾏，增加⼀个scene变量。
var scene = viewer.scene;
下来，使⽤加载汽车模型，添加下⾯的代码：
var modelMatrix = Cesium.Transforms.eastNorthUpToFixedFrame(
Cesium.Cartesian3.fromDegrees(-75.62898254394531, 40.02804946899414, 0.0));
var model = scene.primitives.add(Cesium.Model.fromGltf({
url : '../../../../Apps/SampleData/models/GroundVehicle/GroundVehicle.glb',
modelMatrix : modelMatrix,
scale : 200.0
}));
按F8运⾏，使⽤右上⾓的位置查询⼯具，定位到 Exton, PA。
地理位置查询定位
现在我们垂直俯视观察这个汽车了。使⽤⿏标右键拉近⼀点，然后⿏标中键按下旋转视⾓放平⼀点。
拉近视⾓
Cesium.Model.fromGltf⽅法异步载⼊了glTF 以及它的⼀些外部资源⽂件，完全载⼊（响应了）之后进⾏了渲染。只需要gltf⽂件的url路径，⽰例中就是这个../../../../Apps/SampleData/models/GroundVehicle/GroundVehicle.glb。
fromGltf有个可选的参数scale可以⽤来放⼤缩⼩模型。很多实际⼤⼩的模型都相对地球来说太⼩了，为了测试可以⽤scale把模型放⼤⼀些，有时候甚⾄可以⾮常⼤，⽐如200000.0：
放⼤模型
fromGltf也可以设置⼀个modelMatrix去放置或者旋转模型。这个参数会⽤来创建模型的局部坐标系。我们这⾥使⽤了去创建了⼀个以经纬度（-75.62898254394531，40.02804946899414）为原点的enu（east-north-up ）局部坐标系。为了移动模型，可以随时修改模型的属性。
为了能看见坐标系统，使⽤Cesium的调试⼯具，在第4⾏的var viewer = ...之后添加如下代码：
按F8运⾏，调试⼯具已经显⽰在右上⾓了。展开Primitives⾯板，点击Pick a Primitive，然后在场景中点击汽车模型，然后勾选show reference frame。
参考坐标系
这⾥x轴（正东向）是红⾊的，y轴（正北向）是绿⾊的，z轴（垂直向上）是蓝⾊的。
如果加载飞机或者⼈物的模型，那么只需要修改代码⾥的url参数为'../../../../Apps/SampleData/models/CesiumAir/Cesium_Air.glb'或
者'../../../../Apps/SampleData/models/CesiumMan/Cesium_Man.glb'。完整的配置参数查看⽤户⼿册。
动画
上⾯的模型都⾃带了模型数据制作者内置的关键帧动画，数据制作者定义了⼀些关键位置的模型姿态，Cesium会实时插值做变换展⽰⼀个平滑的动画效果。为了能播放动画，在Cesium.Model.fromGltf调⽤后，添加下⾯的代码：
Cesium.adyPromise).then(function(model) {
model.activeAnimations.addAll({
loop : Cesium.ModelAnimationLoop.REPEAT
});
});
因为动画也是存储在glTF模型⾥，所以需要等待readyPromise执⾏后才能访问他们。⽅法调⽤后播放模型的所有动画。参数设置后，会⼀直循环播放动画，直到activeAnimations集合⾥删除了对应的动画。如果要播放某⼀个特定动画，那么使⽤⽅法，传⼀个动画id (glTF⽂件内部定义的)。
除了loop选项，addAll和add函数提供了⼀些列的参数选项，⽤来控制动画的开始、结束、播放速度，以及播放⽅向。⽐如下⾯的代码设定动画逆向按照半速（相对Cesium时钟）播放:
model.activeAnimations.addAll({
loop : Cesium.ModelAnimationLoop.REPEAT,
speedup : 0.5,
reverse : true
});
add函数返回⼀个类实例 (addAll返回⼀个该类的实例数组), 这个类包含了动画的开始、停⽌、每帧更新的事件。⽐如可以⽤来控制⼀个动画在另⼀个结束后开始播放。具体查看 , , 和事件.
动画是和Cesium时钟同步的，所以可以在动画播放控件上按下播放按钮控制它。也可以通过该控件和时间线的加速、减速、逆向播放功能来控制动画的状态。
时间线(Timeline)
为了让场景中的动画⾃动播放，可以⽤下⾯的代码来初始化Viewer：
var viewer = new Cesium.Viewer('cesiumContainer', {
shouldAnimate : true
});
拾取
和Cesium的所有图元⼀样, 如果模型被选中了，那么的返回值将包括类的实例。同时，glTF中的节点（node）id 和三⾓⽹（mesh）id 也会被返回。⽤这个可以判定精确的模型点击部位。下⾯的代码在控制台输出了⿏标所在位置对应的glTF模型中的节点和三⾓⽹。
var handler = new Cesium.ScreenSpaceEventHandler(scene.canvas);
handler.setInputAction(
function (movement) {
var pick = scene.dPosition);
if (Cesium.defined(pick) && Cesium.de) && sh)) {
console.log('node: ' + de.name + '. mesh: ' + sh.name);
}
},
Cesium.ScreenSpaceEventType.MOUSE_MOVE
);
把 COLLADA（dae）转 glTF
可以使⽤Cesium的. 把.dae和图⽚⽂件转为⼀个内嵌图⽚资源的.gltf⽂件。
问题
如果Cesium加载三维模型有问题，那么⾸先定位问题出现在哪个阶段：
Max，Maya, Modo, SketchUp 等建模⼯具的 COLLADA 导出器有没有问题
COLLADA-to-glTF转换⼯具有没有问题
Cesium glTF 渲染代码有没有问题
Mac 上解决问题
在Mac系统上，判定⼀个COLLADA ⽂件是否导出正常，双击.dae⽂件，它应该会显⽰在预览窗⼝上。如果模型带动画，那么⿏标移动到这个窗⼝上会显⽰⼀个动画控制的⼯具栏。
Mac 模型预览窗⼝
如果COLLADA ⽂件有问题，那么预览界⾯会提⽰错误。这⼀般是由于建模⼯具的导出器有bug。
模型预览错误
为了解决这个问题，安装，然后右键单机这个.dae⽂件，选择Open With -> Xcode。
Xcode 打开
Xcode 如同预览窗⼝⼀样显⽰模型，但是它有更多额外功能，⽐如选择⼀个独⽴的节点。Xcode实际上对于预览窗⼝上显⽰不了的dae有很多解决办法。如果模型可以在Xcode 中加载，那么选择File - Save保存⼀下就能解决问题，这时候预览就没有问题了。
Xcode中展⽰
如果还是⽆法预览，那就是COLLADA 导出器有严重问题了。⾸先确认你使⽤的最新版的建模⼯具，然后试下。如果还不能解决，那么给建模⼯具提bug去吧。也可以试下先导出.fbx格式，然后在其他⼯具中导⼊fbx，再导出dae。
Windows 上解决问题
Windows上，VS2013（包括免费的)包含⼀个模型编辑器，他可以加载COLLADA模型。判断⼀个COLLADA⽂件是否导出正常，把.dae⽂件拖拽到VS窗⼝⾥，如果正常显⽰，就是正常的。否则，可能有⼀些bug。试下。果还不能解决，那么给建模⼯具提bug去吧。也可以试下先导出.fbx格式，然后在其他⼯具中导⼊fbx，再导出dae。
Visual Studio
如果你没有Visual Studio，Autodesk 提供了⼀个基于WebGL的。可以把模型拖拽进去，⽆需登陆就能测试。但是这个⼯具不⽀持动画，如果模型包含图⽚，那么上传⼀个zip压缩包，把dae和图⽚都打进去。
Cesium 上解决问题
COLLADA ⽂件准备好之后，那么使⽤[在线⼯具 ] ()转下格式再在Cesium中加载。如果没于加载成功，那么说明这个转换⼯具或者Cesium 有bug。为了获取更多信息，打开浏览器的调试⼯具 (Chrome快捷键Ctrl-Shift-I ) ，并且选中Pause on all exceptions (Chrome在Sources⾯板⾥ )，然后刷新页⾯.
Pause On All Exceptions
也可以在上发⼀个帖⼦，我们修正bug后会提供⼀个解决⽅法。如果你发帖⼦，请包含下⾯内容：
COLLADA 源⽂件和转换后的 glTF⽂件。我们也知道不是所有⼈都愿意共享它的模型数据，但是如果你共享了，那么对于解决问题很有帮助。
当模型加载的时候浏览器控制台窗⼝输出的所有异常信息。
控制台异常
其他资源
再看下Sandcastle 中。类和类的官⽅⽂档。
中国最专业的Cesium开发者社区