使用OpenCV+FFmpeg向YouTube推流出现黑屏问题求助

以下是导致推流黑屏的几个核心原因及对应修复方案：

1. 重复调用cv2.waitKey(1)导致帧丢失 #

循环里连续两次调用cv2.waitKey(1)，第一次调用已完成1ms等待和按键事件处理，第二次调用会再次阻塞，直接导致部分摄像头帧被跳过，FFmpeg无法接收到连续有效帧，最终显示黑屏。

修复： 合并按键检测逻辑，仅调用一次cv2.waitKey(1)并保存返回值用于判断。

2. 摄像头帧率与FFmpeg输入帧率不匹配 #

FFmpeg命令中指定了-r 30（30fps），但OpenCV未强制设置摄像头捕获帧率，摄像头实际输出帧率可能与30fps不符，导致FFmpeg接收的帧速率和预期不匹配，无法正常渲染画面。

修复： 强制设置摄像头捕获帧率，确保FFmpeg输入帧率参数与摄像头实际输出一致。

3. 摄像头分辨率设置未生效 #

部分摄像头不支持640x480分辨率，cap.set()调用可能失败，导致捕获的帧尺寸与FFmpeg命令中指定的-s 640x480不匹配，FFmpeg无法正确解析画面数据。

修复： 添加参数校验，确认分辨率设置是否成功，使用摄像头实际输出的分辨率配置FFmpeg。

4. 未处理FFmpeg错误输出 #

当前代码未捕获FFmpeg的stderr输出，无法知晓FFmpeg处理帧时是否存在格式兼容、数据缺失等错误。

修复： 启动subprocess时捕获stderr，便于排查底层问题。

修改后的完整代码 #

import subprocess 
import cv2

# YouTube streaming settings
YOUTUBE_URL = "rtmp://a.rtmp.youtube.com/live2/"
KEY = "..."

# OpenCV camera setup
cap = cv2.VideoCapture(0)
# 强制设置摄像头参数
success_width = cap.set(cv2.CAP_PROP_FRAME_WIDTH, 640)
success_height = cap.set(cv2.CAP_PROP_FRAME_HEIGHT, 480)
success_fps = cap.set(cv2.CAP_PROP_FPS, 30)

# 校验参数设置结果
print(f"分辨率设置状态：宽{success_width}，高{success_height}")
print(f"帧率设置状态：{success_fps}")
# 获取摄像头实际输出参数
actual_width = cap.get(cv2.CAP_PROP_FRAME_WIDTH)
actual_height = cap.get(cv2.CAP_PROP_FRAME_HEIGHT)
actual_fps = cap.get(cv2.CAP_PROP_FPS)
print(f"实际捕获参数：{int(actual_width)}x{int(actual_height)}，{int(actual_fps)}fps")

# FFmpeg command for streaming
command = [
    r"C:\utility\ffmpeg\ffmpeg-2024-02-22-git-76b2bb96b4-full_build\ffmpeg-2024-02-22-git-76b2bb96b4-full_build\bin\ffmpeg.exe",
    '-f', 'rawvideo',
    '-pix_fmt', 'bgr24',
    '-s', f"{int(actual_width)}x{int(actual_height)}",  # 匹配实际分辨率
    '-r', f"{int(actual_fps)}",  # 匹配实际帧率
    '-i', '-',
    '-ar', '44100',
    '-ac', '2',
    '-f', 's16le',
    '-i', 'NUL',   
    '-acodec', 'aac',
    '-ab', '128k',
    '-vcodec', 'h264',
    '-pix_fmt', 'yuv420p',
    '-g', '50',
    '-vb', '1000k',
    '-profile:v', 'baseline',
    '-preset', 'ultrafast',
    '-f', 'flv', 
    f"{YOUTUBE_URL}/{KEY}",
]

# 启动FFmpeg并捕获错误输出
pipe = subprocess.Popen(
    command, 
    stdin=subprocess.PIPE,
    stderr=subprocess.PIPE,
    text=True
)

while True:
    ret, frame = cap.read()
    if not ret:
        print("无法捕获摄像头帧，退出")
        break

    cv2.imshow('Frame', frame)
    # 仅调用一次waitKey
    key = cv2.waitKey(1) & 0xFF

    # 发送帧到FFmpeg，强制刷新缓冲区
    try:
        pipe.stdin.write(frame.tobytes())
        pipe.stdin.flush()
    except BrokenPipeError:
        print("FFmpeg管道断开，退出")
        break

    if key == ord('q'):
        break

# 打印FFmpeg错误信息（如果有）
stderr_output = pipe.stderr.read()
if stderr_output:
    print("\nFFmpeg错误输出：")
    print(stderr_output)

# 释放资源
cap.release()
cv2.destroyAllWindows()
pipe.terminate()

额外调试建议 #

• 查看控制台输出的实际摄像头参数，若与预期不符，更换为摄像头支持的分辨率（如1280x720）。
• 若仍黑屏，重点查看FFmpeg的stderr输出，里面会包含具体错误（如编码器缺失、数据格式错误等）。
• 确认使用的FFmpeg版本包含h264编码器，部分轻量版FFmpeg可能缺少核心编码组件。

内容的提问来源于stack exchange，提问作者유혜진