图观产品问答

一、程序安装

1.程序说明

流渲染服务器安装时，对数据库提供两种方式安装：集成安装和独立安装。若用户本地没有数据库，则可选择集成安装；如果用户本地已有 MySQL 或 Microsoft SQLServer，可选择独立安装；

二、项目管理

项目管理包含新建项目、编辑项目、删除项目、添加新版本、修改版本、删除版本、用当前项目版本创建场景等功能。

项目就是为场景提供项目程序文件的，项目就是场景的基础，有了项目，场景才可以被创建。

1.项目列表

2.版本管理

功能截图：

功能描述：

1.一个项目可以对应多个版本，可以记录每次版本的信息的改动，直观的显示版本更新的过程，保留住每次版本的文件。

2.项目程序：项目程序是供场景选择使用的，在场景中配置好选择的项目，启动场景运行的就是此项目程序

三、场景管理

场景管理包含流渲染场景的新建、删除、场景 Token 的查看与复制、场景预览以及预览用户的断开等功能。

1.场景列表

2.场景属性

功能截图：

3.Token管理

功能描述：

3.1Token：Token 就相当于打开场景的钥匙，首先要对 Token 进行验证，只有 Token 验证通过，才可以对场景进行预览操作。

3.2复制 Token：当管理员分配给用户使用时，就可以把这个 Token 发送给用户，然后用户就可以通过这个 Token 完成对场景的预览操作了

3.3更新 Token：当管理员不想让那个现有用户使用了，就可以更新 Token，然后再分发新的 Token，让拥有新 Token 的用户继续使用

3.4暂停使用：如果管理员不想这个场景被使用，就可以暂停使用，这样这个场景就不可以被访问了，访问的用户也会被退出

3.5过期时间设置：设置 token 的有效期，到期后会自动更新 token

4.场景预览

功能截图：

5.查看和断开连接

管理员可以在此页面上看到当前使用该场景的用户 IP。当管理员不希望某个用户预览这个场景，就可以踢出该用户，让其断开连接。

四、预热驻留

1.界面概览

2.通道使用状态查看

这个功能可以很直观的查看当前服务器的通道使用情况，合理使用服务器资源。

3.设置预热数量

预热场景：可以将一个或多个场景设置为预热状态,预热状态下场景将在后台启动并持续运行，当有用户预览时，如果存在未使用的预热的场景，将直接与该场景建立连接，不需要等待场景的启动时间，在场景较大时，可以节省数十秒的启动时间。

五、操作日志管理

操作日志查看

六、渲染设置

渲染设置

在渲染设置界面中，可以显示显卡列表和设置标准通道数，重启服务和重启设备的功能

七、系统设置

1.界面概览

2.启用场景预览页面

可以勾选开启场景预览页面。开启后，启用 9090 端口的前端预览页面。该页面不需要用户登录即可访问场景。

3.Https设置

在这一模块，可以将流渲染服务转换为 https 的安全访问。提供本地证书供测试使用，也支持证书与私钥的上传。

4.端口号设置

在这一模块，可以修改流渲染服务的前端和后端端口。后端端口指的是当前使用的管理平台访问端口，前端端口是 API 调用端口与场景预览页面端口。

5.中继服务

由于 NAT 和防火墙的存在, 在公有云或者复杂网络环境下，客户端浏览器可能无法正常接收流渲染服务传输的视频流。这时需要使用中继服务进行视频流的转发，使视频流可以正常传输到客户端。

6.数据服务

开启内置的数据服务，数据服务为 TGAPI 提供了数据聚合、数据筛选、周边查找 以及大数据传输等功能，并且每个通道的数据独立，当某个通道结束访问后，数据会自动清除。

7.日志定时清理

日志定时清理：定时清除服务器上的日志文件，包含服务自身和项目运行日志文件 。

详见图观官网：https://www.tuguan.net/doc/streaming-server/?features.install

一、图观统一开发API概述

图观统一开发 API 是一套基于 JavaScript 语言开发的二次编程接口，用于在现代浏览器中加载、显示图观引擎提供的流渲染或端渲染三维场景，并且为开发者提供在场景中绘制业务数据、触发场景交互、控制场景逻辑的功能。图观统一开发 API 兼容当前主流的 JavaScript 前端框架，例如 Vue.js 或者 React，前端开发人员可快速便捷的进行二次开发。

1. 双渲染技术架构

图观的渲染核心有流渲染和端渲染两种。对于TGAPI的二次开发接口是一致的。这里简单介绍两种渲染核心的技术架构。

流渲染

图观 流渲染开发架构，是基于实时云渲染（ GPU 云化）、视频串流等技术，整合推出可视化数字孪生流渲染解决方案技术支撑体系，涵盖：流渲染服务平台、流渲染二次开发等技术产品，为大规模场景渲染在轻量化终端上的呈现提供技术保障。

流渲染系统架构如下图所示:

端渲染

图观 端渲染开发架构，是基于 HTML5 和 WebGL 技术，整合推出的数字孪生端渲染技术支撑体系，涵盖端渲染场景编辑器、端渲染服务平台、端渲染二次开发等技术产品，覆盖数字孪生应用开发的全生命周期，提供简便、快捷、强大的数字孪生应用运行和开发平台。

端渲染系统架构如下图所示:

2. 图观引擎场景和二次开发效果速览

流渲染效果速览

端渲染效果速览

3.TGAPI接口体系

TGAPI 3.3正式发布的版本，共有接口总数500多个，其中方法数量200多个、事件数量300多个。

