图观产品问答

digihail123

V1.0.20250724版本更新日志：

修复编辑器运行状态下打开与当前端模型材质存在重名的其他模型时，重名的该材质效果会受上一个模型效果影响问题；
修复流模型进行材质编辑时法线效果不对问题。

digihail123

图观模型编辑器是一款免安装的桌面端应用程序。通过使用图观模型编辑器，可以新建图观模型、或者编辑已有图观模型。图观模型的具体介绍可以参考：什么是图观模型？如何使用图观模型？

图观模型编辑器关键功能

模型构建与导入：支持FBX、GLB等主流格式导入，保留节点层级、材质纹理等原始数据，并转换为.tgm标准化格式。
深度编辑能力：

材质编辑：调整金属度、粗糙度等PBR参数，支持贴图动画、玻璃/涂层特效，预置环境交互材质。
粒子系统：硬件加速的粒子组（火焰、烟雾）可通过关节控制，实现动态效果与数据联动。
关节与动画：定义关节数值驱动模型姿态变化，结合时间线脚本制作复杂动画（如机械臂运动）。

性能优化工具：实时查看模型精度、顶点数等指标，辅助优化资源占用。

应用价值

图观模型编辑器通过标准化流程，将传统静态三维模型升级为可交互、数据响应的数字孪生体，适用于智慧城市、工业仿真等领域。其.tgm格式无缝对接后续开发工具链（如场景构建、API调用），形成从模型编辑到应用落地的闭环，降低多团队协作成本。

软件下载方法

图观商场，模型详情页里的下载链接
登录后通过用户后台的产品中心链接进行下载

系统要求

最低配置

CPU：四核Intel或AMD处理器（不低于2.5 GHz）
内存：16 GB内存
显卡：Nvidia GTX 1060或以上，兼容DirectX 12的显卡
操作系统：64 位Windows 10/11（21H2或以上）

推荐配置

CPU：四核Intel或AMD处理器（不低于2.5 GHz）
内存：32 GB内存
显卡：Nvidia GTX 3060或以上，兼容DirectX 12的显卡
操作系统：64 位Windows 10/11（21H2或以上）

digihail123

下载完的图观模型有以下三种使用方法：

使用孪易配置孪生体外观

孪易数字孪生 IOC是基于用户现有业务系统数据，一站式从零开始，建立完整数字孪生智能运营中心软件系统的工具套件。包括数字孪生智能运营中心的前台监控运维、后台配置管理、数据建模集成、行业预置套件，以及二次开发工具五大部分。

当您注册完成账号，并且登录，通过场景首页右上角可以跳转到后台管理。

在孪易后台管理，从左侧导航栏选择图观模型

在左侧文件夹树选择可以合适的分类，点击导入，选择需要导入的图观模型。

左侧导航栏中选择类别配置，新建或者选择一个孪生体类别后，点击编辑

从上方Tab栏选择外观定义，然后从右侧点击选择模型，从弹出的对话框中，选择刚才导入的图观模型。

使用图观TGAPI添加到流渲染场景

如果孪易标准版IOC的零代码配置无法满足您的业务高度自定义需求，可以通过使用TGAPI低代码二次开发前端页面，加载使用图观模型。

先决条件

您需要先具备图观流渲染服务器，可以购买离线部署版，或者申请公有云试用。
您需要有一个可以在图观流渲染服务器加载串流的场景，您可以联系客服申请试用场景，或者通过图观UE插件和打包服务器自己制作并且打包。

使用步骤

登录流渲染服务器，进入模型管理，上传图观模型

获取流渲染服务器模型服务地址和Token

前端开发工程师，通过调用TGAPI，在初始化服务接口调用完成后，连接模型服务器

function connectionModelServer() {
  // 链接图观模型服务器
  let jsonData = {
    name: "streamingcluster",
    address: "http://172.16.1.1:9090",
    token: "pFugELF9",
  };
  appInstance.uniCall('connectDataServer', jsonData, (result) => {
    console.log(result);
  });
}

