元数据.json

meta.json 是帧模式下每组帧附带的元数据文件。

它的功能是告诉系统如何正确播放序列：实际FPS、帧数、持续时间和音频参考。

文件夹结构

deathvideo/
  videos/   # 源文件 .mp4 / .webm
  frames/   # 在 frames 模式下生成的集合
  cache/    # 直接视频模式使用的缓存

导出帧时生成的文件

在 deathvideo/frames/ 中的每个集合中都会生成以下内容：

-frame_%06d.png -audio.wav（可选） -meta.json

最终大纲

领域	类型	描述
fps_real	number（浮动）	检测到真实的 FPS 进行播放。
total_frames	integer	导出的帧总数。
duration_ms	integer	总持续时间（以毫秒为单位）。
audio_path	string | null	现场音频路径；如果没有音频，请使用null。
created_at	string (ISO-8601)	创建时间戳。

完整示例

{
  "fps_real": 29.97,
  "total_frames": 892,
  "duration_ms": 29763,
  "audio_path": "audio.wav",
  "created_at": "2026-03-02T18:35:11Z"
}

命名约定

• 方框使用frame_%06d.png，例如：frame_000001.png。
• 如果有音频，audio_path 指向同一组文件（通常是audio.wav）。
• 如果没有音频，则使用audio_path: null 来维持上面定义的约定。