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

发布时间:2023年12月22日

作者:kele

一、背景

众所周知,游戏引擎(Unity)功能强大,可以做出很多炫酷的游戏和动画效果,这部分功能的实现往往不仅仅是靠可视化界面就能够实现的,还需要代码开发。SuperMap Hi-Fi SDKS for Unity游戏引擎插件能够实现地理数据与游戏引擎相结合,碰撞出更绚烂的火花,目前SuperMap Hi-Fi SDKS for Unity插件集成了许多可视化界面操作功能,但是在正式的开发环境中,往往不太能满足客户对于功能入口、界面UI的个性化需求,所以这部分功能的实现需要用到代码开发。

二、开发准备

2.1 开发软件下载

产品推荐版本介绍下载地址
Unity Hub3.3.1 - c2(最新版即可)使用 Unity Hub 可以更方便地创建、打开、管理和更新 Unity 项目1、 项目管理:Unity Hub 支持创建、打开和管理Unity项目2、 引擎管理:Unity Hub 能够同时安装和管理多个Unity引擎版本3、 社区资源:Unity Hub 提供了一个集中的位置,让用户可以轻松访问 Unity 社区资源https://unity.cn/releases
Unity2019.4.39 f1c1游戏引擎软件,可通过官网下载或者通过Unity Hub 下载(如果需要打包到 WebGL ,必须使用2019版本)https://unity.cn/releases
Visual Studio2019开发工具,用于 Unity 二次开发https://visualstudio.microsoft.com/zh-hans/downloads
SuperMap Hi-Fi 3D SDK for Unity11.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;  //设置图层最大可见距离
}
文章来源:https://blog.csdn.net/supermapsupport/article/details/135153707
本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。