Varjo 凝视数据记录
在 Varjo Base 中,有一个记录凝视数据的功能。您可以将用户看到的内容与眼动追踪数据一起记录下来。眼动追踪数据将以.csv文件的形式记录下来,以后可以在视频录制的基础上可视化或单独分析。要记录眼动追踪数据,首先需要运行眼动校准,否则该选项将不可用。
https://developer.varjo.com/assets/uploads/without1.png打开“分析”窗口,然后单击底部工具栏上的“眼动追踪”按钮。现在您将在左侧看到眼动追踪菜单。如果您尚未校准眼动追踪,菜单将处于非活动状态。请注意,每次摘下耳机时,您都需要再次重新校准。
校准眼动追踪后,菜单将变为活动状态,您有两个选项。第一个选项允许您在镜子中可视化眼动追踪点(它在耳机内部是不可见的)。它可用于实时检查用户正在查看的位置。第二个选项将记录眼动追踪数据,这些数据可以在以后用于分析或可视化。当记录选项设置为开时,您可以按底部的屏幕录制按钮来录制视频和眼动追踪数据。请注意,“屏幕录制”按钮图标的角落里会有一个眼睛图标,表示将记录眼睛数据。
https://developer.varjo.com/assets/uploads/VarjoBase-AnalyticsWindow-Gaze%20Recording.png完成录制后,您可以在 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)。在范围 内。
left_eye_openness
right_eye_openness
估计眼睛睁开率。值 1.0 对应于完全睁开的眼睛,0.0 对应于完全闭合的眼睛。
页:
[1]