StreamPackage 端点
端点是将频道的输入以播放列表形式提供给观众拉取的输出配置。输入地址用于推流,端点 URL 用于播放,两者需加以区分。
前置准备
确认频道与输入协议,并决定播放格式、访问策略、是否需要时移和 DRM。基础的 HLS 播放确认请在不启用附加功能的情况下开始,所需功能另行单独验证。
在控制台创建
- 打开频道详情的 Output Endpoint 页签。
- 选择 Create Output Endpoint。
- 指定 Name 和 Type。
- 填写 Playback List Name。它对应官方文档中的 Manifest Name。
- 确认所需的 IP Restriction / AuthKey / 时移 / DRM 配置。
- 点击 Confirm 保存,并在生成的列表中确认 URL。


截图中的 URL 已做脱敏处理。请在实际控制台中复制自己的地址。默认播放列表名称 main 在 HLS 中对应 main.m3u8。如果改成了 index,则必须请求 index.m3u8。
访问策略
| 配置 | 确认事项 |
|---|---|
| IP 限制 | 区分实际请求方是播放器还是 CDN 的回源请求节点 |
| AuthKey | 基于 HTTP 请求头 X-TENCENT-PACKAGE 的认证 |
| HTTPS | 为播放域名配置有效的证书 |
| DRM | 确认支持的输出格式与许可证对接条件 |
AuthKey 用于回源请求的认证请求头。请在 CDN 中配置所需的认证信息传递,并妥善保管认证值。
API 查询
bash
tccli mdp DescribeStreamPackageChannel --region ap-seoul --Id YOUR_CHANNEL_ID将查询结果中的端点名称 / 协议 / Manifest / URL 与控制台进行比对。各协议的支持取值以及字段是否必填,请确认所用 API 版本的参数结构。
时移
启用 Time-shifted Viewing 后,即可针对已保存的直播片段构造播放请求。请求的区间必须落在实际已保存的范围之内。
text
https://YOUR_HOST/YOUR_ENDPOINT/main.m3u8?timeshift=1&start=2026-09-18T00:00:00Z&end=2026-09-18T01:00:00Z按官方说明,开始时刻必须落在 Startover Windows 之内,结束时刻必须晚于开始时刻。指定开始 / 结束所返回的区间最长为 24 小时。
与广告插播的区分
SSAI 需在配置正片源 / ADS / 会话之后,再确认广告插播。请按顺序先验证普通 HLS 播放,再验证广告对接。
完成确认与删除
依次确认主播放列表、媒体播放列表、实际分片以及视频 / 音频。删除前请确认正在使用的 CDN 和播放器地址。已删除的端点重新创建后,URL 可能会发生变化。