设置选项卡

该文档提供了一个全面的概述，涵盖了Labvanced中可用的研究级别设置和功能。它解释了如何配置核心研究信息、参与者控制、设备和软件要求、参与者管理、生理测量和可选的高级功能，帮助研究人员有效地从头到尾建立、定制和管理实验。

设置视图分为五个部分：Main，Controls，Subjects，Physiology和Special Features。点击顶部导航栏中的任何部分名称，即可直接跳到该部分。

主要

设置选项卡中的Main部分是配置研究核心方面的中心枢纽，包括其身份、展示、技术设置和可访问性。它结合了Settings，用于参数如ID、名称、语言、设备和离线偏好、多用户或纵向设计、眼动追踪和JavaScript执行，及其默认设置，以确保字体、按钮和框架大小的一致性。它还管理Shared Editing Access以确保安全协作，以及Open Experiment Library用于研究设计的发布、可发现性和受控共享。总体而言，它确保研究得到适当配置，视觉一致，可协作管理，并可按需公开访问。

设置

路径: Settings 选项卡 → 顶部 Main 下拉菜单 → Settings

Settings 部分充当研究的基本配置中心，让研究人员定义其整体身份、功能和可访问性。它建立了研究的内部识别和组织方式，以及其运行的视觉和语言环境。它还规定了基本的技术和方法参数，包括对眼动追踪、多会话或多用户设计、设备优化、离线兼容性和安全JavaScript执行的支持。

研究ID

研究的唯一标识符。也显示在“我的研究”页面中。联系支持时，请始终提供此ID。

路径: Settings 选项卡 → 顶部 Main 下拉菜单 → Settings 部分 → Study Id

研究名称（内部）

内部研究名称是您在“我的研究”页面上用于组织您的研究的名称。

路径: Settings 选项卡 → 顶部 Main 下拉菜单 → Settings 部分 → Study Name (Internal)

研究名称（公开）

公开研究名称是参与者在研究加载时看到的名称。

路径: Settings 选项卡 → 顶部 Main 下拉菜单 → Settings 部分 → Study Name (Public)

加载图像

加载图像是可选的图像，将在研究加载时显示给参与者。

路径: Settings 选项卡 → 顶部 Main 下拉菜单 → Settings 部分 → Loading Image

背景颜色

背景颜色是您屏幕上所有未占用部分的颜色。

Note: 对于眼动追踪研究，确保研究背景颜色与眼动追踪任务的背景颜色匹配非常重要！

路径: Settings 选项卡 → 顶部 Main 下拉菜单 → Settings 部分 → Background Color

时区（UTC）

这决定了您研究的时区。以UTC的偏移量定义。

路径: Settings 选项卡 → 顶部 Main 下拉菜单 → Settings 部分 → Time Zone (UTC)

主要语言

此设置指示显示给参与者的研究主要语言。如果您启用了多种语言，将在开始时提供语言选择选项，或者您可以通过URL参数预定义显示语言。

路径: Settings 选项卡 → 顶部 Main 下拉菜单 → Settings 部分 → Main Language

静态/系统文本语言

此设置指示显示给参与者的系统消息/静态字符串的语言。您可以在 Texts & Translate 选项卡中自定义这些字符串。

路径: Settings 选项卡 → 顶部 Main 下拉菜单 → Settings 部分 → Static / System Text Language

多种语言

指示研究是否定义为多种语言。

路径: Settings 选项卡 → 顶部 Main 下拉菜单 → Settings 部分 → Multiple Languages

眼动追踪研究

指示研究是否已启用眼动追踪。

路径: Settings 选项卡 → 顶部 Main 下拉菜单 → Settings 部分 → Eye-Tracking Study

纵向设计

指示研究是否定义为纵向研究（每个参与者多个会话）。

路径: Settings 选项卡 → 顶部 Main 下拉菜单 → Settings 部分 → Longitudinal Design

多用户研究

指示研究是否定义为多用户/实时多玩家实验。

路径: Settings 选项卡 → 顶部 Main 下拉菜单 → Settings 部分 → Multi User Study

设备偏好

通过更改此设置，其他研究设置将相应调整。例如，如果您选择“移动优化”，则新创建的框架的默认大小将设置为移动设备大小（纵向方向）。

路径: Settings 选项卡 → 顶部 Main 下拉菜单 → Settings 部分 → Device Preference

是否离线兼容

指示研究是否与Labvanced桌面和移动应用程序提供的离线模式兼容。离线兼容的研究可以在没有互联网连接的情况下下载和运行。

路径: Settings 选项卡 → 顶部 Main 下拉菜单 → Settings 部分 → Is Offline Compatible

锁定离线模式

将研究锁定为离线兼容模式，确保仅使用离线模式支持的功能。这推荐用于计划在没有互联网连接下进行的研究。

路径: Settings 选项卡 → 顶部 Main 下拉菜单 → Settings 部分 → Locked Offline Mode

JavaScript代码执行

您可以允许在本地格式或受保护的环境中执行JavaScript代码，以提高安全性。了解更多.

路径: Settings 选项卡 → 顶部 Main 下拉菜单 → Settings 部分 → JavaScript Code Execution

默认设置

路径: Settings 选项卡 → 顶部 Main 下拉菜单 → Defaults

Defaults 部分提供了一种标准化研究的视觉和结构方面的方法，通过为新创建的元素设定基准偏好。它允许研究人员定义默认的字体大小、按钮颜色和按钮悬停颜色，以确保文本和互动元素的一致性，并指定默认的框架大小和方向，以控制如何显示内容。这些默认设置简化了研究设计，确保一致的外观和感觉，并减少在创建新元素时的重复手动调整需求。

默认字体大小（像素）

设置一个首选的字体大小（以像素为单位），将应用于您在研究中创建的任何新文本元素。

路径: Settings 选项卡 → 顶部 Main 下拉菜单 → Defaults 部分 → Default Font Size (Px)

默认按钮颜色

设置一个首选的按钮颜色，将应用于您在研究中创建的任何新按钮元素。

路径： Settings 选项卡 → 顶部 Main 下拉菜单 → Defaults 部分 → Default Button Color

默认按钮悬停颜色

设置首选的按钮悬停颜色，将应用于您在研究中创建的任何新按钮元素。

