手册页部分 1: 用户命令

退出打印视图

更新时间: 2014 年 7 月
 
 

audioplay(1)

名称

audioplay - 播放音频文件

用法概要

audioplay [-iV] [-v vol] [-d dev] [file]...

描述

audioplay 实用程序将指定的音频文件复制到音频设备(如果未提供文件名,则将标准输入复制到音频设备)。如果未指定输入文件且标准输入为 tty,该程序将退出并显示一条错误消息。

输入文件必须包含有效的音频文件头。此文件头中的编码信息与音频设备的功能相匹配,如果数据格式不兼容,则会显示一条错误消息且跳过此文件。压缩的 ADPCM (G.721) 单声道音频数据在播放之前会自动进行解压缩。

通常会忽略抽样频率中的微小偏差(即,小于 1%)。例如,允许抽样频率为 8012 Hz 的数据在仅支持 8000 Hz 的音频设备上播放。如果存在 –V 选项,则会以警告消息标记此类偏差。

选项

支持以下选项:

–d dev

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

–i

Immediate:如果音频设备不可用(即,另一个进程当前已进行写访问),audioplay 通常会等待,直到其可以访问设备为止。当存在 –i 选项时,若设备处于忙碌状态,audioplay 会显示一条错误消息并立即退出。

–v vol

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

–V

Verbose:显示在等待访问音频设备或检测到抽样率偏差时出现的标准错误的相关消息。

−\?

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

操作数

file

File Specification:按顺序播放命令行上指定的音频文件。如果未提供文件名,则播放标准输入流(如果不是 tty),输入流也必须包含音频文件头。特殊文件名 可用于读取标准输入流而不是文件。如果提供的是相对路径名,则参考 AUDIOPATH 环境变量(请参见下文)。

用法

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

环境变量

AUDIODEV

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

AUDIOPATH

以冒号分隔的目录列表,要在这些目录中搜索使用相对路径名提供名称的音频文件。可在搜索路径中显式指定当前目录 (.)。如果未设置 AUDIOPATH 变量,将仅在当前目录中进行搜索。

属性

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

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

另请参见

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

已知问题

audioplay 当前支持一组限定的音频格式转换。如果音频文件的格式不受音频设备支持,则必须先对其进行转换。例如,要转换成动态语音格式,请使用以下命令:

example% audioconvert -f voice myfile | audioplay

格式转换无法始终与音频输出保持同步。在这种情况下,您应该在播放数据之前转换成临时文件。