数据录制

录制五通道 H.265 视频，并读取微秒级对齐的时间戳元数据。

更新于 2026年10月12日约 2 分钟阅读

使用高层录制接口

record_video() 适合大多数采集任务。它会录制五通道网格视频，并生成与视频对齐的微秒级时间戳元数据。

from pathlib import Path
from imprintx import glove

output_dir = Path("./records")
output_dir.mkdir(parents=True, exist_ok=True)

ports = glove.list_ports()
if not ports:
    raise RuntimeError("未发现 ImprintX 设备")

glove.record_video(
    port=ports[0],
    output_path=str(output_dir / "grasp_session.mp4"),
    duration=10.0,
    fps=30.0,
)

读取时间戳

使用 load_video_timestamps() 读取录制产生的 JSON 元数据。请传入实际生成的时间戳文件路径：

timestamps = glove.load_video_timestamps("./records/grasp_session.json")
print(timestamps[0])

使用底层录制控制

如果采集开始和停止需要由业务事件控制，可以直接使用 TouchGlove 的录制方法：

import time
from imprintx.glove import TouchGlove, list_ports

with TouchGlove(port=list_ports()[0]) as device:
    device.start()
    device.start_recording("./records/manual_session.mp4")
    try:
        time.sleep(10)
    finally:
        device.stop_recording()

使用 try/finally 可以确保业务逻辑抛出异常时仍会结束录制并释放文件。

采集检查清单

采集前确认输出目录可写，并预留足够磁盘空间
先录制短样本，检查五个通道的画面与基线是否正常
长时间采集时记录设备序列号、任务名称和采集条件
使用时间戳元数据对齐机器人状态、相机或其他外部传感器