StreamPackage 频道配置
创建 StreamPackage 频道后,会生成两个用于接收流的输入。本步骤先准备频道与推流对接,下一步再创建供观看的端点。
开始前的准备
- 确认你拥有访问 StreamPackage 控制台 的权限。
- 确定任务地域与推流协议。本示例使用首尔地域和 HLS 输入。
- 如需对接 StreamLive,则需要在输出组中指定打包器频道 ID。该 ID 可在频道创建后查看。
1. 创建频道
- 在控制台中选择任务地域。
- 选择 Create Channel。
- 将频道名称指定为
demo_package,输入协议指定为 HLS。 - 确认分片与播放列表的长度限制后,选择 Create。
| 项目 | 含义 | 配置时的确认事项 |
|---|---|---|
| Input Protocol | 进入频道的流所使用的协议 | 需与推流侧的 HLS 或 DASH 配置一致 |
| Max Segment Duration | 可接收分片的最大长度 | 官方文档默认值为 15 秒。请设置为能够容纳实际推流分片长度 |
| Max Playlist Duration | 可接收播放列表的最大总长度 | 官方文档默认值为 600 秒。请以输入列表的总播放时长为准进行确认 |
使用主 / 备输入时,官方文档建议将 Max Segment Duration 设置得比实际分片长度略有余量。
2. 确认频道 ID 与输入
在频道详情的 Details 中确认名称 / ID / 输入协议。Input 是接收地址,Output Endpoint 是播放地址,CDN 则是确认分发对接的页签。


截图中的资源名称与 ID 仅用于界面说明。请使用你实际要操作的频道取值。输入地址已做脱敏处理。
有两个输入意味着系统提供了两条接收路径。只有确认到推流系统是否向两条路径都发送了信号、以及切换后时间戳与播放是否连续,才算验证了冗余。
3. 对接推流系统
| 推流方式 | 要填入的目标地址 | 配置位置 |
|---|---|---|
StreamLive 的 HLS_STREAM_PACKAGE 输出 | StreamPackage 频道 ID | StreamLive 输出组的目标地址 |
| 外部 HLS 推流系统 | 从控制台复制的输入 URL 以及所需的 HTTP 认证信息 | 该推流系统的传输配置 |
StreamLive 专用输出组中需指定 StreamPackage 频道 ID。外部推流则使用输入 URL。
4. 输入认证
可在 Input 页签的 Authentication 中配置 HTTP 认证。启用认证后,推流系统侧也必须应用对应的用户名与密码。
- 输入 HTTP 认证控制的是谁可以推入流。
- 端点的 AuthKey 是使用
X-TENCENT-PACKAGE请求头的另一套认证配置。 - 面向观众的 CDN URL 签名则是 CDN 的独立认证策略。
输入认证、端点认证、CDN 认证需在各自的环节分别应用。
执行 Rotate credentials 会使现有认证信息失效。在生产推流过程中,请把推流侧的认证信息变更与生效时点一并规划好。
5. 创建端点后验证接收
- 按 端点配置 创建 HLS 播放地址。
- 从推流系统向该频道发送流。
- 至少两次获取播放列表,确认媒体序号或分片列表是否在向前推进。
- 请求列表中的分片,并用播放器确认视频与音频。
确认输入 URL / 协议 / HTTP 认证 / 推流状态,并检查输入接收与播放列表更新 / 缓存响应。
用 API 创建 / 查询
请在已配置 TCCLI 认证的环境中执行。创建命令会生成新的资源。
tccli mdp CreateStreamPackageChannel --region ap-seoul --Name demo_package --Protocol HLS从创建响应中获取 ID,并应用到下一条命令。
tccli mdp DescribeStreamPackageChannel --region ap-seoul --Id REPLACE_CHANNEL_ID输入地址可从 API 查询响应或控制台复制。
缓存配置的层次区分
频道的分片 / 播放列表长度限制、API 的缓存相关配置、CDN TTL、播放器缓冲,属于互不相同的层次。
直播播放列表会持续变化,因此如果反复拿到的都是缓存响应,播放位置可能会被拖后。请一并确认 CDN 的 TTL 与缓存键、响应的缓存请求头,以及连续查询到的播放列表的变化情况。API 字段的单位与作用对象,请先确认所用 API 版本中的定义再做变更。
收尾与清理
测试结束后停止推流,并按 CDN 对接 / 端点 / 频道的顺序清理。请先确认资源 ID 及其使用 / 引用关系后再进行。