注意：流渲染场景所在的服务器必须可以访问到图观模型所在的流渲染服务器。

通过TGAPI的添加模型接口，将模型添加到场景。

let jsonData = {
  id: '配电柜00223',
  coordType: 0,
  coordTypeZ: 0,
  coord: [114.560257, 37.09079],
  coordZ: 10,
  rotation: [0, 0, 0],
  alpha: 1,
  scale: 1,
  titleText: '配电柜00223,
  titleColor: '#ffffff',
  titleBackgroundColor: '#333333',
  titleFontSize: 20,
  titileAutoScale: false,
  visible: true,
  modelMaxDistance: 1000,
  modelType: '配电柜-02',  // 流渲染服务器上图观模型的名称
  modelSource: 'dataServer',   // 从流渲染服务器加载图观模型，这里需要写dataServer
};
appInstance.uniCall('addModel', jsonData, (result) => {
  console.log(result);
});

使用图观模型模型编辑器浏览、编辑

如果您对下载的图观模型不满意，需要进行修改编辑，可以使用图观模型编辑器。图观模型编辑的介绍和系统要求可以查看这里：什么是图观模型编辑器？

图观模型编辑器是一款免费的、客户端桌面运行的、可以编辑端流一体模型的、免安装应用程序，通过图观商城中模型详情页的链接下载。

注意：图观模型编辑器是一款三维模型编辑软件，需要您的PC或者便携电脑具有独立显卡。

下载完成后，解压文件。
第一次运行双击：图观模型编辑器.exe，并从菜单中选择打开。

打开的模型可以查看模型节点

或者通过材质、关节、动画、粒子，进一步调整模型。

digihail123

图观场景开发地址是您在图观商城购买场景服务后获得的一个公有云地址（URL）。它代表一个预制的数字孪生场景（如智慧城市、工厂仿真等），是二次开发的入口。简单来说，购买场景服务后，您只需一键复制这个地址，通过图观统一开发API加载它，就能在浏览器中直接调取场景，并基于JavaScript编程扩展功能。无需从头搭建场景，节约开发时间90%以上。

核心特性

图观场景开发地址的设计聚焦便捷性与兼容性：

一键复制与集成：购买后，商城自动提供地址，一键复制即可在API中使用，无需手动配置路径或服务端口。
公有云基础：地址托管在可靠公有云环境，确保高可用性和安全访问，省去私有部署的运维烦恼。
简单易用：地址格式统一，开发者只关注业务逻辑，忽略底层技术细节。

这些特性让开发地址成为“钥匙”，解锁场景服务的二次开发潜力。

功能介绍

通过图观统一开发API（基于JavaScript），开发地址实现丰富功能：

场景加载与管理：传入地址后，API自动预加载、初始化和销毁场景服务（支持端/流渲染），响应速度高达毫秒级。
对象控制与交互：开发地址调取场景后，您可用API绘制和操控图层（如热力图、轨迹图）、模型（如建筑剖分）及特效（如雷达扫描）。例如，传递JSON数据即可生成动态气泡图，并截取点击事件处理自定义业务。
灵活环境设置：结合API，地址支持镜头控制（漫游或聚焦）、时间/气象模拟（如日照变化或沙尘暴效果）及多坐标系适配，增强场景真实感。
开发兼容性：开发地址无缝匹配主流前端框架（Vue/React），只需JavaScript基础，100行代码就能添加数据聚合图层或互动模式（如第一人称行走）。

整个过程分三步：购买服务→复制地址→API调用。开发地址作为“基石”，让二次开发从加载场景起步，高效扩展功能。

价值

图观场景开发地址为开发者创造多重价值：

