了解产品定义（物模型），可以帮助您更加准确、灵活的调用接口，接入设备。
产品定义
2.1 状态属性
2.2 触发事件
2.3 配置项

2.1 状态属性

状态属性是产品的基础物模型，决定了产品的功能。
通过下发命令、人为操作可改变这些状态属性；
如果是传感器类或具备采样功能的产品，环境变化也会设备状态属性变化。
属性 选项 值 说明
线路1
power1 		通 1
断 0
线路2
power2 		通 1
断 0
线路3
power3 		通 1
断 0
线路4
power4 		通 1
断 0
线路5
power5 		通 1
断 0
线路6
power6 		通 1
断 0
线路7
power7 		通 1
断 0
线路8
power8 		通 1
断 0
喇叭状态
status 		空闲 0
播放中 1
喇叭音量
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、网关等任何方式）时，发送命令方式不同，但内容完全相同。
系统命令（所有产品均支持）
名称 内容 说明
网络信息 {"system":"network"} 查看设备当前的网络信息：网络类型、信号强度、IP地址等
软重启 {"system":"restart"} 重启设备，并尽可能的保持当前状态
硬重启 {"system":"reboot"} 重启设备，放弃当前状态
本产品的命令
命令 名称 内容 说明
批量控制
batch 		全开 {"batch":"{"power":1}"}
全关 {"batch":"{"power":0}"}
线路1|3|5|7开 {"batch":"{"relay":[1,3,5,7],"power":1}"}
线路1|3|5|7关 {"batch":"{"relay":[1,3,5,7],"power":0}"}
线路2|4|6|8开 {"batch":"{"relay":[2,4,6,8],"power":1}"}
线路2|4|6|8关 {"batch":"{"relay":[2,4,6,8],"power":0}"}
先通后断
point 		500毫秒，全部线路 {"point":"{"interval":500}"}
1秒，线路1|3 {"point":"{"relay":[1,3],"interval":1000}"}
2秒，线路2 {"point":"{"relay":[2],"interval":2000}"}
先断后通
reset 		500毫秒，全部线路 {"reset":"{"interval":500}"}
1秒，线路1|3 {"reset":"{"relay":[1,3],"interval":1000}"}
2秒，线路2 {"reset":"{"relay":[2],"interval":2000}"}
5秒，线路7 {"reset":"{"relay":["7"],"interval":5000}"}
语音播报
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]好，你好"}
喇叭铃声
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"}

2.2 触发事件

当设备属性状态值因为下面两个原因发生改变时触发：
1. 自身状态变化（如传感器的数值发生变化）；
2. 人为操作（按下了设备按钮）
事件被触发后，平台会携带设备当前状态参数，实时上报消息，
具体机制在“第5节：消息推送”有详细描述
公共事件（所有产品均支持）
名称 内容 说明
开机 {"name":"boot","state":{当前属性值}} 设备加电、云端登记后触发，上报时携带当前状态（各功能属性的值）
本产品的事件
事件 名称 说明
按下按钮 btn1
线路1输入 line1
线路2输入 line2
线路3输入 line3
线路4输入 line4
线路5输入 line5
线路6输入 line6
线路7输入 line7
线路8输入 line8
状态保持 keep

2.3 配置项

