跳到内容

2. StreamLive 输入与频道 ​

更新时间

在 StreamLive 中配置接收源流的输入与转码频道,并将处理后的视频传送到 StreamPackage。下面先说明使用控制台的基本流程,随后提供 API 示例。

准备工作 ​

  • 完成 1. StreamPackage 频道与端点,并准备好频道 ID。
  • 确认同一账号下的目标地域。
  • 准备接入输入的推流侧公网 IP。若接入 StreamLink,请以实际连接 StreamLive 的 StreamLink 输出侧地址(而非编码器)为准设置访问策略。
  • 以下 1080p / 720p 配置为示例,请根据源流分辨率、帧率及所需输出画质进行调整。

1. 创建安全组与输入 ​

  1. 在 StreamLive 控制台 的 Security Group 中创建输入访问策略。
  2. 仅允许实际推流 IP。单个 IPv4 地址请以 203.0.113.10/32 这样的 CIDR 格式输入。该地址仅用于说明,请替换为实际公网 IP。
  3. 在 Input → Create Input 中选择名称与 RTMP_PUSH 类型。
  4. 关联安全组,并输入 Destination 的 application name 与 stream name。
  5. 创建后确认控制台显示的推流地址。该地址将在下一步用作 StreamLink Output 的目标地址。

输入 A/B 是相互独立的管道。配置冗余时,请分别确认各自的地址与推流路径。

2. 配置频道与输出 ​

  1. 选择 Channel → Create Channel 并输入频道名称。
  2. 关联前面创建的 Input。
  3. 将输出组的类型选择为 HLS_STREAM_PACKAGE。
  4. 在目标位置指定同一账号下的 StreamPackage 频道 ID。普通 HLS 输出使用 HTTP PUT 目标 URL,属于另一类型,请注意区分。
  5. 添加两个 Output,并分别在 Transcoding Setting → Setting 中应用以下配置。
配置项1080p 输出720p 输出
音频 / 视频模板名称quickstart1080pquickstart720p
视频编码H.264H.264
分辨率1920 × 10801280 × 720
帧率30 fps30 fps
视频码率4 Mbps2 Mbps
音频AAC, 128 kbpsAAC, 128 kbps

模板名称请使用 1~20 位英文 / 数字字符。同一频道内各输出的帧率配置需保持一致。

分片设置: 在 Segment 设置中,本示例采用 TS 格式、分片长度 4 秒、列表保留数量 5 个。请确认控制台的显示单位。下方 API 示例中的 SegmentDuration: 4000 以毫秒为单位。保存配置: 通过 Confirm → Done 保存。

3. 启动与详情页确认 ​

在目标频道选择 Start 并确认状态。

StreamLive 频道详情页:确认运行状态与已关联的输入

  • Information → Basic Information → State:为 RUNNING 表示频道已启动。
  • Input Setting:确认已关联前面创建的输入的名称与 ID。
  • Output Group Setting:确认 StreamPackage 目标位置与两个输出。
  • Alerts / Health / Logs:确认输入与输出是否存在故障。

确认预览配置与输入状态,最终判定以 StreamPackage 媒体列表刷新及实际视频 / 音频播放为准。

4. 后续步骤与结束测试 ​

在 3. StreamLink Flow 连接 中接入源流推流后,再进行 4. 推流与播放确认。

运行中的频道需先停止再编辑配置。结束测试时,请确认目标频道 / 输入 / 安全组是否仍在使用,并清理专用资源。

官方文档 ​

使用 API 配置的场景 ​

以下是使用 API 构建与控制台流程相同配置的示例。

创建安全组 ​

允许实际接入输入的推流 IP。请将下方用于说明的 IP 替换为实际推流公网 IP。

bash
tccli mdl CreateStreamLiveInputSecurityGroup \
  --region ap-seoul \
  --Name justinkim_ingest_allowed \
  --Whitelist 203.0.113.10/32
json
{
  "Id": "6AA6************26B1"
}

203.0.113.10/32 为说明用地址,请更改为接入 StreamLive 的推流侧公网 IP。请避免允许全部地址。

创建输入 ​

以 RTMP_PUSH 类型创建,并指定 AppName / StreamName。该组合即为推流地址。

bash
tccli mdl CreateStreamLiveInput \
  --region ap-seoul \
  --Name justinkim_quickstart_input \
  --Type RTMP_PUSH \
  --SecurityGroupIds '["6AA6************26B1"]' \
  --InputSettings '[{"AppName":"justinkim","StreamName":"quickstart"}]'
