ffmpeg文档26-输入设备
Posted
tags:
篇首语：本文由小常识网(cha138.com)小编为大家整理，主要介绍了ffmpeg文档26-输入设备相关的知识，希望对你有一定的参考价值。
26 输入设备
FFmpeg中的输入设备配置元素用来启用对附加到您的系统一个多媒体设备访问数据。
当编译时，默认会支持所有的输入设备。你可以通过在配置脚本执行时附加–list-indevs了解到支持的设备。
可以通过–disable-indevs在编译时禁用所有输入设备，也可以在此基础上通过–enable-indev=INDEV允许个别设备，或者在默认支持基础上通过–disable-indev=INDEV禁用个别设备支持达到类似的目的。
在ff*工具集中，使用-devices可以获取当前支持的设备信息。
下面是当前可用的输入设备介绍。
alsa
ALSA (Advanced Linux Sound Architecture——高级Linux音频架构) 输入设备
为了能够使用这个设备，在你的系统上必须安装有libasound库。
这个设备允许从ALSA设备采集，设备通过名称来作为ALSA卡标识符，以进行采集。
ALSA标识语法为：
hw:CARD[,DEV[,SUBDEV]]
这里DEV和SUBDEV是可选的。通过这3个参数（CARD、DEV和SUBDEV）可以指定一个卡的序号或者标识、设备序号和子设备序号（-1意味着任何一个）
在你的系统上要列出当前可用的卡，可以通过文件：/proc/asound/cards and /proc/asound/devices
例如要利用FFmpeg采集ALSA设备（卡ID为0），你可以如下：
ffmpeg -f alsa -i hw:0 alsaout.wav
更多信息参考http://www.alsa-project.org/alsa-doc/alsa-lib/pcm.html
avfoundation
AVFoundation 输入设备
AVFoundation是当前Apple OSX（>=10.7）下建议的流采集框架，它在ios上也是可用的。而老的QTKit框架从OSX10.7开始已经废弃。
这个设备作为输入文件名的语法为：
-i "[[VIDEO]:[AUDIO]]"
第一部分选择视频输入，然后选择音频输入。流必须通过设备列表中的设备名或者设备索引号来指定。或者视频和/或音频输入设备可以通过使用-video_device_index <INDEX>和/或-audio_device_index <INDEX>语法指定，它将覆盖设备名或者索引来作为输入文件名。
所有有效的设备都可以通过使用-list_devices true枚举出来，它会列出所有设备的名称以及对应的索引号。
下面是两个设备的别名：
-
default：选择AVFoundation默认设备（类型）。
-
none：不记录相应的媒体类型，这相当于指定一个空的设备名或者索引
译者补注：none可以用来在进行指定时明确表示没有某种类型，比如
-i "none:[AUDIO]"
表示没有视频只有音频
avfoundation选项
avfoundation支持如下的选项：
-
-list_devices <TRUE|FALSE>
如果设置为
true则列出所有有效输入设备，显示设备名和对应的索引 -
-video_device_index
通过索引指定视频设备，它将覆盖作为输入文件名
-
-audio_device_index
通过索引指定音频设备，它将覆盖作为输入文件名
-
-pixel_format
描述视频设备采用的像素格式，如果不知道，将列出可用设备中第一个有效的支持格式。像素格式是： monob, rgb555be, rgb555le, rgb565be, rgb565le, rgb24, bgr24, 0rgb, bgr0, 0bgr, rgb0, bgr48be, uyvy422, yuva444p, yuva444p16le, yuv444p, yuv422p16, yuv422p10, yuv444p10, yuv420p, nv12, yuyv422, gray
avfoundation例子
-
输出AVFoundation支持的设备
$ ffmpeg -f avfoundation -list_devices true -i ""
-
从视频设备0和音频设备0 采集输出到into out.avi:
$ ffmpeg -f avfoundation -i "0:0" out.avi
-
从视频输入设备2和音频输入设备1采集输出到 out.avi:
$ ffmpeg -f avfoundation -video_device_index 2 -i ":1" out.avi
-
从系统默认视频设备以bgr0像素格式采集，而不采集音频到out.avi:
$ ffmpeg -f avfoundation -pixel_format bgr0 -i "default:none" out.avi
bktr
BSD 视频输入设备
decklink
decklink输入设备提供从Blackmagic DeckLink 采集的能力
要支持这个设备，编译时需要Blackmagic DeckLink SDK ，且需要采用--extra-cflags和--extra-ldflags编译选项。在Windows，你可能需要通过widl运行IDL。
DeckLink非常挑剔支持输入格式。像素格式万恶有uyvy422/210.对于视频你必须利用-list_formats 1指定一个视频画面尺寸（-list_formats 1.）和帧率。音频采样率被设置为48KHz。音频数可能是2、8或16
decklink选项
-
list_devices
如果设置为
true，输出设备列表然后退出，默认为false. -
list_formats
如果设置为
true,输出支持的格式然后退出，默认为`false. -
bm_v210
如果设置为1，则视频采集采用10bit量化的uyvy422 v210标准。不是所有的Blackmagic设备都支持这个选项
decklink例子
-
列出所有输入设备:
ffmpeg -f decklink -list_devices 1 -i dummy
-
列出支持的格式:
ffmpeg -f decklink -list_formats 1 -i ‘Intensity Pro‘
-
采集1080i50视频格式 (format 11):
ffmpeg -f decklink -i ‘Intensity [email protected]‘ -acodec copy -vcodec copy output.avi
-
以10bit采集1080i50视频格式:
ffmpeg -bm_v210 1 -f decklink -i ‘UltraStudio Mini [email protected]‘ -acodec copy -vcodec copy output.avi
-
采集720p50格式，同时采集32bit音频:
ffmpeg -bm_audiodepth 32 -f decklink -i ‘UltraStudio Mini [email protected]‘ -acodec copy -vcodec copy output.avi
-
采集576i50采集视频，同时采集8路音频:
ffmpeg -bm_channels 8 -f decklink -i ‘UltraStudio Mini [email protected]‘ -acodec copy -vcodec copy output.avi
dshow
Windows DirectShow 输入设备。
DirectShow在ffmpeg中由mingw-w64项目提供支持。当前只有音频和视频设备能够使用。
多个单独输入的设备可能被打开,但它们也可能打开相同的输入,这将改善他们之间的同步
输入名可以按格式（语法）：
TYPE=NAME[:TYPE=NAME]
这里TYPE可以是audio或者video，NAME是设备名或者别名。
dshow选项
如果没有特别指定，将采用设备的默认值。如果设备不支持要求的选项，则会打开失败。
-
video_size
设置采集视频的尺寸
-
framerate
设置采集视频的帧率
-
sample_rate
设置采集音频的采样率（单位Hz）
-
sample_size
设置采集音频的采样位深（单位bits）
-
channels
选择采集音频的通道
-
list_devices
如果为真，输出设备列表并退出
-
list_options
如果为真，输出选择设备的选项列表并退出
-
video_device_number
对视频设备名设置索引编号(从0开始，默认0).
-
audio_device_number
对音频设备名设置索引编号(从0开始，默认0).
-
pixel_format
选择用于DirectShow的像素格式。当视频编码没有设置或者设置为
rawvideo时需要设置 -
audio_buffer_size
以milliseconds为单位设置音频设备缓冲大小（它可以直接影响延迟，则取决于依赖的设备）。默认使用设备默认缓冲（通常为500ms的倍数）。这个值设置过低会降低性能。参考http://msdn.microsoft.com/en-us/library/windows/desktop/dd377582(v=vs.85).aspx
-
video_pin_name
通过pin名称（或者别名）选择视频捕获源
-
audio_pin_name
通过pin名称（或者别名）选择音频捕获源
-
crossbar_video_input_pin_number
从交错/交叉设备（音视频交错编码）中选择视频输入端口。可以选择交错设备的视频解码输出端。注意改变这个值将影响未来的调用（设置了一个新的默认值），直到发生系统重启
-
crossbar_audio_input_pin_number
从交错/交叉设备（音视频交错编码）中选择音频输入端口。可以选择交错设备的音频解码输出端。注意改变这个值将影响未来的调用（设置了一个新的默认值），直到发生系统重启
-
show_video_device_dialog
如果设为真，在开始采集前会弹出一个面向用户的对话框，以允许他们改变视频滤镜属性和一些手动配置。注意对于交错设备，可能需要同时在PAL (25 fps)和NTSC (29.97)输入帧率、尺寸、隔行等等属性。改变这些值以不同的扫描率/帧率和避免底部绿色、闪烁的扫描行等等。注意这些改变将影响未来的调用（作为新的默认值）直到系统被重启
-
show_audio_device_dialog
如果为真，将在开始采集前弹出一个面向用户的对话框，以允许他们改变音频滤镜属性和一些手动配置
-
show_video_crossbar_connection_dialog
如果为真，如果打开视频设备将在开始采集前弹出一个面向用户的对话框，以允许手动编辑交错设备路由
-
show_audio_crossbar_connection_dialog
如果为真，如果打开音频设备将在开始采集前弹出一个面向用户的对话框，以允许手动编辑交错设备路由
-
show_analog_tv_tuner_dialog
如果为真，将在开始采集前弹出一个面向用户的对话框，以允许手动调整电视频道/频率
-
show_analog_tv_tuner_audio_dialog
如果为真，将在开始采集前弹出一个面向用户的对话框，以允许手动调整电视音频设置 (例如 mono与stereo, 语言 A,B 或者 C)
-
audio_device_load
从文件加载一个音频捕获设备而不是根据名字搜索。它可以同时加载附加参数（如果滤镜支持）。它用于音频源必须指定为一个值，但可以是任何虚拟的
-
audio_device_save
存储当前音频采集滤镜设备和他们的参数（如果滤镜支持）到一个文件。如果文件存在则被覆盖（这个文件可以被
audio_device_load加载） -
video_device_load
从文件加载一个视频捕获设备而不是根据名字搜索。它可以同时加载附加参数（如果滤镜支持）。它用于视频源必须指定为一个值，但可以是任何虚拟的
-
video_device_save
存储当前视频采集滤镜设备和他们的参数（如果滤镜支持）到一个文件。如果文件存在则被覆盖（这个文件可以被
video_device_load加载）
dshow例子
-
输出DirectShow支持的设备列表并退出:
$ ffmpeg -list_devices true -f dshow -i dummy
-
打开摄像头:
$ ffmpeg -f dshow -i video="Camera"
-
打开名为
Camera的第二个视频设备:$ ffmpeg -f dshow -video_device_number 1 -i video="Camera"
-
打开摄像头和话筒:
$ ffmpeg -f dshow -i video="Camera":audio="Microphone"
-
输出选择设备支持的选项列表并退出:
$ ffmpeg -list_options true -f dshow -i video="Camera"
-
通过名字/别名指定pin名来采集，指定别名设备名:
$ ffmpeg -f dshow -audio_pin_name "Audio Out" -video_pin_name 2 -i video=video="@device_pnp_\?\pci#ven_1a0a&dev_6200&subsys_62021461&rev_01#4&e2c7dd6&0&00e1#{65e8773d-8f56-11d0-a3b9-00a0c9223196}{ca465100-deb0-4d59-818f-8c477184adf6}":audio="Microphone"
-
配置交错设备，指定交错pin，允许在开始时进行视频采集属性调整:
$ ffmpeg -f dshow -show_video_device_dialog true -crossbar_video_input_pin_number 0
-crossbar_audio_input_pin_number 3 -i video="AVerMedia BDA Analog Capture":audio="AVerMedia BDA Analog Capture"
dv1394
Linux DV1394输入设备
fbdev
Linux framebuffer（Linux帧缓冲）输入设备
Linux framebuffer是一种独立于硬件的图像抽象层，它用于在计算机屏幕上显示图像,通常是在控制台（环境）。它可以通过一个文件设备节点访问，通常为：/dev/fb0
要了解更多详细信息请阅读Linux源码文件树下文档：Documentation/fb/framebuffer.txt
为了从/dev/fb0读取：
ffmpeg -f fbdev -r 10 -i /dev/fb0 out.avi
你可以通过下面的命令截屏：
ffmpeg -f fbdev -frames:v 1 -r 1 -i /dev/fb0 screenshot.jpeg
此外还可以在http://linux-fbdev.sourceforge.net/了解fbset(1)。
gdigrab
Win32 GDI 屏幕截取设备
这个设备允许你截取显示在Windows（系统）上的屏幕区域。
它有两个可选的输入文件名（形式）：desktop或者title=window_title
第一个可选名（desktop）会截取整个桌面或者桌面的指定区域，第二个可选名（根据窗口标题）会截取单独的窗口，而无论在屏幕上的位置（即即使根据某些操作，该窗口已经移除屏幕可见区域，或者被其他窗口覆盖了也可以截取到）
下面是截取整个桌面的例子：
ffmpeg -f gdigrab -framerate 6 -i desktop out.mpg
截取桌面上从点（10,20)开始的640x480大小区域
ffmpeg -f gdigrab -framerate 6 -offset_x 10 -offset_y 20 -video_size vga -i desktop out.mpg
截取名为 "Calculator"的窗口
ffmpeg -f gdigrab -framerate 6 -i title=Calculator out.mpg
gdigrab选项
-
draw_mouse
为1指定是截取鼠标，0表示不截取，默认为1
-
framerate
设置帧率，默认为ntsc,相应帧率为30000/1001.
-
show_region
在屏幕上显示截取区域。Show grabbed region on screen.
如果指定为1，则指定的截取范围会显示在屏幕上，通过这个选项，可以很容易的知道要截取的范围，这在只截取屏幕的一部分时很有用。
注意
show_region在截取单独窗口时无效（即不可用）例如:
ffmpeg -f gdigrab -show_region 1 -framerate 6 -video_size cif -offset_x 10 -offset_y 20 -i desktop out.mpg -
video_size
设置视频帧尺寸，默认为屏幕（以
desktop为源）或者窗口（以title=window_title为源）尺寸 -
offset_x
当区域截取时,起点的x轴的偏移（左边距屏幕左边距离）
注意坐标体系是以可见屏幕左上为原点的。如果你有一个监看对象从左边超出了屏幕可见范围，则
offset_x的值为负数值。 -
offset_y
当区域截取时,起点的y轴的偏移（上边距屏幕上边距离）
注意坐标体系是以可见屏幕左上为原点的。如果你有一个监看对象从上边超出了屏幕可见范围，则
offset_y的值为负数值
iec61883
使用iec61883的FireWire（火线） DV/HDV输入设备。
要允许这个输入设备，需要libiec61883, libraw1394 和 libavc1394被安装到系统中。此外还要在编译时配置--enable-libiec61883以支持。
iec61883支持通过 IEEE1394 (FireWire)接口连接设备获取视频(使用libiec61883 和新的Linux FireWire stack (火线堆栈juju)）。从Linux Kernel 2.6.37开始它是默认的DV/HDV输入方法了，而老的FireWire stack已经被移除。
iec61883的选项
-
dvtype
覆盖自动检测的DV/HDV类型。它仅用于自动检测类型失败的情况，或需要禁止者需要的格式被禁止的条件。错误的指定将使设备不能正常工作。选项支持
auto，dv和hdv为参数 -
dvbuffer
对传入的数据设置缓冲（单位帧）。对于DV，它是一个精确的帧数，对于HDV，它不是精确的帧数，因为HDV没有一个固定的帧大小。
-
dvguid
通过GUID来指定截取设备ID。这样捕获将仅从指定的设备，或者失败（没有指定的设备）。对于系统连接了多个可用设备的情况它非常有用。在系统的
/sys/bus/firewire/devices可以找到连接设备的GUID。
iec61883的例子
-
获取播放FireWire DV/HDV
ffplay -f iec61883 -i auto
-
获取记录FireWire DV/HDV，包缓冲大小为100000个包
ffmpeg -f iec61883 -i auto -hdvbuffer 100000 out.mpg
jack
JACK输入设备。
为了能使用JACK设备，需要系统上存在libjack
一个JACK输入设备创建1个或者多个JACK可写客户端，每一个对应于一个音频通道，命名（指定）为client_name:input_N，这里client_name由程序提供，N是通道id号。每个可写客户端作为ffmpeg的输入设备发送数据。
你一次可以创建1个或者多个JACK可读客户端，来连接到1个或者多个JACK可写客户端。
可以使用jack_connect和jack_disconnect连接或者断开（不连接）JACK客户端，或者通过图形化接口实现：例如通过qjackctl，
可以通过jack_lsp来列出JACK客户端和它们的属性列表。
下面的例子展示ffmpeg如何从JACK可读客户端采集数据：
# Create a JACK writable client with name "ffmpeg".
$ ffmpeg -f jack -i ffmpeg -y out.wav
# Start the sample jack_metro readable client.
$ jack_metro -b 120 -d 0.2 -f 4000
# List the current JACK clients.
$ jack_lsp -c
system:capture_1
system:capture_2
system:playback_1
system:playback_2
ffmpeg:input_1
metro:120_bpm
# Connect metro to the ffmpeg writable client.
$ jack_connect metro:120_bpm ffmpeg:input_1
更多信息参考http://jackaudio.org/
lavfi
Libavfilter输入虚拟设备
这个输入设备可以从libavfilter滤镜链图的一个开放输出端口读取数据。
对于每个滤镜链图开放输出端口，这个输入设备将创建一个对应的流映射到这个端口进行输出。当前只支持视频数据。滤镜链图是通过选项graph描述的。
lavfi选项
-
graph
描述用作输入的滤镜链图。每个视频开放输出必须由一个形如
outN的独立标签命名，这里N是从0开始的数字，以指代要映射作为设备的输入流（序号）。第一个没有标签命名的输出自动被作为out0，但所有其他的必须明确指定。通过附加后缀“+subcc”可以向输出标签创建一个额外的封闭包装字幕（实验性质：现只对EIA-608 / CEA-708）。这个
subcc流在所有其它常规流创建后才附加，并按对应流顺序。例如有 "out19+subcc", "out7+subcc" 以及最高普通流"out42"，则43号流是subcc对应于out7，44号流也是subcc流对应out19如果没有指定（选项）默认值为输入设备指定的文件名（这里文件名其实是滤镜链图描述）
-
graph_file
设置通过文件读取/发送（给其他滤镜）滤镜链图的文件名。在文件中的语法与通过
graph选项描述滤镜链图的语法相同。
lavi例子
-
创建一个颜色流并播放：
ffplay -f lavfi -graph "color=c=pink [out0]" dummy
-
类似前面的例子，但是有文件名来指定滤镜链图描述，并且省略了"out0"标签:
ffplay -f lavfi color=c=pink
-
创建3个不同的视频测试滤镜源并播放:
ffplay -f lavfi -graph "testsrc [out0]; testsrc,hflip [out1]; testsrc,negate [out2]" test3
-
从文件中使用
amovie读取音频流来播放:ffplay -f lavfi "amovie=te
以上是关于ffmpeg文档26-输入设备的主要内容，如果未能解决你的问题，请参考以下文章