Varjo凝视数据介绍

WangYu

VarjoBase 2.3 引入了记录注视数据的新功能。现在，您可以将用户看到的内容与眼动追踪数据一起记录下来。眼动追踪数据将以 .csv 文件的形式记录，之后可以在视频记录的顶部进行可视化或单独分析。

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

                               
登录/注册后可看大图

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

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

                               
登录/注册后可看大图

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

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

• 通用注视数据，也可从 Varjo API 获得。这些在开发人员文档和下面进行了描述。
• 视频采集相关数据：
  

• 投影 XY 坐标，可用于将注视坐标直接映射到视频像素坐标。
• 相对于视频开始的时间戳。
  

通用注视数据

原始时间戳

以纳秒为单位记录数据的时间戳。

焦点距离

眼睛与焦点之间的距离。它是一个介于 0 到 2 米之间的值。

帧数

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

稳定

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

地位

表示 Varjo 耳机中眼动追踪状态的值，其中：
0 – 数据不可用，用户未佩戴设备或找不到眼睛
1 – 用户佩戴设备，但正在校准注视追踪
2 – 数据已验证

凝视
_
转发
_x
凝视
_转发_y凝视_转发_z凝视_原点_x凝视_原点_y凝视_原点_z

数据包含有关眼睛位置坐标原点 (x, y, z) 和矢量前进方向 (x, y, z) 的信息。记录左眼 (leftEye)、右眼 (rightEye) 和组合值 (gaze) 的 varjo_ray 信息。关于注视的信息显示在左手坐标系中，并且与头部姿势有关。

left_forward_x
left_forward_y
left_forward_z
left_origin_x
left_origin_y
left_origin_z

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

left_pupil_size

根据 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

根据 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]。

King

数据不可用，用户未佩戴设备或找不到眼睛

King

除了视频文件具有 .avi 扩展名且注视数据具有 .csv 扩展名之外，这两个文件将具有相同的名称。