在实际应用中，有哪些成功案例可以为用户提供参考？

[digihail123]

数字冰雹深耕数字孪生领域十余年，在智慧城市、智慧园区、智慧警务、智慧应急、智慧水利、智能制造、航天军工等领域落地项目千余个，覆盖二十余个行业，具备丰富的项目实施经验和技术积累，可以根据您的项目所属行业和应用需求提供全方位的参考和建议。

您可以访问图观实际成功案例栏目：https://www.tuguan.net/case/case.html 了解您关心的行业案例，如果您感兴趣，可以联系我们为您做详细的演示和介绍。

您还可以 图观在线体验栏目，
（1）访问：https://www.tuguan.net/online-experience/code-sandbox.html 查阅API代码开发相关功能范例和应用案例
（2）访问：https://www.tuguan.net/online-experience/features-example.html 查阅场景特性相关功能范例和应用案例
（3）访问：https://www.tuguan.net/online-experience/application-configuration.html 查阅APP应用配置相关的功能范例和应用案例
（4）访问：https://www.tuguan.net/online-experience/application-example.html 查阅图观行业应用案例

下面，我们以智慧园区应用案例，为您简单介绍一下如何使用图观产品。

众所周知，数字冰雹深耕行业数字孪生十余年，历经上百个智慧园区项目建设，对园区类项目需求有着深入理解。在新型智慧园区系统建设趋势下，数字冰雹一线项目交付团队经过认真研究评估和总结，向图观产品研发团队提出了升级“智慧园区数字孪生运维系统”的需求，在原有智慧园区数字孪生系统功能的基础上：

• 升级园区底座的效果：打造三维实景园区，厘米级精度，高拟真实时天气系统等；

• 丰富系统的孪生功能：结合业务交互功能需求，实现全要素对象管理、便捷剖分楼宇、设备反控、虚拟漫游等数十项通用功能；

• 扩充业务分析模型：围绕安防、能耗、通行、环境空间几大业务场景，增加能耗分析、温度云图、应急疏散、人员热力、告警特效等数十项业务分析图层。

传统开发模式下，要实现以上的功能需求，需要大量的人力进行复杂三维图形图像代码开发，开发人员可能还需要掌握C++等复杂三维开发语言，技术门槛高、制作周期长、效率低，系统最终效果还无法保证。

基于图观引擎，系统升级实现了超高效率的开发体验和惊艳的运行效果。

整个智慧园区数字孪生系统的构建，我们简单拆分为三个层级：
1.实景三维底座层
2.数字孪生功能层
3.业务分析视图层
对于数字孪生运维系统来讲，精细化的孪生底座是基础，满足园区运维管理功能、对园区各复杂业务场景的支撑，才是系统建设的重中之重，因此，在本系统的开发工作中，我们着重使用了图观统一开发API。

‍
图观统一开发API，针对典型业务开发所需接口都进行了良好封装，提供数百项实战化 Javascript开发接口，兼容当前主流的 JavaScript 前端框架，开发人员无需额外学习复杂的三维图形图像开发技术，也无需掌握 C++等三维开发语言，仅需要了解Javascript即可快速上手开发。开发者无需再进行每项功能的代码编写，直接引用代码范例，在配套调试工具中进行低代码修改测试，即可便捷进行复杂功能的扩展开发，大幅降低开发门槛和技术难度。

一、实景三维园区底座构建

1.场景构建

数字冰雹建模师团队前期使用图观引擎，基于原始粗糙模型数据，自动生成精细化建筑、道路、植被、水域、部件设施等海量要素对象，构建了50万平方米范围的实景三维数字孪生园区底座，实现了厘米级高精度实时渲染、孪生园区真实复现。

2. 场景服务发布调用

场景底座基于流渲染架构构建，通过使用图观流渲染场景服务，实现场景服务便捷迁移和部署，采用视频串流技术将高性能三维渲染画面实时传送给用户，突破终端限制，用户无需安装下载任何内容，通过任意现代网络浏览器即可访问高质量数字孪生应用，并支持终端用户和云端应用的实时交互，便捷进行后续二次开发工作。

二、图观统一开发API 孪生功能开发

