跳转至

video-button-response plugin

这一插件的作用是呈现视频并记录被试点击按钮的行为。试次可以在被试做反应时结束，或持续事先设定好的时长。如果被试做了反应、视频播放完毕、或被试在规定时间内没有做反应，试次可以自动结束。你可以禁止被试在视频完成播放前点击按钮。我们可以通过HTML改变按钮的样式。

我们可以使用preload插件自动预加载视频文件。但是，如果你使用了时间线变量或者是其他动态的方法添加视频材料，就需要手动预加载。同时还请注意，如果你的实验是以文件形式运行的（即，直接在浏览器中打开文件，而非通过服务器访问），那么视频预加载会被禁用，以防出现CORS错误——详见运行实验这一部分。

参数

除了适用于所有插件的参数，当前插件还接受以下参数。我们必须对默认值为 undefined 的参数进行赋值，而对于其他参数，如果不需要则不用进行赋值。

参数 类型 默认值 描述
stimulus 数组 undefined 包含所呈现视频路径的数组。你可以为同一个视频添加多个格式（例如.mp4 / .ogg / .webm），以更好地兼容不同浏览器。通常来说，.mp4可以兼容多种浏览请。当前插件不兼容.mov文件。视频播放器你会优先选择当前数组中第一个与所使用的浏览器兼容的视频，所以请将你希望优先使用的视频放到数组开头。
choices 字符串数组 [] 按钮的标签。数组中的每一个字符串都会对应一个按钮。
button_html HTML字符串 '<button class="jspsych-btn">%choice%</button>' 生成按钮的HTML模板。你可以通过修改这一参数来自定义不同种类的按钮。%choice%会根据choices数组中相应的元素值进行修改。如果对于不同按钮需要使用不同的HTML进行呈现，应该把当前的参数值设置为一个数组，这种情况下该数组的长度必须和chocies数组的长度一致。button_html数组的第一个元素对应choices数组中第一个元素，以此类推。
button_layout 字符串 'grid' 如果为'grid'，则会为包裹按钮的元素设置display: grid并启用grid_rows和grid_columns。如果为'flex'，则会为包裹按钮的元素设置display: flex。我们可以通过在button_html中添加行内CSS控制按钮的排布。
grid_rows 数值 1 按钮的行数，只有当button_layout为'grid'时生效。如果为null，则行数会根据按钮数量和列数自动计算。
grid_columns 数值 null 按钮的列数，只有当button_layout为'grid'时生效。如果为null，则列数会根据按钮数量和行数自动计算。
margin_vertical 字符串 '0px' 按钮的垂直方向外边距。
margin_horizontal 字符串 '8px' 按钮的水平方向外边距。
prompt 字符串 null 可以包含HTML元素。该参数的内容会在stimulus下面进行呈现，从而起到提示被试该做什么的作用（例如：该按哪个/些键）。
width 数值 视频原宽度 视频宽度的像素值。
height 数值 视频原高度 视频高度的像素值。
autoplay 布尔 true 如果为true，视频会在加载完成后立刻开始播放。
controls 布尔 false 如果为true，则被试可以看到视频播放器的控制面板，从而可以暂停、调整进度。
start 数值 null 如果赋值，则视频会从该点开始播放（单位：秒）。
stop 数值 null 如果赋值，则视频会到该点停止播放（单位：秒）。
rate 数值 null 视频播放速率。1是原速度，<1是慢速，>1是加速。
trial_ends_after_video 布尔 false 如果为true，则试次会在视频播放完后结束。
trial_duration 数值 null 允许被试做反应的时间限制。如果被试在设定的时间内没有做反应，那么其反应会被记为null，试次会在超出时间后结束。如果当前参数值为null，则试次会一直等待被试做反应。
response_ends_trial 布尔 true 如果为true，则当前试次会在被试做出反应时结束（假定被试是在trial_duration指定的时间范围内做出的反应）如果为false，则当前试次会持续到trial_duration指定的时间才结束。你可以把当前参数设置为false以让被试即便提前做了反应，看当前刺激的时间也要达到固定的时长。
response_allowed_while_playing 布尔 true 如果为true，则允许被试在视频播放期间做反应。如果为false，则被试只能在视频播放完后才能点击按钮。视频播放完后，才会启用按钮并接受被试反应（包括回放的时候）。
enable_button_after 数值 0 延迟多少毫秒后才允许被试点击按钮。如果response_allowed_while_playing为真，则试次一开始就会启动计时；否则，会在视频播放完毕后开始计时。

数据

除了所有插件默认都会收集的数据，当前插件还会记录以下数据。

名称 类型 值
response 数组 说明被试按了哪个按钮。choices数组中的第一个按钮是0，第二个是1，以此类推。
rt 数值 反应时（单位：毫秒），从刺激播放开始计时，到被试做出反应结束。
stimulus 字符串 stimulus数组。在后面使用.json()或.csv()方法保存数据时，该数组会以JSON形式存储起来。

模拟模式

在data-only模式下，response_allowed_while_playing参数不会影响模拟出来的反应时。这是因为该模式下，视频文件不会被加载，所以其时长也是未知的。在未来的版本中，随着模拟模式的改进，这一特性可能会改变。

示例

视频播放完前不接受被试反应 
var trial = {
  type: jsPsychVideoButtonResponse,
  stimulus: [
    'video/fish.mp4'
  ],
  choices: ['0-5', '6-10','11-15','16-20','21-25','25+'],
  prompt: "<p>How many different fish are shown in the video?</p>",
  response_allowed_while_playing: false
};

视频片段由rjt98提供，来自Pond5

在新标签页中打开