图观产品问答

帖子

---

什么是图观商城场景开发地址？
• D 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，您就能打造功能强大、效果惊艳的应用。立即体验——购买服务，获取地址，开启您的开发新征程！

---

什么是图观商城场景场景包？
• D digihail123

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

  核心特性

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

  核心功能与服务

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

  价值优势

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

  立即开启数字孪生场景

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

---

什么是图观商城场景工程包？
• D digihail123

  ​​什么是图观场景工程包？​​

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

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

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

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

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

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

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

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

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

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

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

---

什么是图观模型和图观模型编辑器？
• D digihail123

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

  1. 图观模型核心特性​​

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

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

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

  3. 应用价值​​

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

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

---

流渲染场景服务后台无法启动常见问题排查方法
• Z 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

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

---

RE: 你好，场景编辑器里面怎么才可以人人物动起来。
• Z zhangyu

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

---

端渲染开发部署版与项目部署版使用同一种场景请求方式为什么项目部署版场景加载不出来控制台会报错
• L lilinyan

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

  2.项目部署版
  

---

图观 低代码：API开发包 v3.6 功能更新
• T tuguanteam

  一、新增功能

  流渲染

  1.流渲染，添加路径 addPath 接口支持 autoScale = false ，实现路径一直是等大效果，支持颜色设置，但不支持设置样式、宽度和贴地。
  

  二、优化

  流渲染

  1.流渲染，设置模型显隐 setModelVisibility 接口支持控制视频融合对象显隐。
  视频融合对象显示：
  
  视频融合对象隐藏：
  
  2.流渲染，状态及接口修改季节时太阳方位随着变化。
  春季：
  
  秋季：
  
  3.流渲染，设置环境光照 setEnvTime 接口，设置时间日期时，季节跟着变化：春季：3月1日-5月31日；夏季：6月1日-8月31日；秋季：9月1日-11月30日；冬季：12月1日-2月29日。
  春季：
  
  夏季：
  
  秋季：
  
  冬季：
  
  4.流渲染，各个天气的默认参数优化。

  三、问题修复

  流渲染

  1.修复模型轨迹图拉近时 label 有的不显示问题。
  2.修复聚簇地标图，aggType =1 时，聚合后的图标不触发点击事件问题。
  3.修复模型轨迹图、模型地标图聚焦不居中问题。
  4.修复 addGISMap 指令，添加 WMTS 格式地图，滚轮缩放 GIS 地图，场景卡死问题。
  5.修复 addWatermark 指令，设置 url、dockHorizontal、dockVertical 等属性无效问题。
  6.修复 Earth 场景，add3DMarkerLandmarkLayer 指令，图层显示效果不正确问题。
  7.修复 Earth 场景，地标图执行 pickOverlay、endPickOverlay 指令，所有地标图图层会闪现一下的问题。
  8.修复 addModelTrailLayer、updateModelTrailLayerStyle 指令中错误属性生效问题。

---

图观 低代码：API开发包 v3.5.5 功能更新
• T tuguanteam

  一、新增功能

  流渲染

  1.流渲染，添加路径段热力图 addRoadSgHeatLayerCoord 、updateRoadSgHeatLayerStyle 接口，增加 usingLegends 属性，配置图例。
  addRoadSgHeatLayerCoord
  
  updateRoadSgHeatLayerStyle
  
  2.流渲染，新增 flyToScene 接口。
  
  3.流渲染，模型轨迹图 addModelTrailLayer 、updateModelTrailLayerStyle 接口，增加 labelScale、labelOffset 属性，控制标签文本的缩放和位置偏移。
  addModelTrailLayer
  
  updateModelTrailLayerStyle
  
  4.流渲染，设置环境光照，setEnvTime 接口添加对 envDate 和 fixedTime 属性的支持。
  

  二、问题修复

  流渲染

  1.修复地球场景，路径图、圆形区域图、三维柱图、栅格图、气泡图、事件图、关系图 图层不平铺于球体表面问题。
  2.区域图和圆形区域图，更新样式接口，修复设置 alpha 属性后不生效问题。
  3.修复区域图/路径图，添加时设置为贴地，更新样式时不设置 snapSurface 属性，区域图/路径图未贴地问题。

---

图观 私有化部署 端渲染：项目部署版 v3.5.3 功能更新
• T tuguanteam

  图观 私有化部署 端渲染：项目部署版 v3.5.3 功能更新

  一、新增功能

  统一接口调试器

  流渲染，切换状态，switchState 接口增加 serviceName 属性。
  

  二、问题修复

  端渲染，获取图层中的模型 getModelsByLayer 指令，获取到的图层中模型的 rotation 值不正确问题。
  端渲染，设置图层显隐 setOverlayVisibility 指令，控制热力图显隐不生效问题。
  端渲染，设置类别图层显隐 setOverlayTypeVisibility 指令，控制热力图显隐不生效问题。
  端渲染，更新区域样式和更新区域数据放到一起执行，有一个未起作用问题。
  端渲染，地标图添加图层对象 tip ，使用 setOverlayVisibility 指令隐藏图层，拖动场景，tip 标牌会显示出来问题。