帮你快速理解、总结文档立即下载
文档中心>云直播

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

最近更新时间:2025-06-04 10:19:32
我的收藏
直播时移依托云直播录制的能力,将 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