手册页部分 1: 用户命令

退出打印视图

更新时间: 2014 年 7 月
 
 

audiorecord(1)

名称

audiorecord - 录制音频文件

用法概要

audiorecord [-af] [-v vol] [-c channels] [-s rate]
     [-e encoding] [-t time] [-i info] [-d dev]
     [-T au | aif[f] | wav] [file[.au|.aif[f]]|.wav]


描述

audiorecord 实用程序将音频数据从音频设备复制到指定的音频文件,或者在未提供文件名的情况下复制到标准输出。如果未指定输出文件且标准输出为 tty,该程序将退出并显示一条错误消息。

缺省情况下,单声道音频数据以 8 kHz 的频率进行录制,且以 -law 格式进行编码。如果音频设备支持其他配置,可以使用 –c–s–e 选项指定数据格式。输出文件前附带音频文件头,该文件头用于识别文件中的编码数据格式。

立即开始录制,并一直录制直到收到 SIGINT 信号(例如 Ctrl-C)为止。如果指定了 –t 选项,audiorecord 会在录制了指定数量的数据后停止。

如果音频设备不可用,即,如果另一个进程当前已进行读访问,audiorecord 会显示一条错误消息并立即退出。

选项

支持以下选项:

–\?

Help:输出命令行用法消息。

–a

Append:在指定音频文件的末尾附加数据。音频设备必须支持现有文件的音频数据格式。

–c channels

Channels:指定音频通道的数量(1 或 2)。可将该值指定为一个整数或字符串 monostereo。缺省值为 mono

–d dev

Devicedev 参数指定应从其获取输入的备用音频设备。如果未指定 –d 选项,则参考 AUDIODEV 环境变量(请参见下文)。否则,/dev/audio 会用作缺省音频设备。

–e encoding

Encoding:指定音频数据编码。该值可以是 ulawalawlinear 之一。缺省编码是 ulaw

–f

Force:若指定了 –a 标志,则音频设备的抽样率必须与录制原始文件的抽样率匹配。如果还指定了 –f 标志,则忽略抽样率差异,但会显示一条有关标准错误的警告消息。

–i info

Information:输出文件头的 'information'(信息)字段会设置为 info 参数所指定的字符串。不能将此选项指定为与 –a 参数一起使用。

–s rate

Sample Rate:指定抽样率,以每秒的样例数为单位。如果一个数字后面跟有字母 k,表示乘以 1000(例如 44.1k = 44100)。缺省抽样率为 8 kHz。

–t time

Timetime 参数指定录制的最长时间。可将时间指定为表示秒数的浮点值,或者指定为 hh:mm:ss.dd 形式(其中,小时和分钟规范为可选)。

–T au | aif[f] | wav

指定要创建的音频文件类型。如果使用 –a 选项,文件类型必须与其将附加到的文件匹配。无论文件后缀为何,都要设置为该选项中指定的类型。如果未指定此选项,则由文件后缀确定文件类型。

–v vol

Volume:在开始录制之前将录制增益设置为指定的值,在 audiorecord 退出后将录制增益重置为先前的级别。vol 参数是 0 到 100(包含 0 和 100)之间的一个整数值。如果未指定此参数,输入音量会保持最近由任何进程设置的级别。

操作数

file[.au|.aif[f]]|.wav

File Specification:重写或附加指定的音频文件。如果未提供文件名且标准输出不是 tty,或者如果指定了特殊文件名 “”,则输出会定向到标准输出。

如果未指定 –T 选项,则由文件后缀确定文件类型。如果无法识别后缀,则缺省值为 .au。如果指定 –T 选项,则无论文件后缀为何,都将使用该文件类型。

用法

当遇到的文件大于或等于 2 GB(2 31 字节)时,有关 audiorecord 行为的说明,请参见 largefile(5)

环境变量

AUDIODEV

要从其录制的音频设备的全路径名(如果未提供 –d 参数)。如果未设置 AUDIODEV 变量,将使用 /dev/audio

属性

有关下列属性的说明,请参见 attributes(5)

属性类型
属性值
体系结构
SPARC、x86
可用性
audio/audio-utilities
接口稳定性
Committed(已确定)

另请参见

audioconvert(1)audioctl(1)audioplay(1)attributes(5)largefile(5)audio(7I)