获取实况预览播放地址
接口调用说明
请求地址 : /v1/api/device/video/get_realtime_url
请求方式 : POST
请求头
参数名 | 参数值 | 是否必须 |
---|---|---|
Content-Type | application/json | 是 |
X-Token | 实际accessToken | 是 |
请求报文体
名称 | 类型 | 是否必须 | 备注 |
---|---|---|---|
deviceSn | String | 是 | 设备序列号 |
channelId | int | 是 | 视频通道号 |
streamId | int | 是 | 码流 0<=streamId < streamCount(设备详情接口有返回) ; 0为主码流 非0值为次码流 |
streamUUID | String | 否 | 本次流ID , 长度限制42字符 , 不传或传空平台自动生成(该字段建议开发者自行设定,后面可根据streamUUID进行断流) |
userIp | String | 否 | 终端用户公网ip,用于就近选择策略 |
//示例数据
{
"deviceSn" : "**********",//设备序列号
"channelId" : 0,//视频通道号
"streamId":0,//码流 0<=streamId < streamCount(设备详情接口有返回) ; 0为主码流 非0值为次码流
"streamUUID":"1234567890956789uytrewqwerty23",
"userIp":"1.1.1.1"
}
响应报文
名称 | 类型 | 是否必须 | 备注 |
---|---|---|---|
code | int | 是 | 状态码 |
msg | String | 是 | 状态码解释信息 |
data | Object | 否 | 返回内容(详情见下表) |
data内容如下:
名称 | 类型 | 是否必须 | 备注 |
---|---|---|---|
url | object | 是 | p2p连接列表(详情见下表) |
jvmpUrl | String | 是 | 直播转发地址 |
streamUUID | String | 否 | 本次流ID , 长度限制42字符 , 不传或传空平台自动生成(该字段建议开发者自行设定,后面可根据streamUUID进行断流) |
url内容如下:
名称 | 类型 | 是否必须 | 备注 |
---|---|---|---|
token | object | 是 | 会话token |
addrs | String[] | 是 | P2P地址 |
deviceId | String | 是 | 设备ID |
//示例数据
{
"code": 1000,
"msg": "OK",
"data": {
"streamUUID":"1234567890956789uytrewqwerty23"
"jvmpUrl": "jvmp://xxx.xx.xxx.xxx:7070/live/12421SXXXXXX?token=XXXXXXXXXXXXXXXXXXXXXXXXXX.XXXXXXXXXXXXXXXXXXXXXXXXXX.XXXXXXXXXXXXXXXXXXXXXXXXXX",
"url": {
"token": "XXXXXXXXXXXXXXXXXXXXXXXXXX.XXXXXXXXXXXXXXXXXXXXXXXXXX.XXXXXXXXXXXXXXXXXXXXXXXXXX",
"deviceId": "**********",
"addrs": ["p2p://xxx.xx.xxx.xxx:7050/index=0/node_type=1/addr_type=2"]
}
}
}
错误码
状态码 | 状态描述 |
---|---|
1000 | 成功 |
1001 | 参数错误 |
1002 | 请求异常 |
1006 | AccessToken异常 |
2002 | 设备不在线 |
2008 | 设备不存在 |
2009 | 视频通道号不合法 |
4001 | 获取视频链接地址异常 |