编码与格式 / 系统课时
认识设备输入框架
认识设备输入框架
本课解决“同一条采集命令为什么换到另一台系统就不能用”的问题。你将认识 Windows、macOS 和 Linux 的常见输入框架,学会枚举摄像头与麦克风,并理解设备名称、数字索引和设备节点三种选择方式。
学习目标
- 能说出三个桌面平台常用的 FFmpeg 设备输入框架
- 能在当前系统枚举可用摄像头、麦克风或输入格式
- 能根据框架选择正确的
-f、设备标识和采集参数
三个平台如何接入设备
FFmpeg 通过输入设备模块连接操作系统的采集接口。平台不同,模块名称和设备标识也不同。
| 平台 | 常见视频输入 | 常见音频输入 | 设备标识方式 |
|---|---|---|---|
| Windows | DirectShow dshow |
DirectShow dshow |
设备显示名称 |
| macOS | AVFoundation avfoundation |
AVFoundation avfoundation |
数字索引或设备名称 |
| Linux | Video4Linux2 v4l2 |
ALSA alsa、PulseAudio pulse |
/dev/videoN、hw:N,N 或音频源名称 |
-f 指定输入框架,必须写在对应的 -i 之前。设备标识属于操作系统,不应把别人的摄像头名称、索引或节点路径直接复制到自己的命令中。
在当前系统枚举设备
Windows:DirectShow
DirectShow 使用设备名称。下面的命令会列出视频和音频设备,然后因为 dummy 不是实际输入而结束。
ffmpeg -hide_banner -list_devices true -f dshow -i dummy预期输出类似:
[dshow @ <ID>] "Integrated Camera" (video)
[dshow @ <ID>] "Microphone Array" (audio)
dummy: Immediate exit requested<ID> 和设备名称以本机输出为准。采集时必须完整复制名称,名称中有空格时保留双引号。
macOS:AVFoundation
AVFoundation 通常用数字索引组合视频和音频设备。空输入用于触发设备列表。
ffmpeg -hide_banner -f avfoundation -list_devices true -i ""预期输出类似:
AVFoundation video devices:
[0] FaceTime HD Camera
AVFoundation audio devices:
[0] MacBook Microphone设备索引可能在重启、插拔硬件或权限变化后改变,正式脚本运行前应重新确认。
Linux:V4L2 与音频框架
Linux 摄像头通常表现为 /dev/video0、/dev/video1 等节点。下面的命令检查 /dev/video0 支持的像素格式与分辨率。
ffmpeg -hide_banner -f v4l2 -list_formats all -i /dev/video0预期输出类似:
Raw : yuyv422 : YUYV 4:2:2 : 640x480 1280x720
Compressed: mjpeg : Motion-JPEG : 1280x720 1920x1080
/dev/video0: Immediate exit requested如果节点不存在,应先检查 /dev/video*。音频则根据系统使用 alsa 或 pulse,不能把摄像头节点直接当作音频输入。
读懂输入参数的位置
设备输入参数应放在对应输入之前。以摄像头为例,分辨率、帧率和像素格式通常属于输入能力约束;编码器、码率和输出容器属于输出阶段。
ffmpeg [设备输入参数] -f <输入框架> -i <设备标识> [编码参数] <输出文件>例如 Windows 的设备标识可以写成 video="Integrated Camera":audio="Microphone Array";macOS 常写成 "0:0";Linux 视频常写成 /dev/video0。三者表达的是同一个目标:告诉 FFmpeg 从哪里读取原始音视频,但语法不能跨平台混用。
帧率参数常用 -framerate 30,分辨率常用 -video_size 1280x720。只有设备确实支持该组合时才能成功打开;先枚举能力,再设置参数,比反复猜测更可靠。
完成一次最小采集
下面给出三个平台的最小视频采集命令,选择与当前系统匹配的一条执行。设备名称、索引和节点均需替换为枚举结果。Windows:
ffmpeg -hide_banner -y -f dshow -framerate 30 -video_size 1280x720 `
-i video="Integrated Camera" -t 5 capture.mp4预期结果:
采集约 5 秒并生成 capture.mp4;终端末尾显示正常结束的编码统计。macOS:
ffmpeg -hide_banner -y -f avfoundation -framerate 30 -video_size 1280x720 -i "0:none" -t 5 capture.mp4预期结果:
采集索引 0 的视频约 5 秒并生成 capture.mp4,不包含音频流。Linux:
ffmpeg -hide_banner -y -f v4l2 -framerate 30 -video_size 1280x720 -i /dev/video0 -t 5 capture.mp4预期结果:
从 /dev/video0 采集约 5 秒并生成 capture.mp4。验证时先确认文件存在,再用播放器检查画面。若 FFmpeg 报“不支持的参数组合”,降低分辨率或帧率,并回到设备枚举结果中选择设备明确支持的格式。
常见失败的定位顺序
找不到设备时,先确认操作系统是否识别硬件,再确认 FFmpeg 构建是否包含对应输入模块。可执行 ffmpeg -devices 查看 dshow、avfoundation、v4l2、alsa 或 pulse 是否出现在列表中。
能列出设备但打不开时,优先检查摄像头或麦克风权限、设备是否被其他程序独占,以及名称或索引是否复制正确。Linux 还要检查当前用户对 /dev/videoN 的访问权限。
能打开但画面异常时,再检查分辨率、帧率和像素格式。设备输入阶段的问题不应先通过调整输出码率解决,因为编码参数无法让设备支持一个原本不存在的采集模式。