4.TGAPI方法指令范式

TGAPI除了构造应用使用的new TGApp.app()和初始化服务appInstance.initService()两个接口以外，都是使用appInstance.uniCall(action, parameter, callback)方法来调用的，第一个参数为指令名称，第二个参数为指令参数，第三个参数为回调函数。

5.TGAPI指令回调结果

每个uniCall的指令调用，在第三个参数都包括一个callback回调函数。回调函数的结果，通过一个Object类型的对象返回。

6. TGAPI事件订阅

如上方提到的，TGAPI的事件订阅指令为addEventListener, 参数对象中包括了eventName和一个回调函数callback，其中eventName是需要监听的事件，callback为事件触发时执行的方法。同一个事件，可以监听多次，执行不同的方法。

对应的，取消事件订阅指令为removeEventListener，可以移除指定事件和回调函数的对应关系。

在图观统一开发API中，事件的总数量甚至是比接口指令的数量都要多。掌握好事件监听，能够接收和处理事件的回调消息，对于二次开发好一个应用具有特别重要的意义。特别是对于需要和场景进行交互，感知场景状态，获得场景中无接口调用信息，通过场景触发或者用户交互触发的消息的功能开发。在后面还会详细说到一些事件的具体用法。

二、统一接口调试器

在本章教程中，我们主要讲解图观统一开发API的辅助调试工具图观统一接口调试器。

1.接口调试器优势

图观统一接口调试器主要有以下功能优势：

• 图观统一接口调试器内置了一套最新的图观统一开发API，全部的代码可以脱离接口调试器，在TGAPI SDK中单独运行。

• 可以帮助开发者省去使用程序开发IDE搭建环境、运行程序的繁琐步骤，在线轻松的测试图观已经发布的场景。

• 内置大量的TGAPI标准功能测试代码，可以在您的场景中默认执行。其代码片段亦可作为您的开发手册进行查阅，并复制到您的工程代码中。

• 提供绘制功能，可以在加载的图观场景中标绘点、线、面数据，获得基于场景真实坐标，并且导出数据。

• 提供生成模拟代码功能，可以根据您的标绘点线面数据，生成模拟的图观统一开发API中的图层数据，生成代码。解决您在没有真实数据时，开发项目需要生成模拟数据的苦恼。

• 综合测试功能可以保存您的测试代码，或者生成的模拟代码，以备后续调用。

2.创建调试场景

2.1预先条件

如果您准备使用图观统一接口调试器加载练习场景，需要具备以下硬件和软件的条件。

硬件

8G内存，有独立显卡，NVIDIA GTX 960及以上的笔记本或者台式机。

软件

操作系统：Windows，MacOS，Linux均可
推荐使用Google Chrome 浏览器，版本88及以上（2021年1月之后版本），或者Microsoft Edge 版本88及以上、360浏览器版本13及以上
如需查看自己的Google Chrome浏览器版本，您可以在浏览器地址栏中输入 chrome://settings/help，或者点击菜单 -> 设置 -> 关于Chrome

2.2登录图观打开接口调试器

打开谷歌浏览器，输入图观网址https://www.tuguan.net并访问，我们就进到了图观的官网点击官网导航栏右侧的 登录 按钮，看到了登录界面，输入已开通好的账号和密码后点击 登录。进到了图观业务管理界面，在“我的业务”中有“租户服务”、“端渲染场景服务”、“接口调试器服务”、“应用编辑器服务”4种服务，我们选择“接口调试器服务”点击 前往 按钮。

进入接口调试器首页

2.3 接口调试器首页介绍

进入到接口调试器的首页页面， 页面左侧是 场景管理列表，在这里我们可以对我们所有场景进行分类整理，便于我们后续查找。中间Tab栏切换 工作台 和 案例库，工作台 可新建场景并展示所有已创建场景；案例库 中的案例可以进行预览到导入到自己的工作台。页面右上显示公告，帮助及用户设置。

2.4.创景场景“智慧社区”

点击“新建场景”，将会弹出“新建场景”对话框。

场景类别选择默认“端渲染”，场景名称中输入中文名称“智慧社区”，场景链接输入https://www.tuguan.net/api/sceneEditor/v1/scenes/ed402a51-a00a-48f2-8b60-f51963440e82/loadAVWS，点击“确定”按钮即可完成项目的创建。

鼠标悬停在场景面板上可以唤醒隐藏的功能菜单，我们可以对该场景进行“重命名”、“移动”、“复制”、“删除”。现在我们点击 编辑 按钮，打开该场景。

2.5.场景首页介绍

进入场景首页后，可以看到：

界面上方是“单体测试”和“综合测试”切换按钮。

2.6 单体测试功能介绍

2.6.1单体测试介绍

在单体测试中，界面主要位置显示的是需要调试的三维场景，场景上叠加有工具栏，工具栏的功能后续会有相应介绍。

2.6.2. 使用场景对象

在场景对象中，如果您选中了一个模型节点，将会在“模型”代码执行的时候使用这个模型ID。

2.6.3. 使用图层对象

如果场景已经设置好了基准点，对应了场景和经纬度信息，在图层对象中的所有图层测试数据都会自动围绕着这个场景中心点的经纬度来模拟生成。

在全局对象中选中“其他控制”，点击“获取当前基准位置”，并执行代码，可以在下方看到本场景已经设置了经纬度基准点，如果所示。

2.7绘制和模拟生成代码

在二次开发场景过程中，会经常遇上在场景内获得点位、镜头信息甚至是生成模拟数据的需求，这些在接口调试器中都有对应的功能。

