Varjo 凝视数据记录

WangYu

在 Varjo Base 中，有一个记录凝视数据的功能。您可以将用户看到的内容与眼动追踪数据一起记录下来。眼动追踪数据将以.csv文件的形式记录下来，以后可以在视频录制的基础上可视化或单独分析。

要记录眼动追踪数据，首先需要运行眼动校准，否则该选项将不可用。

                               
登录/注册后可看大图

打开“分析”窗口，然后单击底部工具栏上的“眼动追踪”按钮。现在您将在左侧看到眼动追踪菜单。如果您尚未校准眼动追踪，菜单将处于非活动状态。请注意，每次摘下耳机时，您都需要再次重新校准。

校准眼动追踪后，菜单将变为活动状态，您有两个选项。第一个选项允许您在镜子中可视化眼动追踪点（它在耳机内部是不可见的）。它可用于实时检查用户正在查看的位置。第二个选项将记录眼动追踪数据，这些数据可以在以后用于分析或可视化。当记录选项设置为开时，您可以按底部的屏幕录制按钮来录制视频和眼动追踪数据。请注意，“屏幕录制”按钮图标的角落里会有一个眼睛图标，表示将记录眼睛数据。

                               
登录/注册后可看大图

完成录制后，您可以在 Videos/Varjo 文件夹中找到视频文件和眼动追踪日志文件。这两个文件具有相同的名称，但视频文件的扩展名为.avi，而凝视数据的扩展名为.csv。

凝视数据格式
CSV 每个样本包含以下数据：

通用凝视数据，也可从 Varjo API 获得。这些在开发人员文档和下面的文档中进行了描述。
视频采集相关数据：
投影 X-Y 坐标，可用于直接将视线坐标映射到视频像素坐标。
相对于视频开始的时间戳。

通用凝视数据
raw_timestamp

记录数据的时间戳（以纳秒为单位）。它是相对于 Varjo 系统时间纪元的。
relative_to_unix_epoch_timestamp

将数据记录为 Unix 时间（以纳秒为单位）的时间戳。它的值取决于操作系统的时钟时间调整，但是，它不依赖于夏令时和时区设置。
focus_distance

眼睛和焦点之间的距离。它是介于 0 到 2 米之间的值。
frame_number

记录数据时帧的唯一标识符。
稳定性

介于 0.0 和 1.0 之间的值，指定用户焦点的稳定性。0.0 表示不稳定，1.0 表示稳定。
地位

表示 Varjo 耳机中眼动追踪状态的值，其中：
0 – 数据不可用、用户未佩戴设备或找不到
眼睛 1 – 用户正在佩戴设备，但正在校准视线跟踪
2 – 数据有效
从 Varjo Base 3.7 开始，状态为 0 的行包含在 CSV 中， 因为眼睛的测量数据还是可以使用的。
gaze_forward_x
gaze_forward_y

gaze_forward_z gaze_origin_x
gaze_origin_y
gaze_origin_z

数据包含有关眼球位置坐标原点 （x， y， z） 和矢量向前方向 （x， y， z） 的信息。有关注视的信息以左侧坐标系显示，并且相对于头部姿势。数据的有效性由状态字段给出。
left_forward_x
left_forward_y
left_forward_z
left_origin_x
left_origin_y
left_origin_z

有关矢量和位置的信息与上述相同，但仅适用于左眼。
left_pupil_size

已弃用。对于新开发项目，请使用left_pupil_diameter_in_mm。
根据 Varjo 耳机检测到的瞳孔大小范围计算出的 0 到 1 之间的瞳孔大小值。
left_status

左眼的值，其中：
0 – 未跟踪眼睛且不可见（例如，眼睛闭合）
1 – 眼睛可见但未可靠跟踪（例如扫视或眨眼）
2 – 眼睛被跟踪但质量受损（例如，耳机在校准后移动）
3 – 眼睛被跟踪
right_forward_x
right_forward_y
right_forward_z
right_origin_x
right_origin_y
right_origin_z

有关矢量和位置的信息与上述相同，但仅适用于右眼。
right_pupil_size

已弃用。对于新开发项目，请使用right_pupil_diameter_in_mm。
根据 Varjo 耳机检测到的瞳孔大小范围计算出的 0 到 1 之间的瞳孔大小值。
right_status

右眼的值，其中：
0 – 未跟踪眼睛且不可见（例如，眼睛闭上）
1 – 眼睛可见但未可靠跟踪（例如扫视或眨眼）
2 – 眼睛被跟踪但质量受损（例如，耳机在校准后移动）
3 – 眼睛被跟踪
视频采集相关数据
relative_to_video_first_frame_timestamp

相对于视频开始的时间戳。
left_projected_x
left_projected_y

左眼注视矢量投影在显示左眼图像的视频上。归一化坐标 [-1， 1]。
gaze_projected_to_left_view_x
gaze_projected_to_left_view_y

组合（左+右）眼睛注视矢量投影在显示左眼图像的视频上。归一化坐标 [-1， 1]。

right_projected_x right_projected_y

右眼注视矢量投影在显示右眼图像的视频上。归一化坐标 [-1， 1]。
gaze_projected_to_right_view_x
gaze_projected_to_right_view_y

组合（左+右）眼睛注视矢量投影在显示右眼图像的视频上。归一化坐标 [-1， 1]。
眼部测量数据
inter_pupillary_distance_in_mm

以毫米为单位的瞳孔中心之间距离的估计值。

left_iris_diameter_in_mm right_iris_diameter_in_mm

以毫米为单位的虹膜直径估计值。
left_pupil_diameter_in_mm
right_pupil_diameter_in_mm

以毫米为单位的瞳孔直径估计值。
left_pupil_iris_diameter_ratio
right_pupil_iris_diameter_ratio

瞳孔直径与虹膜直径之比（即 left_pupil_diameter_in_mm / left_iris_diameter_in_mm）。在范围 [0..1] 内。
left_eye_openness
right_eye_openness

估计眼睛睁开率。值 1.0 对应于完全睁开的眼睛，0.0 对应于完全闭合的眼睛。