所有的配置项均保存在设备的Flash中，因为Flash有擦写次数限制，
所以平台未开放批量修改设备配置的接口，您可以在控制台来修改设备的配置项。
所有配置项均有默认值，如不了解配置项目意义，请勿随意修改；
修改配置项只有在设备在线时，才能成功下发并保存，并且不需要重启设备。
配置项
配置项 名称 内容 说明
按钮动作
btn1 		全断 0 默认
全通 1
禁用 dis 默认
1路开机状态
relay1 		通 1
断 0 默认
2路开机状态
relay2 		通 1
断 0 默认
3路开机状态
relay3 		通 1
断 0 默认
4路开机状态
relay4 		通 1
断 0
5路开机状态
relay5 		通 1
断 0
6路开机状态
relay6 		通 1
断 0
7路开机状态
relay7 		通 1
断 0
7路离线状态
offline7 		通 1
断 0
不理会 no
8路开机状态
relay8 		通 1
断 0
1路输入模式
mode1 		轻触 0
长按 1
1路输入动作
action1 		状态反转 reverse
先断后通 reset
先通后断 point
禁用 disable
1路输入延时
time1 		1秒 1000
2秒 2000
3秒 3000
4秒 4000
5秒 5000
2路输入模式
mode2 		轻触 0
长按 1
2路输入动作
action2 		状态反转 reverse 默认
先断后通 reset
先通后断 point
禁用 disable
2路输入延时
time2 		1秒 1000
2秒 2000
3秒 3000
4秒 4000
5秒 5000
3路输入模式
mode3 		轻触 0
长按 1
3路输入动作
action3 		状态反转 reverse 默认
先断后通 reset
先通后断 point
禁用 disable
3路输入延时
time3 		1秒 1000
2秒 2000
3秒 3000
4秒 4000
5秒 5000
4路输入模式
mode4 		轻触 0
长按 1
4路输入动作
action4 		状态反转 reverse
先断后通 reset
先通后断 point
禁用 disable
4路输入延时
time4 		1秒 1000
2秒 2000
3秒 3000
4秒 4000
5秒 5000
5路输入模式
mode5 		轻触 0
长按 1
5路输入动作
action5 		状态反转 reverse
先断后通 reset
先通后断 point
禁用 disable
5路输入延时
time5 		1秒 1000
2秒 2000
3秒 3000
4秒 4000
5秒 5000
6路输入模式
mode6 		轻触 0
长按 1
6路输入动作
action6 		状态反转 reverse
先断后通 reset
先通后断 point
禁用 disable
6路输入延时
time6 		1秒 1000
2秒 2000
3秒 3000
4秒 4000
5秒 5000
7路输入模式
mode7 		轻触 0
长按 1
7路输入动作
action7 		状态反转 reverse
先断后通 reset
先通后断 point
禁用 disable
7路输入延时
time7 		1秒 1000
2秒 2000
3秒 3000
4秒 4000
5秒 5000
8路输入模式
mode8 		轻触 0
长按 1
8路输入动作
action8 		状态反转 reverse
先断后通 reset
先通后断 point
禁用 disable
8路输入延时
time8 		1秒 1000
2秒 2000
3秒 3000
4秒 4000
5秒 5000
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
消抖
filter 		微 150
低 200
中 250
高 300
负载时序
gap 		无保护 0
间隔1秒 1
间隔2秒 2
间隔3秒 3

附. 固件列表

固件更新的原则是兼容性升级，即：新的固件版本会保留原有的功能和指令。
如果当前固件可满足业务需求，则可以不升级最新版本的固件。
最近10个
版本 ID 大小 发布日期 说明
V8
p96.20260103.v8 		id.1548 285.83 KB 2026-01-03 11:58:59 无
id.1557 276.94 KB 2026-01-03 12:40:42 无
id.1558 285.83 KB 2026-01-03 12:40:42 无
V7
p96.20251022.v7 		id.1351 288.54 KB 2025-10-22 14:56:51 无
id.1352 288.54 KB 2025-10-22 15:02:34 无
V6
p96.20250702.v6 		id.1163 305.86 KB 2025-07-02 11:32:43 无
id.1169 305.86 KB 2025-07-02 11:36:00 无
V5
p96.20241221.v5 		id.908 285.84 KB 2024-12-21 18:25:09 无
id.909 285.85 KB 2024-12-21 18:25:28 无
V4
p96.20241206.v4 		id.872 285.02 KB 2024-12-06 14:35:02 无
id.873 285.02 KB 2024-12-06 14:35:53 无
V3
p96.20241120.v3 		id.835 283.33 KB 2024-11-20 17:55:42 无
id.836 283.33 KB 2024-11-20 17:55:59 无
V2
p96.20241112.v2 		id.798 281.21 KB 2024-11-12 11:57:35 无
id.799 281.21 KB 2024-11-12 11:58:20 无
V1
p96.20241024.v1 		id.764 281.07 KB 2024-10-24 15:57:07 无
id.789 281.07 KB 2024-11-09 12:31:51 无