101 lines
3.2 KiB
Markdown
101 lines
3.2 KiB
Markdown
# Utilities
|
|
|
|
alsa-ucm-aw 是一个供用户使用 ALSA UCM 配置文件的应用程序
|
|
|
|
## 使用方法
|
|
```sh
|
|
alsa-ucm-aw [OPTIONS] <COMMAND>
|
|
```
|
|
|
|
### OPTIONS (选项)
|
|
|
|
#### -h, --help
|
|
显示帮助信息
|
|
|
|
#### -c, --card NAME
|
|
指定 card 的名字. 若没指定, 则会根据 UCM 配置文件选择默认的 card
|
|
|
|
#### -v, --verb NAME
|
|
指定 verb 的名字. 若没指定, 则会根据 UCM 配置文件选择默认的 verb
|
|
|
|
#### -d, --device NAME
|
|
指定 device 的名字. 若没指定, 则会根据 UCM 配置文件选择默认的 device
|
|
(在某些情况下不能与指定 modifier 的选项 `-m` 同时使用)
|
|
|
|
#### -m, --modifier NAME
|
|
指定 modifier 的名字. 若没指定, 则会根据 UCM 配置文件选择默认的 modifier
|
|
(在某些情况下不能与指定 device 的选项 `-d` 同时使用)
|
|
|
|
#### -p, --play
|
|
指定为 "播放", 用于指定程序寻找默认 verb 时优先选择 "Play", 以及在音量操作上选择
|
|
"PlaybackVolume" 变量等 (不能与 `-r` 选项同时使用)
|
|
|
|
#### -r, --record
|
|
指定为 "录制", 用于指定程序寻找默认 verb 时优先选择 "Record", 以及在音量操作上选
|
|
择 "CaptureVolume" 变量等 (不能与 `-p` 选项同时使用)
|
|
|
|
#### -V, --verbose
|
|
显示提示信息
|
|
|
|
### COMMAND (命令)
|
|
|
|
#### list
|
|
列出所有的 card, verb, device 和 modifier
|
|
(符号 `[c]` 表示 card, `[v]` 表示 verb, `[d]` 表示 device, `[m]` 表示 modifier)
|
|
|
|
#### enable
|
|
执行 "EnableSequence" 中的内容
|
|
|
|
#### disable
|
|
执行 "DisableSequence" 中的内容
|
|
|
|
#### get IDENTIFIER
|
|
获取 UCM 配置文件中某个变量的值, `IDENTIFIER` 可以为 "PlaybackPCM", "CapturePCM",
|
|
"PlaybackVolume" 等名字, 视配置文件的具体内容而定
|
|
|
|
#### getvol
|
|
根据 "PlaybackVolume" 或 "CaptureVolume" 中控件的名字获取它在当前系统中实际的值
|
|
(需要与 `-p` 或 `-r` 选项同时使用)
|
|
|
|
#### setvol [VALUE]
|
|
根据 "PlaybackVolume" 或 "CaptureVolume" 中控件的名字设置它在当前系统中实际的值,
|
|
若没有指定要设置的具体数值 `VALUE` , 则会将其设置为 "PlaybackVolume" 或
|
|
"CaptureVolume" 中定义的默认值 (需要与 `-p` 或 `-r` 选项同时使用)
|
|
|
|
## 例子
|
|
|
|
以下使用 "card|verb|device|modifier" 的格式表明指定的设备
|
|
|
|
- 执行 audiocodec|Play|Headphone|(null) 的 EnableSequence
|
|
```sh
|
|
alsa-ucm-aw -c audiocodec -v Play -d Headphone enable
|
|
```
|
|
|
|
- 指定了部分设备 (null)|(null)|Headphone|(null), 由程序自动选择所缺部分的默认值
|
|
(没有完整指定名字时需要使用 `-p` 或 `-r` 选项)
|
|
```sh
|
|
alsa-ucm-aw -d Headphone -p enable
|
|
```
|
|
|
|
- 完全由程序自主选择默认设备 (null)|(null)|(null)|(null)
|
|
(没有完整指定名字时需要使用 `-p` 或 `-r` 选项)
|
|
```sh
|
|
alsa-ucm-aw -p enable
|
|
```
|
|
|
|
- 获取 UCM 配置文件中 audiocodec|Play|Headphone|(null) 的 "PlaybackVolume" 的值
|
|
```sh
|
|
alsa-ucm-aw -c audiocodec -v Play -d Headphone get PlaybackVolume
|
|
```
|
|
|
|
- 获取 audiocodec|Call|Headset|(null) 中 "PlaybackVolume" 所指定的控件的值
|
|
(选项 `-p` 对应 "PlaybackVolume", `-r` 则对应 "CaptureVolume")
|
|
```sh
|
|
alsa-ucm-aw -c audiocodec -v Call -d Headset -p getvol
|
|
```
|
|
|
|
- 设置 audiocodec|Call|Headset|(null) 中 "CaptureVolume" 所指定的控件的值为 35
|
|
```sh
|
|
alsa-ucm-aw -c audiocodec -v Call -d Headset -c setvol 35
|
|
```
|