StreamLive 频道配置
在 StreamLive 频道上连接输入 / 转码设置 / 输出目标后启动。频道会将源流按指定画质编码后传输到目标地址。
本文档使用一路 1080p30 输入生成 1080p30 与 720p30 两路输出,并将两路输出传输到 StreamPackage。
开始前的准备
- 需完成 输入配置,并可从推流设备向该输入推流。
- 先创建 StreamPackage 频道 并确认频道 ID。所需的是 频道 ID,而非播放 URL 或输入 URL。
- 输出使用同时包含 H.264 视频与 AAC 音频的组合型模板。模板概念请参考 转码模板。
- 频道运行会产生计费。验证结束后请区分需要停止的频道与继续运营的频道。
1. 频道与输入关联
- 在 StreamLive 控制台 中选择工作地域。
- 在频道创建界面中将名称填写为
demo_channel。 - 在添加输入步骤中选择已准备好的输入。
- 多音频输入需指定要使用的音频轨道。默认配置为第一条音频轨道。
输入已关联到频道与信号已接收是两种不同的状态。
2. 输出组与目标设置
输出组是使用相同传输方式与目标地址的输出集合。输出是实际输出的单个画质。
| 设置项 | 本示例的值 | 含义 |
|---|---|---|
| 输出组名称 | demoPackage | 用于区分输出集合的名称 |
| 输出组类型 | HLS_STREAM_PACKAGE | 向当前账号的 StreamPackage 传输 HLS |
| 目标地址 | 已创建的 StreamPackage 频道 ID | 接收流的频道 |
输出 1 | output1080p | 1920×1080、30fps |
输出 2 | output720p | 1280×720、30fps |
普通 HLS 输出类型通过 HTTP PUT 传输到目标 URL。HLS_STREAM_PACKAGE 类型则指定 StreamPackage 频道 ID。
3. 按画质设置转码
在各输出的 Transcoding Setting 中设置包含视频与音频的组合型模板。
| 设置项 | 1080p 输出 | 720p 输出 |
|---|---|---|
| 模板名称 | demo1080p | demo720p |
| 视频编码 | H.264 | H.264 |
| 分辨率 | 1920×1080 | 1280×720 |
| 帧率 | 30fps | 30fps |
| 视频码率 | 4Mbps | 2Mbps |
| 码率控制 | ABR | ABR |
| 音频 | AAC,128kbps,48kHz | AAC,128kbps,48kHz |
码率为示例值。动态较多的源流与静态源流所需的码率不同,请使用实际内容进行验证。同一频道内所有输出组与输出的帧率设置须保持一致。
本示例为一个输出关联一个组合型模板。使用独立视频 / 音频模板的分离型配置可用于多音频轨道等场景。
4. HLS 设置
| 设置项 | 示例值 | 确认事项 |
|---|---|---|
| Segment Duration | 4 秒 | API SegmentDuration 需输入以毫秒为单位的 4000 |
| Segment Number | 5 | 输出播放列表中保留的分片数量 |
| Scheme | MERGE | 视频与音频合并的分片 |
| Segment Type | ts | MPEG-TS 分片 |
| PDT Insertion | 启用 | 插入节目时间标签 |
| PDT Duration | 600 秒 | PDT 标签插入间隔。并非存储时长或时移范围 |
5 个约 4 秒 的分片,对应约 20 秒 时长的列表。编码 / 传输 / CDN 缓存 / 播放器缓冲还会带来额外影响。
低延迟 HLS / fMP4 / DRM 需根据输出类型 / 编码 / 打包器 / 播放器的组合另行设置。
5. 保存 / 启动 / 播放确认
- 确认设置后,通过 Confirm 与 Done 保存。
- 选择目标频道的 Start。
- 从推流端发送输入信号,并确认频道状态与输入监控。
- 在 StreamPackage 的 Output Endpoint 中确认播放 URL。
- 确认主播放列表中包含两种画质,以及各媒体播放列表是否正常更新。
- 在播放器中分别播放两种画质,并确认视频 / 音频 / 画质切换。
频道启动后,按输入接收 → 编码输出 → 打包器接收 → CDN 响应 → 播放器播放的顺序进行确认。
使用 API 创建相同配置
将以下 JSON 保存为 channel.json,并将 REPLACE_INPUT_ID 与 REPLACE_PACKAGE_CHANNEL_ID 替换为实际值。
{
"Name": "demo_channel",
"AttachedInputs": [
{
"Id": "REPLACE_INPUT_ID"
}
],
"AVTemplates": [
{
"Name": "demo1080p",
"NeedVideo": 1,
"NeedAudio": 1,
"Vcodec": "H264",
"Width": 1920,
"Height": 1080,
"Fps": 30,
"VideoBitrate": 4000000,
"RateControlMode": "ABR",
"Acodec": "AAC",
"AudioBitrate": 128000,
"AudioSampleRate": 48000,
"FrameRateType": "SPECIFIED_HZ"
},
{
"Name": "demo720p",
"NeedVideo": 1,
"NeedAudio": 1,
"Vcodec": "H264",
"Width": 1280,
"Height": 720,
"Fps": 30,
"VideoBitrate": 2000000,
"RateControlMode": "ABR",
"Acodec": "AAC",
"AudioBitrate": 128000,
"AudioSampleRate": 48000,
"FrameRateType": "SPECIFIED_HZ"
}
],
"OutputGroups": [
{
"Name": "demoPackage",
"Type": "HLS_STREAM_PACKAGE",
"Outputs": [
{
"Name": "output1080p",
"AVTemplateNames": [
"demo1080p"
]
},
{
"Name": "output720p",
"AVTemplateNames": [
"demo720p"
]
}
],
"HlsRemuxSettings": {
"SegmentDuration": 4000,
"SegmentNumber": 5,
"PdtInsertion": "OPEN",
"PdtDuration": 600,
"Scheme": "MERGE",
"SegmentType": "ts"
},
"StreamPackageSettings": {
"Id": "REPLACE_PACKAGE_CHANNEL_ID"
}
}
]
}请在已配置 TCCLI 认证与地域的环境中执行。此命令将创建新频道。
tccli mdl CreateStreamLiveChannel --region ap-seoul --cli-input-json file://channel.json在创建响应中确认频道 ID,然后进行查询 / 启动。
tccli mdl DescribeStreamLiveChannel --region ap-seoul --Id REPLACE_CHANNEL_ID
tccli mdl StartStreamLiveChannel --region ap-seoul --Id REPLACE_CHANNEL_ID变更与结束
需要停止的变更,请在安排检修时间或准备备用路径后,于 IDLE 状态下应用。测试后请确认目标 ID 并停止频道。
tccli mdl StopStreamLiveChannel --region ap-seoul --Id REPLACE_CHANNEL_IDStreamLink 传输、StreamPackage 存储功能、CDN 的使用也请分别清理。