数字冰雹基于上百个智慧园区项目实践经验和技术积累，总结出一套适用于园区运维管理业务逻辑的数字孪生功能API接口范例，可以满足园区复杂业务场景的功能应用需求，灵活适配各类智慧园区应用构建。

还可配合图观统一API调试器，帮助您省去使用程序开发IDE搭建环境、运行程序的繁琐步骤，基于统一开发API示例代码，在线轻松测试图观已经发布的场景服务、标绘点/线/面数据、生成模拟代码，操作所见所见即所得，助您快速掌握开发技能。

1.全要素对象管理：可查询、可聚焦、可高亮

园区运维管理涉及繁杂的要素对象，硬件基础设施分布广、设备管线众多、故障告警事件分散…开发智慧园区数字孪生运维系统，首先就是要实现将园区内海量的要素对象进行集中管理，并能够在数字孪生场景中进行一一映射。

图观统一开发API内置单体模型对象查看、聚焦、高亮全套代码范例，这里我们简单给大家介绍一下对象管理开发过程中会用到的一些方法指令：

图观统一开发API中，对象查看可通过单选、框选等多种方式。对象单选使用'pickOverlay'方法，对象框选使用'selectOverlay'方法；对于对象聚焦，通常有聚焦图层'focusById'、聚焦类别图层'focusByType'、聚焦图层子图层'focusByLayer'、聚焦模型'focusModel'、聚焦建筑‘focusBuilding’等多种方法指令，可以结合业务需要灵活调用；如果想要实现建筑高亮的效果，则使用'highlightBuilding'方法即可实现。

结合园区建筑、内部结构、楼层、房间、设备、管线、构件台账，以列表管理的方式 或是 在场景中进行单选/框选多种查看方式，对全域要素均进行精准定位、搜索。如：通过对象管理列表，可以一键精准定位单体设备的位置，查看其运行状态；或是一键定位告警事件、查看事件详情，便于管理者进行事件处置。

2. 建筑结构自由剖分

在园区类的数字孪生应用中，除了整个园区外观的宏观展示，往往还需要查看建筑内部的场景，因此图观统一开发API也将这一需求整合进产品功能中。

图观统一开发API提供了获取建筑、剖分建筑、恢复建筑等全面的代码范例。使用'getBuildings'方法可以获取场景中的建筑对象；使用'showBuildingFloor'方法可以将选定建筑拆解剖分；使用'resetBuildingFloor'方法可以恢复剖分开的建筑；建筑自由剖分使用'setModelClipping'、'clearModelClipping'接口方法；展开建筑楼层使用'expandBuildingFloor'方法。
更多方法指令可在图观官网地址：http://www.tuguan.net/doc/tg-api/?manual.model.building.operation 中查阅。

通过调用相应方法指令，可以便捷地实现任意建筑的自由剖分，如：建筑三轴向自由剖分、楼层组的上卷下钻、单个楼层剖分等功能，便于用户查看建筑结构与建筑室内态势。

3. 设备反控

得益于图观强大的功能，数字冰雹“智慧园区数字孪生运维系统”，已经实现了从“好看”到“可控”再到“孪生世界与物理世界交互控制”的进阶，系统不仅可以实时反映物理园区的实时运行数据，还更能够反过来控制实体对象，发送控制指令。

图观统一开发API提供了模型关节控制相关的丰富接口代码范例。关节控制需要先使用'getModelArticulation'方法获取模型关节，之后使用'setModelArticulation'设置三维场景中模型关节数据，使用'setModelAnimation'方法设置模型动画。

这里我们简单给大家介绍了几个常用的方法，更多方法指令可在图观官网地址：
http://www.tuguan.net/doc/tg-api/?manual.model.default.operation 查阅。

在园区数字孪生系统中，像闸机这类单体模型对象，通过调用关节控制代码范例，结合业务逻辑简单修改模型的属性参数，即可轻松实现闸机抬杆、闸机关闭等指令控制效果。园区照明系统控制、设备开关控制等功能也同样适用。

4. 沉浸式 数字孪生虚拟漫游

