获取设备本地录像地址,按文件名
接口调用说明
请求地址 : /v1/api/device/video/get_playback_url_byfile
请求方式 : POST
请求头
| 参数名 | 参数值 | 是否必须 |
|---|---|---|
| Content-Type | application/json | 是 |
| X-Token | 实际accessToken | 是 |
请求报文体
| 名称 | 类型 | 是否必须 | 备注 |
|---|---|---|---|
| deviceSn | String | 是 | 设备序列号 |
| channelId | int | 是 | 视频通道号 |
| fileName | String | 是 | 文件名 |
| startPos | int | 是 | 相对文件起点的位置,单位:ms 最小0 |
| streamUUID | String | 否 | 本次流ID , 长度限制42字符 , 不传或传空平台自动生成 |
| userIp | String | 否 | 终端用户公网ip,用于就近选择策略 |
| maxPlayDuration | number | 否 | 拉流时长限定 单位(s) 1<=maxPlayDuration<=2592000;服务端根据输入maxPlayDuration值会通知客户端进行断流操作,如客户端未主动断开,服务端会在maxPlayDuration值后延迟10s被动断开,具体可参考SDK错误码 |
//示例数据
{
"deviceSn": "12421SSxxxxxx",
"channelId": 0,
"fileName": "12/22.3",
"startPos": 0,
"streamUUID":"1234567890956789uytrewqwerty23",
"userIp":"1.1.1.1",
"maxPlayDuration": 120
}
响应报文
| 名称 | 类型 | 是否必须 | 备注 |
|---|---|---|---|
| code | int | 是 | 状态码 |
| msg | String | 是 | 状态码解释信息 |
| data | Object | 否 | 返回内容(详情见下表) |
data内容如下:
| 名称 | 类型 | 是否必须 | 备注 |
|---|---|---|---|
| url | object | 是 | p2p连接列表(详情见下表) |
| jvmpUrl | String | 是 | 直播转发地址,有效期180S,超时后无法拉流,需要重新获取播放地址 |
| streamUUID | String | 否 | 本次流ID , 长度限制42字符 , 不传或传空平台自动生成 |
url内容如下:
| 名称 | 类型 | 是否必须 | 备注 |
|---|---|---|---|
| token | object | 是 | 会话token |
| addrs | String[] | 是 | P2P地址 |
| deviceId | String | 是 | 设备ID |
//示例数据
{
"code": 1000,
"msg": "OK",
"data": {
"streamUUID":"1234567890956789uytrewqwerty23"
"jvmpUrl": "jvmp://xxx.xx.x.xxx:7070/vod/**********?token=xxxxxxxxxxxxxx.xxxxxxxxxxxxxxxxx.xxxxxxxxxxxxxxxxxx",
"url": {
"token": "xxxxxxxxxxxxxx.xxxxxxxxxxxxxxxxx.xxxxxxxxxxxxxxxxxx",
"deviceId": "12421SSxxxxxx",
"addrs": ["p2p://xxx.xx.x.xxx:7050/index=0/node_type=1/addr_type=2"]
}
}
}
错误码
| 状态码 | 状态描述 |
|---|---|
| 1000 | 成功 |
| 1001 | 参数错误 |
| 1002 | 请求异常 |
| 1006 | AccessToken异常 |
| 2002 | 设备不在线 |
| 2006 | 设备能力不支持 |
| 2008 | 设备不存在 |
| 2009 | 视频通道号不合法 |
| 2017 | 通道未启用 |
| 4002 | 获取语音对讲链接地址异常 |