# 设备控制

# 播放内容

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

# 错误码定义及描述

errorCode errorMsg 描述
0 请求成功 成功
8400001 必填参数不能为空 必填参数不能为空
8400002 请求参数不合法 请求参数格式不正确,或者参数不满足需要的条件
8400003 设备token无效 设备token无效
8400005 未发现需要更新的唤醒词 上传的唤醒词都在使用中
8400006 未发现设备sdk版本
8401001 唤醒词打分异常 唤醒词打分异常
8401002 唤醒词正在制作中 唤醒词正在制作中
8404444 调用第三方服务异常 调用第三方服务异常
8409999 系统异常 联系管理员