设置选项卡

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

默认字体大小（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 下拉菜单 → 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

浏览器

通过网络浏览器允许参与在线/远程参与。可以启用或禁用单个浏览器。

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标签。

纵向设计

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

路径： 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 标签中包含所有生理信号检测的基本设置，包括应为研究使用哪个工具箱版本，以及如果有多个相机设备，参与者是否可以选择他们的首选设备。

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

生成式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

目录

主

控制

受试者

生理学

特殊功能