路径： Settings 选项卡 → 顶部 Main 下拉菜单 → Defaults 部分 → Default Button Hover Color

默认框架大小

此设置控制您研究的框架（横向或纵向）的默认尺寸。如果选择自定义，您还可以更改显示模式，以控制框架的渲染和显示方式。有关更多信息，请参见文档。

路径： Settings 选项卡 → 顶部 Main 下拉菜单 → Defaults 部分 → Default Frame Size

锁定纵横比

启用后，框架布局的比例将被锁定。如果您在试验编辑器中更改框架尺寸，将出现一个对话框，自动提供重新居中您的内容的选项。这在分辨率调整时保持您的设计布局。

路径： Settings 选项卡 → 顶部 Main 下拉菜单 → Defaults 部分 → Lock Aspect Ratio

共享编辑访问

路径： Settings 选项卡 → 顶部 Main 下拉菜单 → Shared Editing Access 部分

Shared Editing Access 部分管理研究的协作权限。它允许研究管理员通过输入受信任用户的电子邮件或用户名来邀请他们编辑研究，受邀者需要接受访问请求。它还提供了当前具有编辑权限的用户列表，使管理员能随时撤销访问。这一部分确保只有授权的合作者可以修改研究，同时保持监督和安全性。

邀请用户编辑您的研究

通过输入其他用户的电子邮件地址或用户名，为他们授予对该研究的编辑访问权限。他们将收到通知并必须接受编辑访问请求。请注意，您应该只允许信任的用户拥有编辑访问权限。只有研究的管理员可以邀请新用户进行编辑。

路径： Settings 选项卡 → 顶部 Main 下拉菜单 → Shared Editing Access 部分 → Invite User to Edit Your Study

拥有编辑权限的用户列表

此部分显示已获得您研究的编辑访问权限的用户列表。您可以通过单击“撤销访问”按钮来撤销任何用户的访问权限。此访问权限用户仅对研究管理员可见。

路径： Settings 选项卡 → 顶部 Main 下拉菜单 → Shared Editing Access 部分 → List of Users With Edit Rights

打开实验库

路径： Settings 选项卡 → 顶部 Main 下拉菜单 → Open Experiment Library 部分

Open Experiment Library 部分通过允许研究人员使他们的研究公开访问，以促进共享、透明度和协作。它提供了 Labvanced 公共实验库中研究的链接，并控制其他人如何使用研究设计的导入规则，并可选地允许对记录数据和研究设置的仅查看访问。所需的设置，如出版状态、研究时长、隶属关系和关键字，确保研究可发现并正确分类，而可选字段如描述和相关出版物有助于传达背景和提供学术引用。总体而言，此部分支持开放科学，使他人能够找到、检查并在您的研究基础上进行构建。

实验库中的研究

Labvanced 公共实验库是一个免费的开放科学/开放材料资源。它包含 Labvanced 团队以及选择与研究社区共享其工作的其他研究人员的研究集合。

路径： Settings 选项卡 → 顶部 Main 下拉菜单 → Open Experiment Library 部分 → Study in Experiment Library

实验库中的研究链接

Labvanced 公共实验库中您研究的 URL。您可以使用此链接与审稿人、同事和社区中的其他人分享您的研究。

路径： Settings 选项卡 → 顶部 Main 下拉菜单 → Open Experiment Library 部分 → Study Link in Experiment Library

您研究的导入规则

此设置允许您控制其他用户是否以及如何可以从 Labvanced 公共实验库导入您的研究设计。分享您的工作（无论是在出版前还是之后）将增加透明度并允许他人基于您的工作进行构建。

路径： Settings 选项卡 → 顶部 Main 下拉菜单 → Open Experiment Library 部分 → Import Rule For Your Study

允许所有人查看您的记录数据和研究设置（仅查看访问）

此设置允许所有人查看您的记录数据和研究设置，而无需进行任何更改。这对于开放科学和透明度最为有用。

路径： Settings 选项卡 → 顶部 Main 下拉菜单 → Open Experiment Library 部分 → Allow Everyone to Inspect Your Recorded Data and Study Setup (View Access Only)

实验库的设置：

如果一项研究列入公共实验库，则以下设置和研究描述字段也相关：

研究已发布（必填）

一个标志，指示研究是否已发布并可供参与者招募。

路径： Settings 选项卡 → 顶部 Main 下拉菜单 → Open Experiment Library 部分 → Study Is Published (Required)

研究时长（必填）

参与者完成整个研究所需的估计时间。此信息仅在 Labvanced 实验库中显示。

路径： Settings 选项卡 → 顶部 Main 下拉菜单 → Open Experiment Library 部分 → Study Duration (Required)

您的隶属关系（必填）

指您正式关联的学术或研究机构，例如大学、研究中心或公司。此信息仅在 Labvanced 实验库中显示。

路径： Settings 选项卡 → 顶部 Main 下拉菜单 → Open Experiment Library 部分 → Your Affiliation (Required)

研究关键字（必填）

这些是研究人员可以与其研究相关联的描述性词语或短语，以方便在 Labvanced 实验库中更易找到和分类。您可以添加任何自定义关键字。

路径： Settings 选项卡 → 顶部 Main 下拉菜单 → Open Experiment Library 部分 → Study Keywords (Required)

描述（可选）

这是一个文本字段，您可以在其中介绍和提供有关您研究的详细信息。此描述在 Labvanced 实验库和实验加载时都可见。

路径： Settings 选项卡 → 顶部 Main 下拉菜单 → Open Experiment Library 部分 → Description (Optional)

控件

Controls 选项卡控制研究的启动、显示和访问方式。Experiment Startup 处理预加载文件、同意书、初始调查、权限（网络摄像头、麦克风、屏幕）和语言选择。Screen 设置控制全屏模式、退出时暂停、刷新率、方向、黑暗模式和屏幕校准。Software & Devices 设置参与者可以使用的应用、浏览器和设备，并可以包括音频验证的耳机检查。

控件

实验启动
屏幕
软件与设备

实验启动

路径： Settings 选项卡 → 顶部 Controls 下拉菜单 → Experiment Startup

