FFmpeg命令行使用手册-devices输入输出设备汇总篇

我就是我 2022-12-01 05:15 169阅读 0赞

ffmpeg命令系列：

> [FFmpeg命令行使用手册-protocols协议汇总篇][FFmpeg_-protocols]  
> [FFmpeg命令行使用手册-devices输入输出设备汇总篇][FFmpeg_-devices]

# 一、前言 #

本系列介绍ffmpeg命令行中有关-devices输入输出设备的支持和使用。

**输入设备**（input devices）用于采集/抓取来自连接到系统的多媒体设备的数据，比如采集麦克风/话筒的音频采样数据，桌面屏幕图像数据，摄像头/相机图像数据等。

**输出设备**（output devices）用于将多媒体数据写出到系统的输出设备中，比如音频播放设备，窗口，图形渲染设备（openGL上下文、SDL）等。

# 二、参考资料 #

本文参考自ffmpeg官方文档：[https://ffmpeg.org/ffmpeg-devices.html][https_ffmpeg.org_ffmpeg-devices.html]

# 三、如何下载和安装ffmpeg #

windows平台下载：[https://download.csdn.net/download/eguid\_1/12567936][https_download.csdn.net_download_eguid_1_12567936]  
mac平台下载：[https://download.csdn.net/download/eguid\_1/12607297][https_download.csdn.net_download_eguid_1_12607297]  
linux平台下载：linux发行版较多，有些发行版支持ffmpeg，不一一提供，提供ffmpeg官方提供的两个下载链接  
[http://ffmpeg.org/download.html][http_ffmpeg.org_download.html]  
和  
[https://johnvansickle.com/ffmpeg/][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/][http_linux-fbdev.sourceforge.net]

### 6. opengl ###

OpenGL输出设备。  
此输出设备允许渲染到OpenGL上下文。上下文可以由应用程序提供，也可以创建默认的SDL窗口。

### 7. oss ###

OSS（开放声音系统）输出设备。

### 8. pulse ###

PulseAudio输出设备。  
更多信息请查看：[http://www.pulseaudio.org][http_www.pulseaudio.org]。

### 9. sdl ###

SDL（简单DirectMedia层）输出设备。“ sdl2”可以用作“ sdl”的别名。  
此输出设备允许在SDL窗口中显示视频流。每个应用程序只允许一个SDL窗口，因此在一个应用程序中只能有此输出设备的一个实例。  
更多sdl信息请查看：[http://www.libsdl.org/][http_www.libsdl.org]

### 10. sndio ###

sndio音频输出设备。

### 11. v4l2 ###

Video4Linux2输出设备。

### 12. xv ###

XV（XVideo）输出设备。可以在X Window System窗口中显示视频流。

[FFmpeg_-protocols]: https://eguid.blog.csdn.net/article/details/107307093
[FFmpeg_-devices]: https://eguid.blog.csdn.net/article/details/108233278
[https_ffmpeg.org_ffmpeg-devices.html]: https://ffmpeg.org/ffmpeg-devices.html
[https_download.csdn.net_download_eguid_1_12567936]: https://download.csdn.net/download/eguid_1/12567936
[https_download.csdn.net_download_eguid_1_12607297]: https://download.csdn.net/download/eguid_1/12607297
[http_ffmpeg.org_download.html]: http://ffmpeg.org/download.html
[https_johnvansickle.com_ffmpeg]: https://johnvansickle.com/ffmpeg/
[http_linux-fbdev.sourceforge.net]: http://linux-fbdev.sourceforge.net/
[http_www.pulseaudio.org]: http://www.pulseaudio.org
[http_www.libsdl.org]: http://www.libsdl.org/