使用变量

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

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

本节内容

变量简介

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

创建变量

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

变量类型

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

变量属性

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

时间序列变量

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

数据框变量

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

系统变量

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

Role_Id

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

在你构建之前

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

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

记录什么

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

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