API 文档

直播时移

最近更新时间:2020-07-17 16:12:17

直播时移依托云直播录制的能力,将 TS(Transport Stream)分片地址和 TS 文件单独存放,保存于云点播系统中。客户端通过时移播放域名传入时间参数,可以播放当前时间之前的精彩视频内容。

时移原理

在常见的 HLS 视频直播中,推流视频内容被切成多个 TS 分片。用户观看时,通过请求 m3u8 文件来访问 TS 分片地址,获取到 TS 文件,进而观看到直播流内容。这种情况下,因为 TS 文件内容不会持久化保存,用户无法回溯当前时间之前的直播视频内容。

注意事项

开启时移功能将产生点播流量和点播存储费用,请知悉。详细可参见云点播 价格总览

时移使用

前提条件

步骤1:开通云点播服务

  1. 进入 云点播控制台,单击【立即开通】。
  2. 勾选开通服务协议,单击【确定】即可成功开通云点播服务,并访问云点播控制台。

步骤2:添加时移播放域名

您需要添加用于时移播放的云点播域名,具体操作如下:

  1. 进入【云点播控制台】>【分发播放管理】>【域名管理】。
  2. 单击【添加域名】并填写已备案的云点播域名,具体操作请参见 分发播放设置
  3. 完成新增域名 CNAME 配置操作,具体请参见 CNAME 配置 快速添加域名解析

步骤3:关联录制模板

  1. 进入【云直播控制台】>【功能模板】>【录制配置】。
  2. 单击【+】创建录制模板,具体操作请参见 录制模板配置
    注意:

    • 选择录制文件类型为 HLS 格式,开启 HLS 录制。
    • 自定义文件存储时长,且该时长不得短于 时移时长
  3. 将录制模板关联到所需配置的推流域名,具体操作请参见 录制配置

步骤4:开通时移服务

提工单 并选择问题所属产品为“云直播”,提出开通时移服务申请要求,并提供以下参数:

  • 步骤2 中已添加的云点播时移播放域名
  • 步骤3 中的录制模板 ID。
  • 自定义时移时长 timeshift_dur,单位:秒。
    说明:

    • 时移时长:指时移可以看多长时间的内容(目前最长可配置时移7天内的内容)。
    • 此项并不保证绝对精准,按需求配置的前提下,建议多加一小段时间。
    • 假设配置为7200(2小时):表示当前可请求2小时前到现在的时移内容(即 delay 相对时移时长可为90s - 2小时);时移超过2小时前的内容,即使有直播内容,也会返回 HTTP 404

播放请求

请求 URL 格式

http://[Domain]/timeshift/[AppName]/[StreamName]/timeshift.m3u8?delay=xxx

参数说明

参数 说明
[Domain] 您注册的时移服务访问域名,即您在云点播控制台上添加的 时移播放域名
timeshift 固定字段,无须修改
[AppName] 应用名称,若您的应用名称是 live,那么请填 live
[StreamName] 流名称,填您请求对应的流名称
timeshift.m3u8 固定字段,无须修改
delay 表示相对时移时长,单位秒。目前该值小于90,后台可调整成90

示例

假设当前时移域名为 testtimeshift.com,时移应用名称为 live,流名称为 SLPUrIFzGPE,若您需要时移该地址5分钟前的直播内容,则请求 URL 如下:

http://testtimeshift.com/timeshift/live/SLPUrIFzGPE/timeshift.m3u8?delay=300
目录