2.7.1.获取场景点位和镜头信息

如果只是获取单个点位和镜头信息，最快速的方法是使用工具栏的【获取经纬度】和【获取当前视角参数】功能。

2.7.2 绘制

工具栏上的第三个和第四个按钮，是非常重要的功能，这里先介绍第三个 绘制 按钮。

进入到绘制功能之前，请先使用 设置 功能，进入 标绘设置 确认路线和区域的设置，特别是路线宽度和围栏高度，这个数值的单位都是米。在不同大小的场景下，请确保这个数值不会过大或者过小造成看不到的问题。

请按照如图所示设置数值，并点击 确定。

区域绘制

添加

编辑

在三维场景中或者区域列表中，单击一个已经绘制好的区域，可以进入到编辑状态。这时，您可以通过 平移交互轴 调整整个区域位置。通过加号图标在区域上添加一个新的关键点。

2.7.3生成模拟代码

工具栏上的第四个按钮，是非常重要的 生成模拟代码 功能。点击这个按钮，会弹出 生成模拟代码 对话框。

对话框分为三个Tab页签，分别是“图层”， “模型/特效”和“视点”。每个Tab页签下方可以选择更加具体的代码类型，点击右侧的“加号”按钮，可以生成对应类型的模拟代码。

选中 图层 Tab页签，在图层类型中选择 三维柱图，然后点击“+“按钮。

鼠标悬浮在图层上，可以激活图层操作按钮，如图所示，功能分辨是“修改”，“添加到综合测试”、“定位”和“隐藏”

2.8使用综合测试

在上面最后的步骤中，我们已经来到了 综合测试 页面。

3.使用案例库

在接口调试器中，为您提供了案例库功能。使用案例库，您可以快速浏览接口调试器的场景中的代码执行，并且将您感兴趣的案例导入到自己的工作台中，继续进行参考、编辑。

在接口调试器首页点击案例库。

找到 开发教程卡通版。

点击 预览 按钮，这是打开了接口调试器预览页面。

在新开的浏览器标签页里，左侧综合测试列出来当前场景的接口调试器内置测试代码。

鼠标悬浮在列表项上，可以激活 查看代码 按钮。

点击 查看代码 按钮，在右侧代码面板可以查看测试用例的详细内容。

单击列表项可以执行代码。

返回到之前的案例库页面，找到 开发教程卡通版，鼠标点击 导出 按钮。

在弹出的导出对话框了，选择一个希望导入工作台的节点。一版选择 根节点 也可以。

点击 确定 按钮。

这样案例库的示例工程就会出现在 工作台 对应的节点目录下。打开后，跳转到 综合测试 可以看到示例代码功能。

在本教程后面的章节中，全部的示例代码片段都存在于这个 开发教程卡通版 的案例工程里。所以请您在进行后面课程之前，导入到自己的工作台中。

详细开发教程 详见图观官网：https://www.tuguan.net/doc/tg-api/?tutorial.tutorial_1

图观 零代码 应用编辑器，通过拖拉拽所见即所得的操作，不写一行代码，即可完成简单的 数字孪生 应用开发。支持图表控件配置、场景服务调用、复杂交互配置、应用预览发布等功能。内置丰富的可视化组件、页面模板、全面的可编辑属性，支持二次开发。大幅降低开发门槛，助您便捷构建 简单的数字孪生应用。

首先，我们要了解 数字孪生应用的基础概念和软硬件环境准备

第一节 数字孪生应用的重要基本概念

首先呢，和大家说明一下在数字孪生应用中经常遇到的几个重要的基本概念，“APP”、“页面”、“场景”、“状态”

APP：是指构建的数字孪生应用程序，也可以理解为是一个项目。

页面：是指容纳一切用户关注业务内容的载体，在某些可视化系统中也称为主题。

场景：在这里是指由场景编辑器发布的场景，该场景可以被应用编辑器调用。图观应用编辑器即支持端渲染场景也支持流渲染场景。

状态：是指三维场景通过场景编辑器预设或者手动调整后，针对场景模型属性、视野范围、摄像机参数、光照参数等一系列参数产生的“快照”。

如图所示，一个数字孪生应用是由多个页面构成的，每个页面可以加载一个或多个三维场景，每个场景呢又涵盖了多个状态，因此，原则上每个页面都可以关联多个状态，并可以通过交互切换场景的各个状态。

第二节 图观应用编辑器的功能简介

在了解了以上的基本概念后呢，我们要来介绍一下图观应用编辑器了，当前我们看到的这个界面就是应用编辑器的主界面了。

我们可以看见界面上方tab栏显示“工作台”和“资产库”，默认是选中了“工作台”，左侧是项目的文件夹管理列表，中间显示已创建的项目，点击“新建可视化项目”可进行项目的创建。

资产库
点击“资产库”按钮，界面就可以进行切换显示，左侧是资产库列表，分为系统资产和租户资产两大类，中间显示选择的资产内容。系统资产就是我们编辑器自带的资产内容，租户资产是用户根据自己意愿将已做好的项目中的页面、组件、图片、场景等点击“导入资产”按钮后的资产内容，在此处进行显示内容。

组件编辑
点击进入“组件编辑”页签，左侧是组件管理列表，中间显示已添加的组件。组件也称为“卡片”，是一组可视化要素的集合，常用于制作复用的业务卡片或者弹出面板。点击“新建组件”可进行组件的创建。

参数编辑
点击进入“参数编辑”页签，如果当孪生应用涉及的图表之间的数据联动交互，可通过“参数编辑”功能来设置图表的参数进而实现多个图表的数据关联。

