全局设置

概念

全局设置控制 Vinput 的基础运行环境，与 ASR 引擎和场景选择无关。

对应配置：

{
  "global": {
    "default_language": "en",
    "capture_device": "rnnoise_source",
    "duck_output_while_recording": false,
    "duck_output_volume": 0.25
  },
  "asr": {
    "normalize_audio": true,
    "input_gain": 5.0,
    "vad": {
      "enabled": true
    }
  }
}

录音设备

选择麦克风输入源。Vinput 通过 PipeWire 获取音频，这里列出的是系统可用的采集设备。

GUI 操作

在 Vinput GUI 的 控制 页面选择设备。

CLI 操作

vinput device list              # 列出可用录音设备
vinput device use <名称>         # 设置当前设备

音频增益

input_gain 控制录音音量的放大倍数。如果麦克风音量太小导致识别效果差，可以调高此值。

vinput config set /asr/input_gain 5.0

音频归一化

normalize_audio 开启后会对音频做归一化处理，让音量更稳定。

vinput config set /asr/normalize_audio true

VAD（语音活动检测）

VAD 检测录音中是否有人在说话。开启后，静音片段会被自动过滤，减少无效识别。

vinput config set /asr/vad/enabled true

录音时降低输出音量

开启 duck_output_while_recording 后，Vinput 会在录音期间降低系统输出音量，录音结束后自动恢复。适用于同时使用外放音箱和麦克风的场景——例如边听音乐边口述——避免外放声音被麦克风收进去、干扰识别。

duck_output_volume 表示录音期间保留的音量比例（0.25 表示保留当前音量的 25%），取值会被限制在 0.0–1.0 之间。该功能默认关闭。

音量通过 WirePlumber（wpctl）调节，因此与系统音量一致并在结束后完整恢复。若系统上没有 WirePlumber（例如某些沙箱环境），该功能会被静默跳过。

vinput config set /global/duck_output_while_recording true
vinput config set /global/duck_output_volume 0.25

以上两项也可在 Vinput GUI 的 控制 页面 音频 分组中设置。

语言

default_language 设置默认语言，影响界面显示和部分模型行为。

vinput config set /global/default_language zh

通用 CLI

vinput config get <JSON Pointer>        # 读取任意配置项
vinput config set <JSON Pointer> <值>   # 写入任意配置项
vinput config edit core                 # 编辑核心配置 config.json
vinput config edit fcitx                # 编辑 Fcitx 插件配置 vinput.conf
vinput daemon restart                   # 重启守护进程使配置生效