如何为Picamera帧计算与系统时钟同步的毫秒级精确时间戳？

我之前也碰到过这个精确时间戳对齐的问题，确实官方文档没把细节说透，不过咱们可以通过以下两种方式来解决：

针对clock_mode="raw"的方案 #

raw模式下的时间戳是相对于相机初始化时刻的，那我们只需要在相机初始化的同时，高精度记录下系统时钟的时间点，就能把相机的相对时间戳转换成系统时间：

• 初始化相机后，立刻用高精度的计时函数记录系统时间，比如Python的time.time_ns()（提供纳秒级精度）或者带时区的datetime.datetime.now(datetime.timezone.utc)：

  import picamera
  import time
  from datetime import datetime, timezone
  
  camera = picamera.PiCamera()
  # 记录相机初始化时的系统时间（纳秒级）
  camera_init_system_time_ns = time.time_ns()
  # 或者用UTC datetime
  camera_init_system_dt = datetime.now(timezone.utc)
  

• 之后获取到的raw时间戳（单位通常是微秒，需要转成纳秒或者统一单位），直接和初始化时的系统时间相加，就能得到该帧对应的系统时钟时间戳：

  # 假设从帧中拿到的raw时间戳是raw_ts（微秒）
  raw_ts_ns = raw_ts * 1000
  frame_system_time_ns = camera_init_system_time_ns + raw_ts_ns
  # 转成datetime
  frame_system_dt = camera_init_system_dt + datetime.timedelta(microseconds=raw_ts)
  

这个方案的误差极小，因为相机初始化和系统时间记录的间隔几乎可以忽略（远小于毫秒级）。

针对clock_mode="reset"的方案 #

reset模式的时间戳是从录制开始算起的，但start_recording()调用和实际开始捕获帧之间确实有延迟，不能直接用调用时的系统时间。这里的关键是捕获第一帧的系统时间，以此作为基准：

• 定义一个回调函数，当第一帧被处理时，同时记录该帧的reset时间戳和当前系统时间。之后所有帧的时间戳都基于这个基准计算：

  import picamera
  import time
  from datetime import datetime, timezone
  
  first_frame_info = None
  
  def frame_callback(frame):
      global first_frame_info
      if first_frame_info is None:
          # 记录第一帧的reset时间戳和系统时间
          reset_ts = frame.timestamp
          system_time_ns = time.time_ns()
          first_frame_info = (reset_ts, system_time_ns)
          print(f"第一帧基准：reset时间戳 {reset_ts}μs，系统时间 {system_time_ns}ns")
      else:
          # 计算当前帧的系统时间
          reset_ts = frame.timestamp
          delta_ns = (reset_ts - first_frame_info[0]) * 1000
          frame_system_time_ns = first_frame_info[1] + delta_ns
          # 转成datetime
          frame_system_dt = datetime.fromtimestamp(frame_system_time_ns / 1e9, timezone.utc)
          print(f"当前帧系统时间：{frame_system_dt}")
  
  with picamera.PiCamera() as camera:
      camera.clock_mode = 'reset'
      # 启动录制并绑定回调
      camera.start_recording('/dev/null', format='h264', frame_callback=frame_callback)
      camera.wait_recording(10)  # 录制10秒
      camera.stop_recording()
  

• 这个方案利用第一帧的实际捕获时刻作为基准，完全避开了start_recording()调用的延迟问题，精度能达到毫秒级甚至更高。

额外注意事项 #

• 尽量用time.time_ns()或带时区的datetime来记录系统时间，避免用低精度的time.time()（只能到秒级或毫秒级，不同系统精度不同）。
• 如果需要跨设备同步时间，建议用UTC时间戳，避免时区转换带来的误差。
• 可以通过录制一段已知间隔的测试视频（比如用LED频闪），验证计算出的时间戳和实际时间的误差，确保精度符合需求。

内容的提问来源于stack exchange，提问作者Keith