Experiment Startup 部分在 Controls 选项卡中管理研究开始时发生的所有设置，确保参与者体验流畅，数据收集准确。总体而言，此部分确保实验正确启动，参与者提供必要的权限，并有效收集准备数据。

它包括预加载媒体文件以确保及时的刺激呈现，处理文件加载错误，以及在实验开始前展示同意书（Labvanced 或自定义）。它还允许展示初始调查进行主题平衡，请求网络摄像头、麦克风或屏幕访问，并在启用多种语言时提供语言选择。

预加载所有实验文件

这是在研究开始之前，将所有必要的媒体文件（如图像、音频和视频）加载到参与者的浏览器中的过程。确保刺激流畅和及时呈现是最佳实践。如果您的研究有大量媒体文件，建议禁用此选项。

路径： Settings 标签 → 顶部 Controls 下拉菜单 → Experiment Startup 部分 → Pre-load All Experiment Files

文件加载错误处理

此设置决定了在研究开始之前，如果资源文件（如图像或音频文件）未能加载应该发生什么。如果您选择“终止实验”，实验将被终止，参与者将无法参与。

路径： Settings 标签 → 顶部 Controls 下拉菜单 → Experiment Startup 部分 → On File Loading Error

显示 Labvanced 同意书

此选项允许在实验开始之前显示 Labvanced 同意书。

路径： Settings 标签 → 顶部 Controls 下拉菜单 → Experiment Startup 部分 → Show Labvanced Consent Form

显示自定义同意书

此选项允许在实验开始之前显示自定义同意书。通过我们的文本与翻译标签修改此自定义同意书。转到“开始”部分，然后编辑字段“customConsent”。

路径： Settings 标签 → 顶部 Controls 下拉菜单 → Experiment Startup 部分 → Show Custom Consent Form

显示初始调查

初始调查是一个特殊的预定义调查，可以（可选地）在实验开始之前显示。如果启用，初始调查的数据将用于受试者平衡（例如，根据性别、年龄等将受试者分组）。如果需要基于预调查答案进行更自定义的分组，您必须首先将受试者分配到仅一个组，然后使用“更改组操作”更改他们的组。有关更多信息，请阅读我们的文档。

路径： Settings 标签 → 顶部 Controls 下拉菜单 → Experiment Startup 部分 → Shows Initial Survey

请求摄像头访问

此标志指示实验是否在实验启动时请求访问参与者的摄像头。参与者必须同意分享他们的摄像头。

路径： Settings 标签 → 顶部 Controls 下拉菜单 → Experiment Startup 部分 → Asks for Webcam Access

请求麦克风访问

此标志指示实验是否在实验启动时请求访问参与者的麦克风。参与者必须同意分享他们的麦克风。

路径： Settings 标签 → 顶部 Controls 下拉菜单 → Experiment Startup 部分 → Asks for Microphone Access

请求屏幕访问

此标志指示实验是否在实验启动时请求记录参与者的屏幕。参与者必须同意分享他们的屏幕。

路径： Settings 标签 → 顶部 Controls 下拉菜单 → Experiment Startup 部分 → Asks for Screen Access

显示实验语言选择

此标志指示研究是否提供多种语言，参与者将在实验开始时被提示选择其首选语言。

路径： Settings 标签 → 顶部 Controls 下拉菜单 → Experiment Startup 部分 → Shows Experiment Language Selection

屏幕

路径： Settings 标签 → 顶部 Controls 下拉菜单 → Screen 部分

Screen 控件标签中的部分管理显示设置，以确保参与者按预期查看研究并在整个过程中保持专注。它包括以全屏模式启动研究的选项、如果退出全屏或浏览器标签则暂停以及强制最小监视器刷新率以实现精确的视觉时序。它还允许指定允许的屏幕方向，防止暗模式，并校准屏幕大小和距离以确保准确的刺激呈现。此外，研究人员可以定义最小屏幕大小，以确保在各种设备上的可见性和功能性。总体而言，此部分确保了视觉保真度、参与者专注和准确的刺激传递。

以全屏模式开始研究

此选项确保研究在全屏模式下开始，为参与者提供沉浸式体验，利用整个屏幕空间。

路径： Settings 标签 → 顶部 Controls 下拉菜单 → Screen 部分 → Start Study in Fullscreen

退出全屏时暂停

此选项在参与者退出全屏模式时暂停研究，确保参与者保持专注，不错过任何重要内容和指示。

路径： Settings 标签 → 顶部 Controls 下拉菜单 → Screen 部分 → Pause on Exit Fullscreen

退出浏览器标签时暂停

此选项在参与者导航离开浏览器标签时暂停研究，帮助保持他们的专注力与参与感，并避免参与者在不在场时尝试完成研究。

路径： Settings 标签 → 顶部 Controls 下拉菜单 → Screen 部分 → Pause on Exit Browser Tab

设置所需刷新率 (Hz)

这是一个设置，允许研究人员指定参与者的设备必须具有的最低监视器刷新率，以运行研究。此功能对精确时序视觉刺激至关重要，例如，当刺激呈现时间短于 100 毫秒时。

路径： Settings 标签 → 顶部 Controls 下拉菜单 → Screen 部分 → Set Required Refresh Rate (Hz)

允许的屏幕方向

此设置允许您指定参与者在研究过程中允许使用的屏幕方向。对于那些设计为在平板电脑和智能手机等移动设备上运行的研究，这一点尤其重要。

路径： Settings 标签 → 顶部 Controls 下拉菜单 → Screen 部分 → Allowed Screen Orientation

防止黑暗模式主题

启用时，这会阻止参与者在参与研究时使用其设备的黑暗模式主题。这在防止显示问题方面尤为有用，尤其是在移动设备上。

路径： Settings 标签 → 顶部 Controls 下拉菜单 → Screen 部分 → Prevent Dark Mode Theme

屏幕尺寸：

此部分提供选项，以测量屏幕尺寸和距离来指定屏幕校准，以及设置参与研究的最小屏幕尺寸，如下所述：

测量屏幕尺寸（卡片校准）

启用时，参与者将被要求使用标准化卡片（85.60 x 53.98 毫米）来校准其屏幕尺寸。此校准可用于确保视觉刺激以正确的毫米或视觉角度显示，这对需要精确视觉测量的实验至关重要。

