作者：kele
一、背景
众所周知，游戏引擎（Unity）功能强大，可以做出很多炫酷的游戏和动画效果，这部分功能的实现往往不仅仅是靠可视化界面就能够实现的，还需要代码开发。SuperMap Hi-Fi SDKS for Unity游戏引擎插件能够实现地理数据与游戏引擎相结合，碰撞出更绚烂的火花，目前SuperMap Hi-Fi SDKS for Unity插件集成了许多可视化界面操作功能，但是在正式的开发环境中，往往不太能满足客户对于功能入口、界面UI的个性化需求，所以这部分功能的实现需要用到代码开发。
二、开发准备
2.1 开发软件下载
| 产品 | 推荐版本 | 介绍 | 下载地址 |
|---|---|---|---|
| Unity Hub | 3.3.1 - c2（最新版即可） | 使用 Unity Hub 可以更方便地创建、打开、管理和更新 Unity 项目1、 项目管理：Unity Hub 支持创建、打开和管理Unity项目2、 引擎管理：Unity Hub 能够同时安装和管理多个Unity引擎版本3、 社区资源：Unity Hub 提供了一个集中的位置，让用户可以轻松访问 Unity 社区资源 | https://unity.cn/releases |
| Unity | 2019.4.39 f1c1 | 游戏引擎软件，可通过官网下载或者通过Unity Hub 下载（如果需要打包到 WebGL ，必须使用2019版本） | https://unity.cn/releases |
| Visual Studio | 2019 | 开发工具，用于 Unity 二次开发 | https://visualstudio.microsoft.com/zh-hans/downloads |
| SuperMap Hi-Fi 3D SDK for Unity | 11.1.1 | 超图游戏引擎（Unity）插件，可通过SuperMap官网下载 | http://support.supermap.com.cn/DownloadCenter/ProductPlatform.aspx |
2.2 开发接口介绍
所有开发接口位于插件包文件夹下 SuperMap Hi-Fi 3D SDK for Unity 接口参考文档.xlsx 内。
常用接口类介绍：
| 名称 | 描述 |
|---|---|
| SuperMapSDK SuperMap SDK | 命名空间，包含数据加载、三维分析等功能 |
| RealspaceView | 接口主类，控制整个场景 |
| Scene | 三维场景类。三维数据会依据地理空间参考信息，填加到三维场景中 |
| CameraState | 相机状态类 |
| Layer3D | 三维图层类。该类提供了三维图层显示控制等便于三维地图管理的一系列属性 |
| Layer3DS3MFile | 缓存图层类 |
| Style3D | 图层风格类 |
三、开发步骤
3.1 创建canvas
在项目根节点上右键：GameObjects-UI-Canvas，创建Canvas用于放置UI元素
3.2 创建导航栏
在Canvas节点上右键：UI-Image，创建image对象，之后调整大小以及位置，使其位于Canvas顶部
将准备好的图片拖拽至工程目录下，选择图片后在右边属性面板中，将 Texture Type 选择为 Speite（2D and UI），然后通过鼠标鼠标将处理好的图片拖拽到 image 下 Source Image 中，导航栏就制作完成了；接下来通过同样的方法添加 Text 和 Button 用来展示项目名称与功能入口
3.3 创建脚本
在 Asset 下创建文件夹，并在文件夹内创建 C# Script，命名为 location
双击 C# 脚本，默认用 Visual Studio 打开编辑（如果没有安装，请参考2.1进行安装）。先编写飞行定位页面，编写好后点击保存，之后返回Unity
3.4 关联设置
回到Unity界面在左侧的层级视图（Hierarchy）面板中找到GameObjeect，点击右侧And Component，添加 location 的Script，将cs和自己创建的项目相关联，具体操作如下图所示：
文章来源：https://www.toymoban.com/news/detail-775673.html
3.5 运行结果
文章来源地址https://www.toymoban.com/news/detail-775673.html
四、功能开发示例
4.1 添加图层
using System.Collections;
using System.Collections.Generic;
using UnityEngine;
using SuperMapSDK;
public class location : MonoBehaviour
{
public void addLayer()
{
CameraState state = new CameraState(104.05099856483271,30.651860100062148, 5000, 0, 0, 0);
SupermapGIS.Instance.Realspace.SceneControl.Scene.Fly(state, 4000);
//添加s3m图层,不添加到队列最前面
SupermapGIS.Instance.Realspace.SceneControl.Scene.Layers.Add(
"E:/sampledata/SampleData/Cache/Building/Building.scp", //缓存文件地址
Layer3DType.S3M, //图层类型
false, //是否添加到最前面
"Building" //图层名称
);
//添加影像图层
SupermapGIS.Instance.Realspace.SceneControl.Scene.Layers.Add(
"E:/sampledata/SampleData/Cache/BeijingTerrain@BeijingTerrain/BeijingTerrain@BeijingTerrain/
BeijingTerrain@BeijingTerrain.sci3d",
Layer3DType.Map,
false,
"Beijingimg"
);
//添加地形图层
SupermapGIS.Instance.Realspace.SceneControl.Scene.TerrainLayers.Add(
"E:/sampledata/SampleData/Cache/BeijingTerrain@BeijingTerrain/
BeijingTerrain@BeijingTerrain_Terrain/BeijingTerrain@BeijingTerrain_Terrain.sct",
false
);
//添加在线S3M服务
SupermapGIS.Instance.Realspace.SceneControl.Scene.Layers.Add(
"http://localhost:8090/iserver/services/3D-local3DCache-Ground/rest/realspace",
Layer3DType.S3M,
"Ground",
false);
}
}
4.2 飞行定位到指定图层
Realspace = new RealspaceView();
Scene scene = SupermapGIS.Instance.Realspace.SceneControl.Scene;//获取场景
//获取图层管理器里所有图层
List<LayerInfo> layerInfos = SupermapGIS.Instance.Layers.LayerInfos;
for (int i = 0; i < layerInfos.Count; i++)
{
//遍历获取图层管理器里每个图层
Layer3D layer3D = layerInfos[i].Layer as Layer3D;
if (layer3D.Type == Layer3DType.S3M)
{
//获取S3M缓存图层
if (layer3D.Name.Contains("Water"))
{
//Vector3 pos = new Vector3();
var bounds = layer3D.Bounds;
pos = new Vector3((float)bounds.Center.x,(float)bounds.Center.y, 2000);
CameraState state = new CameraState(pos.x, pos.y, pos.z, 0, 0, 0);
SupermapGIS.Instance.Realspace.SceneControl.Scene.Fly(state, 4000);
};
}
}
4.3 飞行定位到指定坐标位置
CameraState state = new CameraState(114, 39, 4000, 0, 0, 0);
SupermapGIS.Instance.Realspace.SceneControl.Scene.Fly(state, 4000);
4.4 点击模型获取属性
Realspace = new RealspaceView();
Scene scene = SupermapGIS.Instance.Realspace.SceneControl.Scene;//获取场景
//获取图层管理器里所有图层
List<LayerInfo> layerInfos = SupermapGIS.Instance.Layers.LayerInfos;
for (int i = 0; i < layerInfos.Count; i++)
{
//遍历获取图层管理器里每个图层
Layer3D layer3D = layerInfos[i].Layer as Layer3D;
if (layer3D.Type == Layer3DType.S3M)
{
//获取S3M缓存图层
if (layer3D.Name.Contains("Building"))
{
Selection3D selection = layer3D.Selection;
int id = selection.LastSelectID;
Layer3DS3MFile layer3DS3MFile = layerInfos[i].Layer as Layer3DS3MFile;//获取S3M缓存图层
var selectID = layer3DS3MFile.GetAllFieldValue(id);
foreach (var element in selectID) //element的类型与mList声明时一样
{
Debug.Log(element); //输出属性
};
}
}
}
4.5 修改图层风格
if (s3mLayer != null && s3mLayer.Type == Layer3DType.S3M && s3mLayer.Name.Contains("矢量面")){
//设置初始风格
Style3D style = s3mLayer.Style;
style.FillColor = new Color(1, 0.4f, 0, 0.5f); //矢量面黄色填充
style.LineColor = new Color(1.0f, 0.0f, 0.0f, 1.0f);//矢量面绿框
style.AltitudeMode = AltitudeMode.ClampToGround; //矢量面贴地
s3mLayer.Style = style;
//设置选中风格
Style3D selectstyle = s3mLayer.SelectStyle;
selectstyle.FillColor = new Color(0.0f, 0.0f, 1.0f, 0.5f); //矢量面选中时红色填充
selectstyle.AltitudeMode = AltitudeMode.ClampToGround;
s3mLayer.SelectStyle = selectstyle;
s3mLayer.UpdateData();
}else if (s3mLayer != null && s3mLayer.Type == Layer3DType.S3M && s3mLayer.Name.Contains("倾斜")){
s3mLayer.ClampVector = true; //矢量面贴倾斜、模型图层
s3mLayer.MinVisibleAltitude = 2000; //设置图层最小可见距离
s3mLayer.MaxVisibleAltitude = 50000; //设置图层最大可见距离
}
到了这里，关于SuperMap Hi-Fi 3D SDK for Unity基础开发教程的文章就介绍完了。如果您还想了解更多内容，请在右上角搜索TOY模板网以前的文章或继续浏览下面的相关文章，希望大家以后多多支持TOY模板网！
