# 设备控制
# 播放内容
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 | 系统异常 | 联系管理员 |