# 设备控制
# 播放内容
HTTP Method:POST
请求地址:https://uvs-biz.hivoice.cn/rest/v1/device_control/command
参数 | 类型 | 必填 | 描述 |
---|---|---|---|
appkey | String | Y | 产品KEY |
deviceId | String | Y | 设备标识 |
deviceToken | String | Y | 设备令牌 |
userId | String | Y | 用户ID |
commandType | String | Y | 操作终端指令的类型(具体参数值参考指令对应信息) |
payload | String | N | 指令辅助参数 |
controlType参数对应表格:
指令名 | 指令类型 | 指令辅助参数 | 备注说明 |
---|---|---|---|
恢复出厂设置 | system.factory_reset | ||
重启 | system.reboot | ||
关机 | system.power_off | ||
解除授权绑定 | system.revoke_authorization | ||
检查更新 | system.check_software_update | ||
立即更新 | system.update_software | ||
音量控制 | speaker.set_volume | {"volume":50, "type":"percent"} | volume,type必填 |
播放控制 | playback_control.command | {"type":"类型", "resourceId":"资源ID", "offset":播放位置, "targetOffset":目标播放位置} | type值:"PAUSE","RESUME", "NEXT","FAST_FORWARD", "PREVIOUS","FAST_REWIND"。 type, resourceId必填 |
返回值
参数 | 类型 | 必填 | 描述 |
---|---|---|---|
errorCode | String | Y | 响应code,成功为0,具体见错误码定义 |
errorMsg | String | Y | 响应描述 |
返回结果示例:
{
"errorCode": "0",
"errorMsg": "请求成功"
}
1
2
3
4
2
3
4
# 错误码定义及描述
errorCode | errorMsg | 描述 |
---|---|---|
0 | 请求成功 | 成功 |
8400001 | 必填参数不能为空 | 必填参数不能为空 |
8400002 | 请求参数不合法 | 请求参数格式不正确,或者参数不满足需要的条件 |
8400003 | 设备token无效 | 设备token无效 |
8400005 | 未发现需要更新的唤醒词 | 上传的唤醒词都在使用中 |
8400006 | 未发现设备sdk版本 | |
8401001 | 唤醒词打分异常 | 唤醒词打分异常 |
8401002 | 唤醒词正在制作中 | 唤醒词正在制作中 |
8404444 | 调用第三方服务异常 | 调用第三方服务异常 |
8409999 | 系统异常 | 联系管理员 |