Audio Device Diagnostic

何时使用

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

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

诊断脚本

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()

命令

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

输出示例

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)

故障排除

自动设备选择

设备 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 — 唤醒词技能

依赖

pip install pyaudio