
任务向导 | 快速实验构建手册
概述
如果你喜欢使用电子表格 / CSV 数据来设置你的实验任务,任务向导可以帮助你加快实验任务创建过程!
使用任务向导,你可以创建整个实验任务结构,包括刺激、事件、变量、因子、条件、随机化和数据记录,所有这些都来自一个 CSV 文件及其刺激文件。借助任务向导,你还可以选择刺激配对、框架转场,并在短短几分钟内构建一个带有内置随机化和数据记录的自定义任务结构。
工作流程提示: 在继续使用向导之前,查看以下内容可能对你有帮助,以便了解如何组织 / 命名你的刺激并提前准备你的 CSV 文件。如有任何问题,请随时与我们联系!
访问任务向导
根据你在任务创建过程中的位置,有稍微不同的路径可以访问任务向导。
| 研究状态 | 访问任务向导的路径 |
|---|---|
| 新研究 | 创建新研究 → 设置任务 → 继续上传刺激 |
| 现有研究 | 打开现有研究,在 研究设计 标签下点击 + 新任务 选择 实验任务 → 继续上传刺激 |
进度条
访问实验任务向导后,会出现一个对话框,顶部显示准备任务的步骤和阶段:

有关任务向导功能的一般介绍,请观看此视频:
在任务向导中的刺激上传
在此初步步骤中,你将上传实际的刺激文件。
- 上传所有刺激: 点击此处上传所有实验刺激(如果你有图像、视频等)。如果你有文本刺激,只需点击“下一步”并继续上传你的 CSV 文件。你稍后将指定刺激分配的工作方式(将在接下来的部分中描述)。请注意:
- 所有文件扩展名在每个刺激类别中必须统一! 例如,你不能在不同列中切换 .jpg 或 .jpeg(请参见下面的图像示例)
- 根据文件上传的工作方式,所有任务特定的刺激必须位于一个文件夹内。
- 点击“确定”后,你可以立即继续上传你的 CSV。
- 下一步(我已上传所有刺激): 继续任务向导的下一阶段。
📌 实践学习: 如果你想下载示例数据以开始尝试任务向导,请使用以下链接下载我们提供的工作材料:
https://www.labvanced.com/static/taskWizardExamples.zip
在任务向导中的 CSV 上传
在上传刺激后,接下来是上传 CSV 文件。在即将到来的部分中,我们将更详细地解释如何设置 CSV。
从 CSV 到任务设置
CSV 在任务创建过程中的基本使用理念:
- 行: CSV 文件中的每一行将创建一个实验任务试次。如下图所示,默认情况下该过程将生成 8 个试次——当然,你可以稍后编辑以根据实验设计的需要更改试次数量。
- 列: 第一行可用作列标题来命名刺激。每一列必须是一个单独的刺激元素(图像、视频等)或数据类别(将在下一部分中描述)。请注意,每列的长度必须相同(即所有单元格均填满)。

我们将在接下来的部分中更详细地解释上面的图像。
准备你的 CSV 文件
现在我们来讨论你应该 / 可以放入 CSV 文件的信息类型。
CSV 文件可以包含 3 种不同类别的数据,即刺激、因子和附加信息:
| 数据类别 | 规格 / 描述 | 示例 |
|---|---|---|
| 刺激 | 刺激可以是文件名(图像、视频或音频),也可以是纯文本字符串。 请注意:对于 CSV 文件中的所有刺激,将自动创建相应的对象。然后,在任务向导的稍后部分,即 框架与刺激排列 步骤中,你将有机会根据希望在参与者面前显示的框架来排列它们。确保使用带有正确后缀的文件名,例如 “flower.jpg” | 上面的 A 列 代表视频刺激标题; B-C 列 代表图像刺激标题;而 D 列 代表基于文本的刺激。 |
| 因子 | 因子就像你刺激的类别标签,必须包含与同一行刺激相关的水平 / 值。 例如,若因子名为“失真”,可能有两个可能值“失真”或“正常”,因此每行中的图像刺激应包含这两个因子值之一; 例如,失真的图像刺激那一行将有“失真”类别,而正常或对照图像的类别将有“正常”。 **注意:**您可以有多个列用于分配不同因子,以便最后每行可以包含多个因子的值。例如,您可以添加第二个因子“性别”,其中图像刺激“alice.jpg”的值为“女性”。因此,这将建立此试次的分类为“失真 x 女性”。这些组合因子在后面称为条件。 | 上面的 F-G 列 |
| 附加信息 | 此类数据可以用作你希望记录每个试次的附加(刺激)描述,但本身既不是刺激,又不是因子 / 条件信息。 例如,你可能想编码两个刺激中哪个是“正确”的,以便计算受试者给出的答案是否正确。所有刺激信息将自动记录。 | 上面的 E 列 |
上传 CSV 文件
创建 CSV 后,你可以继续上传它。将出现以下包含选项的对话框:

- 将字符串映射到文件: 允许你将文件名作为字符串包含,然后使用映射功能指向存储文件的文件夹。这样,该列的文件名将寻找与数据框中的值完全匹配的文件。此功能仅在列由字符串值填充时可用。
- 使用第一行作为标题: 将数据框中第一行的值用作每一列的变量名。
- 转置数据: 仅简单地上传数据框。 如果你的数据框中不包含任何文件名,则此项非常有用。
在任务向导中的刺激和因子选择
CSV 文件的预览将出现。如果需要,你也可以在此处重新上传 CSV 文件。
在此步骤中,你可以编辑顶部字段,正如下图所示:
名称: 如果每列的第一个单元格是列名,则可以在此处编辑。在下面的示例中,第一列的标题为“方向”,第二列的标题为“度数”,依此类推……数据类型: 数据类型会根据 CSV 中的值自动选择和识别。 单击“书本”图标可以重新分配你的刺激,而“垃圾箱”图标将删除整列,操作时要小心!用作: 此字段需要在此过程中最关注。你必须指明数据属于哪种类别,如上面所讨论(即刺激、因子或附加信息)。根据下面的图像:- 第 1 列将用于“因子”,因为在此实验设计中,我们旨在评估单词分类类型(即 Bouba 或 Kiki)是否被正确识别。
- 第 2 列是图像文件的名称
- 第 3 列是将出现的文本字符串
- 第 4 列也是将出现的第二文本字符串
要继续,你必须为所有 用作 字段分配值。

完成后,将出现一个绿色的“下一步”按钮,允许你进入下一阶段。
在任务向导中的刺激配对
用于随机化的配对
在你的 CSV 文件中配对的列在随机化过程中会一起被打乱(它们的行关系将保持不变),而在不同的配对组中的列则在每个参与者中独立打乱。换句话说,通过配对刺激,它们在随机化过程中保持在一起。注意,因子始终在第一配对组中,但刺激和信息列可以放在任何位置。必须至少有一个配对组,每个组必须至少有一个条目。

在任务向导中的框架和刺激排列
在框架上放置刺激
现在是时候排列你的刺激,并决定每个试次有多少框架,以及哪个刺激应该放在哪个框架上。将记录的数据类型和转场将在接下来的部分中讨论。

任务向导将自动在你 CSV 文件中排列的顺序中为每个框架放置一种刺激类型(列)。上面的图像是展示 两个部分之前的 CSV 文件 的输出。相同框架上的刺激默认同时显示(你可以使用 事件 更改此设置)。不同框架上的刺激总是按试次时间线连续显示。当然,所有这些都是可以编辑的,以满足你的实验需求。
在此步骤中,任务向导允许你创建新框架,删除空框架,以及在框架之间拖放刺激(例如,如果你希望文本和图像刺激一起在屏幕上显示)。你还可以在没有任何刺激的框架中添加静态文本内容和注视十字。 在任务构建完成基础设置流程后,更多关于框架和刺激的详细编辑选项将在任务编辑器中提供。框架分支逻辑,即你希望实验在试次中的一个框架与下一个框架之间如何进展,也可以在编辑器中稍后调整。例如,如果答案是“正确的”,并且你希望显示“正确”的反馈框架,这可以在任务编辑器中微调。
📌实践示例:重新排列刺激并添加注视十字: 在下面的短视频中,我们拖放刺激,使所有三个刺激一起显示在一个框架中。我们删除未使用的框架,并创建一个将在每个试次之前的注视十字。
在任务向导中的转场
排列完框架后,是时候指定框架的转场和将要进行的记录。你可以选择是否要为所有或特定的框架激活眼动追踪或鼠标追踪。
在下面的图像中,frame_1 将持续 固定时间,我们指定为 1000 毫秒。然后,frame_2 将在单击任何刺激后结束。注意:对于本研究,我们实际上不希望当他们单击 图像 对象时结束框架,但可以在稍后的任务编辑器中通过选择图像对象并将其 对象属性 下的 激活 选项设置为 False 来禁用该功能。
任务向导自动设置为记录被单击的对象并将该数据存储在变量中。

关于随机化的额外说明
关于随机化,请注意以下信息:
- 默认情况下,试次顺序将完全随机化。
- 可以在
随机化设置对话框中设置更自定义的试次顺序(例如固定顺序、分块条件、阶梯等)。 - 还可以通过添加随机化来进一步平衡(例如,刺激的左右平衡)(请参见下图)。
- 通过
研究设计标签,可以使用组或随机化分隔符进行组间平衡。 - 你可以在这里 阅读更多关于随机化技术的信息。
- 你还可以观看关于Labvanced的随机化的深入视频。

对于大多数研究,随机化可以是简单明了的。然而,如果你需要帮助或者对高级设计的随机化/平衡有疑问,请随时通过电子邮件或聊天支持与我们联系!