编码与格式 / 系统课时

枚举可用采集设备

枚举可用采集设备

在开始录制前,先确认 FFmpeg 构建包含系统采集模块,再取得摄像头、麦克风或屏幕设备的准确名称,并探测可用分辨率、帧率与像素格式。本课分别给出 Windows、macOS 和 Linux 的检查路径,避免因名称或格式不匹配导致输入初始化失败。

学习目标

  • 判断当前 FFmpeg 是否包含所需的采集输入模块。
  • 枚举系统中的视频与音频设备,并复制可直接用于命令的名称或索引。
  • 在正式录制前验证设备支持的分辨率、帧率和像素格式。

先确认采集模块

FFmpeg 把摄像头、麦克风和桌面采集器视为输入设备。不同系统使用不同模块:Windows 常用 dshow 与 gdigrab,macOS 使用 avfoundation,Linux 摄像头常用 v4l2,X11 桌面使用 x11grab。当前安装包只会显示编译时启用且适用于本平台的模块。:contentReference[oaicite:0]{index=0}

先执行设备模块列表:

bash
ffmpeg -hide_banner -devices

预期输出:

text
Devices:
 D. = Demuxing supported
 .E = Muxing supported
 D  <AVAILABLE_INPUT_DEVICE>  <DEVICE_DESCRIPTION>

输出中的 D 表示该模块可以作为输入。若后续命令提示 Unknown input format,先回到这里确认目标模块是否存在;缺失时需要更换包含对应设备支持的 FFmpeg 构建。

Windows:枚举 DirectShow 设备

DirectShow 可以同时列出摄像头、采集卡和麦克风。设备名称必须完整复制,包括空格、括号和品牌后缀。

powershell
ffmpeg -hide_banner -list_devices true -f dshow -i dummy

预期输出:

text
[dshow @ <ADDRESS>] "Integrated Camera" (video)
[dshow @ <ADDRESS>] "Microphone Array (<DEVICE_NAME>)" (audio)
dummy: Immediate exit requested

列表完成后出现退出或找不到输入的提示通常是正常现象,因为 dummy 只用于触发枚举。接着用实际摄像头名称查询它支持的格式:

powershell
ffmpeg -hide_banner -f dshow -list_options true -i video="Integrated Camera"

预期输出:

text
[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}

bash
ffmpeg -hide_banner -f avfoundation -list_devices true -i ""

预期输出:

text
[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 应替换为实际视频索引:

bash
ffmpeg -hide_banner -f avfoundation -framerate 30 -video_size 1280x720 -i "0:none" -t 3 -f null -

预期输出:

text
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 工具列出。先查看当前设备节点和录音端点:

bash
ls -1 /dev/video* 2>/dev/null
arecord -L

预期输出:

text
/dev/video0
default
sysdefault:<CARD_NAME>
hw:<CARD_INDEX>,<DEVICE_INDEX>

arecord 来自 alsa-utils。如果系统没有该命令,需要先通过发行版的软件包管理器安装。摄像头的格式可以直接交给 FFmpeg 查询:

bash
ffmpeg -hide_banner -f v4l2 -list_formats all -i /dev/video0

预期输出:

text
[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 输出,可以提前发现占用、权限、格式不支持和设备名称错误。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

枚举可用采集设备

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通