概述
SceneV 3D 是面向数字孪生和三维可视化场景的在线设计能力，用三维空间承载设备、建筑、产线、园区和城市对象，让业务数据从二维看板延展到可漫游、可交互、可联动的 3D 场景中。
参考在线演示站的产品形态，SceneV 3D 更适合用于智慧工厂、智慧园区、能源监控、设备运维、城市物联等需要表达空间关系的场景。
1. 产品定位
SceneV 大屏可视化侧重二维画布、图元组件、ECharts 图表和业务看板。SceneV 3D 侧重三维空间、模型资产、实时状态和沉浸式交互。两者可以组合使用：
| 能力 | SceneV 大屏可视化 | SceneV 3D |
|---|---|---|
| 展示方式 | 2D 大屏、驾驶舱、组态画布 | 3D 场景、数字孪生、空间漫游 |
| 核心对象 | 图元、图表、组件、数据卡片 | 模型、场景、设备、空间节点 |
| 适用场景 | 数据总览、指标监控、业务看板 | 设备定位、园区态势、产线仿真 |
| 交互方式 | 点击、拖拽、弹框、条件动作 | 视角控制、模型选中、状态高亮 |
2. 核心能力
- 三维场景搭建：围绕园区、厂房、产线、机房、设备等对象组织空间结构。
- 模型资产管理：通过模型表达真实设备和业务对象，形成可复用的 3D 资产。
- 实时数据驱动：接入 HTTP、WebSocket、MQTT、ThingsBoard 等数据源，驱动颜色、状态、告警和信息面板。
- 沉浸式交互：支持视角漫游、模型选中、缩放查看、信息弹窗和场景跳转。
- 脚本与事件编排：面向复杂业务联动，可通过脚本、条件、事件动作组织场景逻辑。
- 在线预览发布：面向大屏展示和 Web 端访问，支持设计完成后的预览与发布。
3. 工作模式
根据在线站点加载方式，SceneV 3D 可分为编辑、预览和访问三类模式：
| 模式 | 入口形态 | 说明 |
|---|---|---|
| 编辑模式 | 设计器主应用 | 用于搭建场景、管理模型、配置属性、绑定数据和编排事件 |
| 预览模式 | /preview/3d 或 ?preview=1 | 用于在发布前检查真实运行效果 |
| 查看模式 | /view/3d | 用于面向大屏、业务系统或最终用户展示 3D 场景 |
编辑模式关注配置效率，预览模式关注还原运行效果，查看模式关注加载速度、稳定性和业务集成。
4. 技术能力
在线演示站加载了 WebGL 三维渲染资源、Monaco 编辑器资源和 3D 预览资源，因此 SceneV 3D 文档建议围绕以下能力展开：
| 能力 | 说明 |
|---|---|
| WebGL 渲染 | 用于在浏览器中运行三维场景、模型、材质、灯光和动画 |
| 3D 预览 | 用于将编辑态场景切换到真实运行态 |
| 脚本编辑 | 用于编写数据过滤、事件回调和业务联动逻辑 |
| 资源按需加载 | 编辑器、预览器、模型资源和样式资源按场景加载，降低首屏压力 |
| 业务集成 | 支持作为独立页面或嵌入式页面接入业务系统 |
5. 典型应用
智慧工厂
以厂房、产线、设备和工位为核心对象，展示设备运行状态、产线节拍、能耗、告警和巡检信息。
智慧园区
以建筑、道路、楼层、摄像头、门禁、能耗点位为核心对象，展示园区运行态势和空间分布。
设备运维
以关键设备模型为中心，关联实时遥测、故障状态、维护记录和告警详情，帮助运维人员快速定位问题。
城市物联
以道路、建筑、路灯、井盖、环境监测点等对象为核心，呈现城市级设备分布和实时状态。
6. 与数据平台集成
SceneV 3D 可以作为物联网平台、业务系统或运维系统的可视化前端。常见集成方式包括：
- 通过 HTTP 接口拉取业务数据。
- 通过 WebSocket 订阅实时数据。
- 通过 MQTT 接收设备消息。
- 通过 ThingsBoard 获取遥测、属性和告警数据。
7. 建设步骤
一个完整的 SceneV 3D 项目通常按以下步骤推进：
- 确定业务对象：梳理园区、楼栋、产线、设备、传感器等核心对象。
- 准备模型资产：确认模型格式、命名、层级、贴图和精度。
- 搭建基础场景：完成地面、环境、灯光、相机和空间层级。
- 绑定业务数据：将设备状态、遥测指标、告警和统计数据绑定到模型。
- 配置交互逻辑：组织点击、视角切换、弹框、联动和跳转。
- 优化运行性能：控制模型面数、贴图尺寸、动画数量和数据刷新频率。
- 发布与集成：通过预览确认后，嵌入大屏、业务系统或运维平台。
下一步可阅读 快速开始，了解一个 3D 场景从创建到发布的基本流程。