json
{
  "Id": "6AA6************26B2"
}

查询后会返回输入地址。

bash
tccli mdl DescribeStreamLiveInput \
  --region ap-seoul \
  --Id 6AA6************26B2
json
{
  "Type": "RTMP_PUSH",
  "InputSettings": [
    {
      "AppName": "justinkim",
      "StreamName": "quickstart",
      "InputAddress": "rtmp://13******46.ap-seoul-1.streamlive.myqcloud.com"
    }
  ]
}

也就是说,推流地址可归纳为以下两行。

text
URL       rtmp://13******46.ap-seoul-1.streamlive.myqcloud.com/justinkim
StreamKey quickstart

创建频道 ​

频道是将输入 + 转码模板 + 输出组捆绑在一起的执行单元。由于配置较长,可写入 JSON 文件后使用。

bash
cat > /tmp/streamlive-channel.json <<'EOF'
{
  "Name": "justinkim_quickstart_channel",
  "AttachedInputs": [{ "Id": "6AA6************26B2" }],
  "AVTemplates": [
    {
      "Name": "justinkim1080p",
      "NeedVideo": 1, "Vcodec": "H264",
      "Width": 1920, "Height": 1080, "Fps": 30,
      "VideoBitrate": 4000000, "RateControlMode": "ABR",
      "NeedAudio": 1, "Acodec": "AAC", "AudioBitrate": 128000
    },
    {
      "Name": "justinkim720p",
      "NeedVideo": 1, "Vcodec": "H264",
      "Width": 1280, "Height": 720, "Fps": 30,
      "VideoBitrate": 2000000, "RateControlMode": "ABR",
      "NeedAudio": 1, "Acodec": "AAC", "AudioBitrate": 128000
    }
  ],
  "OutputGroups": [
    {
      "Name": "justinkim_to_package",
      "Type": "HLS_STREAM_PACKAGE",
      "Outputs": [
        { "Name": "justinkimout1080p", "AVTemplateNames": ["justinkim1080p"] },
        { "Name": "justinkimout720p",  "AVTemplateNames": ["justinkim720p"] }
      ],
      "Destinations": [
        { "OutputUrl": "https://13******46.ap-seoul.streampackage.srclivepush.myqcloud.com/v1/01a0****96005/01a0****96006" }
      ],
      "HlsRemuxSettings": {
        "SegmentDuration": 4000,
        "SegmentNumber": 5,
        "Scheme": "MERGE",
        "SegmentType": "ts"
      },
      "StreamPackageSettings": { "Id": "6AA6************32BF" }
    }
  ]
}
EOF

保存 JSON 文件后,使用以下命令创建频道。

bash
tccli mdl CreateStreamLiveChannel \
  --region ap-seoul \
  --cli-input-json file:///tmp/streamlive-channel.json
json
{
  "Id": "6AA6************5542"
}

配置项 ​

项目值含义
TypeHLS_STREAM_PACKAGE将 HLS 推送到 StreamPackage 的输出类型
Destinations.OutputUrlStreamPackage Input URL在 1 步骤中获取的地址
StreamPackageSettings.Id频道 ID指定目标频道
SegmentDuration4000分片 4 秒
SegmentNumber5播放列表中保留的分片数量
SchemeMERGE将音频与视频打包为一个 TS

每个输出请只放一个 AVTemplateNames。若把 1080p 与 720p 集中在同一输出中,虽可创建成功,但只会产出一个 rendition。若要构建 ABR 阶梯,需按模板数量分别创建输出。

转码模板名称请像 streamlive1080p 一样使用英文 / 数字。频道名称可使用下划线。

启动频道 ​

bash
tccli mdl StartStreamLiveChannel \
  --region ap-seoul \
  --Id 6AA6************5542

确认状态是否为 RUNNING。下一步将验证实际推流与播放。

bash
tccli mdl DescribeStreamLiveChannels --region ap-seoul
text
justinkim_quickstart_channel   6AA6************5542   RUNNING

RTMP 输入创建界面 ​

StreamLive RTMP 输入创建表单

在 RTMP_PUSH 输入创建表单中选择 Security Group,并在 Destination A 中指定 application name 与 stream name,然后点击 Confirm。Destination B 用于第二条管道。

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