2.1 状态属性
状态属性是产品的基础物模型，决定了产品的功能。
通过下发命令、人为操作可改变这些状态属性；
如果是传感器类或具备采样功能的产品，环境变化也会设备状态属性变化。
通过下发命令、人为操作可改变这些状态属性；
如果是传感器类或具备采样功能的产品，环境变化也会设备状态属性变化。
| 属性 | 选项 | 值 | 说明 |
|---|---|---|---|
|
状态 status |
空闲 | 0 | |
| 播放中 | 1 | ||
|
灯带 led |
亮 | 1 | |
| 灭 | 0 | ||
|
音量 volume |
0 | 0 | |
| 1 | 1 | ||
| 2 | 2 | ||
| 3 | 3 | ||
| 4 | 4 | ||
| 5 | 5 | ||
| 6 | 6 | ||
| 7 | 7 | ||
| 8 | 8 | ||
| 9 | 9 | ||
|
音色 voice |
女声 | 0 | |
| 男声 | 1 | ||
|
语速 speed |
0 | 0 | |
| 1 | 1 | ||
| 2 | 2 | ||
| 3 | 3 | ||
| 4 | 4 | ||
| 5 | 5 | ||
| 6 | 6 | ||
| 7 | 7 | ||
| 8 | 8 | ||
| 9 | 9 | ||
|
语调 tone |
0 | 0 | |
| 1 | 1 | ||
| 2 | 2 | ||
| 3 | 3 | ||
| 4 | 4 | ||
| 5 | 5 | ||
| 6 | 6 | ||
| 7 | 7 | ||
| 8 | 8 | ||
| 9 | 9 |
2.2 设备指令
设备支持以下命令，可通过接口向设备下发这些命令。
在私有化（Broker、网关等任何方式）时，发送命令方式不同，但内容完全相同。
在私有化（Broker、网关等任何方式）时，发送命令方式不同，但内容完全相同。
系统命令（所有产品均支持）
| 名称 | 内容 | 说明 |
|---|---|---|
| 网络信息 | {"system":"network"} | 查看设备当前的网络信息：网络类型、信号强度、IP地址等 |
| 软重启 | {"system":"restart"} | 重启设备，并尽可能的保持当前状态 |
| 硬重启 | {"system":"reboot"} | 重启设备，放弃当前状态 |
本产品的命令
| 命令 | 名称 | 内容 | 说明 |
|---|---|---|---|
|
播报 play:gbk:16 |
到账提醒 | {"play:gbk:16":"支付宝到账200元"} | |
| 业务提醒 | {"play:gbk:16":"你好，小程序上有新的业务线索：河北的刘先生要定制一款小程序，请及时处理"} | ||
| 工作通知(男声) | {"play:gbk:16":"[m1]小王，请你到一下张总的办公室"} | ||
| 长文本 | {"play:gbk:16":"今天天气非常晴朗，暖暖的太阳照在人身上真舒服。我不禁的感叹：这真是美好的一天。最长不要超过50个字符，如果超过50个，可分多条连续下发命令。"} | ||
| 提示音+文字 | {"play:gbk:16":"[message_3]欢迎光临"} | ||
| 数字 | {"play:gbk:16":"ID为[n1]888，手机号码为[n3]18500860080的客户，共消费[n2]1888元，优惠100元。"} | ||
| 多音字 | {"play:gbk:16":"请把空调调[=diao4]转一下角度"} | ||
| 停顿 | {"play:gbk:16":"你[w0]好，你好"} | ||
|
重复 repeat |
重复播报3次 | {"repeat":"3"} | |
|
铃声 ring |
1 | {"ring":"1"} | |
| 2 | {"ring":"2"} | ||
| 3 | {"ring":"3"} | ||
| 4 | {"ring":"4"} | ||
| 5 | {"ring":"5"} | ||
|
提示音 message |
1 | {"message":"1"} | |
| 2 | {"message":"2"} | ||
| 3 | {"message":"3"} | ||
| 4 | {"message":"4"} | ||
| 5 | {"message":"5"} | ||
|
警示音 alert |
1 | {"alert":"1"} | |
| 2 | {"alert":"2"} | ||
| 3 | {"alert":"3"} | ||
| 4 | {"alert":"4"} | ||
| 5 | {"alert":"5"} | ||
|
停止 stop |
停止当前 | {"stop":"0"} | |
| 全部停止 | {"stop":"1"} | ||
|
灯带 led |
开 | {"led":"1"} | |
| 关 | {"led":"0"} | ||
| 恢复默认 | {"led":"default"} | ||
|
颜色 color |
红 | {"color":"[255,0,0]"} | |
| 绿 | {"color":"[0,255,0]"} | ||
| 蓝 | {"color":"[0,0,255]"} | ||
| 黄 | {"color":"[255,255,0]"} | ||
| 青 | {"color":"[0,255,255]"} | ||
| 紫 | {"color":"[255,0,255]"} | ||
| 白 | {"color":"[255,255,255]"} | ||
|
闪烁 twinkle |
快 | {"twinkle":"100"} | |
| 慢 | {"twinkle":"500"} | ||
| 停 | {"twinkle":"0"} | ||
|
呼吸 breath |
快 | {"breath":"1000"} | |
| 慢 | {"breath":"2000"} | ||
| 停 | {"breath":"0"} | ||
|
多彩 colorful |
红蓝切换 | {"colorful":"{"speed":1500,"colors":[[155,0,0],[0,0,155]]}"} | |
| 三色切换 | {"colorful":"{"speed":1500,"colors":[[155,0,0],[0,155,0],[0,0,155]]}"} | ||
| 停 | {"colorful":"{"speed":0}"} |
2.2 触发事件
当设备属性状态值因为下面两个原因发生改变时触发：
1. 自身状态变化（如传感器的数值发生变化）；
2. 人为操作（按下了设备按钮）
事件被触发后，平台会携带设备当前状态参数，实时上报消息，
具体机制在“第5节：消息推送”有详细描述
1. 自身状态变化（如传感器的数值发生变化）；
2. 人为操作（按下了设备按钮）
事件被触发后，平台会携带设备当前状态参数，实时上报消息，
具体机制在“第5节：消息推送”有详细描述
公共事件（所有产品均支持）
| 名称 | 内容 | 说明 | |
|---|---|---|---|
| 开机 | {"name":"boot","state":{当前属性值}} | 设备加电、云端登记后触发，上报时携带当前状态（各功能属性的值） | |
本产品的事件
| 事件 | 名称 | 说明 |
|---|---|---|
| 按下按钮 | btn1 |
2.3 配置项
所有的配置项均保存在设备的Flash中，因为Flash有擦写次数限制，
所以平台未开放批量修改设备配置的接口，您可以在控制台来修改设备的配置项。
所有配置项均有默认值，如不了解配置项目意义，请勿随意修改；
修改配置项只有在设备在线时，才能成功下发并保存，并且不需要重启设备。
所以平台未开放批量修改设备配置的接口，您可以在控制台来修改设备的配置项。
所有配置项均有默认值，如不了解配置项目意义，请勿随意修改；
修改配置项只有在设备在线时，才能成功下发并保存，并且不需要重启设备。
配置项
| 配置项 | 名称 | 内容 | 说明 |
|---|---|---|---|
|
按钮 btn |
静音/恢复 | volume | |
| 禁用 | disable | ||
|
led灯 led |
长亮 | open | |
| 长灭 | close | ||
| 长亮｜静音时灭 | volume | ||
| 长灭｜播放时亮 | play | ||
|
开机提示音 boot_message |
无 | 0 | |
| 提示音1 | 1 | ||
| 提示音2 | 2 | ||
| 提示音3 | 3 | ||
| 提示音4 | 4 | ||
| 提示音5 | 5 | ||
|
上线提示音 online_message |
无 | 0 | |
| 提示音1 | 1 | ||
| 提示音2 | 2 | ||
| 提示音3 | 3 | ||
| 提示音4 | 4 | ||
| 提示音5 | 5 | ||
|
操作提示音 oper_message |
无 | 0 | |
| 提示音1 | 1 | ||
| 提示音2 | 2 | ||
| 提示音3 | 3 | ||
| 提示音4 | 4 | ||
| 提示音5 | 5 | ||
|
led灯色彩 led_color |
红 | [120,0,0] | |
| 绿 | [0,120,0] | ||
| 蓝 | [0,0,120] |
附. 固件列表
固件更新的原则是兼容性升级，即：新的固件版本会保留原有的功能和指令。
如果当前固件可满足业务需求，则可以不升级最新版本的固件。
如果当前固件可满足业务需求，则可以不升级最新版本的固件。
最近10个
| 版本 | ID | 大小 | 发布日期 | 说明 |
|---|---|---|---|---|
|
V19 p35.20251222.v19 |
id.1580 | 282.65 KB | 2026-01-05 22:28:21 | 无 |
| id.1581 | 282.65 KB | 2026-01-05 22:31:40 | 无 | |
| id.1583 | 282.65 KB | 2026-01-05 22:35:04 | 无 | |
| id.1584 | 282.65 KB | 2026-01-05 22:37:47 | 无 | |
| id.1571 | 284.72 KB | 2026-01-05 14:38:01 | 无 | |
| id.1575 | 284.72 KB | 2026-01-05 21:31:25 | 无 | |
|
V18 p35.20251013.v18 |
id.1341 | 282.16 KB | 2025-10-13 16:27:46 | 无 |
| id.1340 | 282.16 KB | 2025-10-13 16:26:09 | 无 | |
| id.1338 | 283.17 KB | 2025-10-13 16:25:53 | 无 | |
| id.1339 | 289.49 KB | 2025-10-13 16:26:08 | 无 | |
|
V17 p35.20250624.v17 |
id.1111 | 282.28 KB | 2025-06-24 16:52:23 | 无 |
| id.1110 | 282.28 KB | 2025-06-24 16:51:24 | 无 | |
| id.1108 | 283.14 KB | 2025-06-24 16:48:14 | 无 | |
| id.1109 | 283.14 KB | 2025-06-24 16:51:23 | 无 | |
|
V16 p35.20250523.v16 |
id.1086 | 301.2 KB | 2025-06-14 14:25:39 | 无 |
| id.1047 | 301.71 KB | 2025-05-23 23:03:05 | 无 | |
| id.1046 | 305 KB | 2025-05-23 23:02:14 | 无 | |
|
V15 p35.20250517.v15 |
id.1031 | 300.88 KB | 2025-05-17 11:36:35 | 无 |
| id.1032 | 304.23 KB | 2025-05-17 11:40:10 | 无 | |
|
V14 p35.20250320.v14 |
id.993 | 286.68 KB | 2025-03-20 15:24:48 | 无 |
| id.994 | 286.68 KB | 2025-03-20 15:25:00 | 无 | |
|
V13 p35.20250102.v13 |
id.933 | 286.8 KB | 2025-01-02 17:36:50 | 无 |
| id.935 | 286.81 KB | 2025-01-02 17:40:17 | 无 | |
|
V12 p35.20241221.v12 |
id.904 | 285.48 KB | 2024-12-21 11:14:33 | 无 |
| id.905 | 285.48 KB | 2024-12-21 11:15:09 | 无 | |
|
V11 p35.20241120.v11 |
id.839 | 281.36 KB | 2024-11-20 18:01:34 | 无 |
| id.840 | 281.36 KB | 2024-11-20 18:01:48 | 无 |