路径： Settings 标签 → 顶部 Controls 下拉菜单 → Screen 部分 → Measure Screen Size (card calibration)

默认屏幕距离（厘米）

这是一个设置，用于估算呈现在屏幕上的刺激的视觉角度。它代表参与者的眼睛与显示器之间的假设距离，单位为厘米。

路径： Settings 标签 → 顶部 Controls 下拉菜单 → Screen 部分 → Measure Screen Size (card calibration)

设置最小屏幕尺寸

此设置允许研究人员定义参与设备的最小屏幕尺寸要求，单位可多样化，以确保最佳显示和研究功能。

以像素为单位： 指定最小屏幕尺寸（单位：像素）。
以毫米为单位： 指定最小屏幕尺寸（单位：毫米，需测量屏幕尺寸）。
以视觉角度为单位： 指定最小屏幕尺寸（单位：视觉角度，需测量屏幕尺寸和估算屏幕距离）。

路径： Settings 标签 → 顶部 Controls 下拉菜单 → Screen 部分 → Set Minimum Screen Size

软件与设备

路径： Settings 标签 → 顶部 Controls 下拉菜单 → Software & Devices 部分

Software & Devices 部分在 Controls 标签中管理参与者可通过哪些平台和应用程序访问研究。它允许研究人员通过 Labvanced 手机应用进行移动数据收集，通过 Labvanced 桌面应用进行本地在线或离线数据收集和生理整合，以及通过网络浏览器，指定允许使用的浏览器，如 Chrome、Firefox、Edge、Opera、Safari 或其他浏览器。此部分确保研究在适当的设备和软件上可访问，同时保持测试环境的控制。

允许的软件：

Labvanced手机应用

Labvanced手机应用是一个面向Android设备的应用程序（计划支持iOS），能够在本机手机应用中进行数据收集。它还包括离线数据收集模式。了解更多.

路径： Settings 选项卡 → 顶部 Controls 下拉菜单 → Software & Devices 部分 → Allowed Software

Labvanced桌面应用

Labvanced桌面应用是一个可下载的应用程序（适用于Windows、Mac和Linux），将Labvanced平台的功能带到研究人员的本地计算机上，支持在线和离线数据收集。此外，它集成了Lab Streaming Layer (LSL)，以支持EEG和其他生理数据的收集。了解更多.

路径： Settings 选项卡 → 顶部 Controls 下拉菜单 → Software & Devices 部分 → Allowed Software

浏览器

允许通过Web浏览器参与使在线/远程参与成为可能。可以启用或禁用个别浏览器。

Google Chrome

允许参与者使用Google Chrome。

Mozilla Firefox

允许参与者使用Mozilla Firefox。

Microsoft Edge

允许参与者使用Microsoft Edge。

Opera

允许参与者使用Opera。

Safari

允许参与者使用Safari。

其他

允许参与者使用其他浏览器。

路径： Settings 选项卡 → 顶部 Controls 下拉菜单 → Software & Devices 部分 → Browsers

允许的参与设备：

Android手机

允许参与者使用Android手机。

Android平板

允许参与者使用Android平板。

iPhone

允许参与者使用iPhone。

iPad

允许参与者使用iPad。

Windows PC

允许参与者使用Windows PC。

Mac

允许参与者使用Mac。

Linux PC

允许参与者使用Linux PC。

其他设备

允许参与者使用其他设备。

路径： Settings 选项卡 → 顶部 Controls 下拉菜单 → Software & Devices 部分 → Allowed Participation Devices:

耳机检查

要测试参与者是否佩戴耳机，您可以在您的研究中包括这个或这个模块。

路径： Settings 选项卡 → 顶部 Controls 下拉菜单 → Software & Devices 部分 → Headphone Check

受试者

Subjects 标签中的Settings 部分集中管理参与者和实验组平衡。这使得可以配置重复参与，包括纵向研究设计，并根据完成状态避免重新进入，使用唯一标识符。它还支持通过自动或手动平衡规则将参与者结构化分配到多个组，同时如基于超时的受试者丢弃和重新分配参与者编号的选项有助于在实验条件下保持均匀分布和有效的数据集。总体而言，它确保了对谁参与、何时参与以及如何维护数据完整性和组平衡的精确控制。

Note: 有关众包和自定义链接创建的参与设置，请参阅Launch & Participate 标签。

受试者

重复参与
受试者平衡

重复参与

Repeated Participation 标签中的部分控制参与者是否可以多次参加同一研究。

路径： Settings 选项卡 → 顶部 Subjects 下拉菜单 → Repeated Participation 部分

Note: 有关众包和自定义链接创建的参与设置，请参阅Launch & Participate 标签。

纵向设计

纵向设计意味着参与者可以在同一研究中不同的时间重复参与。为此，至少有1组必须包含超过1个会话。

路径： Settings 选项卡 → 顶部 Subjects 下拉菜单 → Repeated Participation 部分 → Longitudinal Design

防止受试者重新参与

此设置控制参与者是否可以多次参加同一研究。要防止受试者重新参与研究，Labvanced需要URL中的唯一受试者标识符。您可以使用“subject_code”、“token”或“Prolific_PID”参数。阅读更多.

路径： Settings 选项卡 → 顶部 Subjects 下拉菜单 → Repeated Participation 部分 → Prevent Subject Re-Participation

‣ Prevent When Completed

此选项防止受试者在研究完成后再次参与同一研究。

路径： Settings 选项卡 → 顶部 Subjects 下拉菜单 → Repeated Participation 部分 → Prevent When Completed

‣ Prevent When Not Completed

此选项防止在受试者开始研究但未完成研究的情况下再次参与同一研究，即他们只获得一次完成研究的机会。如果重要的是确保受试者没有看到您研究的刺激/内容，则应启用此选项。请注意，当受试者因技术原因或研究设计错误无法完成研究时，这可能会在众包平台上引发投诉。因此，您还应该公平地补偿未完成研究的受试者。

路径： Settings 选项卡 → 顶部 Subjects 下拉菜单 → Repeated Participation 部分 → Prevent When Not Completed

受试者平衡

