W70W 防水音柱云喇叭 API
W70W 防水音柱云喇叭 API
适用型号:W70W,设备序列号前缀为W70W。本文接口对应W70W系列固件能力;不同版本返回字段可能有差异,以设备查询结果为准。W70W使用独立型号身份,固件升级文件必须与型号一致。
应用凭证请在硬件云平台获取。所有请求使用POST、Content-Type: application/json。凭证和序列号通过环境变量填写,不在示例中保存真实值。
1.注册设备
简要描述
将W70W设备绑定到当前应用,成功后再调用控制接口。
请求URL
https://wdev.wmj.com.cn/deviceApi/register
请求方式
POST
请求参数
{
"app_id": "{{wmjv2appid}}",
"app_secret": "{{wmjv2appsecret}}",
"device_sn": "{{device_sn}}"
}
| 参数 | 类型 | 说明 |
|---|---|---|
| app_id | string | 应用ID,必填 |
| app_secret | string | 应用密钥,必填 |
| device_sn | string | W70W设备序列号,必填 |
返回示例
{
"code": 0,
"msg": "注册成功"
}
2.查询在线状态
简要描述
查询云端连接状态。online或兼容字段on_line为1表示在线、0表示离线。
W70W操作示范
适用设备为序列号以W70W开头的WiFi防水音柱。将环境变量device_sn填写为实际W70W序列号,wmjv2appid和wmjv2appsecret填写为当前应用凭证。不能用W70B或W70R序列号替代。
- 首次接入:注册设备 → 查询在线状态 → 查询设备信息,确认project=W70W。
- 单次播报:设置默认音量 → 播放文本语音 → 查询播放状态。play使用speed=5表示正常档位。
- 离线循环:开始循环播报 → 查询播放状态,等loop_persistent和loop_cache_ready都为true → 验证离线及重启恢复;结束时调用停止循环播报。
- 定时任务:查询定时播报 → 设置单组定时播报 → 再查询核对 → 重启后再次核对。第1组index=0,工作日weekdays=62,定时speed=1.0表示正常倍率。
- OTA:从正式发布记录取得W70W应用固件地址和版本 → 填写OTA环境变量 → 发送升级 → 等待重新上线 → 查询设备信息核对sw_ver。
- 更换所属应用:在原应用解绑设备,再在新应用注册。
平台code=0和设备data.info.code=0需分别检查。播放、循环和升级接口返回成功,均不等于实际出声、缓存完成或升级完成。不要把恢复出厂、清空全部定时或解绑加入自动批量演示流程。
请求URL
https://wdev.wmj.com.cn/deviceApi/getOnLine
请求方式
POST
请求参数
{
"app_id": "{{wmjv2appid}}",
"app_secret": "{{wmjv2appsecret}}",
"device_sn": "{{device_sn}}"
}
| 参数 | 类型 | 说明 |
|---|---|---|
| app_id | string | 应用ID,必填 |
| app_secret | string | 应用密钥,必填 |
| device_sn | string | W70W设备序列号,必填 |
返回示例
{
"code": 0,
"data": {
"on_line": 1
},
"msg": "查询成功"
}
3.查询设备信息
简要描述
查询设备型号、版本、音量、上电配置和定时状态。以下返回仅列出公开业务字段。
请求URL
https://wdev.wmj.com.cn/deviceApi/send
请求方式
POST
请求参数
{
"app_id": "{{wmjv2appid}}",
"app_secret": "{{wmjv2appsecret}}",
"device_sn": "{{device_sn}}",
"type": 1,
"data": {
"cmd_type": "getdevinfo",
"info": {}
}
}
| 参数 | 类型 | 说明 |
|---|---|---|
| app_id | string | 应用ID,必填 |
| app_secret | string | 应用密钥,必填 |
| device_sn | string | W70W设备序列号,必填 |
| type | int | 固定传1 |
| data.cmd_type | string | getdevinfo |
| data.info | object | 本接口参数对象,无参数时传空对象 |
返回示例
{
"code": 0,
"data": {
"device_sn": "{{device_sn}}",
"cmd": "getdevinfo",
"info": {
"code": 0,
"err_code": 0,
"msg": "",
"project": "W70W",
"hw_ver": "2.0.0",
"sw_ver": "W70W.2.47",
"net_type": "wifi",
"volume": 5,
"volume_percent": 50,
"time_synced": true,
"schedule_enabled_count": 1,
"schedule_total_count": 20,
"schedule_storage_ready": true,
"schedule_storage_revision": 1
}
}
}
schedule_storage_ready为定时存储是否就绪,schedule_storage_revision为保存修订号;保存后读回并比较任务内容。time_synced为校时状态。仅对W70W对应能力固件使用这些字段。
4.播放文本语音
简要描述
播放一段文本。返回TTS started表示任务已接受,实际播放状态需继续查询。播放参数只用于本次任务,默认音量使用setting保存。
请求URL
https://wdev.wmj.com.cn/deviceApi/send
请求方式
POST
请求参数
{
"app_id": "{{wmjv2appid}}",
"app_secret": "{{wmjv2appsecret}}",
"device_sn": "{{device_sn}}",
"type": 1,
"data": {
"cmd_type": "play",
"info": {
"tts": "欢迎使用W70W防水音柱。",
"volume": 5,
"speaker": "prompt_female_high",
"speed": 5,
"number_mode": "value",
"refresh_cache": false
}
}
}
| 参数 | 类型 | 说明 |
|---|---|---|
| app_id | string | 应用ID,必填 |
| app_secret | string | 应用密钥,必填 |
| device_sn | string | W70W设备序列号,必填 |
| type | int | 固定传1 |
| data.cmd_type | string | play |
| data.info | object | 本接口参数对象,无参数时传空对象 |
| data.info.tts | string | 必填;1-2047个UTF-8字节,兼容text |
| data.info.volume | int | 可选;1-10档;省略或0使用默认音量 |
| data.info.volume_percent | int | 可选;精确百分比,优先于volume;建议静音通过setting设置 |
| data.info.speaker | string | 可选;示例prompt_female_high,其他音色须由所用合成服务支持 |
| data.info.speed | number | 可选;建议使用1-9档,5为正常;不要把1.0当作正常倍率 |
| data.info.number_mode | string | value按数值读;digit逐位读 |
| data.info.num_step | int | 可选;传递给合成服务的分段步长,按服务能力设置 |
| data.info.refresh_cache | bool | false复用缓存,true重新合成;不宜每次都刷新 |
返回示例
{
"code": 0,
"data": {
"device_sn": "{{device_sn}}",
"cmd": "play",
"info": {
"code": 0,
"err_code": 0,
"msg": "TTS started",
"volume_arg": 5
}
}
}
5.查询播放状态
简要描述
播放状态会随任务推进变化;is_playing=false不代表循环任务已被清除,循环间隔内也可能为false。
请求URL
https://wdev.wmj.com.cn/deviceApi/send
请求方式
POST
请求参数
{
"app_id": "{{wmjv2appid}}",
"app_secret": "{{wmjv2appsecret}}",
"device_sn": "{{device_sn}}",
"type": 1,
"data": {
"cmd_type": "get_play_status",
"info": {}
}
}
| 参数 | 类型 | 说明 |
|---|---|---|
| app_id | string | 应用ID,必填 |
| app_secret | string | 应用密钥,必填 |
| device_sn | string | W70W设备序列号,必填 |
| type | int | 固定传1 |
| data.cmd_type | string | get_play_status |
| data.info | object | 本接口参数对象,无参数时传空对象 |
返回示例
{
"code": 0,
"data": {
"device_sn": "{{device_sn}}",
"cmd": "get_play_status",
"info": {
"code": 0,
"err_code": 0,
"msg": "",
"is_playing": false,
"is_loop_playing": true,
"loop_persistent": true,
"loop_cache_ready": true,
"loop_interval_ms": 30000
}
}
}
is_playing表示当前正在播放,is_loop_playing表示循环启用,loop_persistent表示循环已保存,loop_cache_ready表示该循环缓存就绪,loop_interval_ms的单位为毫秒。
6.设置默认音量
简要描述
将默认音量保存到设备,重启后保留。精确音量可改传volume_percent。设置后调用getdevinfo读回。
请求URL
https://wdev.wmj.com.cn/deviceApi/send
请求方式
POST
请求参数
{
"app_id": "{{wmjv2appid}}",
"app_secret": "{{wmjv2appsecret}}",
"device_sn": "{{device_sn}}",
"type": 1,
"data": {
"cmd_type": "setting",
"info": {
"volume": 6
}
}
}
| 参数 | 类型 | 说明 |
|---|---|---|
| app_id | string | 应用ID,必填 |
| app_secret | string | 应用密钥,必填 |
| device_sn | string | W70W设备序列号,必填 |
| type | int | 固定传1 |
| data.cmd_type | string | setting |
| data.info | object | 本接口参数对象,无参数时传空对象 |
| data.info.volume | int | 0-10档,0静音;与volume_percent二选一 |
| data.info.volume_percent | int | 0-100,优先于volume |
返回示例
{
"code": 0,
"data": {
"device_sn": "{{device_sn}}",
"cmd": "setting",
"info": {
"code": 0,
"err_code": 0,
"msg": ""
}
}
}
7.设置上电播报
简要描述
保存上电播报配置。首次文本缓存未就绪时需联网合成;设置成功不等于离线缓存已经生成。
请求URL
https://wdev.wmj.com.cn/deviceApi/send
请求方式
POST
请求参数
{
"app_id": "{{wmjv2appid}}",
"app_secret": "{{wmjv2appsecret}}",
"device_sn": "{{device_sn}}",
"type": 1,
"data": {
"cmd_type": "setting",
"info": {
"pwr_on_enabled": 1,
"pwr_on_text": "欢迎使用W70W防水音柱。",
"pwr_on_delay": 3,
"pwr_on_volume": 3,
"pwr_on_repeat": 1
}
}
}
| 参数 | 类型 | 说明 |
|---|---|---|
| app_id | string | 应用ID,必填 |
| app_secret | string | 应用密钥,必填 |
| device_sn | string | W70W设备序列号,必填 |
| type | int | 固定传1 |
| data.cmd_type | string | setting |
| data.info | object | 本接口参数对象,无参数时传空对象 |
| data.info.pwr_on_enabled | int/bool | 0关闭,1开启 |
| data.info.pwr_on_text | string | 最多540个UTF-8字节 |
| data.info.pwr_on_delay | int | 启动后延迟秒数,0-3600 |
| data.info.pwr_on_volume | int | 独立音量档位0-10 |
| data.info.pwr_on_repeat | int | 重复次数1-10 |
返回示例
{
"code": 0,
"data": {
"device_sn": "{{device_sn}}",
"cmd": "setting",
"info": {
"code": 0,
"err_code": 0,
"msg": ""
}
}
}
8.开始循环播报
简要描述
保存循环配置并开始循环。interval单位为秒,是循环等待间隔。首次联网合成且loop_cache_ready=true后,设备可使用本地缓存离线循环,重启后恢复;缓存被清理或不可用时仍需联网生成。
请求URL
https://wdev.wmj.com.cn/deviceApi/send
请求方式
POST
请求参数
{
"app_id": "{{wmjv2appid}}",
"app_secret": "{{wmjv2appsecret}}",
"device_sn": "{{device_sn}}",
"type": 1,
"data": {
"cmd_type": "loop_play",
"info": {
"tts": "欢迎使用W70W防水音柱。",
"volume": 5,
"speaker": "prompt_female_high",
"speed": 5,
"number_mode": "value",
"refresh_cache": false,
"interval": 30
}
}
}
| 参数 | 类型 | 说明 |
|---|---|---|
| app_id | string | 应用ID,必填 |
| app_secret | string | 应用密钥,必填 |
| device_sn | string | W70W设备序列号,必填 |
| type | int | 固定传1 |
| data.cmd_type | string | loop_play |
| data.info | object | 本接口参数对象,无参数时传空对象 |
| data.info.tts | string | 必填,文本与play一致 |
| data.info.interval | int | 1-86400秒;不传或小于等于0按5秒 |
| data.info.volume / speaker / speed / number_mode | 混合 | 与play一致;speed建议用5表示正常 |
返回示例
{
"code": 0,
"data": {
"device_sn": "{{device_sn}}",
"cmd": "loop_play",
"info": {
"code": 0,
"err_code": 0,
"msg": ""
}
}
}
9.停止循环播报
简要描述
停止循环并清除持久化循环配置,重启后不再恢复该循环。
请求URL
https://wdev.wmj.com.cn/deviceApi/send
请求方式
POST
请求参数
{
"app_id": "{{wmjv2appid}}",
"app_secret": "{{wmjv2appsecret}}",
"device_sn": "{{device_sn}}",
"type": 1,
"data": {
"cmd_type": "loop_stop",
"info": {}
}
}
| 参数 | 类型 | 说明 |
|---|---|---|
| app_id | string | 应用ID,必填 |
| app_secret | string | 应用密钥,必填 |
| device_sn | string | W70W设备序列号,必填 |
| type | int | 固定传1 |
| data.cmd_type | string | loop_stop |
| data.info | object | 本接口参数对象,无参数时传空对象 |
返回示例
{
"code": 0,
"data": {
"device_sn": "{{device_sn}}",
"cmd": "loop_stop",
"info": {
"code": 0,
"err_code": 0,
"msg": ""
}
}
}
10.停止全部播放
简要描述
停止当前语音并清除循环配置;不会删除定时播报任务。
请求URL
https://wdev.wmj.com.cn/deviceApi/send
请求方式
POST
请求参数
{
"app_id": "{{wmjv2appid}}",
"app_secret": "{{wmjv2appsecret}}",
"device_sn": "{{device_sn}}",
"type": 1,
"data": {
"cmd_type": "stop_play",
"info": {}
}
}
| 参数 | 类型 | 说明 |
|---|---|---|
| app_id | string | 应用ID,必填 |
| app_secret | string | 应用密钥,必填 |
| device_sn | string | W70W设备序列号,必填 |
| type | int | 固定传1 |
| data.cmd_type | string | stop_play |
| data.info | object | 本接口参数对象,无参数时传空对象 |
返回示例
{
"code": 0,
"data": {
"device_sn": "{{device_sn}}",
"cmd": "stop_play",
"info": {
"code": 0,
"err_code": 0,
"msg": ""
}
}
}
11.查询定时播报
简要描述
返回20个定时槽位、当前时间和校时状态;先确认time_synced=true再验证定时执行。 返回示例仅展示第一个槽位,实际返回完整列表。
请求URL
https://wdev.wmj.com.cn/deviceApi/send
请求方式
POST
请求参数
{
"app_id": "{{wmjv2appid}}",
"app_secret": "{{wmjv2appsecret}}",
"device_sn": "{{device_sn}}",
"type": 1,
"data": {
"cmd_type": "get_tts_schedules",
"info": {}
}
}
| 参数 | 类型 | 说明 |
|---|---|---|
| app_id | string | 应用ID,必填 |
| app_secret | string | 应用密钥,必填 |
| device_sn | string | W70W设备序列号,必填 |
| type | int | 固定传1 |
| data.cmd_type | string | get_tts_schedules |
| data.info | object | 本接口参数对象,无参数时传空对象 |
返回示例
{
"code": 0,
"data": {
"device_sn": "{{device_sn}}",
"cmd": "get_tts_schedules",
"info": {
"code": 0,
"err_code": 0,
"msg": "",
"time_synced": true,
"current_time": "2026-11-03 11:00:00",
"weekday": 2,
"schedules": [
{
"index": 0,
"enabled": true,
"hour": 12,
"minute": 0,
"weekdays": 62,
"tts_text": "温馨提醒,请注意安全。",
"repeat_count": 1,
"speaker": "prompt_female_high",
"speed": 1.0,
"number_mode": "digit"
}
]
}
}
}
12.设置单组定时播报
简要描述
按index替换一组任务,必须传完整任务字段;未传字段会使用默认值。保存成功后查询并核对,重启后再次查询验证保持。定时使用北京时间,尚未校时不会触发。
请求URL
https://wdev.wmj.com.cn/deviceApi/send
请求方式
POST
请求参数
{
"app_id": "{{wmjv2appid}}",
"app_secret": "{{wmjv2appsecret}}",
"device_sn": "{{device_sn}}",
"type": 1,
"data": {
"cmd_type": "set_tts_schedule",
"info": {
"index": 0,
"enabled": true,
"hour": 12,
"minute": 0,
"weekdays": 62,
"tts_text": "温馨提醒,请注意安全。",
"repeat_count": 1,
"speaker": "prompt_female_high",
"speed": 1.0,
"number_mode": "digit"
}
}
}
| 参数 | 类型 | 说明 |
|---|---|---|
| app_id | string | 应用ID,必填 |
| app_secret | string | 应用密钥,必填 |
| device_sn | string | W70W设备序列号,必填 |
| type | int | 固定传1 |
| data.cmd_type | string | set_tts_schedule |
| data.info | object | 本接口参数对象,无参数时传空对象 |
| data.info.index | int | 必填0-19;小程序第1组对应0,第20组对应19 |
| data.info.enabled | bool | true启用,false停用 |
| data.info.hour / minute | int | 小时0-23,分钟0-59 |
| data.info.weekdays | int | 星期位掩码;周日1、周一2、周二4、周三8、周四16、周五32、周六64;每天127、工作日62、周末65 |
| data.info.tts_text | string | 最多255个UTF-8字节,中文通常每字3字节;不要超长截断 |
| data.info.repeat_count | int | 1-10,未传默认3 |
| data.info.speaker | string | 合成服务支持的音色名称 |
| data.info.speed | number | 定时使用倍率;1.0表示正常,与play的兼容档位不同 |
| data.info.number_mode | string | digit或value,默认digit |
返回示例
{
"code": 0,
"data": {
"device_sn": "{{device_sn}}",
"cmd": "set_tts_schedule",
"info": {
"code": 0,
"err_code": 0,
"msg": ""
}
}
}
13.批量设置定时播报
简要描述
替换整张定时表,未包含的槽位将清空。只改一组请用set_tts_schedule;批量替换前先读取并保留其余任务。
请求URL
https://wdev.wmj.com.cn/deviceApi/send
请求方式
POST
请求参数
{
"app_id": "{{wmjv2appid}}",
"app_secret": "{{wmjv2appsecret}}",
"device_sn": "{{device_sn}}",
"type": 1,
"data": {
"cmd_type": "set_tts_schedules",
"info": {
"schedules": [
{
"index": 0,
"enabled": true,
"hour": 12,
"minute": 0,
"weekdays": 62,
"tts_text": "温馨提醒,请注意安全。",
"repeat_count": 1,
"speaker": "prompt_female_high",
"speed": 1.0,
"number_mode": "digit"
}
]
}
}
}
| 参数 | 类型 | 说明 |
|---|---|---|
| app_id | string | 应用ID,必填 |
| app_secret | string | 应用密钥,必填 |
| device_sn | string | W70W设备序列号,必填 |
| type | int | 固定传1 |
| data.cmd_type | string | set_tts_schedules |
| data.info | object | 本接口参数对象,无参数时传空对象 |
| data.info.schedules | array | 最多20项,每项字段同单组任务;建议显式提供index |
返回示例
{
"code": 0,
"data": {
"device_sn": "{{device_sn}}",
"cmd": "set_tts_schedules",
"info": {
"code": 0,
"err_code": 0,
"msg": ""
}
}
}
14.清除单组定时播报
简要描述
删除指定槽位,其他任务保持。
请求URL
https://wdev.wmj.com.cn/deviceApi/send
请求方式
POST
请求参数
{
"app_id": "{{wmjv2appid}}",
"app_secret": "{{wmjv2appsecret}}",
"device_sn": "{{device_sn}}",
"type": 1,
"data": {
"cmd_type": "clear_tts_schedule",
"info": {
"index": 0
}
}
}
| 参数 | 类型 | 说明 |
|---|---|---|
| app_id | string | 应用ID,必填 |
| app_secret | string | 应用密钥,必填 |
| device_sn | string | W70W设备序列号,必填 |
| type | int | 固定传1 |
| data.cmd_type | string | clear_tts_schedule |
| data.info | object | 本接口参数对象,无参数时传空对象 |
| data.info.index | int | 0-19 |
返回示例
{
"code": 0,
"data": {
"device_sn": "{{device_sn}}",
"cmd": "clear_tts_schedule",
"info": {
"code": 0,
"err_code": 0,
"msg": ""
}
}
}
15.清除全部定时播报
简要描述
清空全部20组任务,执行前确认已保留业务侧备份。
请求URL
https://wdev.wmj.com.cn/deviceApi/send
请求方式
POST
请求参数
{
"app_id": "{{wmjv2appid}}",
"app_secret": "{{wmjv2appsecret}}",
"device_sn": "{{device_sn}}",
"type": 1,
"data": {
"cmd_type": "clear_all_tts_schedules",
"info": {}
}
}
| 参数 | 类型 | 说明 |
|---|---|---|
| app_id | string | 应用ID,必填 |
| app_secret | string | 应用密钥,必填 |
| device_sn | string | W70W设备序列号,必填 |
| type | int | 固定传1 |
| data.cmd_type | string | clear_all_tts_schedules |
| data.info | object | 本接口参数对象,无参数时传空对象 |
返回示例
{
"code": 0,
"data": {
"device_sn": "{{device_sn}}",
"cmd": "clear_all_tts_schedules",
"info": {
"code": 0,
"err_code": 0,
"msg": ""
}
}
}
16.配置WiFi
简要描述
保存新的WiFi名称和密码并切换连接。设备切换期间会暂时离线;请先确认目标网络可用。
请求URL
https://wdev.wmj.com.cn/deviceApi/send
请求方式
POST
请求参数
{
"app_id": "{{wmjv2appid}}",
"app_secret": "{{wmjv2appsecret}}",
"device_sn": "{{device_sn}}",
"type": 1,
"data": {
"cmd_type": "wifi_config",
"info": {
"wifi_name": "{{wifi_ssid}}",
"wifi_pwd": "{{wifi_password}}"
}
}
}
| 参数 | 类型 | 说明 |
|---|---|---|
| app_id | string | 应用ID,必填 |
| app_secret | string | 应用密钥,必填 |
| device_sn | string | W70W设备序列号,必填 |
| type | int | 固定传1 |
| data.cmd_type | string | wifi_config |
| data.info | object | 本接口参数对象,无参数时传空对象 |
| data.info.wifi_name | string | 目标WiFi名称 |
| data.info.wifi_pwd | string | 目标WiFi密码,使用环境变量填写 |
返回示例
{
"code": 0,
"data": {
"device_sn": "{{device_sn}}",
"cmd": "wifi_config",
"info": {
"code": 0,
"err_code": 0,
"msg": ""
}
}
}
17.重启设备
简要描述
设备接受后重启。恢复联网后重新读取状态,确认已保存的配置和任务。
请求URL
https://wdev.wmj.com.cn/deviceApi/send
请求方式
POST
请求参数
{
"app_id": "{{wmjv2appid}}",
"app_secret": "{{wmjv2appsecret}}",
"device_sn": "{{device_sn}}",
"type": 1,
"data": {
"cmd_type": "restart",
"info": {}
}
}
| 参数 | 类型 | 说明 |
|---|---|---|
| app_id | string | 应用ID,必填 |
| app_secret | string | 应用密钥,必填 |
| device_sn | string | W70W设备序列号,必填 |
| type | int | 固定传1 |
| data.cmd_type | string | restart |
| data.info | object | 本接口参数对象,无参数时传空对象 |
返回示例
{
"code": 0,
"data": {
"device_sn": "{{device_sn}}",
"cmd": "restart",
"info": {
"code": 0,
"err_code": 0,
"msg": ""
}
}
}
18.OTA升级
简要描述
仅填写经发布确认的W70W应用OTA地址,并与设备硬件版本匹配。不能使用W70B/W70R文件,也不能使用4MB量产或合并镜像。返回成功仅表示升级任务被接受,重连后必须查询getdevinfo确认版本。
请求URL
https://wdev.wmj.com.cn/deviceApi/send
请求方式
POST
请求参数
{
"app_id": "{{wmjv2appid}}",
"app_secret": "{{wmjv2appsecret}}",
"device_sn": "{{device_sn}}",
"type": 1,
"data": {
"cmd_type": "set_ota",
"info": {
"url": "{{w70w_ota_url}}",
"hw_ver": "{{w70w_hw_ver}}",
"sw_ver": "{{w70w_sw_ver}}"
}
}
}
| 参数 | 类型 | 说明 |
|---|---|---|
| app_id | string | 应用ID,必填 |
| app_secret | string | 应用密钥,必填 |
| device_sn | string | W70W设备序列号,必填 |
| type | int | 固定传1 |
| data.cmd_type | string | set_ota |
| data.info | object | 本接口参数对象,无参数时传空对象 |
| data.info.url | string | 已发布W70W应用OTA文件URL;当前示例不预置未验收版本地址 |
| data.info.hw_ver | string | 先查询设备硬件版本后填写,例如2.0.0 |
| data.info.sw_ver | string | 与所选镜像一致,例如W70W.x.xx;不要填写70.2.47 |
返回示例
{
"code": 0,
"data": {
"device_sn": "{{device_sn}}",
"cmd": "set_ota",
"info": {
"code": 0,
"err_code": 0,
"msg": ""
}
}
}
19.恢复出厂设置
简要描述
清除设备配置并重启,需要重新配网及设置播报任务。请在确需恢复时单独执行。
请求URL
https://wdev.wmj.com.cn/deviceApi/send
请求方式
POST
请求参数
{
"app_id": "{{wmjv2appid}}",
"app_secret": "{{wmjv2appsecret}}",
"device_sn": "{{device_sn}}",
"type": 1,
"data": {
"cmd_type": "reset",
"info": {}
}
}
| 参数 | 类型 | 说明 |
|---|---|---|
| app_id | string | 应用ID,必填 |
| app_secret | string | 应用密钥,必填 |
| device_sn | string | W70W设备序列号,必填 |
| type | int | 固定传1 |
| data.cmd_type | string | reset |
| data.info | object | 本接口参数对象,无参数时传空对象 |
返回示例
{
"code": 0,
"data": {
"device_sn": "{{device_sn}}",
"cmd": "reset",
"info": {
"code": 0,
"err_code": 0,
"msg": ""
}
}
}
20.解绑设备
简要描述
解除当前应用与设备绑定;后续控制需重新注册。解绑不是恢复出厂设置。
请求URL
https://wdev.wmj.com.cn/deviceApi/logout
请求方式
POST
请求参数
{
"app_id": "{{wmjv2appid}}",
"app_secret": "{{wmjv2appsecret}}",
"device_sn": "{{device_sn}}"
}
| 参数 | 类型 | 说明 |
|---|---|---|
| app_id | string | 应用ID,必填 |
| app_secret | string | 应用密钥,必填 |
| device_sn | string | W70W设备序列号,必填 |
返回示例
{
"code": 0,
"msg": "解绑成功"
}
更新日志
| 日期 | 内容 |
|---|---|
| 2026-11-03 | 新增W70W独立API目录和操作示范,覆盖播放、离线循环、音量、上电播报、20组定时、WiFi、OTA及注册解绑,补充保存读回与升级完成确认方法 |
最后编辑:极客师傅 更新时间:2026-11-03 14:36