本文介绍使用 pyaudio 精确筛选系统中真实可用的输入音频设备（即实际麦克风）的方法，通过过滤 host api 类型和输入通道数，避免重复设备干扰，确保结果与 windows 设置 > 系统 > 声音 中显示的麦克风列表一致。
本文介绍使用 pyaudio 精确筛选系统中真实可用的输入音频设备（即实际麦克风）的方法，通过过滤 host api 类型和输入通道数，避免重复设备干扰，确保结果与 windows 设置 > 系统 > 声音 中显示的麦克风列表一致。
PyAudio 底层基于 PortAudio，而 PortAudio 为兼容不同操作系统音频子系统（如 Windows 上的 WASAPI、DirectSound、MME；macOS 上的 Core Audio；Linux 上的 ALSA/PulseAudio），会为同一物理设备在多个 Host API 下分别注册设备条目。这正是你看到 29 个设备（远超实际的 3 个麦克风 + 2 个扬声器）的根本原因——同一麦克风可能在 WASAPI、MME、DirectSound 等多个 API 下被重复枚举。
要获得与操作系统设置界面（如 Windows 的「设置 > 系统 > 声音」）中一致的真实麦克风列表，关键在于：
✅ 仅保留支持输入（maxInputChannels > 0）的设备；
✅ 限定单一主流 Host API（推荐 hostApi == 0，即默认/首选 API，在 Windows 通常对应 WASAPI，macOS 对应 Core Audio，Linux 对应 ALSA），从而消除跨 API 重复。
以下是精简、可靠且跨平台友好的实现：
import pyaudio
pa = pyaudio.PyAudio()
print(f"总设备数（含所有 API 及输入/输出）: {pa.get_device_count()}")
print("\n✅ 真实可用的麦克风设备（仅 hostApi=0 且支持输入）:")
microphone_indices = []
for i in range(pa.get_device_count()):
try:
info = pa.get_device_info_by_index(i)
# 过滤条件：必须有输入能力，且使用首选 Host API
if info['maxInputChannels'] > 0 and info['hostApi'] == 0:
print(f" [{i}] {info['name']} "
f"(输入通道: {info['maxInputChannels']}, "
f"采样率上限: {int(info['defaultSampleRate'])} Hz)")
microphone_indices.append(i)
except OSError:
# 忽略因设备状态变化导致的异常（如热插拔）
continue
if not microphone_indices:
print("⚠️ 未检测到可用麦克风，请检查硬件连接与系统音频设置。")
else:
print(f"\n提示：共找到 {len(microphone_indices)} 个真实麦克风，"
"可使用上述索引值初始化录音流。")
? 注意事项与最佳实践：
- hostApi == 0 表示 PortAudio 的默认主机 API，在绝大多数现代系统中提供最佳兼容性与低延迟（Windows 默认为 WASAPI，macOS 为 Core Audio）。若需指定其他 API（如强制使用 WASAPI），可通过 pa.get_host_api_info_by_index(0) 查看 API 名称确认。
- 不建议依赖 device_info['name'] 去重（名称可能不唯一或含空格/编码问题），应以 hostApi + index 为唯一标识。
- 实际部署时，建议增加异常处理（如设备被占用、权限不足等），并在用户选择前校验设备是否仍有效（调用 pa.is_format_supported() 或尝试打开流）。
- 若需进一步匹配系统“默认通信设备”，可结合 pycaw（Windows）或 sounddevice 等库获取默认输入设备索引，但 PyAudio 本身不提供该元数据。
通过此方法，你将得到一份干净、准确、与系统设置同步的麦克风列表，为后续音频采集奠定可靠基础。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
