时移回看
更新时间:2022-02-17
接口描述
本接口用于发起视频直播的时移回看请求,返回hls文件内容。
注意: 仅当设备录制格式为M3U8,且空间开启时移配置时,该接口可用。
请求(Request)
请求URI
GET https://{domain}/{app}/{stream}.m3u8?start={start}&end={end}×tamp={timestamp}&token={token}
参数名称 | 类型 | 是否必需 | 描述 |
---|---|---|---|
domain | String | 是 | 设备所属空间的下行播放域名 |
app | String | 是 | 设备流的app |
stream | String | 是 | 设备流的stream |
start | Integer | 是 | 时移回看开始时间,Unix时间戳,单位秒,形如"1617261115" |
end | Integer | 否 | 时移回看结束时间,Unix时间戳,单位秒,形如"1617261132" |
timestamp | Integer | 否 | 鉴权计算时间戳 |
token | String | 否 | 鉴权计算token |
注意: 时移请求即仅指定start参数,返回内容包含从start时间到当前时间的所有ts切片; 回看请求即同时指定start、end参数,返回这个时间区间内的所有ts切片。 timestamp和token的计算规则和「获取播流链接」接口相同。
timestamp={now}
token=HmacSha256("{domain}/{app}/{stream};{timestamp}", {key})
// 从「查询空间」或「查询设备」接口获取到downstreamAuth参数,可以得到key,expire即token的有效期。
请求头域
除公共头域外,无其它特殊头域。
请求体
无。
响应(Response)
响应头域
除公共头域外,无其它特殊头域。
响应体
响应体内容即推流或播流链接。
示例
请求示例
GET https://evs.down.baidu.com/app/stream.m3u8?start=1617179125&end=1617179284×tamp=1617261346&token=8cd2a1ad5005c6e8000b2af4b030d21bd8131e88dd3a6b1cc10d951e5bbb12a1 HTTP/1.1
响应示例
HTTP/1.1 200 OK
Server: openresty/1.13.6.2
Date: Thu, 01 Apr 2021 07:25:30 GMT
Content-Type: application/vnd.apple.mpegurl
Transfer-Encoding: chunked
Connection: keep-alive
Access-Control-Allow-Origin: *
#EXTM3U
#EXT-X-VERSION:3
#EXT-X-ALLOW-CACHE:NO
#EXT-X-TARGETDURATION:21
#EXT-X-MEDIA-SEQUENCE:1617178826
#EXTINF:20.32
https://evs.down.baidu.com/bcxk5pym7wpt7e64w8b/evs/record/1000001/ts/1617179125.ts
#EXTINF:20.52
https://evs.down.baidu.com/bcxk5pym7wpt7e64w8b/evs/record/1018859/ts/1617179146.ts
#EXTINF:19.4
https://bcxk1aa77f28kadm63i.down.evs.bcelive.com/bcxk5pym7wpt7e64w8b/evs/record/1018859/ts/1617179165.ts
#EXTINF:19.12
https://bcxk1aa77f28kadm63i.down.evs.bcelive.com/bcxk5pym7wpt7e64w8b/evs/record/1018859/ts/1617179184.ts
#EXT-X-ENDLIST
错误码
参考公共错误码。