图片素材
点击进入“图片素材”页签，左侧是图片素材管理列表，中间显示已添加的图片素材，图片素材用来上传孪生场景中涉及的图片内容，支持添加本地图片和在线图片两种方式，添加完成的图片素材，在页面编辑下方的“本项目-图片”中显示，可在拖拽到画布中进行设置。

第三节 "智慧社区运营中心"成果案例展示

现在大家在屏幕中看到的这个案例，就是我们要给大家分享演示的，基于图观应用编辑器做出的数字孪生应用：“智慧社区运营中心”。

第四节 软件和硬件的环境准备

在2K分辨率场景下推荐使用NVIDIA GTX 1660或以上级别独立显卡，在4K分辨率场景下推荐使用NVIDIA RTX2070或以上级别独立显卡。如果硬件显卡达不到这个级别，也可以通过场景设置，在应用编辑器的编辑状态不加载三维模型，或者保持模型大小不超过50兆一般也是可以使用的。

如果主机或笔记本是双显卡，或者一个主板整合显卡一个独立显卡的情况，默认浏览器可能调用的是主板整合显卡，而不是性能更强劲的独立显卡。就需要正确的配置操作系统、显卡驱动和浏览器设置，让独立显卡在浏览器中起作用。
详见以下网址：http://show.tuguan.net/xksz

针对软件环境推荐使用Windows10操作系统，浏览器使用谷歌Chrome浏览器，并升级到最新版。

如果在加载三维场景的时候卡在0%或者99%，大多数情况是因为浏览器不支持或者浏览器版本太低导致对WebGL的支持不全面。所以如果遇到这种情况，请先检查浏览器和版本。

第五节 获取“智慧社区配套素材”

本教程指南以构建“智慧社区运营中心”数字孪生应用为例，小伙伴首先需通过以下三种方式获取“智慧社区配套素材”。
1、百度网盘获取

2、添加图观客服微信获取

3、输入网址直接获取：https://show.tuguan.net/tutorial/zhsqcjb

第二章 快速搭建并发布第一个数字孪生应用

第一节 图观登录，选择应用编辑器进入

首先我们打开谷歌浏览器，输入图观网址https://www.tuguan.net 并访问，然后我们就进到了图观的官网。

如果第一次访问图观，首先需要注册一个账户，可以添加图观客服微信索取邀请码。填写邀请码和基本信息后，就开通了图观的账号。

点击官网导航栏右侧的【登录】按钮，就看到了登录界面，输入已开通好的账号和密码后点击【登录】，我们就进到了图观业务管理界面，能看到在“我的业务”中有“租户服务”、“端渲染场景服务”、“接口调试器服务”、“应用编辑器服务”4种服务，我们选择“应用编辑器服务”点击【前往】按钮，这样我们就进入到了应用编辑器的首页了。

创建新应用：在应用编辑器中，您可以选择创建新应用。通常，您需要为新应用提供一个名称，并选择一个应用模板（如果有的话）。应用模板可以帮助您快速搭建一个基本的应用结构。

编辑界面和布局：应用编辑器提供了可视化的界面编辑功能，您可以通过拖拽组件、调整布局和设置样式来设计应用的界面。编辑器中通常会包含一些预定义的组件，如按钮、文本框、图表等，您可以根据需要添加到应用中。

配置组件属性：每个组件都有一些可配置的属性，如颜色、尺寸、数据绑定等。您可以通过编辑器的属性面板来设置这些属性，实现组件的个性化定制。

添加交互逻辑：应用编辑器通常提供了一种简化的编程方式，如图形化编程或低代码编程，让您可以在不编写复杂数字孪生代码的情况下实现应用的交互逻辑。您可以通过这些方式为组件添加事件处理器，如按钮点击、滑块拖动等。

预览和测试：在编辑过程中，您可以随时预览和测试应用的效果。这有助于您发现潜在的问题并及时进行调整。

保存和发布：完成编辑后，您可以保存应用并将其发布到平台上。发布后的应用可以与数字孪生模型和数据进行集成，为您的业务提供支持。

总之，使用应用编辑器需要进行以下步骤：登录平台、打开应用编辑器、创建新应用、编辑界面和布局、配置组件属性、添加交互逻辑、预览和测试、保存和发布。通过这些步骤，您可以在数字孪生开发平台上轻松创建和编辑应用程序。

详细的开发教程 见图观官网：https://www.tuguan.net/doc/application-editor/?tutorial.concept

首先我们来了解一下跟 图观 端渲染场景编辑器相关的 基础概念。

首先什么是【端渲染】

端渲染是指在Web应用程序中基于客户端浏览器本身能力也就是HTML5 和 WebGL 技术，实时渲染三维场景的技术方案。适用于中小场景，优点是对服务器负担小，支持高并发，带宽要求低。场景构建过程所见即所得，大大降低技术门槛，节省在数字孪生项目中的升级改造成本。但是，渲染依赖客户端显卡配置，如果场景过大或者显卡配置过低，都可能会导致场景运行卡顿。

使用端渲染场景编辑器，对电脑的配置要求是：需要有独立显卡，在2K分辨率场景下建议配置为英伟达 GTX 1660以上级别，在4K分辨率场景下建议配置为英伟达 RTX2070或以上级别。如果您的显卡配置没有达到推荐配置，场景编辑器也是可以正常打开的。本次课程用到的模型资产也可以使用内置的卡通模型替代。只是或者导入的模型尽量控制在50兆以内一般也是可以的。

