直播时移依托云直播录制的能力,将 TS(Transport Stream)分片地址和 TS 文件单独存放,保存于云点播系统中。客户端通过时移播放域名传入时间参数,可以播放当前时间之前的精彩视频内容。
时移原理
在常见的 HLS 视频直播中,推流视频内容被切成多个 TS 分片。用户观看时,通过请求 m3u8 文件来访问 TS 分片地址,获取到 TS 文件,进而观看到直播流内容。
注意
因为 TS 文件内容不会持久化保存,用户无法回溯时移时长之前的直播视频内容。
注意事项
如需查看旧版时移计费信息相关接口,请参看(旧版)直播时移计费信息查询。
时移使用
前提条件
已 注册腾讯云 账号,并完成实名认证。
已开通腾讯云直播服务,并添加 推流域名。
步骤1:开通云点播服务
1. 进入 云点播控制台,单击 立即开通。
2. 勾选开通服务协议,单击 确定 即可成功开通云点播服务,并访问云点播控制台。
步骤2:添加时移播放域名
您需要添加用于时移播放的云点播域名,具体操作如下:
1. 进入 云点播控制台>分发播放管理>域名管理。
2. 单击 添加域名 并填写已备案的云点播域名,具体操作请参见 分发播放设置。
3. 完成新增域名 CNAME 配置操作,具体请参见 CNAME 配置 快速添加域名解析。
步骤3:关联录制模板
1. 进入 云直播控制台 > 功能配置 > 直播录制。
2. 单击 创建录制模板,具体操作请参见 录制模板配置。
3. 将录制模板关联到所需配置的推流域名,具体操作请参见 录制配置。
步骤4:开通时移服务
提工单 并选择问题所属产品为“云直播 CSS”,提出开通时移服务申请要求,并提供以下参数:
步骤2 中已添加的云点播时移播放域名。
步骤3 中的录制模板 ID。
自定义时移时长
timeshift_dur
,单位:秒。说明
时移时长:指时移可以看多长时间的内容(目前最长可配置时移30天内的内容)。
此项并不保证绝对精准,按需求配置的前提下,建议多加一小段时间。
假设配置为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