编码与格式 / 系统课时
枚举可用采集设备
枚举可用采集设备
在开始录制前,先确认 FFmpeg 构建包含系统采集模块,再取得摄像头、麦克风或屏幕设备的准确名称,并探测可用分辨率、帧率与像素格式。本课分别给出 Windows、macOS 和 Linux 的检查路径,避免因名称或格式不匹配导致输入初始化失败。
学习目标
- 判断当前 FFmpeg 是否包含所需的采集输入模块。
- 枚举系统中的视频与音频设备,并复制可直接用于命令的名称或索引。
- 在正式录制前验证设备支持的分辨率、帧率和像素格式。
先确认采集模块
FFmpeg 把摄像头、麦克风和桌面采集器视为输入设备。不同系统使用不同模块:Windows 常用 dshow 与 gdigrab,macOS 使用 avfoundation,Linux 摄像头常用 v4l2,X11 桌面使用 x11grab。当前安装包只会显示编译时启用且适用于本平台的模块。:contentReference[oaicite:0]{index=0}
先执行设备模块列表:
ffmpeg -hide_banner -devices预期输出:
Devices:
D. = Demuxing supported
.E = Muxing supported
D <AVAILABLE_INPUT_DEVICE> <DEVICE_DESCRIPTION>输出中的 D 表示该模块可以作为输入。若后续命令提示 Unknown input format,先回到这里确认目标模块是否存在;缺失时需要更换包含对应设备支持的 FFmpeg 构建。
Windows:枚举 DirectShow 设备
DirectShow 可以同时列出摄像头、采集卡和麦克风。设备名称必须完整复制,包括空格、括号和品牌后缀。
ffmpeg -hide_banner -list_devices true -f dshow -i dummy预期输出:
[dshow @ <ADDRESS>] "Integrated Camera" (video)
[dshow @ <ADDRESS>] "Microphone Array (<DEVICE_NAME>)" (audio)
dummy: Immediate exit requested列表完成后出现退出或找不到输入的提示通常是正常现象,因为 dummy 只用于触发枚举。接着用实际摄像头名称查询它支持的格式:
ffmpeg -hide_banner -f dshow -list_options true -i video="Integrated Camera"预期输出:
[dshow @ <ADDRESS>] DirectShow video device options
[dshow @ <ADDRESS>] pixel_format=<PIXEL_FORMAT> min s=<WIDTH>x<HEIGHT> fps=<FPS>
video=Integrated Camera: Immediate exit requested同一设备可能列出多组分辨率、帧率和像素格式。正式采集时应选择同一行或同一能力组中真实存在的组合,不要只凭摄像头宣传参数填写。
macOS:枚举 AVFoundation 索引
AVFoundation 使用“视频索引:音频索引”选择输入。先列出设备,记住方括号中的数字;屏幕采集设备也会出现在视频设备列表中。:contentReference[oaicite:1]{index=1}
ffmpeg -hide_banner -f avfoundation -list_devices true -i ""预期输出:
[AVFoundation indev @ <ADDRESS>] AVFoundation video devices:
[AVFoundation indev @ <ADDRESS>] [0] <VIDEO_DEVICE_NAME>
[AVFoundation indev @ <ADDRESS>] AVFoundation audio devices:
[AVFoundation indev @ <ADDRESS>] [0] <AUDIO_DEVICE_NAME>使用选中的视频索引做一次三秒探测,可以确认指定分辨率和帧率是否能打开。下面的 0 应替换为实际视频索引:
ffmpeg -hide_banner -f avfoundation -framerate 30 -video_size 1280x720 -i "0:none" -t 3 -f null -预期输出:
Input #0, avfoundation, from '0:none':
Stream #0:0: Video: <PIXEL_FORMAT>, 1280x720, 30 fps
frame=<FRAME_COUNT> time=<TIME> speed=<SPEED>若请求格式不受支持,FFmpeg 会报告初始化失败或列出可用格式。此时根据提示调整 -video_size、-framerate 或 -pixel_format,直到探测能够持续输出帧。
Linux:定位设备文件并探测格式
Linux 摄像头通常对应 /dev/video*,音频设备名称可由 ALSA 工具列出。先查看当前设备节点和录音端点:
ls -1 /dev/video* 2>/dev/null
arecord -L预期输出:
/dev/video0
default
sysdefault:<CARD_NAME>
hw:<CARD_INDEX>,<DEVICE_INDEX>arecord 来自 alsa-utils。如果系统没有该命令,需要先通过发行版的软件包管理器安装。摄像头的格式可以直接交给 FFmpeg 查询:
ffmpeg -hide_banner -f v4l2 -list_formats all -i /dev/video0预期输出:
[video4linux2,v4l2 @ <ADDRESS>] Raw : <PIXEL_FORMAT> : <DESCRIPTION> : <WIDTH>x<HEIGHT> <FPS>
[video4linux2,v4l2 @ <ADDRESS>] Compressed: <CODEC> : <DESCRIPTION> : <WIDTH>x<HEIGHT> <FPS>如果存在多个 /dev/video*,应逐个查询。某些节点只是红外、元数据或虚拟设备,能够列出节点并不代表它可以输出普通彩色视频。
选择最终采集参数
最终记录至少四项信息:输入模块、设备名称或索引、分辨率与帧率、像素或音频格式。例如 Windows 摄像头可记为 dshow + Integrated Camera + 1280x720@30 + yuyv422,macOS 则记为 avfoundation + 0:none + 1280x720@30。
设备枚举只证明系统看得到硬件,短时探测成功才证明该参数组合能被 FFmpeg 打开。正式录制前先运行 3~5 秒到 null 输出,可以提前发现占用、权限、格式不支持和设备名称错误。