降本增效：一键复用预制场景，避免耗时建模和调试。结合免费API，团队可节省70%开发成本，聚焦业务逻辑而非渲染技术（无需C++/UE技能）。
高质量交付：双模式渲染确保超凡效果（PBR材质或UE内核）和超高并发（单服务器支持千级用户），无论大屏指挥中心或桌面系统都能快速适配，提升市场竞争力。
业务灵活性：地址与API强绑定，支持不修改代码切换场景模式。需求变更时（如从GIS地图到建筑控制），直接更新地址即可复用逻辑，降低开发风险。
普惠开发：免费开放，降低入局门槛，中小企业也能构建专业数字孪生应用，助力行业创新。

结尾

图观场景开发地址是数字孪生开发的“黄金钥匙”，让二次开发变得极简高效。只需在图观商城选配场景服务、复制地址、调用统一API，您就能打造功能强大、效果惊艳的应用。立即体验——购买服务，获取地址，开启您的开发新征程！

digihail123

图观场景包是通过图观流渲染编辑发布后产生的工件，可以导入到图观端渲染服务器，场景发布后可以在线浏览或者通过URL进行二次开发。它包含三维模型、状态定义、模型关节和定义、地理信息坐标等全部运行要素，直接交付即可部署使用。您可以在图观商城-场景专区挑选各行各业（如智慧城市、工业能源、交通园区等）的成熟场景服务，购买后即可导入云平台或下载至本地。

核心特性

一键式交付：场景包已整合所有资源（模型、材质、脚本）。
灵活部署：
公有云托管：一键导入图观端渲染场景服务器，生成访问链接即开即用。
本地化运行：下载场景包至私有环境，实现内网安全部署。
开箱即用：内置浏览与基础交互功能，无需额外配置即可展示数字孪生场景。
行业化覆盖：商城提供能源、交通、园区等数十种行业场景模板，快速匹配需求。

核心功能与服务

场景导入与导出：自动压缩工程文件及资源，支持云/本地灵活迁移。
导入即用：
- 公有云：上传即托管，自动生成场景浏览链接。
- 私有云：导入本地服务器，实现内网高效访问。
场景管理：云端控制台支持多场景分类、启停控制、访问统计与日志跟踪。
场景浏览服务：通过浏览器即可：
- 自由漫游、切换孪生体状态
- 查看设备关节和动画
- 切换环境效果预览
二次开发支持：提供统一API接口，可调用场景服务至自有系统（如加载场景、响应交互事件）。

价值优势

降本增效：0成本使用公有云标准版，避免重复开发；高并发架构降低硬件投入。
敏捷部署：云化服务5分钟上线，独立部署支持项目现场快速迁移。
开放兼容：支持公有云/私有云/混合环境，数据互通无忧。
开发友好：API无缝接入业务系统，赋能定制化数字孪生应用。

立即开启数字孪生场景

无论您需要快速展示行业方案，还是将场景集成至业务平台，图观场景包都能提供标准化、高性能的解决方案。访问图观商城场景专区，选择所需场景服务，购买→导入→发布→启用，轻松开启您的数字孪生之旅！

digihail123

什么是图观场景工程包？

图观场景工程包是数字孪生场景的可定制化原始工程文件，可直接导入至图观公有云场景编辑器（或下载到本地编辑器），支持自由修改、重构和二次开发。它不同于开箱即用的“图观商城场景包”（直接渲染服务），而是提供场景的底层工程框架与资源库，用户可基于此高效搭建个性化数字孪生应用。

核心特性：自由编辑 + 高效开发

完全可编辑
- 所有模型、材质、粒子效果、动画逻辑、GIS数据等均开放编辑权限，支持深度定制。
- 提供可视化编辑器，无需建模基础，拖拽即可调整场景结构。
多源兼容性
- 支持导入GLB模型、倾斜摄影（3DTiles）、GIS地图、城市建筑等多类型数据。
- 兼容外部建模工具（3DMAX/Maya/Blender）生成的文件。
工程化资产管理
- 内置模型库（1万+）、PBR材质库、粒子特效库等行业资源，可复用可扩展。

