设置选项卡

本 documentation 提供了 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 团队和其他选择与研究社区分享其工作的研究人员的研究集合。

路径: 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 mm）校准其屏幕尺寸。此校准可用于确保视觉刺激以正确的毫米或视觉度数显示，对于需要精确视觉测量的实验至关重要。

路径： 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

浏览器

允许通过网页浏览器参与可实现在线/远程参与。可以启用或禁用各个浏览器。

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 Labvanced中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 或 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 部分

虚拟下巴托

此设置控制虚拟下巴托何时处于活动/检查状态。

‣ 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、游戏手柄或流媒体协议的集成。它们还支持多用户互动、视频会议和通过Webhook或WebSocket的外部服务器连接，提供灵活性、可靠性和增强的实验交互性。

特殊功能

音频录制
音频转录（基于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

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

目录

主设置

控制

参与者

生理学

特殊功能