PsychoPy音频设备默认选择机制的问题与修复方案

问题背景

在PsychoPy心理学实验工具中，音频输出设备的选择是一个重要功能。在2024.1.0版本之前，当用户设置prefs.hardware["audioDevice"] = "default"时，系统能够正确识别并使用当前操作系统的默认音频输出设备。然而，在2024版本及以后的更新中，这一功能出现了异常行为。

问题现象

新版本中存在一个关键变化：当指定使用"default"音频设备时，系统不再正确识别操作系统默认设备，而是简单地选择设备列表中的第一个设备（索引为0的设备）。这导致以下问题：

1. 当默认音频设备不是列表中的第一个设备时，音频不会从预期的设备输出
2. 实验程序的音频输出行为与用户系统设置不一致
3. 在多音频设备环境下，实验结果可能因设备选择错误而受到影响

技术分析

通过分析PsychoPy源代码，发现问题出在SpeakerDevice类的初始化方法中。在旧版本中，系统通过底层音频库正确识别默认设备，而新版本则采用了简化的设备选择逻辑：

# 问题代码段
profiles = self.getAvailableDevices()
index = profiles[0]['index']  # 简单地选择第一个设备

这种实现方式忽略了操作系统级别的默认设备设置，直接硬编码选择设备列表中的第一个设备，导致了与用户预期不符的行为。

解决方案

修复方案的核心是恢复使用操作系统级别的默认设备识别机制。通过PsychoPy依赖的psychtoolbox库，我们可以获取准确的系统默认音频设备信息：

import psychtoolbox as ptb

class SpeakerDevice(BaseDevice):
    def __init__(self, index):
        if not isinstance(index, (int, float)) or index < 0:
            # 使用psychtoolbox获取真正的默认设备
            default_port_audio = ptb.PsychPortAudio('Open')
            index = ptb.PsychPortAudio('GetStatus', default_port_audio)['OutDeviceIndex']
        
        self.index = index
        setDevice(index)

这个修改方案具有以下优点：

1. 准确反映操作系统的默认音频设备设置
2. 保持与旧版本一致的行为
3. 兼容多音频设备环境
4. 无需用户额外配置

影响范围

该问题主要影响以下场景：

1. 使用多个音频输出设备的实验环境
2. 依赖系统默认音频设备的实验程序
3. 需要精确控制音频输出设备的心理学实验

最佳实践建议

对于PsychoPy用户，在使用音频功能时建议：

1. 明确指定音频设备索引而非依赖"default"设置
2. 在实验开始前验证音频输出设备是否正确
3. 在多设备环境中，记录实际使用的音频设备信息
4. 考虑在实验指导语中加入音频设备检查步骤

总结

PsychoPy作为心理学实验工具，音频输出的准确性对实验结果至关重要。本次发现的默认音频设备选择问题虽然看似简单，但可能对实验产生实质性影响。通过恢复使用操作系统级别的设备识别机制，可以确保实验程序与用户系统设置的一致性，提高实验的可靠性和可重复性。