文档中心>云直播

旧版直播时移(时移总时长)

最近更新时间:2023-05-16 10:19:04

我的收藏
直播时移依托云直播录制的能力,将 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:开通时移服务

提工单 并选择问题所属产品为“云直播 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