FFmpeg命令行使用手册-devices输入输出设备汇总篇
ffmpeg命令系列：
FFmpeg命令行使用手册-protocols协议汇总篇
FFmpeg命令行使用手册-devices输入输出设备汇总篇
一、前言
本系列介绍ffmpeg命令行中有关-devices输入输出设备的支持和使用。
输入设备（input devices）用于采集/抓取来自连接到系统的多媒体设备的数据，比如采集麦克风/话筒的音频采样数据，桌面屏幕图像数据，摄像头/相机图像数据等。
输出设备（output devices）用于将多媒体数据写出到系统的输出设备中，比如音频播放设备，窗口，图形渲染设备（openGL上下文、SDL）等。
二、参考资料
本文参考自ffmpeg官方文档：https://ffmpeg.org/ffmpeg-devices.html
三、如何下载和安装ffmpeg
windows平台下载：https://download.csdn.net/download/eguid_1/12567936
mac平台下载：https://download.csdn.net/download/eguid_1/12607297
linux平台下载：linux发行版较多，有些发行版支持ffmpeg，不一一提供，提供ffmpeg官方提供的两个下载链接
http://ffmpeg.org/download.html
和
https://johnvansickle.com/ffmpeg/
四、如何查看ffmpeg支持的所有输入输出设备
使用ffmpeg命令列出所有ffmpeg支持的设备
ffmpeg.exe -devices
注意：ffmpeg支持的设备列表与每台机器的系统环境和设备环境有关，每台机器可能都不同。
五、ffmpeg支持的devices设备列表
输入设备(input devices)
1. alsa
ALSA（高级Linux声音体系结构）输入设备。
要在配置期间启用此输入设备，您需要在系统上安装libasound。
该设备允许从ALSA设备进行捕获。要捕获的设备的名称必须是ALSA卡标识符。
alsa详细信息：https://www.alsa-project.org/alsa-doc/alsa-lib/pcm.html
1.1 ffmpeg命令
ffmpeg -f alsa -i hw:0 alsaout.wav
1.2 参数说明
hw:CARD[,DEV[,SUBDEV]]
三个参数顺序为：CARD，DEV，SUBDEV。
CARD：指定卡号或标识符
DEV：设备号
SUBDEV：子设备号（-1表示任意）
2. android_camera
Android相机输入设备。
基于Android Camera2 NDK API，该API在API级别为24+的设备上可用。在配置过程中会自动检测到android_camera的可用性。
该设备允许从集成在Camera2 NDK API中的Android设备上的所有相机捕获。可用的摄像机在内部进行枚举，可以使用camera_index参数进行选择。输入文件字符串将被丢弃。
通常，背面摄像头的索引为0，而正面摄像头的索引为1。
3. avfoundation
AVFoundation是Apple（苹果公司）当前推荐的多媒体框架，可用于在OSX> = 10.7和iOS上进行流式抓取图像和音频。
可以通过ffmpeg -f avfoundation -list_devices true -i ""列出当前macOS或iOS上支持的抓取设备名称和对应设备的索引号。
3.1 ffmpeg命令
ffmpeg -f avfoundation -i “0:0” out.avi
将索引号为0的视频设备和索引号0的音频设备录制成out.avi视频文件
3.2 参数说明
-i “[[VIDEO]:[AUDIO]]”
video：视频设备索引号
audio：音频设备索引号
索引号通过ffmpeg -f avfoundation -list_devices true -i ""命令查看。
4. bktr
BSD视频输入设备。
5. decklink
decklink输入设备为Blackmagic DeckLink设备提供捕获功能。
6.dshow
Windows DirectShow输入设备,用于采集windows下的视频和音频设备。
通过命令 ffmpeg -list_devices true -f dshow -i dummy 查看支持的设备列表，包含设备名称，设备类型等信息。
6.1 ffmpeg命令
ffmpeg -f dshow -i video=“Camera”:audio=“Microphone”
打开摄像头和麦克风
6.2 参数说明
TYPE=NAME[:TYPE=NAME]
TYPE：设备类型，video或者audio
NAME：设备名称（对应命令 ffmpeg -list_devices true -f dshow -i dummy 中输出的设备名称）
7. fbdev
Linux帧缓冲输入设备。
Linux帧缓冲区是独立于图形硬件的图形抽象层，用于在计算机监视器（通常在控制台）上显示图形。通过文件设备节点（通常是/ dev / fb0）访问它。
详情信息：http://linux-fbdev.sourceforge.net/
8.gdigrab
基于Win32 GDI的屏幕捕获设备。可以捕获Windows桌面屏幕显示区域的画面图像，包含windows窗口显示画面。
6.1 ffmpeg命令
捕获桌面屏幕指定区域的画面图像(不加-offset_x 和 -offset_y就是捕获全屏)
ffmpeg -f gdigrab -framerate 6 -offset_x 10 -offset_y 20 -video_size vga -i desktop out.mpg
捕获计算器窗口画面图像
ffmpeg -f gdigrab -framerate 6 -i title=Calculator out.mpg
6.2 参数说明
framerate：帧率
desktop：desktop是指输入设备是桌面屏幕
title=window_title ：window_title是windows窗口的标题，注意不是进程名称
draw_mouse：是否绘制鼠标，0：不绘制鼠标，1：绘制鼠标（如果为空默认为1）
-offset_x：捕获的区域X坐标，屏幕左上角为起始坐标（0,0），右下角为（screenSize,screenSize）
-offset_y：捕获的区域Y坐标
9. iec61883
使用libiec61883的FireWire DV / HDV输入设备。
10. jack
JACK输入设备
11. kmsgrab
KMS视频输入设备。
将与指定的CRTC或平面关联的KMS扫描输出帧缓冲区捕获为DRM对象，并将其传递给其他硬件功能。
需要DRM主服务器或CAP_SYS_ADMIN才能运行。
12. lavfi
Libavfilter输入虚拟设备。
该输入设备从libavfilter过滤器图的打开的输出垫读取数据。
对于每个filtergraph打开的输出，输入设备将创建一个对应的流，该流映射到生成的输出。当前仅支持视频数据。过滤器图是通过选项图指定的。
13. libcdio
基于libcdio的音频CD输入设备。
要在配置期间启用此输入设备，您需要在系统上安装libcdio。它需要配置选项–enable-libcdio。
此设备允许从音频CD播放和抓取。
14. libdc1394
IIDC1394输入设备，基于libdc1394和libraw1394。
15. openal
OpenAL输入设备通过有效的OpenAL 1.1实施在所有系统上提供音频捕获。OpenAL标头和库应作为OpenAL实施的一部分提供，或作为其他下载（SDK）提供。
16. oss
打开声音系统输入设备。
提供给输入设备的文件名是代表OSS输入设备的设备节点，通常设置为/ dev / dsp。
17. pulse
pulseAudio输入设备。
提供给输入设备的文件名是源设备或字符串“ default”。
18. sndio
sndio输入设备。
提供给输入设备的文件名是代表sndio输入设备的设备节点，通常设置为/ dev/audio0。
19. video4linux2, v4l2
Video4Linux2输入视频设备。“ v4l2”可以用作“ video4linux2”的别名。
如果FFmpeg是使用v4l-utils支持构建的（通过使用–enable-libv4l2配置选项），则可以将其与-use_libv4l2输入设备选项一起使用。
要抓取的设备的名称是文件设备节点，通常，Linux系统会在将设备（例如USB网络摄像头）插入系统时自动创建此类节点，并且名称为/ dev / videoN，其中N是与设备关联的数字。
Video4Linux2设备通常支持一组有限的widthxheight大小和帧速率。您可以使用-list_formats all查看Video4Linux2设备支持的功能。某些设备（例如电视卡）支持一种或多种标准。可以使用-list_standards all列出所有受支持的标准。
时间戳记的时基为1微秒。根据内核版本和配置的不同，时间戳可能来自实时时钟（Unix纪元起源）或单调时钟（通常在引导时起源，不受NTP或手动更改时钟的影响）。 -timestamps abs或-ts abs选项可用于强制转换为实时时钟。
20. vfwcap
VfW（Windows视频）捕获输入设备。作为输入传递的文件名是捕获驱动程序号，范围从0到9，一般用于捕获摄像头图像。
可以使用“ list”作为文件名来查看支持的设备列表。其他任何文件名将被解释为设备号0。
20.1 ffmpeg命令
查看本机支持的设备列表
ffmpeg -y -f vfwcap -i list
捕获摄像头图像并保存成mp4文件
ffmpeg -y -f vfwcap -i 0 out.mp4
20.2 参数说明
video_size：设置抓取的图像大小（例如：800x600）
framerate：帧率，默认30帧
21. x11grab
X11视频输入设备。可以捕获X11显示器的区域。
输出设备
1. alsa
ALSA（高级Linux声音体系结构）输出设备。
2. AudioToolbox
AudioToolbox输出设备。
允许本机输出到OSX上的CoreAudio设备。
3. caca
CACA输出设备。
此输出设备允许在CACA窗口中显示视频流。每个应用程序只允许一个CACA窗口，因此在一个应用程序中只能有一个此输出设备的实例。
4. decklink
decklink输出设备为Blackmagic DeckLink设备提供播放功能。
5. fbdev
Linux帧缓冲输出设备。
Linux帧缓冲区是独立于图形硬件的图形抽象层，用于在计算机监视器（通常在控制台）上显示图形。通过文件设备节点（通常是/ dev / fb0）访问它。
更多详细信息请查看：http://linux-fbdev.sourceforge.net/
6. opengl
OpenGL输出设备。
此输出设备允许渲染到OpenGL上下文。上下文可以由应用程序提供，也可以创建默认的SDL窗口。
7. oss
OSS（开放声音系统）输出设备。
8. pulse
PulseAudio输出设备。
更多信息请查看：http://www.pulseaudio.org。
9. sdl
SDL（简单DirectMedia层）输出设备。“ sdl2”可以用作“ sdl”的别名。
此输出设备允许在SDL窗口中显示视频流。每个应用程序只允许一个SDL窗口，因此在一个应用程序中只能有此输出设备的一个实例。
更多sdl信息请查看：http://www.libsdl.org/
10. sndio
sndio音频输出设备。
11. v4l2
Video4Linux2输出设备。
12. xv
XV（XVideo）输出设备。可以在X Window System窗口中显示视频流。