手册页部分 1: 用户命令

退出打印视图

更新时间: 2014 年 7 月
 
 

audioctl(1)

名称

audioctl - 音频混音器控制命令行应用程序

用法概要

audioctl list-devices
audioctl show-device [-v] [-d device]
audioctl show-control [-v] [-d device] [control ...]
audioctl set-control [-v] [-d device] control value
audioctl save-controls [-d device] [-f] file
audioctl load-controls [-d device] file

描述

audioctl 命令用于控制音频混音器的各种功能以及获取有关音频混音器和音频设备的信息。可以对以下数据类型运行 audioctl 命令:

device

音频设备,例如 audiohd#0。接受此设备的子命令会将其作为选项 –d 的参数。如果未提供音频设备,则假定使用缺省音频设备。与音频设备关联的任何设备节点也正常运行,例如 /dev/sound/0/dev/dsp1/dev/audio

control

混音器控制名称,例如 volume

value

控制的值。具体格式取决于控制的类型。单声道值通常使用 0100(含 0 和 100)之间的一个整数。立体声值使用一对此类数字,表示左右两个声道。布尔值指示 onoff。枚举采用一个或多个名称的单个值。

file

控制设置的 ASCII 文本文件。

选项

每个子命令都具有自己的专用选项集合。但是,某些子命令支持特殊标志 -v,该标志表示要求更详细的输出。

子命令

支持以下子命令:

audioctl list-devices

列出系统上的所有音频设备。

audioctl show-device [-v] [-d devices]

显示有关设备的常规信息。

audioctl show-control [-v] [-d device] [control ..]

显示设备的控制设置值。显示指定的控制。如果未提供控制名称,则显示所有控制值。

audioctl set-control [-v] [-d device] control value

将控制值更改为所提供的值。

audioctl save-controls [-f] [-d device] file

将所有混音器控制值的当前状态保存到指定文件。如果该文件已存在,此命令会安全中止,除非指定 –f

audioctl load-controls [-d device] file

针对所有混音器控制恢复先前保存在指定文件中的状态。

环境变量

AUDIODEV

如果未指定 –d–a 选项,则参考 AUDIODEV 环境变量。如果已设置这两个选项,AUDIODEV 将包含用户的缺省音频设备的全路径名。

文件

/dev/audioctl /dev/sound/{0...n}ctl

属性

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

属性类型
属性值
体系结构
SPARC、x86
可用性
system/io/audio
接口稳定性
请参见下文。

audioctl 命令及其子命令是 "Committed"(已确定)。用户可读的输出"Not An Interface"(不是接口)。设备名称、控制名称和值是 "Uncommitted"(未确定)。save-controlsload-controls 子命令使用的状态文件的格式“已提交为专用”。

另请参见

audioconvert(1)audioplay(1)audiorecord(1)open(2)attributes(5)