Subject Balancing 提供设置选项，以确保实验组之间的参与者分布均匀。像Multi Group Design 这样的选项指示参与者将被分配到不同的组，而基于超时的受试者丢弃会标记花费过长时间的参与者，有助于维护平衡的数据集。从超时或被丢弃的参与者那里重新分配受试者编号到新的参与者身上进一步改善了组和实验条件之间的平衡。

路径： Settings 选项卡 → 顶部 Subjects 下拉菜单 → Subject Balancing 部分

多组设计

此部分指示您的研究是否包含研究中的不同组（例如，控制组和实验组）。了解更多.。多组设计允许您将参与者分配到研究中的不同组（例如，控制组和实验组）。

路径： Settings 选项卡 → 顶部 Subjects 下拉菜单 → Multi Group Design 部分

Note: 操作可用于在Groups 之间移动参与者。

在Study Design 标签下，如果Groups 部分包含多个组，则此处的Multi Group Design 设置将自动更新为YES。因此，以下两个设置将出现，详细说明如下：

受试者分组选择已完成

此设置指定受试者应如何分配到组中。

Note: 对于在离线模式下运行的研究（即通过Labvanced桌面应用），唯一可用的选项是By Participant (Manual)，因为无法与服务器在线通信以执行基于服务器的平衡。

‣ Automatic (Server-based)

使用自动/基于服务器的组选择时，服务器将尝试在组之间均匀平衡受试者。

‣ By Participant (Manual)

此选项允许参与者选择他们将开始研究的组。

路径： Settings 选项卡 → 顶部 Subjects 下拉菜单 → Multi Group Design 等于 YES → Subject Group Selection is Done

受试者平衡规则（哪些受试者被计算在内）

默认情况下，服务器将始终将新受试者分配到受试者人数最少的组。然而，此设置决定了每组中计算哪些受试者，因此影响新受试者将被分配到哪个组。第一个选项计算所有受试者，第二个选项计算已完成和最近开始（可能仍在进行）的受试者。最后一个选项仅计算已完成的受试者。在大多数同时来自多个受试者的参与场景中，第二个选项是最佳选择，并导致最均衡的数据集。

路径： Settings 选项卡 → 顶部 Subjects 下拉菜单 → Multi Group Design 等于 YES → Subject Balancing Rule (Which Subjects are Counted for Balancing)

‣ All subjects who started (includes incomplete datasets)

指示应计算所有受试者，并使用这些值进行平衡。这包括不完整的数据集。

警告： 此选项将包含不完整的数据集在您的受试者计数中。

路径： Settings 选项卡 → 顶部 Subjects 下拉菜单 → Multi Group Design 等于 YES → Subject Balancing Rule (Which Subjects are Counted for Balancing) → All subjects who started (includes incomplete datasets)

‣ Subjects who completed the study or started recently (not timed out)

此选项计算已完成和最近开始的受试者（可能仍然处于活跃状态且未超时）。在大多数情况下，多个受试者的并发参与下，此选项是最佳选择，并导致最平衡的数据集。

此选项在受试者加入研究时增加计数，但如果他们在规定时间内未完成研究，则从计数中减去他们。点击此选项后，可以设置此时间限制。这是推荐的选项，因为它确保在大多数情况下受试者的平衡最均匀。

路径： Settings 选项卡 → 顶部 Subjects 下拉菜单 → Multi Group Design 等于 YES → Subject Balancing Rule (Which Subjects are Counted for Balancing) → Subjects who completed the study or started recently (not timed out)

‣ Only subjects who completed the study

此选项将仅使用成功完成研究的受试者计数作为平衡计数的一部分。一旦受试者完成研究，该组的计数将增加，并将未来的受试者分配到受试者数量较少的组中。

警告： 如果许多受试者同时开始研究并因此分配到同一组，可能会导致受试者计数不平衡。当选择此选项时，我们建议将您的受试者分批记录，以更好地控制平衡。

路径： Settings 选项卡 → 顶部 Subjects 下拉菜单 → Multi Group Design 等于 YES → Subject Balancing Rule (Which Subjects are Counted for Balancing) → Only subjects who completed the study

基于超时的受试者丢弃

启用后，如果受试者花费太长时间完成实验，则会将其标记为超时。这对于平衡各组之间的已完成数据集/受试者非常重要。超时受试者的数据仍将在数据导出中可用。

路径： Settings 选项卡 → 顶部 Subjects 下拉菜单 → Timeout Based Subject Discarding 部分

启用后，以下选项可用：

‣ Timeout (minutes)

指定受试者被视为超时的时间。此时间应为平均参与时间的30-50%（即，您应该相对确定此受试者不会完成研究）。

路径： Settings 选项卡 → 顶部 Subjects 下拉菜单 → Timeout Based Subject Discarding 部分 → Timeout (minutes)

‣ Replace Subject Numbers of Timed Out and Discarded Subjects

如果启用，超时和手动丢弃的受试者的编号将被分配给新参与者。如果使用“Subject_Nr”或“Subject_Nr_Per_Group”变量，或者在任务内的组间因素，启用此选项将进一步改善受试者平衡。

启用此选项后，新受试者将获得与被丢弃受试者相同的受试者编号。好处在于，您可以使用 Subject_Nr（或 Subject_Nr_Per_Group 如果您有多个组）变量进行平衡，并且它将考虑到退场。例如，如果 Subject_Nr 在数据框中用作列索引，则在自动或手动丢弃受试者时，新受试者将获得该受试者编号，从而获得该列索引。这使得您可以更精确地进行组间随机化。您可以选择有或没有替换地分配受试者编号（变量 Subject_Nr 或 Subject_Nr_Per_Group）。

路径： Settings 选项卡 → 顶部 Subjects 下拉菜单 → Timeout Based Subject Discarding 部分 → Replace Subject Numbers of Timed Out and Discarded Subjects

在页面关闭时自动丢弃受试者

启用后，如果参与者在完成研究之前关闭浏览器或导航离开，则其会话将自动标记为丢弃，其组槽立即可用于重新分配。这保持了组统计数据的准确性，无需手动清理，并防止不完整的会话影响组平衡。

路径： Settings 选项卡 → 顶部 Subjects 下拉菜单 → Subject Balancing 部分 → Automatically Discard Subjects on Page Close

生理学

