1. StreamPackage 频道与端点
在 StreamPackage 中创建用于接收 HLS 的频道和播放端点。之后将该频道指定为 StreamLive 的输出目的地,并关联 CSS 播放域名。
准备工作
- 确认 StreamPackage 与 CSS 的使用权限。
- 选择要使用的地域。本示例以首尔(ap-seoul)为基准。
- 准备 CSS 播放域名,并确认 DNS 及 HTTPS 证书设置。
- 使用能与现有运营频道区分开的测试用名称。
1. 创建频道
在 StreamPackage 控制台中选择目标地域,然后点击 Create Channel。
| 项目 | 示例设置 | 含义 |
|---|---|---|
| Name | demo_channel | 频道区分名称 |
| Input Protocol | HLS | 从 StreamLive 接收的格式 |
| Max Segment Duration | 不小于源切片长度 | 可接收的切片最大长度 |
| Max Playlist Duration | 不小于源列表长度 | 可接收的播放列表最大长度 |
最大长度不是用于生成输出切片的设置,而是为接收输入而设置的限制值。官方文档中的默认值分别为 15 秒 和 600 秒,请根据实际输入条件设置。
选择 Create 后,在频道详情页面中确认名称 / ID / 输入协议。

在频道详情的 Details 中确认名称 / ID / 协议。Input 是接收地址,Output Endpoint 是播放地址,CDN 是确认分发连接的标签页。截图中的名称和 ID 仅为示例,请使用实际操作的频道的值。
2. 确认输入地址
在频道详情的 Input 中确认自动生成的两个输入地址。
如果使用输入 HTTP 认证,请将下发的用户名和密码同时应用到推流侧。

实际输入地址已做脱敏处理。请在各个输入行中确认地址,并应用到推流侧。
3. 创建播放端点
- 在频道详情中选择 Create Endpoint。
- 输入端点名称,并将类型指定为 HLS。
- 将 Manifest Name 指定为
index。如果使用默认值main,最终文件名也会是main.m3u8。 - 设置所需的 IP 访问策略与 AuthKey。AuthKey 是使用 HTTP 请求头
X-TENCENT-PACKAGE的认证方式,因此请确认实际请求方能否发送该请求头。 - 在基础直播播放确认中,仅在有时移 / DRM 等需求时才配置附加功能。
- 通过 Confirm 保存,并确认生成的 Endpoint URL。
端点创建完成与视频播放成功是两个独立的步骤。

当前控制台的播放列表名称字段为 Playback List Name。它对应官方文档中的 Manifest Name,若使用默认值 main,则会生成为 main.m3u8。

以上截图仅显示常规 HLS 端点行,播放地址已做遮挡处理。实际操作时请确认该行的 URL 与 Details。
4. 关联 CSS 播放域名
在频道详情的 CDN 标签页中确认访问权限与分发配置。两个方向的权限都需要。
| 方向 | 需要的原因 |
|---|---|
| StreamPackage → CSS | 在 StreamPackage 中配置 CSS 播放域名 |
| CSS → StreamPackage | CSS 拉取打包源站的视频 |
在 Authorization 流程中确认服务角色的权限并授权后,确认 CSS 侧 StreamPackage 的使用权限是否为 Activated 状态。如无权限,请向账号管理员申请。
权限设置完成后,在 Edit Configuration 中指定播放域名,并通过 Confirm 保存。新域名需要按 DNS 服务商的说明注册 CNAME。若要通过 HTTPS 播放,播放域名还需要有效的证书。

Enabled 是控制台中的启用状态。DNS 解析、HTTPS 证书有效性、实际源站访问与视频播放成功需要另行验证。
5. 传递到下一步的信息
| 信息 | 使用位置 |
|---|---|
| StreamPackage 频道 ID | StreamLive 的 HLS_STREAM_PACKAGE 输出目的地 |
| 输入地址与所需的认证信息 | 确认推流设置 |
| Endpoint URL | 确认源站直接播放 |
| CSS 播放域名 | 观众播放地址 |
CDN 播放地址是将已关联的 Endpoint URL 的域名替换为 CSS 播放域名,并保持路径不变。
接下来是 2. StreamLive 输入与频道。全部连通后,在 4. 推流并确认播放 中分别检查源站与 CDN。
测试结束
确认是否被其他服务占用后,停止测试推流。如需删除,请确认 CDN 关联及端点依赖关系,先移除端点,再删除频道。
官方文档
使用 API 配置的方式
以下命令是控制台流程的替代方案。被脱敏的 ID 与地址需替换为实际值。
创建频道
协议指定为 HLS。
tccli mdp CreateStreamPackageChannel \
--region ap-seoul \
--Name justinkim_quickstart \
--Protocol HLS{
"Info": {
"Id": "6AA6************32BF",
"Name": "justinkim_quickstart",
"Protocol": "HLS"
}
}响应中的 Id 从下一步开始会持续使用。
频道名称如 streamlive_quickstart 所示,使用英文 / 数字 / 下划线。
创建端点
端点是决定“打包结果以何种形式输出”的单位。这里创建一个 HLS 单端点。
tccli mdp CreateStreamPackageChannelEndpoint \
--region ap-seoul \
--Id 6AA6************32BF \
--Name justinkim_quickstart_hls \
--Protocol HLS \
--Manifest index \
--AuthInfo '{"WhiteIpList":,"BlackIpList":,"AuthKey":""}'Manifest:设为index时,index.m3u8会成为主播放列表AuthInfo:此处留空。在运营环境中请务必配置 IP 限制或认证密钥
确认地址
tccli mdp DescribeStreamPackageChannel \
--region ap-seoul \
--Id 6AA6************32BF{
"Points": {
"Inputs": [
{
"Url": "https://13******46.ap-seoul.streampackage.srclivepush.myqcloud.com/v1/01a0****96005/01a0****96006"
},
{
"Url": "https://13******46.ap-seoul.streampackage.srclivepush.myqcloud.com/v1/01a0****96005/01a0****96007"
}
],
"Endpoints": [
{
"Name": "justinkim_quickstart_hls",
"Url": "https://13******46.ap-seoul.streampackage.srclivepull.myqcloud.com/v1/01a0****96005/01a0****86d1/index.m3u8",
"Protocol": "HLS",
"Manifest": "index"
}
]
}
}关联 CSS 播放域名
将 CSS 播放域名绑定到 StreamPackage 频道。本示例使用已在 Seoul 地域注册的域名 cdn.。
tccli mdp BindNewLVBDomainWithChannel \
--region ap-seoul \
--ChannelId 6AA6************32BF \
--LVBDomain cdn.{
"LVBDomain": "cdn."
}绑定完成后,仅将端点 URL 的域名替换为播放域名的地址就是 CSS 播放地址。路径保持不变。
https://cdn.CDN 关联完成后,请确认源站访问权限、认证、请求路径 / 查询参数、DNS / TLS 以及实际播放。变更前请先确认相应的请求区间。
配置结果
| 项目 | 值 |
|---|---|
| Channel | justinkim_quickstart (6AA6************32BF) |
| Endpoint | justinkim_quickstart_hls |
| Input URL (StreamLive 推送的目标) | https://13****<strong>46.ap-seoul.streampackage.srclivepush.myqcloud.com/v1/01a0</strong><strong>96005/01a0</strong>**96006 |
| Endpoint URL (源站) | https://13****<strong>46.ap-seoul.streampackage.srclivepull.myqcloud.com/v1/01a0</strong><strong>96005/01a0</strong>**86d1/index.m3u8 |
| CSS 播放 URL | https://cdn. |