跳到内容

StreamPackage 频道配置 ​

更新时间

创建 StreamPackage 频道后,会生成两个用于接收流的输入。本步骤先准备频道与推流对接,下一步再创建供观看的端点。

开始前的准备 ​

  • 确认你拥有访问 StreamPackage 控制台 的权限。
  • 确定任务地域与推流协议。本示例使用首尔地域和 HLS 输入。
  • 如需对接 StreamLive,则需要在输出组中指定打包器频道 ID。该 ID 可在频道创建后查看。

StreamLive 与打包输入的对接

1. 创建频道 ​

  1. 在控制台中选择任务地域。
  2. 选择 Create Channel。
  3. 将频道名称指定为 demo_package,输入协议指定为 HLS。
  4. 确认分片与播放列表的长度限制后,选择 Create。
项目含义配置时的确认事项
Input Protocol进入频道的流所使用的协议需与推流侧的 HLS 或 DASH 配置一致
Max Segment Duration可接收分片的最大长度官方文档默认值为 15 秒。请设置为能够容纳实际推流分片长度
Max Playlist Duration可接收播放列表的最大总长度官方文档默认值为 600 秒。请以输入列表的总播放时长为准进行确认

使用主 / 备输入时,官方文档建议将 Max Segment Duration 设置得比实际分片长度略有余量。

2. 确认频道 ID 与输入 ​

在频道详情的 Details 中确认名称 / ID / 输入协议。Input 是接收地址,Output Endpoint 是播放地址,CDN 则是确认分发对接的页签。

StreamPackage 频道详情:确认频道名称 / ID / HLS 协议

StreamPackage Input:确认两个输入及认证状态

截图中的资源名称与 ID 仅用于界面说明。请使用你实际要操作的频道取值。输入地址已做脱敏处理。

有两个输入意味着系统提供了两条接收路径。只有确认到推流系统是否向两条路径都发送了信号、以及切换后时间戳与播放是否连续,才算验证了冗余。

3. 对接推流系统 ​

推流方式要填入的目标地址配置位置
StreamLive 的 HLS_STREAM_PACKAGE 输出StreamPackage 频道 IDStreamLive 输出组的目标地址
外部 HLS 推流系统从控制台复制的输入 URL 以及所需的 HTTP 认证信息该推流系统的传输配置

StreamLive 专用输出组中需指定 StreamPackage 频道 ID。外部推流则使用输入 URL。

4. 输入认证 ​

可在 Input 页签的 Authentication 中配置 HTTP 认证。启用认证后,推流系统侧也必须应用对应的用户名与密码。

  • 输入 HTTP 认证控制的是谁可以推入流。
  • 端点的 AuthKey 是使用 X-TENCENT-PACKAGE 请求头的另一套认证配置。
  • 面向观众的 CDN URL 签名则是 CDN 的独立认证策略。

输入认证、端点认证、CDN 认证需在各自的环节分别应用。

执行 Rotate credentials 会使现有认证信息失效。在生产推流过程中,请把推流侧的认证信息变更与生效时点一并规划好。

5. 创建端点后验证接收 ​

  1. 按 端点配置 创建 HLS 播放地址。
  2. 从推流系统向该频道发送流。
  3. 至少两次获取播放列表,确认媒体序号或分片列表是否在向前推进。
  4. 请求列表中的分片,并用播放器确认视频与音频。

确认输入 URL / 协议 / HTTP 认证 / 推流状态,并检查输入接收与播放列表更新 / 缓存响应。

用 API 创建 / 查询 ​

请在已配置 TCCLI 认证的环境中执行。创建命令会生成新的资源。

bash
tccli mdp CreateStreamPackageChannel --region ap-seoul --Name demo_package --Protocol HLS

从创建响应中获取 ID,并应用到下一条命令。

bash
tccli mdp DescribeStreamPackageChannel --region ap-seoul --Id REPLACE_CHANNEL_ID

输入地址可从 API 查询响应或控制台复制。

缓存配置的层次区分 ​

频道的分片 / 播放列表长度限制、API 的缓存相关配置、CDN TTL、播放器缓冲,属于互不相同的层次。

直播播放列表会持续变化,因此如果反复拿到的都是缓存响应,播放位置可能会被拖后。请一并确认 CDN 的 TTL 与缓存键、响应的缓存请求头,以及连续查询到的播放列表的变化情况。API 字段的单位与作用对象,请先确认所用 API 版本中的定义再做变更。

收尾与清理 ​

测试结束后停止推流,并按 CDN 对接 / 端点 / 频道的顺序清理。请先确认资源 ID 及其使用 / 引用关系后再进行。

参考文档 ​

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