Physiology 设置提供了关于如何收集生理数据的控制，包括设备、工具箱版本、眼动追踪的初始化和校准选项，以及激活头部追踪、心率和情绪检测。

生理学

常见设置
眼动追踪
头部追踪
心率检测
情绪检测

Note: 当您添加一个带有基于生理的触发器（例如眼动追踪、心率或情绪检测触发器）的事件时，相应的录制选项将在任务和研究级别自动启用。这防止了未激活底层录制的触发器的常见设置错误。

常见设置

Common Settings 部分中 Physiology 选项卡下的选项包含与所有生理信号检测相关的基本设置，包括应在研究中使用哪个工具箱版本，以及参与者是否允许选择他们的首选摄像头设备（如果有多个）。

路径： Settings 选项卡 → 顶部 Physiology 下拉菜单 → Common Settings 部分

生理工具箱版本

指示在研究中使用的 Labvanced 生理工具箱的版本。（以前称为 eye-tracking version）。研究将保留其最初设计的版本，因此其数据在会话之间保持可比性。了解更多

路径： Settings 选项卡 → 顶部 Physiology 下拉菜单 → Common Settings 部分 → Physiology Toolbox Version

允许选择摄像头（如果多个）

允许参与者选择其首选摄像设备。

路径： Settings 选项卡 → 顶部 Physiology 下拉菜单 → Common Settings 部分 → Allow Choosing Camera If Multiple

眼动追踪

此功能允许研究人员在其实验中启用基于网络摄像头的眼动追踪。Labvanced 的基于网络摄像头的眼动追踪技术在准确性和易用性方面处于领先地位，并在多项研究和出版物中得到了验证。了解更多

路径： Settings 选项卡 → 顶部 Physiology 下拉菜单 → Eye-Tracking 部分

以下设置描述了 Physiology Toolbox Version 1.3 及更早版本。在 2.0 中，此过程大部分是通过设置向导配置的（请参见选择一个等级）。选择 Custom 不会将这些设置重置为新默认值，而是从先前应用的任何等级开始，并简单地使其设置可单独编辑，而不是暴露在此未逐项列出的设置表面。

虚拟下巴托

此设置控制虚拟下巴托何时处于激活/勾选状态。

‣ Enable (check during trials)

‣ Enable (check between trials)

‣ Enable (check between trials) and show ignore button

‣ Disable

路径： Settings 选项卡 → 顶部 Physiology 下拉菜单 → Eye-Tracking 部分 → Virtual Chinrest

最小面网速度

此设置设置面网处理的最小速度。它充当阈值，以确保太慢的设备不被纳入研究。

Very Low (0.5Hz)
Low (2.5Hz)
Medium Low (5Hz)
Medium (7.5Hz)
Medium High (10Hz)
High (12.5Hz)
Very High (15Hz)

路径： Settings 选项卡 → 顶部 Physiology 下拉菜单 → Eye-Tracking 部分 → Minimum Facemesh Speed

手动确认面具

启用后，受试者需要手动确认面网是否正确放置在他们的脸上。这对于获得参与者关于面网正确工作的确认非常有用。

路径： Settings 选项卡 → 顶部 Physiology 下拉菜单 → Eye-Tracking 部分 → Confirm Face Mask Manually

与 Labvanced 共享数据

启用后，眼动追踪数据将与 Labvanced 共享，以改善我们的眼动追踪。

路径： Settings 选项卡 → 顶部 Physiology 下拉菜单 → Eye-Tracking 部分 → Share Data with Labvanced

校准设置：

以下设置专门用于控制校准在研究中的行为和运行方式：

婴儿友好模式

如果开启，则下面的眼动追踪校准设置将自动调整为适合婴儿。了解更多

路径： Settings 选项卡 → 顶部 Physiology 下拉菜单 → Eye-Tracking 部分 → Infant Friendly Mode

校准长度

此设置控制校准中的点数，因此控制校准的总长度。更长的校准可以提高准确性/减少误差。当校准做好时，您可以平均期待以下准确度值：

130 points：精度为 约1.5视觉度
55 points：精度为 约2.0视觉度
15 points：精度为 约2.7视觉度 阅读我们的文档以了解更多

以下校准长度选项可用：

175 points, 12 poses (~7 minutes)
130 points, 9 poses (~5 minutes)
55 points, 4 poses (~2 minutes)
15 points, 1 pose (~30 seconds)
Very long experimental / debug (15 minutes)
Debug

路径： Settings 标签 → 顶部 Physiology 下拉菜单 → Eye-Tracking 部分 → Calibration Length

设置最大校准误差

这启用最大校准误差，因此可以作为质量控制措施，确保眼动追踪数据的准确性。

当选中该复选框时，将出现以下选项：

‣ Max Calibration Error (%)

这设置允许的最大校准误差（以屏幕对角线的百分比计）。减小此值可以进一步提高眼动追踪数据的质量，但会使更多人未能通过校准。

路径： Settings 标签 → 顶部 Physiology 下拉菜单 → Eye-Tracking 部分 → Set Maximum Calibration Error 被选中 → Max Calibration Error (%)

‣ Max Nr Calibration Attempts

这控制在研究完全失败之前，允许重新尝试校准的次数。

路径： Settings 标签 → 顶部 Physiology 下拉菜单 → Eye-Tracking 部分 → Set Maximum Calibration Error 被选中 → Max Nr Calibration Attempts

校准图像类型

您可以选择点或动物图标作为校准图像。

路径： Settings 标签 → 顶部 Physiology 下拉菜单 → Eye-Tracking 部分 → Calibration Image Type

播放校准声音

选择是否播放校准声音。当选中该复选框时，将出现一个音量/声音滑块以调整音量。

路径： Settings 标签 → 顶部 Physiology 下拉菜单 → Eye-Tracking 部分 → Play Calibration Sounds

显示网格

控制在校准期间是否显示网格。

路径： Settings 标签 → 顶部 Physiology 下拉菜单 → Eye-Tracking 部分 → Show Grid

允许重复使用校准

这允许参与者重用之前会话的校准。请注意，在开发实验时这可能非常有用。

路径： Settings 标签 → 顶部 Physiology 下拉菜单 → Eye-Tracking 部分 → Allow Calibration Reuse

头部追踪

