设置选项卡

本文件提供了 Labvanced 中可用的研究级设置和功能的综合概述。它解释了如何配置核心研究信息、参与者控制、设备和软件要求、受试者管理、生理测量以及可选的高级功能，帮助研究人员从头到尾有效地设置、定制和管理实验。

主要

设置选项卡中的 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 部分提供了一种通过为新创建的元素设置基线首选项来标准化研究的视觉和结构方面的方法。它允许研究人员定义默认字体大小、按钮颜色和按钮悬停颜色，以确保文本和交互元素的一致性，并指定默认框架大小和方向以控制内容的显示方式。这些默认值简化了研究设计，确保统一的外观和感觉，并减少在创建新元素时需要重复手动调整的需求。

默认字体大小（Px）

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

路径: 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 下拉 → 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

浏览器

允许通过网页浏览器参与，使在线/远程参与成为可能。可以启用或禁用单独的浏览器。

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组必须包含多个会话。

路径： 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”变量，或者在任务中使用受试者间因素，将进一步改善受试者平衡。了解更多。

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

生理学

Physiology设置提供了对生理数据采集的控制，涉及设备、工具箱版本、眼动追踪的初始化和校准选项，以及激活头部追踪、心率和情感检测。

生理学

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

常见设置

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、游戏控制器或流媒体协议的集成。它们还支持多用户互动、视频会议和通过 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 部分

生成性人工智能集成

此功能允许在您的研究中使用大型语言模型（即 chatGPT）和其他生成性人工智能模型，以实现高级人工智能功能。了解更多.

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

目录

主要

控制

受试者

生理学

特殊功能