那么什么是【数字孪生场景】

数字孪生场景直观的讲，就是数字孪生应用中的三维场景部分。

场景由一个或多个模型组成，除模型外场景中还包含灯光、特效、图片等。模型则包含节点、材质、以及对应的关节、动画信息。同一个数字孪生场景可以配置多个不同的效果参数及镜头信息，从而形成多个场景状态，方便在应用开发中快速调用切换。

图观【场景编辑器】是一款基于浏览器运行的编辑器软件产品，只需要在网页浏览器中通过鼠标拖拽和调整效果参数，就可以快速完成三维场景构建，并且实现超凡的渲染效果。场景配置完成后，可一键发布为云服务，支持网页浏览和程序二次开发调用。

功能简介

图观场景编辑器的主要功能包括场景编辑、模型编辑、状态编辑、坐标编辑、以及场景预览和发布。其中场景编辑，主要是用来使用模型组合场景，同时配置场景灯光、特效等参数。

模型编辑，主要用来调整单个模型的节点位置、大小、以及材质、关节、动画等。
状态编辑，可以预置一个或多个场景效果快照，从而使数字孪生应用方便地切换显示参数，进而极大的减少场景控制代码量。
坐标编辑，可以通过与地图服务叠加，将三维场景x、y、z坐标与真实世界中的经度、纬度、高度坐标系进行匹配，实现经纬度定位。
图片管理，用来导入和管理场景中用到的图片素材。在场景构建过程中随时可以点击“预览”，查看场景配置效果。配置完成后可以发布为场景服务，供后续应用开发使用。

案例预览

最后我们来预览一下本次课程将要完成的数字孪生场景最终效果。

现在大家看到的，就是基于图观场景编辑器构建的“智慧社区”数字孪生场景，整个场景包含多个状态，例如：全景展示、顶视图、闸机和住宅，我们在闸机状态配置了闸机抬杆的关节动画，在住宅状态配置了建筑楼层剖分效果，场景使用了两个外部模型和多个图观内置模型资产搭建，想要下载模型尝试自己搭建的小伙伴，请扫屏幕上的二维码，关注“图观”微信公众号，回复“智慧社区模型”获取或添加图观客服微信获取。

使用 图观场景编辑器的关键步骤

1.打开 场景编辑器：在平台主页面上，找到端渲染场景编辑器的入口，点击即可进入。

2.创建新场景：在场景编辑器中，您可以选择创建新场景。通常，您需要为新场景提供一个名称。

3.导入模型：在场景编辑器中，您可以导入已有的三维模型，如建筑、设备、地形等。这些模型可以是您自己创建的，也可以从第三方资源库中获取。

4.编辑场景：场景编辑器提供了丰富的模型资源、可视化的编辑功能，您可以通过拖拽、缩放、旋转等操作来调整场景元素的位置和方向。同时，您还可以对场景元素进行分组、隐藏、锁定等操作，以便更方便地管理场景。

注：模型单位最好与图观场景编辑器统一设置为米。建模时尽量减少多边形数量及顶点数。删除物体内部永远不可见的面，减少零碎物体个数。模型材质使用标准材质或者物理材质。格式保存为GLB。

5.配置场景属性：为了让场景更加真实和生动，您可以设置场景的一些属性，如光照、阴影、雾效等。这些属性可以通过编辑器的属性面板进行调整。

6.添加动画和交互：场景编辑器通常支持为场景元素添加动画和交互功能。例如，模型关节数据驱动、运转动画等。

7.预览和测试：在编辑过程中，您可以随时预览和测试场景的效果。这有助于您发现潜在的问题并及时进行调整。

8.保存和发布：完成编辑后，您可以保存场景并将其发布到平台上。发布后的场景可以与数字孪生模型和数据进行集成，为您的业务提供支持。

详细的开发教程 见图观官网
https://www.tuguan.net/doc/scene-editor/?tutorial.overview

一、 产品概述

图观应用服务器，是为基于图观应用编辑器生成的零代码数字孪生应用，提供项目导入、项目管理、项目离线迁移配置、项目访问控制等功能应用的专用软件服务。

二、 产品功能

1. 应用管理

图形化管理界面，操作简单高效；提供数字孪生应用资源导入、多应用一站式托管服务，可自动识别数字孪生应用的层级结构并生成分级导航，实现场景资源的便捷管理。

2. 应用访问控制

支持应用角色统一管理，可一键创建、删除用户角色，并可对每一个页面设置用户角色的浏览权限；支持添加用户，并为用户分配角色信息，可一键开通/关闭用户的浏览权限，无需任何代码开发工作，大幅提升应用管理效率。

3. 访问日志管理

支持访问日志管理，可直观查看应用访问时间、访问用户、用户名称、访问页面等信息，支持一键导出访问日志，可实时掌握用户访问情况。

4. 支持离线部署

针对特定用户需求，提供应用服务器离线部署服务，离线部署版支持导入用户应用数据，并可对数字孪生应用进行自定义分组，充分满足用户需求。

三、 产品优势

1. 便捷高效的应用管理

友好易用的图形化交互界面，零代码开发，操作简单高效，大幅节省场景管理的时间和成本。

2. 稳定高效的运行性能

具备稳定可靠的运行服务能力，场景资源一键性能优化，实现超凡显示性能、高效响应。

3. 数据安全加密

原生满足 Web 应用防火墙管理，保护用户数据隐私；租户数据物理隔离，数据网络传输端到端加密，符合业界专业标准，通过第三方安全实验室测试。