此功能启用使用参与者的网络摄像头进行头部和面部追踪，使研究人员能够监测和分析头部运动，并在研究期间获得详细的面部网格数据。了解更多

路径： Settings 标签 → 顶部 Physiology 下拉菜单 → Head-Tracking 部分

心率检测

此功能启用通过网络摄像头视频使用远程光电容积脉搏波（rPPG）进行心率检测，使研究人员能够在没有物理传感器的情况下监测参与者的心率。

路径： Settings 标签 → 顶部 Physiology 下拉菜单 → Heart Rate Detection 部分

‣ Initialize RPPG on Study Start

RPPG 通过计算加权平均值来工作，因此可能需要10秒或更长时间进行初始化。激活此设置有助于确保RPPG测量在您的主要任务开始之前准备好（除非您在第一个任务中启用RPPG）。

路径： Settings 标签 → 顶部 Physiology 下拉菜单 → Heart Rate Detection 部分 → Initialize RPPG on Study Start

‣ Wait for heartrate confidence

启用后，研究将在心率检测达到指定置信水平之前停止执行。如果在实验过程中心率置信度低于指定阈值，研究也将暂停。这对于确保心率数据可靠很有用。

设置 Heartrate Confidence Threshold（作为0到1之间的数字），心率检测必须达到该值才能进行研究。

路径： Settings 标签 → 顶部 Physiology 下拉菜单 → Heart Rate Detection 部分 → Wait for heartrate confidence

情感检测

此功能支持通过网络摄像头视频使用基于AI的面部表情分析进行实时情感检测，使研究人员能够在研究中监测参与者的情感状态。实现基于此出版物。

路径： Settings 标签 → 顶部 Physiology 下拉菜单 → Emotion Detection 部分

特殊功能

Special Features 设置使研究人员能够控制先进的研究功能，支持音频和视频录制、实时转录、通过端到端加密确保数据处理的安全性，以及与AI、游戏手柄或流协议的集成。它们还支持多用户交互、视频会议以及通过 Webhooks 或 WebSockets 的外部服务器连接，提供灵活性、可靠性和增强的实验交互性。

特殊功能

音频录音
音频转录（基于AI）
端到端加密
游戏手柄集成
生成AI集成
实验室流层（LSL）
多用户研究
屏幕录制
视频会议
视频录制
Webhook API
Websocket 连接

音频录音

启用音频录音以捕捉参与者的口头响应或研究期间的环境声音。了解更多

路径： Settings 标签 → 顶部 Special Features 下拉菜单 → Audio Recordings 部分

如果有多个麦克风则允许选择

选中此框以允许参与者选择他们首选的麦克风设备进行音频录制。

路径： Settings 标签 → 顶部 Special Features 下拉菜单 → Audio Recordings 部分 → Allow Choosing Mic If Multiple

音频转录（基于AI）

此功能启用在研究期间自动转录收集的音频录音，使用AI算法（Whisper AI）。了解更多

路径： Settings 标签 → 顶部 Special Features 下拉菜单 → Audio Transcription (AI-based) 部分

转录模型

选择用于转录的模型。小模型速度更快但准确性较低，而大模型更准确但速度较慢。较大模型将导致实验启动时间更长，因为必须在参与者的设备上下载。可用选项：

Speed Optimized (tiny model)
Accuracy Optimized (large model)

路径： Settings 标签 → 顶部 Special Features 下拉菜单 → Audio Transcription (AI-based) 部分 → Transcription Model

端到端加密

此功能确保所有由参与者上传的二进制文件（例如，视频、音频）在传输前在其设备上进行加密，从而增强数据的安全性和隐私。

路径： Settings 标签 → 顶部 Special Features 下拉菜单 → End-to-End Encryption 部分

加密密钥

启用此选项时，单击 Set PGP Key 将提示您粘贴您的 PGP 公钥。

路径： Settings 标签 → 顶部 Special Features 下拉菜单 → End-to-End Encryption 部分 → Encryption Key

游戏手柄集成

此功能允许在研究中使用游戏手柄或操纵杆作为输入设备。了解更多

路径： Settings 标签 → 顶部 Special Features 下拉菜单 → Gamepad Integration 部分

生成AI集成

此功能允许在您的研究中使用大型语言模型（即chatGPT）和其他生成AI模型，以增强AI功能。了解更多

路径： Settings 标签 → 顶部 Special Features 下拉菜单 → Generative AI Integration 部分

API 密钥（用于 OpenAI）

插入您的 OpenAI API 密钥。这将安全存储在我们的服务器上。

路径： Settings 标签 → 顶部 Special Features 下拉菜单 → Generative AI Integration 部分 → API Key (for OpenAI)

密钥有效

如果上面提供的 API 密钥在粘贴后有效，这个状态指示器将从 NO 变为 YES。

路径: Settings 选项卡 → 顶部 Special Features 下拉菜单 → Generative AI Integration 部分 → Key is Valid

实验室流媒体层 (LSL)

此功能允许与实验室流媒体层（LSL）协议集成，以进行实时数据流传输。仅在桌面应用程序上支持。了解更多

路径: Settings 选项卡 → 顶部 Special Features 下拉菜单 → Lab Streaming Layer (LSL) 部分

输出流

Name: 为特定流指定名称
Type: 表明正在传输的数据类型，如“标记”或“注视”。
Channel Count: 指流中存在的通道数量或不同数据类型
Nominal Sample Rate (Hz): 标称采样率，单位为赫兹 [Hz]；如果速率不规则，请选择 0
Channel Format: 表明设备的通道格式或数据类型。可用选项包括：
- String
- Float32
- Double64
- Int32
- Int16
- Int8

路径: Settings 选项卡 → 顶部 Special Features 下拉菜单 → Lab Streaming Layer (LSL) 部分 → Output Stream

输入流

Prop: 属性名称
Value: 值

路径: Settings 选项卡 → 顶部 Special Features 下拉菜单 → Lab Streaming Layer (LSL) 部分 → Input Stream

多用户研究

多用户研究是一种在线实验，允许多个参与者之间的实时互动。了解更多

路径: Settings 选项卡 → 顶部 Special Features 下拉菜单 → Multi User Study 部分

如果启用，将显示以下选项：

