跳到内容

1. StreamPackage 频道与端点 ​

更新时间

在 StreamPackage 中创建用于接收 HLS 的频道和播放端点。之后将该频道指定为 StreamLive 的输出目的地,并关联 CSS 播放域名。

准备工作 ​

  • 确认 StreamPackage 与 CSS 的使用权限。
  • 选择要使用的地域。本示例以首尔(ap-seoul)为基准。
  • 准备 CSS 播放域名,并确认 DNS 及 HTTPS 证书设置。
  • 使用能与现有运营频道区分开的测试用名称。

1. 创建频道 ​

在 StreamPackage 控制台中选择目标地域,然后点击 Create Channel。

项目示例设置含义
Namedemo_channel频道区分名称
Input ProtocolHLS从 StreamLive 接收的格式
Max Segment Duration不小于源切片长度可接收的切片最大长度
Max Playlist Duration不小于源列表长度可接收的播放列表最大长度

最大长度不是用于生成输出切片的设置,而是为接收输入而设置的限制值。官方文档中的默认值分别为 15 秒 和 600 秒,请根据实际输入条件设置。

选择 Create 后,在频道详情页面中确认名称 / ID / 输入协议。

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

在频道详情的 Details 中确认名称 / ID / 协议。Input 是接收地址,Output Endpoint 是播放地址,CDN 是确认分发连接的标签页。截图中的名称和 ID 仅为示例,请使用实际操作的频道的值。

2. 确认输入地址 ​

在频道详情的 Input 中确认自动生成的两个输入地址。

如果使用输入 HTTP 认证,请将下发的用户名和密码同时应用到推流侧。

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

实际输入地址已做脱敏处理。请在各个输入行中确认地址,并应用到推流侧。

3. 创建播放端点 ​

  1. 在频道详情中选择 Create Endpoint。
  2. 输入端点名称,并将类型指定为 HLS。
  3. 将 Manifest Name 指定为 index。如果使用默认值 main,最终文件名也会是 main.m3u8。
  4. 设置所需的 IP 访问策略与 AuthKey。AuthKey 是使用 HTTP 请求头 X-TENCENT-PACKAGE 的认证方式,因此请确认实际请求方能否发送该请求头。
  5. 在基础直播播放确认中,仅在有时移 / DRM 等需求时才配置附加功能。
  6. 通过 Confirm 保存,并确认生成的 Endpoint URL。

端点创建完成与视频播放成功是两个独立的步骤。

HLS 输出端点创建页面

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

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

以上截图仅显示常规 HLS 端点行,播放地址已做遮挡处理。实际操作时请确认该行的 URL 与 Details。

4. 关联 CSS 播放域名 ​

在频道详情的 CDN 标签页中确认访问权限与分发配置。两个方向的权限都需要。

方向需要的原因
StreamPackage → CSS在 StreamPackage 中配置 CSS 播放域名
CSS → StreamPackageCSS 拉取打包源站的视频

在 Authorization 流程中确认服务角色的权限并授权后,确认 CSS 侧 StreamPackage 的使用权限是否为 Activated 状态。如无权限,请向账号管理员申请。

权限设置完成后,在 Edit Configuration 中指定播放域名,并通过 Confirm 保存。新域名需要按 DNS 服务商的说明注册 CNAME。若要通过 HTTPS 播放,播放域名还需要有效的证书。

CSS 播放域名与 CNAME 及 Enabled 状态

Enabled 是控制台中的启用状态。DNS 解析、HTTPS 证书有效性、实际源站访问与视频播放成功需要另行验证。

5. 传递到下一步的信息 ​

信息使用位置
StreamPackage 频道 IDStreamLive 的 HLS_STREAM_PACKAGE 输出目的地
输入地址与所需的认证信息确认推流设置
Endpoint URL确认源站直接播放
CSS 播放域名观众播放地址

CDN 播放地址是将已关联的 Endpoint URL 的域名替换为 CSS 播放域名,并保持路径不变。

接下来是 2. StreamLive 输入与频道。全部连通后,在 4. 推流并确认播放 中分别检查源站与 CDN。

测试结束 ​

确认是否被其他服务占用后,停止测试推流。如需删除,请确认 CDN 关联及端点依赖关系,先移除端点,再删除频道。

官方文档 ​

使用 API 配置的方式 ​

以下命令是控制台流程的替代方案。被脱敏的 ID 与地址需替换为实际值。

创建频道 ​

协议指定为 HLS。

bash
tccli mdp CreateStreamPackageChannel \
  --region ap-seoul \
  --Name justinkim_quickstart \
  --Protocol HLS
json
{
  "Info": {
    "Id": "6AA6************32BF",
    "Name": "justinkim_quickstart",
    "Protocol": "HLS"
  }
}

响应中的 Id 从下一步开始会持续使用。

频道名称如 streamlive_quickstart 所示,使用英文 / 数字 / 下划线。

创建端点 ​

端点是决定“打包结果以何种形式输出”的单位。这里创建一个 HLS 单端点。

bash
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 限制或认证密钥

确认地址 ​

bash
tccli mdp DescribeStreamPackageChannel \
  --region ap-seoul \
  --Id 6AA6************32BF
json
{
  "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.。

bash
tccli mdp BindNewLVBDomainWithChannel \
  --region ap-seoul \
  --ChannelId 6AA6************32BF \
  --LVBDomain cdn.
json
{
  "LVBDomain": "cdn."
}

绑定完成后,仅将端点 URL 的域名替换为播放域名的地址就是 CSS 播放地址。路径保持不变。

text
https://cdn.

CDN 关联完成后,请确认源站访问权限、认证、请求路径 / 查询参数、DNS / TLS 以及实际播放。变更前请先确认相应的请求区间。

配置结果 ​

项目值
Channeljustinkim_quickstart (6AA6************32BF)
Endpointjustinkim_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 播放 URLhttps://cdn.

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