直播时移

时移直播原理

时移直播基于常规的HLS视频直播，直播推流被切分成TS分片，通过HLS协议向播放用户分发，用户请求的m3u8播放文件中包含不断刷新的TS分片地址；对于常规的HLS直播而言，TS分片地址及相应的TS文件并不持久化保存，导致当前时间之前的直播视频内容无法回溯；而对于开通了时移功能的HLS直播而言，TS分片地址及相应TS文件会分别在数据库和OSS中持久化保存最长30天，使得回溯从直播开始时间到当前时间之间的视频内容成为可能。

时移配置

时移功能可以在直播控制台自助开通使用。

时移请求参数

常规HLS直播地址形如 http://domain/app/stream.m3u8，为实现时移播放需要在此直播地址基础上追加时移相关参数。

必备参数

aliyunols= on

时间相关的参数

key格式：lhs_{type}_{format}_{unit}_{zone}

示例

• lhs_start_human_s_8=20170809200010

• lhs_start_unix_s_0=1502280113

• lhs_offset_unix_ms_0=1800000（向前时移30min）

请求示例

http://xxx.com/live/channel1.m3u8?aliyunols=on&lhs_start_human_s_8=20171024160220&lhs_end_human_s_8=20171024160420

时间轴查询

查询某个流历史某段时间内哪些时间段有时移数据。

• url：http://{$domain}/openapi/timeline/query

  说明

  此处的{$domain}需替换为自己的播流域名。

• method：GET

• params

  • aliyunols（required）：on

  • app（required）：app。

  • stream（required）：流名。

  • format（required）：指定查询ts或者flv格式的时移数据。

  • lhs_start_unix_s_0（required）：开始时间的时间戳（单位s）。

  • lhs_end_unix_s_0（required）：结束时间的时间戳（单位s）。

    说明

    如果用户开启了CDN的鉴权，需要加上对应的鉴权参数。

• response（JSON格式）。

  • current：表示当前系统时间，播放器可以基于这个字段对时。

  • timeline：一个数组，数组的元素是一个map，表示一段有效的时移时间段，包含如下字段。

  • timeline[i].start：有效片段的开始时间戳（单位s）。

  • timeline[i].end：有效片段的结束时间戳（单位s）。

• example

  http://{$domain}/openapi/timeline/query?aliyunols=on&app=bbb&stream=cc&format=ts&lhs_end_unix_s_0=1513334270&lhs_start_unix_s_0=1513334255

  带鉴权的示例：

  http://{$domain}/openapi/timeline/query?auth_key=1606204918-0-0-3e898a5f491fedb113d17aad7c091dde&aliyunols=on&app=zzb-test&stream=zzb-shiyi&format=ts&lhs_start_unix_s_0=1606200900&lhs_end_unix_s_0=1606202520

• 鉴权生成

  • 控制台生成

    在直播控制台对应播流域名下的访问控制--URL鉴权处生成鉴权地址，然后再拼接时移参数即可。

    

  • API生成

    直播也提供了API生成鉴权URL的方式，详情参考鉴权代码示例。

• response

  {"retCode":0,"description":"success","content":{"current":1514269063,"timeline":[{"start":1514269054,"end":1514269058},{"start":1514269058,"end":1514269062}]}}'