跳转至

jspsych-fullscreen plugin

这个插件的作用是进入或退出全屏模式。由于安全问题,所有浏览器都要求在进入全屏模式前需要用户和浏览器交互。在jsPsych中,进入全屏模式需要用户点击按钮。退出全屏模式不需要用户和浏览器交互。

Safari在全屏模式下不支持键盘输入。因此,jsPsych在Safari下不会启动全屏模式,实验会忽略使用fullscreen插件的试次。

参数

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

参数 类型 默认值 描述
fullscreen_mode 布尔 true 如果为true,则实验进入全屏模式;如果为false,则实验退出全屏模式。
message 字符串 <p>The experiment will switch to full screen mode when you press the button below</p> 呈现在确认进入全屏按钮上方的HTML内容。
button_label 字符串 'Continue' 确认进入全屏按钮上的文本。
delay_after 数值 1000 进入全屏模式到结束当前试次的时间延迟。对于大多数浏览器,进入全屏模式后会呈现提示进入全屏的消息,这会影响我们的实验,而设置当前参数则可以规避该问题。

数据

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

名称 类型
success 布尔 如果浏览器支持全屏模式(即,不是Safari)则为true。

示例

进入和退出全屏模式

var timeline = [];

timeline.push({
  type: 'fullscreen',
  fullscreen_mode: true
});

timeline.push({
  type: 'html-keyboard-response',
  stimulus: 'This trial will be in fullscreen mode.'
});

// exit fullscreen mode
timeline.push({
  type: 'fullscreen',
  fullscreen_mode: false
});

timeline.push({
  type: 'html-keyboard-response',
  stimulus: 'This trial will NOT be in fullscreen mode.'
});

jsPsych.init({
  timeline: timeline
});