核心功能：灵活构建全要素场景

模型与材质编辑
- 精细化调整模型位置/旋转/缩放，支持14层PBR材质复合渲染（金属度、玻璃、自发光等）。
动态效果配置
- 关节控制：通过数值/布尔/枚举数据驱动模型姿态变化（如机械臂运动）。
- 粒子系统：实现雨雪、火焰、爆炸等实时特效，并与模型节点绑定联动。
- 场景动画：定义时间线脚本，控制复杂模型关节动画序列。
场景集成与增强
- 融合GIS地图、建筑剖分、城市简模、画刷批量建模（路网/植被等）。
- 配置全局光照、环境反射、雾效、后期滤镜等影院级画面效果。
数据与空间校准
- 精准匹配真实世界坐标（经纬度/朝向），支持业务数据空间叠加显示。
多状态发布
- 一键保存多个场景状态（光照/特效/摄像机位），切换显示不同业务视角。

核心价值：降本增效，精准定制

快速启航
基于预置行业模板（如智慧园区、电力能源），复用成熟框架，节省90%搭建时间。
无缝二开
提供完整API接口，轻松对接业务系统，动态控制场景对象属性与行为。
跨场景复用
通过工程包复用模型/特效/逻辑模块，避免重复开发，积累企业数字资产。
私有化部署
支持下载工程至本地，保障数据安全，适配内网环境高效运行。

工程包 vs 场景包：关键区分

能力	场景工程包	商城场景包（成品服务）
编辑权限	全要素可修改、重构	仅支持直接调用
二次开发	修改场景、浏览和二次开发	仅支持浏览和二次开发
数据融合	可嵌入新的模型、GIS等数据，修改模型关节、动画和粒子效果定义	原样渲染
适用阶段	开发/定制阶段核心资源	交付阶段直接使用

数字孪生场景的“创客工具箱”

图观场景工程包将复杂的数字孪生开发简化为可视化编辑流程，通过开放的工程框架、行业预置资源与强大的动态效果引擎，赋能用户零代码构建专业级场景。无论是复用模板快速搭建，还是深度定制企业专属应用，它都是实现数字孪生敏捷开发的理想起点。进入图观商城“场景专区”，下载工程包，30分钟定制您的第一个数字孪生场景！（公有云编辑器免费使用，私有化部署享极致性能）

digihail123

图观模型是专为数字孪生应用设计的三维模型增强格式（.tgm），通过集成外观效果、数据驱动能力和多渲染模式兼容性，为数字孪生开发提供标准化的三维对象控制底层支持。其核心目标是解决传统三维模型在数字孪生场景中动态交互、数据联动和跨平台渲染的难题，显著提升开发效率与协作性。

1. 图观模型核心特性

端/流双渲染架构兼容： 支持本地端（如WebGL）与云端流渲染（如实时推流）两种模式，确保模型在不同终端的高效呈现。
数据驱动控制： 通过关节（数值、布尔、枚举类型）绑定材质、粒子或动画属性，实现模型状态随外部数据（如IoT传感器）动态变化。
高保真视觉效果： 基于PBR材质编辑、粒子特效及环境反应（如积雨/积雪），提升模型的物理仿真度。

2. 图观模型编辑器关键功能模块

模型构建与导入： 支持FBX、GLB等主流格式导入，保留节点层级、材质纹理等原始数据，并转换为.tgm标准化格式。
深度编辑能力：
- 材质编辑： 调整金属度、粗糙度等PBR参数，支持贴图动画、玻璃/涂层特效，预置环境交互材质。
- 粒子系统： 硬件加速的粒子组（火焰、烟雾）可通过关节控制，实现动态效果与数据联动。
- 关节与动画： 定义关节数值驱动模型姿态变化，结合时间线脚本制作复杂动画（如机械臂运动）。
性能优化工具： 实时查看模型精度、顶点数等指标，辅助优化资源占用。

