2. StreamLive 输入与频道
在 StreamLive 中配置接收源流的输入与转码频道,并将处理后的视频传送到 StreamPackage。下面先说明使用控制台的基本流程,随后提供 API 示例。
准备工作
- 完成 1. StreamPackage 频道与端点,并准备好频道 ID。
- 确认同一账号下的目标地域。
- 准备接入输入的推流侧公网 IP。若接入 StreamLink,请以实际连接 StreamLive 的 StreamLink 输出侧地址(而非编码器)为准设置访问策略。
- 以下
1080p/720p配置为示例,请根据源流分辨率、帧率及所需输出画质进行调整。
1. 创建安全组与输入
- 在 StreamLive 控制台 的 Security Group 中创建输入访问策略。
- 仅允许实际推流 IP。单个 IPv4 地址请以
203.0.113.10/32这样的 CIDR 格式输入。该地址仅用于说明,请替换为实际公网 IP。 - 在 Input → Create Input 中选择名称与 RTMP_PUSH 类型。
- 关联安全组,并输入 Destination 的 application name 与 stream name。
- 创建后确认控制台显示的推流地址。该地址将在下一步用作 StreamLink Output 的目标地址。
输入 A/B 是相互独立的管道。配置冗余时,请分别确认各自的地址与推流路径。
2. 配置频道与输出
- 选择 Channel → Create Channel 并输入频道名称。
- 关联前面创建的 Input。
- 将输出组的类型选择为 HLS_STREAM_PACKAGE。
- 在目标位置指定同一账号下的 StreamPackage 频道 ID。普通 HLS 输出使用 HTTP PUT 目标 URL,属于另一类型,请注意区分。
- 添加两个 Output,并分别在 Transcoding Setting → Setting 中应用以下配置。
| 配置项 | 1080p 输出 | 720p 输出 |
|---|---|---|
| 音频 / 视频模板名称 | quickstart1080p | quickstart720p |
| 视频编码 | H.264 | H.264 |
| 分辨率 | 1920 × 1080 | 1280 × 720 |
| 帧率 | 30 fps | 30 fps |
| 视频码率 | 4 Mbps | 2 Mbps |
| 音频 | AAC, 128 kbps | AAC, 128 kbps |
模板名称请使用 1~20 位英文 / 数字字符。同一频道内各输出的帧率配置需保持一致。
分片设置: 在 Segment 设置中,本示例采用 TS 格式、分片长度 4 秒、列表保留数量 5 个。请确认控制台的显示单位。下方 API 示例中的 SegmentDuration: 4000 以毫秒为单位。保存配置: 通过 Confirm → Done 保存。
3. 启动与详情页确认
在目标频道选择 Start 并确认状态。

- 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。
tccli mdl CreateStreamLiveInputSecurityGroup \
--region ap-seoul \
--Name justinkim_ingest_allowed \
--Whitelist 203.0.113.10/32{
"Id": "6AA6************26B1"
}203.0.113.10/32 为说明用地址,请更改为接入 StreamLive 的推流侧公网 IP。请避免允许全部地址。
创建输入
以 RTMP_PUSH 类型创建,并指定 AppName / StreamName。该组合即为推流地址。
tccli mdl CreateStreamLiveInput \
--region ap-seoul \
--Name justinkim_quickstart_input \
--Type RTMP_PUSH \
--SecurityGroupIds '["6AA6************26B1"]' \
--InputSettings '[{"AppName":"justinkim","StreamName":"quickstart"}]'{
"Id": "6AA6************26B2"
}查询后会返回输入地址。
tccli mdl DescribeStreamLiveInput \
--region ap-seoul \
--Id 6AA6************26B2{
"Type": "RTMP_PUSH",
"InputSettings": [
{
"AppName": "justinkim",
"StreamName": "quickstart",
"InputAddress": "rtmp://13******46.ap-seoul-1.streamlive.myqcloud.com"
}
]
}也就是说,推流地址可归纳为以下两行。
URL rtmp://13******46.ap-seoul-1.streamlive.myqcloud.com/justinkim
StreamKey quickstart创建频道
频道是将输入 + 转码模板 + 输出组捆绑在一起的执行单元。由于配置较长,可写入 JSON 文件后使用。
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 文件后,使用以下命令创建频道。
tccli mdl CreateStreamLiveChannel \
--region ap-seoul \
--cli-input-json file:///tmp/streamlive-channel.json{
"Id": "6AA6************5542"
}配置项
| 项目 | 值 | 含义 |
|---|---|---|
Type | HLS_STREAM_PACKAGE | 将 HLS 推送到 StreamPackage 的输出类型 |
Destinations.OutputUrl | StreamPackage Input URL | 在 1 步骤中获取的地址 |
StreamPackageSettings.Id | 频道 ID | 指定目标频道 |
SegmentDuration | 4000 | 分片 4 秒 |
SegmentNumber | 5 | 播放列表中保留的分片数量 |
Scheme | MERGE | 将音频与视频打包为一个 TS |
每个输出请只放一个 AVTemplateNames。若把 1080p 与 720p 集中在同一输出中,虽可创建成功,但只会产出一个 rendition。若要构建 ABR 阶梯,需按模板数量分别创建输出。
转码模板名称请像 streamlive1080p 一样使用英文 / 数字。频道名称可使用下划线。
启动频道
tccli mdl StartStreamLiveChannel \
--region ap-seoul \
--Id 6AA6************5542确认状态是否为 RUNNING。下一步将验证实际推流与播放。
tccli mdl DescribeStreamLiveChannels --region ap-seouljustinkim_quickstart_channel 6AA6************5542 RUNNINGRTMP 输入创建界面

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