tencent cloud

云直播

动态与公告
公告
新手指南
产品简介
产品概述
子产品简介
基本概念
产品功能
应用场景
产品优势
使用限制
购买指南
计费概述
基础服务费
增值服务费
预付费资源包
购买流程
计费变更
退款说明
账单查询
续费说明
欠费停服说明
计费常见问题
标准直播
概述
应用场景
快速入门
SDK 接入说明
快直播(超低延时直播)
概述
快直播和标准直播区别
应用场景
快速入门
SDK 接入说明
云导播台
概述
应用场景
功能区介绍
云导播台管理
通用云导播
配置节目单和自动导播
控制台指南
控制台介绍
概览
域名管理
流管理
资源包管理
AI 智能
功能配置
拉流转推
计费用量
业务监控
常用工具
无忧直播
CAM 访问控制
功能实践
直播推流与播放
直播增值功能
典型场景实践
云端原生录制
直播安全
海外直播
回调事件消息通知
常见第三方工具指南
SDK 实践
0. SDK 接入引导
1. 推流
2. 播放
3. 高级功能
API 文档
History
Introduction
API Category
Making API Requests
Live Pad APIs
Live Stream Mix APIs
Time Shifting APIs
Monitoring Data Query APIs
Billing Data Query APIs
Live Transcoding APIs
Delayed Playback Management APIs
Domain Name Management APIs
Watermark Management APIs
Certificate Management APIs
Stream Pulling APIs
Recording Management APIs
Live Callback APIs
Screencapturing and Porn Detection APIs
Authentication Management APIs
Live Stream Management APIs
Data Types
Error Codes
运维指南
优化视频卡顿
推流失败问题排查
播放失败问题排查
CLS 协助直播问题排查
直播延迟问题排查
拉流视频质量不清晰问题排查
COS bucket 授权给直播实现截图存储
故障处理
直播混流报错:InvalidParameter.OtherError
常见问题
服务地区相关
直播基础相关
推流播放相关
直播计费相关
直播海外相关
直播录制相关
云端混流相关
域名配置相关
云导播台相关
适配苹果 ATS 相关
服务等级协议
云直播服务等级协议
CSS 政策
隐私协议
数据处理和安全协议
词汇表

直播时移

PDF
聚焦模式
字号
最后更新时间: 2025-12-26 14:24:17
云直播对直播时移进行了全新升级,您可以在控制台创建时移模板便捷开通新版直播时移功能。按拼接规则对直播时移播放地址进行组装,可以在直播中回看直播内容。同时直播时移功能已接入API3.0,请参见 新版直播时移相关接口。通过本文,您将了解新版直播时移的原理和播放请求方式。

注意

新版直播时移目前支持3万人同时观看,如有更大并发时移播放需求,请 提交工单 与我们联系。
如播放域名配置了播放鉴权并设定了有效期,鉴权有效期到期后该时移播放地址将失效。
实现时移播放,需要为时移模板绑定推流域名,同时在播放地址的基础上追加时移播放参数
原通过点播域名拉取时移方式需要通过工单方式评估,相关文档请参见 如何在直播过程中实现回看功能,为了更好的时移体验,推荐使用当前直播时移方案。

前提条件

已开通腾讯云直播服务,并添加 推流域名

时移原理

直播时移通过在直播过程中将媒体流转换成 TS 存储、同时在云端建立 TS 和直播流实时时间的索引关系实现直播回看功能。常用于电视台重播、赛事精彩回看等场景。客户端通过 HLS 协议分发,在 M3U8 请求参数中指定回看的时间(详细参数见 播放请求)。

播放请求

直播时移播放地址格式为 http://domain/appname/stream.m3u8, 要支持时移播放需要在此地址上追加时移参数,下文按时移回看方式分别介绍两种时移相关参数:
回看指定时间区间:可用于播放赛事精彩画面场景,播放内容截止到指定时间。
回看相对当前时间的偏移:可用于延迟直播场景,播放内容截至直播结束。

播放指定时间区间参数

字段名称
含义
是否必选项
例子
txTimeshift
取值 on - 开启直播新时移
txTimeshift=on
tsStart
时移开始时间,至少比当前时间早 30秒,tsStart 与 tsEnd 间隔不能小于1个 Ts 分片时长,不能大于6小时
tsStart=20121010010101
tsEnd
时移结束时间,tsStart 与 tsEnd 间隔不能小于1个 Ts 分片时长,不能大于6小时
tsEnd=20121010010102
tsFormat
tsStart 和 tsEnd 的格式,取值格式{timeformat}_{unit}_{zone}
timeformat 取值:
unix:unix 时间戳, 选了 unix 后面的时区 zone 可以忽略
human:人类可以读的时间 20121010010101
unit:s,单位:s
zone:时区分为东区和西区和中时区(零时区):
东区的取值范围为1~12
西区的取值范围为 -12~-1
tsFormat=unix_s
tsFormat=human_s_8
tsCodecname
转码流需要指定模板名称,原始流和水印流不带这个字段
tsCodecname=hd

请求示例1(unix 格式时间)

http://example.domain.com/live/stream.m3u8?txTimeshift=on&tsFormat=unix_s&tsStart=1675302995&tsEnd=1675303025&tsCodecname=test

请求示例2(human 格式时间)

http://example.domain.com/live/stream.m3u8?txTimeshift=on&tsFormat=human_s_8&tsStart=20230202095635&tsEnd=20230202095705&tsCodecname=test

播放相对当前时间的偏移参数

字段名称
含义
是否必选项
例子
txTimeshift
取值 on - 开启直播新时移
txTimeshift=on
tsDelay
相对当前时间早多少秒
tsDelay=30 播放当前时间30s之前的内容
tsCodecname
转码流需要指定模板名称
tsCodecname=2000

请求示例

http:://example.domain.com/live/stream.m3u8?txTimeshift=on&tsDelay=30&tsCodecname=test

时移鉴权参数

时移和直播鉴权参数保持一致,具体可以 参考文档(官网生成 HLS 地址的有效期为1天,1天后需要重新生成)。

时移索引查询

通过控制台直播时移-索引信息可查询某段时间内的时移流列表,查看详情可查询单个流的详情数据。 通过云 API 也可查询时移流列表和单个流详情,具体参考文档:

帮助和支持

本页内容是否解决了您的问题?

填写满意度调查问卷,共创更好文档体验。

文档反馈