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窗口显示画面。

8.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

8.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窗口中显示视频流。