JsPsych插件audio-keyboard-response 2.1.0版本发布解析

项目简介

JsPsych是一个用于在网页浏览器中运行心理学实验的JavaScript库。它提供了一系列插件，使研究人员能够轻松创建各种实验范式。其中，audio-keyboard-response插件专门用于播放音频刺激并收集被试通过键盘做出的反应。

版本更新亮点

2.1.0版本为audio-keyboard-response插件引入了一个重要的新功能——标准化引用信息支持。这一改进使得研究人员能够更方便地引用他们在实验中使用的方法和工具。

技术细节解析

引用信息标准化

新版本在每个插件中增加了标准化的引用信息字段，包含两种主流引用格式：

1. APA格式：适合心理学领域论文引用
2. BibTeX格式：适合LaTeX文档引用系统

这些引用信息是自动生成的，基于插件根目录下的.cff文件（Citation File Format）。在构建过程中，系统会自动读取这些信息并整合到插件中。

新增API功能

jsPsych包新增了一个实用函数getCitations()，研究人员可以通过以下方式使用：

const citations = jsPsych.getCitations(['audio-keyboard-response'], 'apa');

这个函数会返回格式化后的引用字符串，其中：

• 第一个参数是插件名称数组
• 第二个参数指定引用格式('apa'或'bibtex')

值得注意的是，函数总是会首先输出jsPsych核心库的引用，然后是各插件的引用，每个引用之间用换行符分隔。

技术意义

这一改进为学术研究带来了几个重要优势：

1. 学术规范性：使研究者能够轻松符合学术引用规范
2. 研究可重复性：明确标注实验工具版本和来源
3. 工作效率：自动化生成引用，减少手动查找和格式化的时间成本
4. 标准化：统一了jsPsych生态系统的引用方式

使用建议

对于使用audio-keyboard-response插件的研究人员，建议：

1. 在方法部分明确说明使用了该插件及其版本号
2. 使用getCitations()函数生成标准引用
3. 定期检查插件更新，以获取最新的功能改进和错误修复

总结

audio-keyboard-response 2.1.0版本的发布，体现了jsPsych项目对学术研究规范性的重视。通过标准化引用系统，不仅提升了研究工作的专业性，也为心理学实验的可重复性研究提供了更好的支持。这一改进将特别有利于需要进行学术发表的研究人员，帮助他们更轻松地满足出版物的引用要求。