设备行为ID配置¶

问题描述¶

在智能公元平台配置设备行为时，语音指令的ID与设备配置中的标识ID不一致，导致指令无法正确执行。

解决方案¶

1. 确认设备组件标识ID¶

在设备行为配置页面中，每个组件都有唯一的"标识(id)"字段：

进入设备行为自定义配置页面
在左侧组件列表中选择相应组件（如开关、滑块等）
在右侧配置面板中查看"标识(id)"字段的值
例如：开关组件的ID为"switch_1"

2. 配置语音指令ID¶

在配置语音指令时，确保指令中的ID与设备组件标识ID一致：

{
  "command": "打开灯光",
  "data": {
    "id": "switch_1"
  }
}

3. ID匹配规则¶

严格匹配：语音指令中的id必须与设备组件的标识id完全一致
区分大小写：ID值区分大小写，"switch_1"和"Switch_1"是不同的
唯一性：每个组件的ID在同一设备中必须唯一
命名规范：建议使用有意义的命名，如"light_switch"、"temperature_slider"等

4. 配置步骤详解¶

步骤1：配置设备组件¶

在平台左侧选择"设备组件"
添加所需组件（开关、滑块、显示等）
选中组件后，在右侧设置：
- 组件名称（如"灯开关"）
- 标识(id)（如"switch_1"）⭐ 重点配置
- 其他参数（默认值、范围等）

步骤2：配置语音指令¶

在语音指令配置区域
设置指令词（如"打开灯"、"关闭灯"）

在指令的data字段中设置对应的组件ID：

// 打开灯指令
{
    "command": "打开灯",
    "data": {
    "id": "switch_1",
    "value": 1
    }
}

// 关闭灯指令
{
    "command": "关闭灯",
    "data": {
    "id": "switch_1",
    "value": 0
    }
}

步骤3：测试验证¶

保存配置并生成固件
烧录到设备进行测试
通过语音触发指令，验证设备是否正确响应
如无响应，检查ID配置是否一致

5. 常见错误及解决¶

错误1：ID拼写错误¶

现象：语音指令无响应
检查：对比组件ID和指令ID是否完全一致
解决：修正拼写错误

错误2：大小写不匹配¶

现象：偶发性响应失败
检查：确认ID的大小写
解决：统一使用小写或按规范命名

错误3：重复ID¶

现象：设备响应混乱
检查：确认所有组件ID唯一
解决：修改重复的ID

错误4：缺少ID字段¶

现象：指令无法执行
检查：JSON格式是否正确，是否包含id字段
解决：添加正确的id字段

6. 最佳实践¶

命名规范：
- 使用小写字母和下划线
- 采用"组件类型_编号"格式
- 示例：switch_1、slider_2、display_1
文档管理：
- 记录所有组件ID及其功能
- 建立ID与功能的映射表
- 定期检查配置一致性
版本控制：
- 保存配置版本
- 修改前备份
- 追踪变更历史
测试流程：
- 单个组件逐一测试
- 组合功能验证
- 异常情况测试

7. 配置示例¶

完整设备配置示例¶

// 设备组件配置
{
  "components": [
    {
      "name": "客厅灯开关",
      "id": "living_room_light",
      "type": "switch"
    },
    {
      "name": "空调温度",
      "id": "ac_temperature",
      "type": "slider",
      "range": [16, 30]
    }
  ]
}

// 对应语音指令
{
  "commands": [
    {
      "phrase": "打开客厅灯",
      "data": {
        "id": "living_room_light",
        "value": 1
      }
    },
    {
      "phrase": "关闭客厅灯",
      "data": {
        "id": "living_room_light",
        "value": 0
      }
    },
    {
      "phrase": "空调调到26度",
      "data": {
        "id": "ac_temperature",
        "value": 26
      }
    }
  ]
}

快速检查清单¶

在提交配置前，请检查：

[ ] 所有组件都有唯一的标识ID
[ ] 语音指令中的id与组件ID完全一致
[ ] JSON格式正确，无语法错误
[ ] ID命名符合规范
[ ] 已进行功能测试
[ ] 记录了所有ID的对应关系

完成以上检查后，即可正常使用语音控制设备功能。