参与者人数

在多用户研究中，您可以有任意数量的参与者。当参与者加入时，他们会被放置在候诊室，直到会话所需的参与者数量达到。

路径: Settings 选项卡 → 顶部 Special Features 下拉菜单 → Multi User Study 部分 → Number of Participants

最大并行会话

这指的是可以同时运行的最大实验会话数。此设置充当防护措施，以防止服务器过载。

路径: Settings 选项卡 → 顶部 Special Features 下拉菜单 → Multi User Study 部分 → Maximum Parallel Sessions

用户离开研究时的操作

这决定如果一个人离开研究，比如关闭浏览器窗口，剩余参与者会发生什么。以下选项可用：

Finish Study with Error
Finish Study Correctly
Custom / Redirect

路径: Settings 选项卡 → 顶部 Special Features 下拉菜单 → Multi User Study 部分 → Action on User Leaving Study

允许 WebSocket 重新连接

这决定参与者是否可以在临时断开或失去互联网连接后重新加入研究。

路径: Settings 选项卡 → 顶部 Special Features 下拉菜单 → Multi User Study 部分 → Allow WebSocket Reconnection

检查互联网连接

如果启用，在实验开始之前将执行连接和 ping 测试。仅允许通过此连接测试的参与者参与研究。

路径: Settings 选项卡 → 顶部 Special Features 下拉菜单 → Multi User Study 部分 → Check Internet Connection

如果启用，将出现以下两个设置：

‣ Maximum Allowed Ping

这定义了参与者的互联网连接可以有的最高可接受延迟（ping）（在 30 秒内的 10 次测量中）。

路径: Settings 选项卡 → 顶部 Special Features 下拉菜单 → Multi User Study 部分 → Check Internet Connection 已启用 → Maximum Allowed Ping

‣ Average Ping Allowed

这设置了参与者的互联网连接可以有的最大平均 ping（毫秒）（在 30 秒内的 10 次测量中）。

路径: Settings 选项卡 → 顶部 Special Features 下拉菜单 → Multi User Study 部分 → Check Internet Connection 已启用 → Average Ping Allowed

允许在候诊室邀请朋友

这使参与者能够在等待研究的候诊室时发送邀请链接（通过电子邮件）。

路径: Settings 选项卡 → 顶部 Special Features 下拉菜单 → Multi User Study 部分 → Allow Inviting Friends in Lobby

屏幕录制

此功能启用屏幕录制，以捕捉参与者在研究过程中在屏幕上的活动。了解更多

路径: Settings 选项卡 → 顶部 Special Features 下拉菜单 → Screen Recordings 部分

视频会议

此功能使您的研究中能够使用“Stream.IO”集成进行视频会议呼叫能力。了解更多

路径: Settings 选项卡 → 顶部 Special Features 下拉菜单 → Video Conferencing 部分

选择 API 密钥

指定应使用的 API 密钥以启用视频会议：

Use Labvanced API Key
Use Own API Key from StreamIO (see link above for instructions on how to set this up)

路径: Settings 选项卡 → 顶部 Special Features 下拉菜单 → Video Conferencing 部分 → Choose API Key

视频录制

此功能启用摄像头/视频录制，以捕捉参与者的脸和/或视觉环境。了解更多

路径: Settings 选项卡 → 顶部 Special Features 下拉菜单 → Video Recordings 部分

如果有多个，允许选择摄像头

允许参与者选择其首选的摄像头设备进行视频录制。

路径: Settings 选项卡 → 顶部 Special Features 下拉菜单 → Video Recordings 部分 → Allow Choosing Camera If Multiple

选择视频分辨率

选择视频录制的所需分辨率。更高的分辨率会导致文件大小更大。另外请注意，如果您启用了眼动追踪，选择高分辨率会对眼动追踪算法的性能产生负面影响。可用分辨率：

960 x 720 pixels
1280 x 720 pixels
1920 x 1080 pixels (Full HD)

路径: Settings 选项卡 → 顶部 Special Features 下拉菜单 → Video Recordings 部分 → Select Video Resolution

选择视频比特率

选择视频录制的所需比特率。更高的比特率会导致更好的质量，但文件大小更大。可用选项：

Default
High
Very High

路径: Settings 选项卡 → 顶部 Special Features 下拉菜单 → Video Recordings 部分 → Select Video Bitrate

尽可能使用 Mp4

如果浏览器支持，则视频将以 mp4 格式录制。否则，将以 webm 格式录制。

路径: Settings 选项卡 → 顶部 Special Features 下拉菜单 → Video Recordings 部分 → Use Mp4 When Possible

Webhook API

启用此选项以通过 Webhook API 将记录的研究数据发送到您选择的外部服务器。查看 API 文档

路径: Settings 选项卡 → 顶部 Special Features 下拉菜单 → Webhook API 部分

启用后，将出现以下选项：

IP 地址

接收记录数据的后端服务器的 IP 地址或 URL。

例如： https://www.my-university-data-center.com

路径: Settings 选项卡 → 顶部 Special Features 下拉菜单 → Webhook API 部分 → IP Address

端口

接收记录数据的后端服务器的端口。

例如：8082

路径: Settings 选项卡 → 顶部 Special Features 下拉菜单 → Webhook API 部分 → Port

URL 路径

接收实时记录数据的后端服务器的命名空间/URL 路径。

例如：/labvanced/my-username

路径: Settings 选项卡 → 顶部 Special Features 下拉菜单 → Webhook API 部分 → URL Path

Websocket 连接

启用与外部服务器或连接到同一计算机的其他录制设备的连接。了解更多

路径: Settings 选项卡 → 顶部 Special Features 下拉菜单 → Websocket Connection 部分

启用后，将出现以下选项：

WebSocket 地址

输入您服务器的 IP 地址以连接到外部服务器，或输入 'ws://localhost' 以连接到同一计算机上的录制设备。

路径: Settings 选项卡 → 顶部 Special Features 下拉菜单 → Websocket Connection 部分 → WebSocket Address

端口

输入您服务器的端口，默认为 8081。

路径: Settings 选项卡 → 顶部 Special Features 下拉菜单 → Websocket Connection 部分 → Port

目录

主要

控件

受试者

生理学

特殊功能