跳到内容

StreamPackage 端点 ​

更新时间

端点是将频道的输入以播放列表形式提供给观众拉取的输出配置。输入地址用于推流,端点 URL 用于播放,两者需加以区分。

前置准备 ​

确认频道与输入协议,并决定播放格式、访问策略、是否需要时移和 DRM。基础的 HLS 播放确认请在不启用附加功能的情况下开始,所需功能另行单独验证。

在控制台创建 ​

  1. 打开频道详情的 Output Endpoint 页签。
  2. 选择 Create Output Endpoint。
  3. 指定 Name 和 Type。
  4. 填写 Playback List Name。它对应官方文档中的 Manifest Name。
  5. 确认所需的 IP Restriction / AuthKey / 时移 / DRM 配置。
  6. 点击 Confirm 保存,并在生成的列表中确认 URL。

HLS 输出端点创建界面

HLS 在端点列表中确认播放地址

截图中的 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 可能会发生变化。

基于 VitePress 构建 · 部署于腾讯云 EdgeOne Pages