基于数字孪生技术构建的智慧园区运维系统，最突出的优势在于超高精细度、高写实度的场景还原，在此基础上，图观 引擎提供了路径漫游、飞行漫游、步行漫游等多种沉浸式场景游历方式，可便捷进行园区全方位展示、业务巡检。

对于场景漫游这一功能，图观统一开发API提供了丰富的摄像机漫游接口，包括：获取镜头视界、设置镜头视界、限制镜头视界、设置漫游镜头、路径移动镜头、环绕旋转镜头、模型跟随镜头等。

在配置漫游镜头之前，我们可以做一些基本的场景镜头配置。
获取镜头视界，就是获取当前场景的镜头基本参数，调用的是'getCameraInfo'方法。设置镜头视界使用'setCamera'方法，然后传入视角的设置参数即可；限制镜头视界需要调用2个方法，第一个是'restrictCamera'方法，这个方法是限制镜头视野的参数，另外还要开启'setCameraRestrictionState'视野限制状态。

通过使用'roamingCamera'方法来开启镜头漫游。通过'setCameraRoamingState'方法来进行镜头漫游的暂停、继续和停止移动。路径移动镜头是在场景中先添加一个路径，当我们开启路径移动镜头之后，这个镜头会按照路径规划的顺序来实现镜头的移动，通过调用'pathingCamera'方法，就可以实现开启路径移动镜头。当然，在统一开发API中还内置了更多的漫游方式，

通过调用接口范例，用户可以在实景园区场景中自由漫游；也可以设若干漫游控制点位形成漫游路径，实现基于自定义路径的虚拟漫游；或是设定模型跟随镜头，实现镜头跟随移动模型进行移动的漫游功能。

5. 与真实世界同步 的 全拟真 气象环境模拟

一个真实有质感的数字孪生园区场景，逼真的24小时光照、天气、四季变化效果是必不可少的。图观统一开发API内置了丰富的天气、光照、环境效果代码范例，可以通过统一API调试器便捷测试天气效果。

使用'setEnvWeather'方法可以设置天气效果、使用'setEnvTime'方法设置时间，可以修改不同时间段的场景光照效果。具体的天气效果参数可以参看文档：https://www.tuguan.net/doc/tg-api/?manual.global.specialControl.operation

开发人员无需掌握复杂的天气系统渲染计算方法和技术，只需要使用调用对应的指令参数，就可以快速实现对园区季节（春、夏、秋、冬）、时间（早晨、中午、黄昏、夜晚）、天气（晴天、降雪、降雨、多云、雾霾）进行自由切换。同时也可通过与天气系统对接，实现环境模拟内容根据实际天气数据进行自动切换。通过组合代码，还可实现多种效果组合，如：冬季清晨薄雾效果、夏季夜晚灯光效果等，轻松为数字孪生场景增色。

三、业务分析视图开发

1. 分析图层开发

围绕 “园区态势、安防态势、便捷通行、能耗管理、环境空间”等运维管理业务分析应用场景，图观统一开发API提供了数十种物理空间和逻辑空间数据分析图层接口，如地标点、路径图、区域图、气泡图、热力图、事件图等。配合图观统一API调试器，可以便捷配置、调试图层效果。

通过接入园区运行数据，结合可视分析视图，可实现园区水/电/供暖空间可视分析、人员热力分析、温度云图、应急疏散、人员轨迹分析等数十种场景的研判分析。

2. 分析图表配置

对于页面分析图表的开发，除了可以完全使用Javascript代码二次开发，亦可以使用图观应用编辑器，零代码完成图表控件配置、场景服务调用、复杂交互配置等功能操作。

附：

关于图观统一开发API的全套开发文档，可以在图观官网地址：

https://www.tuguan.net/doc/tg-api/?manual.global.application.operation 中查阅。

图观全流程工具的教程视频，可以在图观官网地址：

https://www.tuguan.net/development-tutorial/video-tutorial.html?video=primary 中查阅。

数字冰雹图观引擎已广泛应用于城市、园区、交通、建筑、设备等全要素数字孪生应用的构建和管理，利用图观统一开发API，可以完全释放图观场景的二次开发能力，就能够快速搭建一个效果非凡、功能丰富的数字孪生应用。