SuperMap Hi-Fi 3D SDK for Unity基础开发教程

作者：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和自己创建的项目相关联，具体操作如下图所示：

3.5 运行结果

四、功能开发示例

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;  //设置图层最大可见距离
}