获取设备本地录像播放地址,按时间段-标准协议

接口调用说明

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

请求头

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

请求报文体

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

响应报文

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

data内容如下:

名称 类型 是否必须 备注
url String 播放地址URL-ws协议,有效期180S,超时后无法拉流,需要重新获取播放地址
streamUUID String 流UUID
//示例数据
{
    "code": 1000,
    "msg": "OK",
    "data": {
        "url": "wss://xxx.xxx.xxx.xx:8080?token=xxxxxxxxxxxxxx.xxxxxxxxxxxxxxx.xxxxxxxxxxxxxxx",
        "streamUUID":"1234567890956789uytrewqwerty23"
    }
}

错误码

状态码 状态描述
1000 成功
1001 参数错误
1002 请求异常
1006 AccessToken异常
2002 设备不在线
2006 设备能力不支持
2008 设备不存在
2009 视频通道号不合法
2017 通道未启用
4002 获取录像地址异常
4003 资源不存在

results matching ""

    No results matching ""