跳到内容

StreamLive 频道配置 ​

更新时间

在 StreamLive 频道上连接输入 / 转码设置 / 输出目标后启动。频道会将源流按指定画质编码后传输到目标地址。

本文档使用一路 1080p30 输入生成 1080p30 与 720p30 两路输出,并将两路输出传输到 StreamPackage。

从输入到 StreamPackage 输出

开始前的准备 ​

  • 需完成 输入配置,并可从推流设备向该输入推流。
  • 先创建 StreamPackage 频道 并确认频道 ID。所需的是 频道 ID,而非播放 URL 或输入 URL。
  • 输出使用同时包含 H.264 视频与 AAC 音频的组合型模板。模板概念请参考 转码模板。
  • 频道运行会产生计费。验证结束后请区分需要停止的频道与继续运营的频道。

1. 频道与输入关联 ​

  1. 在 StreamLive 控制台 中选择工作地域。
  2. 在频道创建界面中将名称填写为 demo_channel。
  3. 在添加输入步骤中选择已准备好的输入。
  4. 多音频输入需指定要使用的音频轨道。默认配置为第一条音频轨道。

输入已关联到频道与信号已接收是两种不同的状态。

2. 输出组与目标设置 ​

输出组是使用相同传输方式与目标地址的输出集合。输出是实际输出的单个画质。

设置项本示例的值含义
输出组名称demoPackage用于区分输出集合的名称
输出组类型HLS_STREAM_PACKAGE向当前账号的 StreamPackage 传输 HLS
目标地址已创建的 StreamPackage 频道 ID接收流的频道
输出 1output1080p1920×1080、30fps
输出 2output720p1280×720、30fps

普通 HLS 输出类型通过 HTTP PUT 传输到目标 URL。HLS_STREAM_PACKAGE 类型则指定 StreamPackage 频道 ID。

3. 按画质设置转码 ​

在各输出的 Transcoding Setting 中设置包含视频与音频的组合型模板。

设置项1080p 输出720p 输出
模板名称demo1080pdemo720p
视频编码H.264H.264
分辨率1920×10801280×720
帧率30fps30fps
视频码率4Mbps2Mbps
码率控制ABRABR
音频AAC,128kbps,48kHzAAC,128kbps,48kHz

码率为示例值。动态较多的源流与静态源流所需的码率不同,请使用实际内容进行验证。同一频道内所有输出组与输出的帧率设置须保持一致。

本示例为一个输出关联一个组合型模板。使用独立视频 / 音频模板的分离型配置可用于多音频轨道等场景。

4. HLS 设置 ​

设置项示例值确认事项
Segment Duration4 秒API SegmentDuration 需输入以毫秒为单位的 4000
Segment Number5输出播放列表中保留的分片数量
SchemeMERGE视频与音频合并的分片
Segment TypetsMPEG-TS 分片
PDT Insertion启用插入节目时间标签
PDT Duration600 秒PDT 标签插入间隔。并非存储时长或时移范围

5 个约 4 秒 的分片,对应约 20 秒 时长的列表。编码 / 传输 / CDN 缓存 / 播放器缓冲还会带来额外影响。

低延迟 HLS / fMP4 / DRM 需根据输出类型 / 编码 / 打包器 / 播放器的组合另行设置。

5. 保存 / 启动 / 播放确认 ​

  1. 确认设置后,通过 Confirm 与 Done 保存。
  2. 选择目标频道的 Start。
  3. 从推流端发送输入信号,并确认频道状态与输入监控。
  4. 在 StreamPackage 的 Output Endpoint 中确认播放 URL。
  5. 确认主播放列表中包含两种画质,以及各媒体播放列表是否正常更新。
  6. 在播放器中分别播放两种画质,并确认视频 / 音频 / 画质切换。

频道启动后,按输入接收 → 编码输出 → 打包器接收 → CDN 响应 → 播放器播放的顺序进行确认。

使用 API 创建相同配置 ​

将以下 JSON 保存为 channel.json,并将 REPLACE_INPUT_ID 与 REPLACE_PACKAGE_CHANNEL_ID 替换为实际值。

json
{
  "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 认证与地域的环境中执行。此命令将创建新频道。

bash
tccli mdl CreateStreamLiveChannel --region ap-seoul --cli-input-json file://channel.json

在创建响应中确认频道 ID,然后进行查询 / 启动。

bash
tccli mdl DescribeStreamLiveChannel --region ap-seoul --Id REPLACE_CHANNEL_ID
tccli mdl StartStreamLiveChannel --region ap-seoul --Id REPLACE_CHANNEL_ID

变更与结束 ​

需要停止的变更,请在安排检修时间或准备备用路径后,于 IDLE 状态下应用。测试后请确认目标 ID 并停止频道。

bash
tccli mdl StopStreamLiveChannel --region ap-seoul --Id REPLACE_CHANNEL_ID

StreamLink 传输、StreamPackage 存储功能、CDN 的使用也请分别清理。

参考文档 ​

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