3. 应用价值

图观模型编辑器通过标准化流程，将传统静态三维模型升级为可交互、数据响应的数字孪生体，适用于智慧城市、工业仿真等领域。其.tgm格式无缝对接后续开发工具链（如场景构建、API调用），形成从模型编辑到应用落地的闭环，降低多团队协作成本。

总结： 图观模型是数字孪生领域的“智能化三维资产”，其编辑器通过数据驱动、跨平台适配与高自由度编辑，成为连接三维建模与孪生应用开发的关键枢纽。

zhangyu

以下方法为初步排查方式，如果尝试后仍无法正常使用，请联系客服人员查看

一、流渲染场景服务后台无法启动
首先排查是否是IP改变，在地址栏输入localhost:9090测试能否访问
1.localhost:9090能够访问场景服务后台的情况
win+r输入cmd 输入ipconfig查看ip是否有变化，如果ip不一致需要用当前ip访问

2.localhost:9090无法访问
Ctrl + Shift + Esc：直接打开任务管理器 > 打开服务 > 查看这三个服务是否是启动状态

图1

图2

情况1：没有启动 需要手动启动服务
1）服务能够手动启动重新刷新后台页面
2）服务如果无法启动双击部署时使用的场景安装包，在弹出的弹窗中选择修复按钮。如果没有安装包可以在官网下载最新安装包选择升级
*注意：
如果安装的流渲染跟最新版本差距较大，升级时请咨询客服人员

情况2：缺少服务 同样先尝试修复，修复后没有变化可以尝试卸载重装
*注意：
机器上安装360等杀毒软件大概率会清除服务，建议卸载杀毒软件或使用火绒
如果当前有部署好的场景需要备份场景后再卸载重装，需要在部署文件夹里分别压缩场景包，具体操作如果有疑问可以联系客服人员

二、验证码不显示
需要查看MySQL数据库是否正常启动，参考图1、图2方法在服务中找到MySQL服务重启后刷新页面看验证码是否显示

三、显示渲染节点不在线
首先在流渲染场景服务后台重启服务，重启服务按钮位置可以参考官网操作文档
https://www.tuguan.net/doc/streaming-server/?features.render_setting
重启后如果还是显示渲染节点不在线
Ctrl + Shift + Esc：直接打开任务管理器 > 打开服务 > 查看三个服务是否是启动状态

如果没有启动，需要手动启动服务
1）服务能够手动启动重新刷新后台页面
2）服务如果无法启动双击部署时使用的场景安装包，在弹出的弹窗中选择修复按钮。如果没有安装包可以在官网下载最新安装包选择升级
*注意：如果安装的流渲染跟最新版本差距较大，升级时请咨询客服人员

服务正常但是显示渲染节点不在线，需要检查显卡驱动是否正常
查看流渲染场景服务后台 > 系统管理 > 渲染设置检查服务是否能检测到显卡

图3

图3为正常状态，如果此处没有显示显卡，可以打开任务管理器 > 性能查看显卡能否正常识别到

图4

如果没有显示显卡并且在设备管理器确认机器有显卡，可以尝试更新驱动

zhangyu

您好，在3DMax里面做好的动画，可以在图观场景编辑器里面继承，也可以在场景编辑器里面，做相应的关节、动画的编辑。您方便可以添加微信：18500818281

lilinyan

开发部署版与项目部署请求方式有所不同，详情可参考下面图片
1.开发部署版

2.项目部署版
微信图片_20240517101522.jpg

L	liulei
L	lilinyan
J	jingzhijie
C	cui01
Z	zhangyu
X	xiaoshi
T	tuguanteam
D	digihail123

图观产品问答

Moderators

帖子

使用孪易配置孪生体外观

使用图观TGAPI添加到流渲染场景

使用图观模型模型编辑器浏览、编辑

成员列表