Cesium for Unity离线加载地图

Cesium for Unity 安装指南

Cesium for Unity 是一个插件，允许在 Unity 项目中集成 Cesium 的全球 3D 地理空间数据。以下为安装与基本使用方法。

环境要求

• Unity 2020.3 或更高版本（推荐 LTS 版本）
• 需要安装 Unity Package Manager (UPM)
• 注册 Cesium ion 账户（用于获取 3D 卫星影像和地形数据）

安装步骤

通过 Unity Package Manager 安装

1. 打开 Unity，导航至 Window > Package Manager
2. 点击 + 按钮，选择 Add package from git URL
3. 输入以下 Git URL：

   https://github.com/CesiumGS/cesium-unity.git
   

   如果下载得很慢,也可以下载com.cesium.unity-1.17.0.tgz

4. 如果下载得很慢,也可以下载com.cesium.unity-1.17.0.tgz,下载地址Releases · CesiumGS/cesium-unityhttps://github.com/CesiumGS/cesium-unity/releases.
   

5. 等待 Unity 下载并导入om.cesium.unity-1.17.0.tgz 
6. 在顶部菜单栏，点击 ​Window​ > ​Package Manager。

7. 在 Package Manager 窗口的左上角，点击 ​​"+"​​ 按钮。从弹出的下拉菜单中，选择 ​Add package from tarball...​。
   
    

配置 Cesium ion 访问

1. 登录 Cesium ion 并获取 Access Token
   
   
2. 在 Unity 中，导航至 Cesium > Cesium Settings
3. 在 Cesium ion 面板输入 Access Token

基本使用

加载 3D 地形和影像

1. 
   下载高程和影像,我是在91卫图助手下载,打开91卫图助手,选择区域,然后下载高程和影像,注意要选择保存格式为GeoTiff,坐标投影为墨卡托投影.
   
   
2. 处理下载好的高程和影像切片.这里下载CesiumLab,下载地址
   首页 地球可视化实验室.团队致力于提供基础应用开发，助力数字孪生从业者，开发相关业务。地球可视化实验室.团队致力于提供基础应用开发，助力数字孪生从业者，开发相关业务。https://cesiumlab.com/
   将你下载的高程数据tif添加到输入文件里面,下载了几个层级就全部添加进去,选择ctb类型,输出文件选择散列,最后输入要保存的地址,最后处理完成会导出切片.
   
   同理处理影像切片,只需要选择影像切片,按照图片配置即可.
   
   

3.   配置Nginx路径.由于离线加载地图需要配置好高程和影像的路径,所以我选择使用Nginx来配置路径,配置好之后在浏览器输入http://localhost/terrain/ 
   
   
   就能访问文件夹里面的东西.

4.  在 Unity 场景中创建一个 Cesium3DTileset 对象,并且输入对应的layer.json路径  http://localhost/terrain/layer.json
   
   
   添加CesiumTileMapServiceRasterOverlay组件,并且输入http://localhost/imagery/tilemapresource.xml
   

5. 添加相机,最后运行就能看江加载的地图啦
   
   

常见问题

加载失败

• 检查 配置Nginx路径 是否有效
• 确保layer.json里面的"format":"quantized-mesh-1.0"为unity可以识别的

性能优化

以上步骤可帮助快速在 Unity 中集成 Cesium 3D 地理数据，适用于虚拟地球、GIS 应用等场景。