PsychoPy中Gazepoint眼动仪校准屏幕异常问题的分析与解决

问题现象

在使用PsychoPy 2024.1.5版本配合Gazepoint眼动仪进行实验时，用户遇到了一个典型的校准显示问题。具体表现为：在进行眼动仪校准时，屏幕会短暂显示2-3次绿色闪屏，而正常的校准点和校准屏幕却无法正常显示。值得注意的是，起始校准界面和结束校准界面能够正常显示，且如果跳过校准环节，眼动追踪数据仍能被正常记录。

技术背景

PsychoPy是一个广泛使用的心理学实验构建工具，它支持多种硬件设备的集成，包括各种型号的眼动仪。Gazepoint作为其中一种支持的眼动追踪设备，需要通过特定的插件与PsychoPy进行交互。在校准过程中，系统会在屏幕上显示一系列目标点，要求被试注视这些点，从而建立眼球位置与屏幕坐标之间的映射关系。

问题根源分析

经过技术团队的调查，发现该问题源于单位转换错误。具体来说，在校准目标尺寸的计算过程中，系统错误地将像素单位转换为了屏幕高度的倍数。例如，原本应该设置为30像素的校准点大小，实际上被设置为屏幕高度的30倍，导致校准点变得异常巨大（超出屏幕范围），从而表现为绿色闪屏现象。

解决方案

针对这一问题，PsychoPy开发团队已在后续版本中进行了修复：

1. 升级PsychoPy至2024.2.1版本
2. 同时升级psychopy-gazepoint插件至0.0.2版本

这两个版本的组合已经解决了单位转换错误的问题，能够正确显示校准点和校准屏幕。

额外技术细节

值得注意的是，用户还报告了另一个相关技术问题：为了使用Gazepoint眼动仪，需要手动添加GazepointSampleEvent到特定的初始化文件中。这一操作反映了早期版本中可能存在的插件完整性不足的问题。在最新版本中，这一手动操作应该不再需要，因为插件已经包含了所有必要的组件。

结论

对于使用PsychoPy配合Gazepoint眼动仪的研究人员，建议始终保持软件和插件的最新版本。这不仅能够避免已知的技术问题，还能获得更好的性能和稳定性。当遇到类似显示异常时，检查单位转换和尺寸计算通常是有效的排错方向。