处理变量

变量是任何 Labvanced 实验的基石。它们是运行时存储数据的容器：参与者响应、反应时间、刺激条件、准确性评分以及您研究逻辑所依赖的任何计算值。没有变量，实验无法记录，无法适应，也无法做出决策。每个读取值或写入结果的事件操作都在对一个变量进行操作。

理解变量是将静态实验转变为完全动态、分支研究的关键。当变量的值发生变化时，它可以触发一个事件。事件可以更新一个变量。变量值可以控制显示哪个图像，选择哪个任务分支，或者参与者是否向前移动或被重定向。变量与事件之间的相互作用赋予了 Labvanced 实验灵活性。

本节内容

变量简介

变量是什么，它们存储什么数据，以及每个实验为什么依赖它们。如果您是变量系统的新手，请从这里开始。

创建变量

创建变量的四种方法：从变量选项卡、任务编辑器面板、对象提示或事件系统。涵盖命名约定及每种方法何时最有用。

变量类型

Labvanced 中六种类型的变量：系统变量、因素变量、对象变量、自定义变量、数组和数据框。每种类型存储什么以及何时使用。

变量属性

每个设置的完整参考：数据类型、量表、格式、起始值、重置行为和记录选项。使用此页面正确配置您的研究设计的变量。

时间序列变量

如何记录连续的测量，如鼠标位置、注视或生理信号。涵盖记录类型、采样方法，以及导出数据的样子。

数据框变量

如何将 CSV 作为数据框上传，映射文件刺激，并使用事件系统逐行读取试验。刺激列表和对照平衡的标准工具。

系统变量

什么是系统变量：自动创建、只读，并跟踪实验级别的信息，如试验编号和 Role_Id。

Role_Id

在多用户研究中识别每个参与者的系统变量，而无需收集任何个人信息。

在构建之前

变量是全球性的。一个任务中创建的变量在整个研究的每个任务和事件系统中都是可见和可访问的。变量名称必须是唯一的：两个变量不能共享同一个名称。

在构建您的第一个任务之前，规划出您需要的变量。问自己：我需要收集什么数据？实验需要做出什么决策？在试验或任务中需要跟踪哪些值？有清晰计划地创建变量比在构建过程中添加它们并围绕它们重新构建事件逻辑要容易得多。

记录内容

系统变量、因素变量和对象变量是自动记录的。自定义变量需要两个额外步骤：在变量属性中启用 Record Variable，并在事件系统中添加 Set / Record Variable 操作，以在正确的时刻写入值。

对于反应时间、鼠标跟踪或生理信号等时间敏感的测量，请参见 时间序列变量，了解控制如何捕获连续数据的额外 Record Type 和 Sampling Method 设置。