跳转到内容
文档导航数据录制
开发者中心使用指南

数据录制

保存五通道快照、录制 H.265 视频,并读取微秒级时间戳元数据。

更新于 2026年11月3日约 2 分钟阅读

保存触觉快照

save_image() 保存各通道图片与组合网格图。默认前缀为 tactile,通道文件名使用 *_ch0.png 至 *_ch4.png,组合图使用 *_grid.png。

Python
from imprintx import glove

glove.save_image(output_dir="./snapshots")

快照参数

参数默认值 / 用途
portNone;设备端口
output_dir".";输出目录
prefix"tactile";文件名前缀
save_gridTrue;同时保存组合网格图

录制视频

record_video() 录制五通道 H.265 网格视频,同时导出微秒级对齐时间戳 JSON 元数据。默认采样视频帧率为 30.0,时长为 5.0 秒。

Python
from imprintx import glove

glove.record_video(
    output_path="recording.mp4",
    duration=5.0,
    fps=30.0,
)

读取时间戳

load_video_timestamps(path) 读取录像产生的 JSON 时间戳元数据。将路径替换为实际生成的元数据文件。

Python
from imprintx import glove

timestamps = glove.load_video_timestamps("path/to/metadata.json")
print(timestamps)

底层录制控制

在自定义采集流程中,可使用 TouchGlove.start_recording(output_path) 和 stop_recording() 控制录像。设备连接与流状态的要求以 SDK 当前版本为准。