跳到内容

4. 推流并确认播放 ​

更新时间

向前三步中配置的传输路径发送测试信号,然后依次确认 StreamPackage 源站与 CSS CDN。

准备工作 ​

  • 确认 StreamLink Flow 与 StreamLive 频道已处于启动状态。
  • 准备 StreamLink 输入的实际推流地址。
  • 准备 StreamPackage Endpoint URL 与 CSS 播放 URL。
  • 确认推流 IP 允许策略、所需的认证信息、DNS 与 HTTPS 证书。
  • 准备 FFmpeg / ffprobe / ffplay 或 OBS 与 HLS 播放器。

以下 URL 仅用于说明。

1. 发送测试信号 ​

在 OBS 中,输入与 StreamLink 输入设置相匹配的服务器地址和串流密钥,然后开始推流。如果使用 FFmpeg,可以按如下方式发送视频测试图案与 440Hz 测试音。播放测试音前请先调低音量。

bash
STREAM_PUSH_URL='rtmp://YOUR_STREAMLINK_HOST/YOUR_APP/YOUR_STREAM_KEY'
ffmpeg -re \
  -f lavfi -i "testsrc=size=1920x1080:rate=30" \
  -f lavfi -i "sine=frequency=440:sample_rate=48000" \
  -c:v libx264 -preset veryfast -b:v 4000k -maxrate 4000k -bufsize 8000k \
  -pix_fmt yuv420p -g 60 \
  -c:a aac -b:a 128k -ar 48000 \
  -f flv "$STREAM_PUSH_URL"

检查 FFmpeg 日志中的推流帧数与时间、StreamLink 输入地址 / 协议 / 端口 / 允许 IP,以及目的地的接收状态。

2. 确认传输与处理状态 ​

环节确认内容
编码器 → StreamLink输入连接与接收状态
StreamLink → StreamLiveFlow 输出目的地与 StreamLive 输入接收状态
StreamLive → StreamPackage输出组、目标频道 ID、输出状态
StreamPackage → CDN域名连接、双向服务权限、源站访问策略

同时确认 RUNNING 状态、输入 / 输出指标与最终播放。

3. 确认源站主播放列表 ​

bash
STREAM_ORIGIN_URL='https://YOUR_PACKAGE_HOST/YOUR_ENDPOINT_PATH/index.m3u8'
curl --fail-with-body --show-error --silent --max-time 20 "$STREAM_ORIGIN_URL"

如果已配置端点认证,请另行应用该请求所需的请求头或认证信息。

以下是包含两种分辨率的列表格式示例。文件名与数值会随实际配置而不同。

m3u8
#EXTM3U
#EXT-X-STREAM-INF:BANDWIDTH=2128000,RESOLUTION=1280x720,FRAME-RATE=30.000
720p.m3u8
#EXT-X-STREAM-INF:BANDWIDTH=4128000,RESOLUTION=1920x1080,FRAME-RATE=30.000
1080p.m3u8

如果能看到这两项,说明主列表中已声明两路输出。要确认各路输出的视频是否正常,需要一直查到媒体列表与实际分片。

4. 确认媒体列表与分片 ​

以实际主列表 URL 为基准解析主列表中写明的媒体列表 URI。如果只有文件名,则以同一目录为基准;如果以 / 开头,则以同一主机的根目录为基准。如果是完整 URL,则直接使用该地址。

bash
STREAM_MEDIA_URL='https://YOUR_PACKAGE_HOST/YOUR_ENDPOINT_PATH/720p.m3u8'
curl --fail-with-body --show-error --silent --max-time 20 "$STREAM_MEDIA_URL"

每隔几秒重新确认以下格式的列表。

m3u8
#EXTM3U
#EXT-X-TARGETDURATION:4
#EXT-X-MEDIA-SEQUENCE:100
#EXTINF:4.000,
segment100.ts
#EXTINF:4.000,
segment101.ts
  • 确认直播推流过程中是否有新的分片加入。
  • 在滑动列表中,确认 MEDIA-SEQUENCE 是否随时间递增。
  • 确认列表中记录的分片 URL 是否实际可访问。
  • 确认 720p 与 1080p 中是否各自包含视频 / 音频。
bash
ffprobe -v error -show_entries stream=codec_type,codec_name,width,height,r_frame_rate \
  -of json "$STREAM_MEDIA_URL"

ffprobe 结果用于确认媒体格式。是否存在黑屏、静音、卡顿,需要通过实际播放另行确认。

5. 通过 CDN 确认播放 ​

对连接到 StreamPackage 的 CSS 播放 URL 重复同样的检查。

bash
STREAM_CDN_URL='https://YOUR_PLAYBACK_DOMAIN/YOUR_ENDPOINT_PATH/index.m3u8'
curl --fail-with-body --show-error --silent --max-time 20 \
  --dump-header - --output /dev/null "$STREAM_CDN_URL"
ffplay "$STREAM_CDN_URL"

确认播放器中是否播放了视频测试图案与测试音,以及在一段时间内是否无中断地持续播放。由于自动画质选择可能只播放其中一种分辨率,因此也要分别检查各个媒体列表。

HTTPS 播放需通过有效的证书 / 主机名 / 证书链来确认。

故障环节区分 ​

现象优先确认
StreamLink 输入 —编码器推流地址 / 密钥、协议、防火墙与允许 IP
StreamLive 输入 —Flow 输出地址与 StreamLive 安全组
源站列表 404端点路径、源站是否在推流、输出目的地
源站或 CDN 出现 403请求引用对象的权限、请求头 / 查询认证、IP 限制、域名连接
主列表正常 / 媒体结果确认媒体 URI 解析、路径与认证信息
媒体正常 / 分片结果确认分片 URI 与访问策略、已缓存列表的有效性
列表更新中断源站推流、输入 / 输出状态、列表缓存
源站播放 / CDN 结果确认CSS 源站访问权限、Host / 路径 / 认证传递、DNS / TLS
只有视频播放而没有声音 —源站音频轨、音频选择与输出模板

同时确认该请求的主机 / 路径 / 响应 / 各环节日志。

完成标准 ​

  1. 在 StreamLink 与 StreamLive 中确认源站接收与输出投递
  2. 确认 StreamPackage 主列表中包含所需的分辨率列表
  3. 确认各媒体列表的更新与分片可访问
  4. 在源站与 CSS CDN 中确认实际视频 / 音频播放
  5. 确认播放过程中的输入 / 输出状态与连续播放

结束测试 ​

FFmpeg 请在其运行的终端中按 Ctrl+C 结束推流。之后停止用于测试的 StreamLink Flow 与 StreamLive 频道。删除为可选操作,请先确认是否为共享资源以及相关依赖关系。

同时确认运行资源与存储 / 传输用量。

相关文档 ​

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