一、 产品概述

图观应用编辑器，是以B/S架构为基础，围绕数字孪生全要素场景，零代码、轻松构建专业级数字孪生应用的专用产品。原生兼容云上云下多源异构数据，具备丰富的可视化组件、便捷的配置管理工具、全面的可定义对象属性、超凡的实时渲染效果，支持二次开发、部署发布等功能，可广泛应用于构建各细分行业的数字孪生解决方案。

二、 实施流程

基于图观应用景编辑器，零代码即可轻松实现数据接入——场景导入——图表配置——交互配置——场景发布一站式应用编辑，帮助开发者轻松驾驭 数字孪生应用开发！实施流程如下：

三、 产品功能

1. 页面创建

支持针对不同应用需求，创建不同的显示页面，提供图形化的页面配置功能，可以自定义页面布局，新建/修改/保存页面布局模式。

2. 场景服务调用

支持全要素场景调用，自由切换 端/流 渲染服务，复用全部应用工程配置，告别无效重复劳动，充分满足不同应用需求。

3. 场景图层编辑

支持在场景中添加多类型数据图层，如地标图、柱图、气泡图、热力图、飞线图、区域图、轨迹图等，将业务数据与孪生场景充分结合，支持用户构建复杂场景应用。

4. 页面图表编辑

内置近百种图表/图层/界面控件，全拖拽式自由页面布局，可配置丰富的样式/数据/交互属性，定制高度个性化的组件样式，支持 BI 式互动数据分析，实现丰富的数据可视化效果。

5. 多源数据接入

强大的数据兼容性，支持多种来源、格式、类型的数据融合接入，支持手工录入/数据库/数据接口/文件上传多种数据对接方式，提供数据源、数量字段、类别字段、经/纬度等数十种编辑选项，可快速将可视化组件属性和数据进行绑定，真正为用户业务应用赋能。

6. 自定义控件接入

支持页面、组件、图层二次开发；提供开发SDK，上传通过审核，即可在应用编辑器中使用，满足特殊定制需求。

7. 页面交互编辑

内置众多交互指令，可灵活配置交互关系，如：地图联动、图表联动、表表联动、关联选中、数据回放、数据筛选、图层控制、建筑剖分等；支持复杂脚本编程；通过简便配置即可实现孪生场景、操作界面、数据图层/图表的复杂交互逻辑。

8. 数字孪生应用预览发布

便捷高效的应用生成配置，一键发布数字孪生云应用，大幅降低部署成本和复杂度，用户可通过浏览器轻松访问；支持私有云部署，灵活应用不同使用情景。

四、 产品优势

1. 轻松接入 多源异构数据

强大的数据兼容性，原生兼容业界各类地理信息数据、倾斜摄影数据、无人机航拍数据、精细建筑结构数据、BIM/CIM数据、传感器数据、城市部件数据等，以及数据库、数据平台、云服务、业务系统、仿真引擎、传感器/视频监控/物联网、模型算法等多源数据，充分满足业务应用需求。

2. 零代码开发，大幅提升开发效率

全拖拉拽式、零代码页面搭建，灵活自定义编辑，通过简单的配置操作即可快速构建出功能强大、效果炫酷的数字孪生应用，有效缩短实施周期，大幅降低开发门槛和成本。

3. 丰富的图表、图层组件，全面的配置属性

内置上百种 图表、图层、界面控件，全面的可配置属性，支持多维关联可交互数据分析、灵活的交互逻辑定制，帮助开发者轻松驾驭 数字孪生应用开发。

4. 灵活扩展，支持自定义控件开发

提供二次开发SDK，可根据实际需求灵活的进行现有控件调整、修改，自定义控件扩充，充分满足用户业务定制需求。

5. 渲染模式自由切换，跨平台适配

原生兼容端渲染/流渲染开发架构，可自由切换 端/流 渲染服务，复用全部应用工程配置，告别无效重复劳动。灵活适配大中小屏演示环境，强大的跨平台发布能力，灵活的云部署方案，既可发布为私有云部署版，也可以发布为公有云在线版，灵活应对不同使用情景。

一、 产品概述

图观统一API调试器，可调用场景编辑器发布的三维场景服务，基于统一开发API示例代码，进行简单修改代码模板，即可快速调试场景交互效果、进行数据标绘与导出等，修改操作所见即所得，可为开发者提供在场景中测试接口、生成数据的能力，助您快速掌握开发技能。

二、 产品功能

1. 场景服务调用

支持集成图观 场景编辑器”生成的全要素场景，内含图观 统一开发API全部接口的示例代码，只需简单修改参数即可对相应接口进行开发调试。

2. 端/流切换

原生支持端/流双渲染架构，一套代码，可兼容相同地理位置的不同场景服务，场景服务自由切换，移植便捷。

3. 单项接口调试

提供完备 API 体系，针对每项接口，可快捷编写控制逻辑、数据绘制代码，点击执行，立即看到结果，所见即所得。

4. 综合接口调试

支持组合 API 调用，调试复杂逻辑代码、编写复杂脚本，实时调试、所见即所得，满足复杂开发需求。

5. 数据标绘和代码数据导出

可在三维场景中 自定义进行点/线/面 标绘，并可基于标绘数据，自动生成数十类 API 调用代码，并支持填充模拟演示数据，有效提高数据绘制效率。

三、 产品优势

1. 上手宝典，全部数百 API 代码模板

提供数百项API 代码模板，并可基于前端开发框架自主进行二次开发扩展，灵活满足各种开发需求。

