组态组件说明
一、组件分类
| 类型 | 用途 | 常见组件 |
|---|---|---|
| 基础组件 | 搭建页面结构和静态内容 | 文本、图片、形状、按钮、分组 |
| 数据组件 | 展示设备或接口数据 | 数字面板、仪表盘、数据表格、趋势图 |
| 控制组件 | 向设备下发指令 | 开关、按钮、下拉框、状态按钮 |
| 告警组件 | 展示告警记录和状态 | 告警列表、告警记录组件 |
| 视频组件 | 展示监控画面或 URL 流 | 视频播放器、通道选择 |
| 计算组件 | 对变量做计算展示 | 科学计算、函数变量、动态数据 |
| 公共接口组件 | 调用外部或平台接口 | 公共接口数据源、接口表格 |
| 3D/模型组件 | 展示模型或三维属性 | 模型管理、三维属性 |
二、变量类组件
变量类组件绑定物模型或场景变量。配置时重点关注：
| 配置项 | 说明 |
|---|---|
| 变量来源 | 产品、设备、场景、模拟数据或函数变量 |
| 变量标识符 | 对应物模型 id |
| 数据类型 | 数值、布尔、枚举、字符串、数组 |
| 显示格式 | 小数位、单位、枚举文本、颜色映射 |
| 刷新频率 | 实时、定时或事件触发 |
| 离线展示 | 设备离线或无数据时的默认状态 |
三、控制类组件
控制类组件会触发平台下发指令，应特别谨慎。
| 配置项 | 说明 |
|---|---|
| 绑定功能 | 选择可写物模型或控制指令 |
| 下发值 | 布尔、枚举或数值 |
| 确认弹窗 | 危险操作建议开启 |
| 执行反馈 | 设备回传后刷新状态 |
| 权限控制 | 普通展示用户不应有控制权限 |
控制组件上线前至少测试三种情况：设备在线、设备离线、设备返回失败。
四、告警记录组件
告警记录组件适合放在设备运行页面或大屏中，用于查看设备异常。
配置建议：
- 选择设备或设备类型。
- 选择告警状态。
- 配置展示字段。
- 控制刷新频率。
- 保持列表高度稳定，避免大屏布局跳动。
五、视频组件
视频组件常用于监控设备、NVR 通道或 URL 拉流通道。
配置重点：
- 通道来源。
- 设备绑定关系。
- 播放协议。
- 自动播放策略。
- 断流重连。
- 全屏和分屏。
如果视频无法播放，先到 视频能力进阶 检查流地址、ZLM 和浏览器兼容性。
六、数据表格与图表
数据表格和趋势图建议只展示用户真正需要比较的数据，不要把所有物模型字段都堆到同一个组件中。
| 场景 | 推荐组件 |
|---|---|
| 单个实时值 | 数字面板、仪表盘 |
| 多个实时值 | 数据表格、状态卡片 |
| 时间变化趋势 | 折线图、面积图 |
| 枚举分布 | 饼图、柱状图 |
| 告警与事件 | 告警列表、事件表格 |
七、组件命名建议
组件命名建议包含业务含义，例如：
主泵运行状态进水口压力告警记录列表一号摄像头直播温度趋势图
避免只使用 组件1、文本2、按钮3，后期维护成本会很高。