Audio Device Diagnostic

何时使用#

满足以下条件时加载此技能：

• 音频录制/唤醒词检测不工作
• 需要列出所有可用麦克风/输入设备
• 需要诊断 PyAudio 设备连接问题
• 需要确认设备索引号以传递给 --device 参数

诊断脚本#

python

import pyaudio

p = pyaudio.PyAudio()
info = p.get_host_api_info_by_index(0)
numdevices = info.get('deviceCount')

print("Available audio input devices:")
for i in range(0, numdevices):
    if p.get_device_info_by_host_api_device_index(0, i).get('maxInputChannels') > 0:
        device_info = p.get_device_info_by_host_api_device_index(0, i)
        print(f"  Input Device id {i} - {device_info.get('name')}")

p.terminate()

命令#

bash

cd D:\coze-local\db
python check_audio_devices.py

输出示例#

text

Available audio input devices:
  Input Device id 0 - Microsoft Sound Mapper - Input
  Input Device id 1 - 麦克风 (Realtek(R) Audio)
  Input Device id 2 - 立体声混音 (Realtek(R) Audio)
  Input Device id 3 - CABLE Output (VB-Audio Virtual Cable)

故障排除#

问题原因解决[Errno -9999] Unanticipated host error设备索引不存在运行本诊断脚本，使用有效设备ID[WinError 2] 系统找不到指定文件缺少 ffmpeg已修复：使用 numpy 数组直接传 WhisperUnboundLocalError: stream异常路径未初始化变量已修复：初始化 stream = None``UnicodeEncodeError终端编码限制已修复：添加 safe_print() 函数

自动设备选择#

设备 ID 0（Microsoft Sound Mapper - Input）是系统默认输入设备，兼容性最好。如果使用虚拟音频设备（如 VB-Cable），请使用对应的设备 ID。

相关文件#

• D:\coze-local\db\check_audio_devices.py — 诊断脚本
• D:\coze-local\db\audio.py — 音频核心模块
• D:\coze-local\external\clawhub_skills\wake-word-detector\SKILL.md — 唤醒词技能

依赖#

bash

pip install pyaudio