2. 逻辑代码统一，场景服务自由切换

原生支持端渲染和流渲染服务，使用统一接口调用方式，一套代码，端/流兼容，可兼容相同地理位置的不同场景服务，移植便捷，可复用度高。

3. 实时调试，所见即所得

只需简单修改代码模板，即可实时预览、测试接口编辑效果，点击执行，立即看到结果，易于反复尝试出满意结果。

一、 产品概述
图观统一开发 API 是一套基于 JavaScript 语言开发的二次编程接口，用于在现代浏览器中加载、显示图观 引擎提供的流渲染或端渲染三维场景，并且为开发者提供在场景中绘制业务数据、触发场景交互、控制场景逻辑的功能。图观统一开发 API 兼容当前主流的 JavaScript 前端框架，例如 Vue.js 或者 React，前端开发人员可快速便捷的进行二次开发。

二、 产品功能

1. 图层绘制

图观统一开发 API 可提供500余项API调用接口，支持地标点、热力图、柱图、气泡图、地标图、轨迹图、三维柱图、区域图、栅格图、关系图、类型/数值区域图、聚合等丰富的数据图层接口编辑绘制。

2. 场景特效绘制

支持调整天气、光照、雨雪雾、烟花、萤火虫、信息雨、人流线、车流线等场景特效，可轻松构建出效果非凡的三维场景。

3. 全局控制

支持多数据接口的交互控制，如场景摄像机镜头控制、状态控制、建筑结构、事件处理、分析图层交互等，开发者可在 web 前端基础上，根据业务逻辑轻松实现三维场景要素图层的加载显示和交互分析。

3.1. 场景控制

支持构造应用、场景调度、建筑剖分、状态切换、事件监听、时间天气等数十种API接口。

3.2. 镜头控制

支持场景镜头视界、镜头漫游、镜头聚焦等数十项镜头控制接口，调度全要素场景中的镜头行为和摄像及参数等。

3.3. 数据要素交互

支持数据检索、圈选、定位、筛选点选查看、智能选中；支持事件响应；空间量算、测距、标绘等。

三、 产品优势

1. 上手宝典，全部数百 API 代码模板

提供数百项API 代码模板，并可基于前端开发框架自主进行二次开发扩展，灵活满足各种开发需求。

2. 逻辑代码统一，场景服务自由切换

一套代码，端/流兼容，可兼容相同地理位置的不同场景服务，移植便捷，可复用度高。

3. 文档完善，开发无忧

提供详细全面的开发文档和使用教程，为用户开发使用提供完备参考依据，助力用户开发无忧。

4. 便捷易用，调用灵活

通过调用良好封装的JS SDK，可以方便快捷的三维场景添加各种图层接口，快速定制符合业务需求的API接口。

一、 产品概述

图观流渲染场景服务，提供云端一站式场景管理、视频流服务，将大规模数字孪生场景在云端进行分布式渲染，采用视频串流技术将高性能三维渲染画面实时传送给用户，突破终端限制，用户无需安装下载任何内容，通过任意现代网络浏览器即可访问高质量数字孪生应用，并支持终端用户和云端应用的实时交互，为用户提供轻量化、高效便捷的云渲染支持，供后续数字孪生应用开发集成调用。

二、 产品功能

1. 项目管理

图形化管理界面，基于管理中心，可查看多个项目的版本信息、程序大小、创建时间、版本描述等信息，并可进行项目新建/编辑/删除、添加/修改/删除项目版本、创建场景等编辑操作，并可对项目内多个版本信息进行统一管理，操作直观便捷。

2. 场景管理

支持对项目中的多个流渲染场景进行集中管理，支持新建场景，并可对场景名称、分辨率、选择项目、缩略图等基本属性进行编辑，同时可设置场景视频质量参数、渲染倍数、预热重置、交互指令、浏览时间限制等属性，轻松管理用户场景数据。

3. 预览访问控制

兼容当前主流浏览器，可基于网页直接进行访问。支持场景Token 复制、更新、暂停、设置时间限制，支持单用户独享一个渲染服务或多用户共享一个渲染服务，可一键断开用户预览权限，灵活应对不同应用需求。

4. 预热驻留

通过管理中心，可以直观查看当前通道的使用状态，以及设置场景预热/非预热的通道数量，辅助用户合理配置服务器资源；开启预热驻留，渲染场景自动预先加载，用户预览即点即用，秒级响应，大幅提升运行响应效率。

5. 日志管理

支持访问日志、操作日志、错误日志的查看、筛选、搜索、导出、删除、一键跳转等操作，辅助用户实时掌握场景运行状况，提高运维效能。

6. 渲染设置

支持自动识别显卡列表、服务器项目存储使用空间、通道使用状态等信息；可根据显卡性能，自定义设置显卡标准通道数，合理控制服务器的硬件资源；同时支持一键重启渲染服务和流渲染服务器，实现服务器的远程一键控制。

7. 辅助工具

提供网络带宽测试、网络延迟测试以及硬件检测等功能，帮助用户直观了解服务器的实时网络状况和硬件信息评分，实现便捷运维。

三、 产品优势

1. 多端适配

兼容当前主流浏览器，可基于网页直接进行访问；支持 PC、手机、Pad、大屏等终端硬件，多屏一体化联动，跨终端提供一致体验。

2. 秒级启动

开启预热驻留，渲染场景自动先加载，即点即用，秒级响应，大幅提升使用效率。

3. 非凡视效

