获取语音对讲链接地址_标准协议

接口调用说明

请求地址 : /v1/api/device/video/get_voice_url_standard
请求方式 : POST

请求头

参数名 参数值 是否必须
Content-Type application/json
X-Token 实际accessToken

请求报文体

名称 类型 是否必须 备注
deviceSn String 设备序列号
channelId int 视频通道号
streamUUID String 流UUID(字母,数字,下划线),最长 42 位,可以为一个随机数,断流时候使用,如果不传,后台会自动生成一个
protocolType string 协议类型 取值:wss、rtmp
userIp String 终端用户公网ip,用于就近选择策略
maxPlayDuration number 拉流时长限定 单位(s) 1<=maxPlayDuration<=2592000;服务端根据输入maxPlayDuration值会通知客户端进行断流操作,如客户端未主动断开,服务端会在maxPlayDuration值后延迟10s被动断开,具体可参考SDK错误码
针对标准协议,建议设置的maxPlayDuration不宜过低,过低可能会出现还未出图就断开连接的情况
//示例数据
{
    "deviceSn" : "**********",//设备序列号
    "channelId" : 0 ,//视频通道号
    "streamUUID":"1234567890956789uytrewqwerty23",
    "protocolType":"wss",
    "userIp":"1.1.1.1",
    "maxPlayDuration": 120
}

响应报文

名称 类型 是否必须 备注
code int 状态码
msg String 状态码解释信息
data Object 返回内容(详情见下表)

data内容如下:

名称 类型 是否必须 备注
url object 语音转发地址
streamUUID String 本次流ID , 长度限制42字符 , 不传或传空平台自动生成
//示例数据
{
    "code": 1000,
    "msg": "OK",
    "data": {
        "url": "wss://xxx.xx.x.xxx:7070/voice/12421SSBxxxx?token=xxxxxxxxxxxxxxxxx.xxxxxxxxxxxxxxxx.xxxxxxxxxxxxxxxxxxxxxx",
        "streamUUID": "123456789056789uytrewqwerty123"
    }
}

错误码

状态码 状态描述
1000 成功
1001 参数错误
1002 请求异常
1006 AccessToken异常
1008 内部服务异常
2002 设备不在线
2006 设备能力不支持
2008 设备不存在
2009 视频通道号不合法
2014 通道不在线
2017 通道未启用
4002 获取语音对讲链接地址异常

results matching ""

    No results matching ""