Audio Device Diagnostic
音频设备诊断技能 — 列出系统所有可用音频输入设备,检测设备是否正常工作。 Trigger: 当音频设备不工作、需要查看可用麦克风、或选择正确的音频输入设备时。
何时使用
满足以下条件时加载此技能:
- 音频录制/唤醒词检测不工作
- 需要列出所有可用麦克风/输入设备
- 需要诊断 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)
故障排除
| 问题 | 原因 | 解决 |
|---|---|---|
[Errno -9999] Unanticipated host error | 设备索引不存在 | 运行本诊断脚本,使用有效设备ID |
[WinError 2] 系统找不到指定文件 | 缺少 ffmpeg | 已修复:使用 numpy 数组直接传 Whisper |
UnboundLocalError: 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— 唤醒词技能
依赖
pip install pyaudio
Related skills
- Downloads
- 796All time
- Security audit
- Pass
- Last updated
- 5mo ago
- Current version
- v1.0.0
- License
- MIT-0
