数据格式标准
为了确保数据能正确在编辑器和预览大屏中展示,请遵循以下 JSON 数据结构。
基础结构
数据以 数组 形式传递,数组中的每一项代表一个属性字段。
字段说明
| 字段名 | 类型 | 必填 | 说明 |
|---|---|---|---|
key | String | 是 | 属性名称,将作为标签显示(如“温度”、“压力”) |
value | Any | 是 | 属性值,支持数字、字符串或布尔值 |
unit | String | 否 | 单位(如 "℃", "Pa"),可选 |
示例数据
json
[
{
"key": "流速",
"value": 99,
"unit": "m/s"
},
{
"key": "压力",
"value": 1.3,
"unit": "MPa"
},
{
"key": "温度",
"value": 77.3,
"unit": "℃"
},
{
"key": "是否报警",
"value": "是"
},
{
"key": "告警原因",
"value": "压力异常",
"style": "error" // 可选:支持简单的样式标记
},
{
"key": "更新时间",
"value": "2026/2/10 13:18:12"
}
]前端调用示例
如果您是在进行二次开发,可以直接调用编辑器暴露的 updateModelData 方法来更新数据。
javascript
// 假设 modelId 为目标模型的 UUID
const modelId = "aecd3ff6-8ac3-4268-9462-61565014b4d";
const realTimeData = [
{ key: "流速", value: 99 },
{ key: "压力", value: 1.3 },
// ... 其他数据
];
// 调用核心 API 更新数据
editor.businessDataProvider.updateData(modelId, realTimeData);数据更新后,场景中绑定的 UI 组件(信息牌、侧边栏)将自动刷新显示。
