前端使用Cesium加载三维模型全攻略

想象一下，地球在你眼前旋转，上面还有各种3D模型，是不是很酷？Cesium是一个超酷的库，专门用来创建超炫的3D地球和地图。好，言归正传，今天这篇文章就分享一下前端如何使用Cesium加载三维模型。

一：准备工作

首先，确保你已经安装了Cesium库。可以从Cesium官网下载最新版本的库文件，或者使用npm进行安装：

npm install cesium
或者
yarn add cesium

然后，找一个舒服的地方坐下，准备好开始你的3D之旅

二：加载模型

要加载一个3D模型，你需要知道模型在哪里，然后告诉Cesium去哪里找它。就像你告诉外卖小哥你的地址一样。然后，你就可以把这个模型加到你的地球上了！

// 创建你的Cesium Viewer  
let viewer = new Cesium.Viewer('cesiumContainer');  
  
// 定义模型的坐标和大小  
let modelMatrix = Cesium.Transforms.eastNorthUpToFixedFrame(  
    Cesium.Cartesian3.fromDegrees(-75.628982, 40.028194),   
    new Cesium.HeadingPitchRoll()   
);  
  
// 定义模型的路径和其他选项  
let modelOptions = {  
    uri: 'path/to/your/model.gltf',   
    scale: 1.0,   
    minimumPixelSize: 128,   
    maximumScale: 20000,   
    modelMatrix: modelMatrix   
};  
  
// 把模型加到场景里！  
viewer.scene.primitives.add(new Cesium.Model(modelOptions));

我们首先创建了一个Cesium Viewer实例，然后定义了模型的路径和选项。其中，modelMatrix参数用于定义模型的变换矩阵，包括位置、方向、俯仰和偏航角度等。然后，我们使用new Cesium.Model()构造函数创建一个模型实例，并将模型添加到场景中。
当然别忘了把’path/to/your/model.gltf’替换成你自己的GLTF模型文件路径哦！如果你有Blender或者其他的3D建模软件，你可以导出为GLTF格式，然后放到你的项目里。建议用blender免费而且还比较好用。

三：交互和动画

当然，加载模型只是第一步。你还可以和模型互动哦！比如你可以给模型添加碰撞检测，这样你就可以知道哪些地方可以“撞”到模型。就像玩虚拟现实游戏一样！
首先，你需要定义一个碰撞器的形状和大小。然后，你可以把这个碰撞器加到场景里，和你的模型一起显示出来。就像给你的模型穿上盔甲一样！

// 定义碰撞器的位置和尺寸  
var boxGeometry = new Cesium.BoxGeometry({  
    length: 100000, // 长度（单位：米）  
    width: 100000, // 宽度（单位：米）  
    height: 100000 // 高度（单位：米）  
});  
var boxMaterial = new Cesium.Material({  
    fabric: {  
        type: 'Grid', // 使用网格材质类型  
        unlit: true // 不进行光照计算，仅显示碰撞器轮廓线  
    }  
});  
var boxPrimitive = new Cesium.Primitive({ // 创建碰撞器实体对象  
    geometryInstances: new Cesium.GeometryInstance({ // 定义碰撞器几何体实例  
        geometry: boxGeometry, // 使用BoxGeometry作为几何体类型  
        modelMatrix: modelMatrix, // 设置模型变换矩阵，使其与模型对齐  
        id: 'box' // 设置碰撞器标识符，方便后续查找和识别碰撞事件  
    }),  
    asynchronous: false, // 是否异步加载碰撞器几何体数据，这里选择同步加载以提高性能和效率  
    material: boxMaterial // 设置碰撞器材质属性，这里使用网格材质类型显示轮廓线效果  
});  
viewer.scene.primitives.add(boxPrimitive); // 将碰撞器添加到场景中显示出来。

四：其他api实例

就写几个我用到的吧。
1.地理信息查询
当你想要查找某个地点的具体信息时，可以使用Cesium的地理信息查询功能。例如，你可以通过经纬度坐标或地名来查询相关的地理信息

viewer.geocoder.geocode({  
    text: '北京',  
    view: Cesium.ScreenSpaceEventType.LEFT_CLICK  
}).then(function(results) {  
    // 查询成功，获取查询结果  
    var entity = results[0].entity;  
    console.log(entity); // 输出查询到的实体信息  
});

2.轨迹绘制
如果你想要在地图上绘制轨迹，可以使用Cesium提供的轨迹绘制工具。通过定义一系列的经纬度坐标，你可以轻松地绘制出轨迹。

// 定义轨迹的坐标点数组  
var waypoints = [  
    Cesium.Cartesian3.fromDegrees(116.407, 39.904), // 北京  
    Cesium.Cartesian3.fromDegrees(121.473, 31.230), // 上海  
    Cesium.Cartesian3.fromDegrees(104.065, 30.574)  // 成都  
];  
  
// 创建轨迹实体  
var polyline = viewer.entities.add({  
    polyline: {  
        positions: waypoints,  
        width: 5,  
        material: Cesium.Color.RED,  
        leadTime: 0,  
        trailTime: 0  
    }  
});

定义一个包含经纬度坐标的数组waypoints，表示轨迹上的点。然后，我们使用viewer.entities.add()方法创建了一个红色的轨迹实体，并将其添加到地图上。通过调整width参数可以改变轨迹的宽度，而leadTime和trailTime参数则分别控制轨迹的前导和尾迹时间
3.地理编码
如果你有一系列的地名或地址，并想要获取其对应的经纬度坐标，可以使用Cesium的地理编码功能。通过地理编码，你可以将地址转换为准确的坐标位置

var viewer = new Cesium.Viewer('cesiumContainer');  
var encodedAddress = '北京市朝阳区'; // 需要地理编码的地址或地名  
var request = {  
    address : encodedAddress, // 地址或地名字符串  
    resource : 'address' // 地理编码资源类型，这里使用地址编码资源类型（address）进行示范。如果使用地名编码资源类型（geocode），需要传递地名相关的参数。例如：{ name : '北京' }。此外，还可以选择其他资源类型（例如：postalCode、intersection等）。具体可参考Cesium官方文档。  
};  
viewer.geocoder.geocode(request).then(function(results) {  
    // 地理编码成功，获取地理编码结果（包含经纬度坐标等）  
    var position = results[0].position; // 获取第一个结果的经纬度坐标位置信息，返回一个Cesium.Cartesian3对象。如果有多于一个结果，可以根据实际需求进行筛选或处理。例如：results[0].entity 等。可以参考Cesium官方文档了解更多关于地理编码结果的信息。使用经纬度坐标信息进行后续操作，例如：绘制标记点、添加轨迹等。   
});