Skip to content

数据格式标准

为了确保数据能正确在编辑器和预览大屏中展示,请遵循以下 JSON 数据结构。

基础结构

数据以 数组 形式传递,数组中的每一项代表一个属性字段。

字段说明

字段名类型必填说明
keyString属性名称,将作为标签显示(如“温度”、“压力”)
valueAny属性值,支持数字、字符串或布尔值
unitString单位(如 "℃", "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 组件(信息牌、侧边栏)将自动刷新显示。

Released under the MIT License.