高性能全要素场景加载，超大场景智能化全尺度加载（LOD），超精细还原真实世界纹理细节，稳定可靠的大数据吞吐能力，超凡的显示性能，满足超大范围、超大规模场景要素的渲染、交互性能需求。

4. 数据加密

原生支持 Web 应用防火墙，保护用户数据隐私；租户数据物理隔离，数据网络传输端到端加密，符合业界专业标准，通过第三方安全实验室测试。

一、 产品概述

图观端渲染场景服务器，是专为图观场景编辑器生成的场景服务提供访问服务能力、访问控制、场景管理的软件服务。产品基于HTML5 和 WebGL 技术，通过客户端显卡实现轻量级三维场景在浏览器的渲染，并且满足多用户同时加载和高并发访问的需求。

）

二、 产品功能

1. 场景资源管理

图形化管理界面，操作简单高效；提供数字孪生场景资源导入、多场景服务一站式托管服务，可自动识别发布场景的层级结构并生成分级导航，实现场景资源的便捷管理。

2. 场景详情查阅

支持一键查询场景服务详细信息，如发布时间、调用次数、二次开发地址、场景浏览地址等。

3. 场景访问控制

提供数字孪生场景访问能力，支持用户权限控制、发布管理等操作，可一键启用/关闭场景访问权限，无需任何代码开发工作，大幅提升场景管理效率。

4. 资源压缩

支持对场景资源的压缩处理，包括无损压缩、低质量压缩、中质量级别、高质量压缩等。通过不同压缩级别，来控制发布场景的文件大小，合理匹配服务器资源。

5. 支持离线部署

针对特定用户需求，提供场景服务器离线部署服务，离线部署版支持导入用户场景数据，并可对场景资源进行自定义分组，充分满足用户应用需求。

三、 产品优势

1. 便捷高效的场景资源管理

友好易用的图形化交互界面，零代码开发，操作简单高效，大幅节省场景管理的时间和成本。

2. 单设备高并发访问

具备稳定可靠的并行处理能力，任意终端都能获得优秀的渲染效果、服务器负担小、带宽要求低，低成本支撑大并发访问。

3. 稳定高效的运行性能

具备稳定可靠的运行服务能力，场景资源一键性能优化，实现超凡显示性能、高效响应。

4. 数据安全加密

原生满足 Web 应用防火墙管理，保护用户数据隐私；租户数据物理隔离，数据网络传输端到端加密，符合业界专业标准，通过第三方安全实验室测试。

一、产品概述

图观场景编辑器，是基于HTML5 和 WebGL 技术，用于配置可交互实时渲染三维场景效果的专用产品。产品具备强大的数据集成能力、友好易用的配置环境、丰富的可定义场景属性、超凡的实时渲染效果，并可将配置完成的三维场景发布成公有云服务。

二、实施流程

基于图观端渲染场景编辑器，能够编辑地创建数字孪生场景，发布孪生场景服务。实施流程如下：

三、产品功能

1. 模型导入

支持导入3DMAX、Maya、Blender等建模工具导出的的GLB模型文件，可准确读取模型层级结构、纹理材质、数据驱动逻辑等属性参数，有效利用现有数据资源。

2. 场景构建

全托拉拽式场景编辑，预置大量模型资产，可将多个模型拖入场景进行组合，并通过坐标编辑进行偏移校正，实现场景模型的精准定位。

3. 材质编辑

预置丰富材质库，并支持对基本贴图、高光、粗糙度、透明度、自发光、烤漆图层等物理材质属性进行自定义编辑，快捷获得精细化的材质效果。

4. 关节动画

支持模型对象复杂层级结构、模型节点定义，可同时控制多个结构节点，支持为模型定义数据驱动逻辑、复杂动画设置，允许用户传入简单数值，即可对三维对象进行复杂控制。

5. 灯光编辑

支持为三维场景配置灯光效果，预置多种类型场景灯光效果，并支持自定义编辑灯光角度、强度、投影、阴影等属性参数，强化场景对象的光影效果。

6. 特效编辑

预置丰富的画面特效、空间特效，如全局投影、景深、辉光、风格滤镜、雾、信息雨、萤火虫、雨、雪等，支持自定义场景特效属性、支持同时添加多个特效，实现超凡的实时渲染效果。

7. 状态管理

支持将场景要素的多个属性进行组合为状态，实现多个编辑属性的综合管理，一键切换不同显示需要。

8. 坐标编辑

兼容GIS标准，支持以场景原点为中心，基于真实地理空间经纬度，通过录入经纬度坐标或地图匹配的方式，定义场景内各要素地理坐标，实现要素对象精确定位。

9. 场景预览

支持对当前场景下的所有属性信息进行保存，并可在浏览器中对场景最终效果进行预览。

四、 产品优势

1. 全物理材质渲染

全PBR渲染，丰富材质效果选项，高达15层材质贴图，快捷获得非凡材质效果，实现接近物理真实的渲染效果。

2. 丰富的渲染特效滤镜

内置众多图像渲染效果滤镜，高逼真还原真实世界场景要素，实现超凡的场景渲染效果轻松为场景最终效果增色。

3. 场景地图精准定位

兼容GIS标准，精准定位场景位置，准确显示经纬度格式数据，实现场景要素的精准加载显示。

4. 数据驱动逻辑定义

通过定义结构、关节、动作，为三维模型赋予数据驱动能力，允许通过传入数据，对模型姿态、动作、状态变化进行复杂控制。

5. 丰富的模型资产

插件式预置场景资产库，拖拉拽式模型导入，操作简单，易于掌握，配置结果所见即所得，助力用户高质量构建多行业场景。