跳转至

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。
rt 数值 被试点击全屏按钮所需的时间。

模拟模式

浏览器不允许通过代码进入全屏模式,这是为了防止一些恶意的行为。在visual模式中,当前试次会正常运行,也会模拟点击按钮,但是并不会进入/退出全屏。如果想要进入全屏模式,则需要对当前试次禁用模拟,并手动点击按钮。

示例

进入和退出全屏模式
var enter_fullscreen = {
  type: jsPsychFullscreen,
  fullscreen_mode: true
}

var trial_in_fullscreen = {
  type: jsPsychHtmlButtonResponse,
  stimulus: 'This trial will be in fullscreen mode.',
  choices: ['Continue']
}

var exit_fullscreen = {
  type: jsPsychFullscreen,
  fullscreen_mode: false,
  delay_after: 0
}

var trial_after_fullscreen = {
  type: jsPsychHtmlButtonResponse,
  stimulus: 'This trial will NOT be in fullscreen mode.',
  choices: ['Continue']
}

在新标签页中打开