检索视频
通过每秒抽帧（可在 0.1 ~ 30 秒之间调整）为 MP4、MOV、AVI、MKV、M4V、WebM、TS 建立索引，把命中结果读成合并后的时间区间，并让预览跳到找到该人物的采样秒。
SnapByFace 把视频看成一串静止画面。它抽帧，跑与图片完全相同的检测与 512 维特征提取，然后报出某人出现的时间戳。
支持的格式
MP4、MOV、AVI、MKV、M4V、WebM、TS。 视频目录与图片目录一样递归扫描。
抽帧间隔
SnapByFace 默认每 1 秒 抽取一帧。间隔可在 0.1 到 30 秒 之间配置。
| 间隔 | 每小时视频的帧数 | 适用场景 |
|---|---|---|
| 0.5 秒 | 约 7,200 | 短片段、剪辑快、人物只出现一瞬 |
| 1 秒（默认） | 约 3,600 | 一般使用 |
| 5 秒 | 约 720 | 长时间录制、镜头变化慢、大归档的第一遍粗扫 |
| 30 秒 | 约 120 | 超长素材的快速筛查 |
:::caution 抽帧间隔是在视频被分析的那一刻确定的。改间隔就必须重新分析相关视频。改相似度阈值不会重新分析视频 —— 它只是拿已经存在的特征重新匹配。 :::
视频结果怎么呈现
单帧命中会被合并成时间区间，所以你看到的是「这个人从 00:12 到 00:48 一直在画面里」，而不是几十条零散记录。
- 每个区间会显示开始与结束时间。
- 双击某个区间可以在预览里直接定位到那个时刻，再前后拖动确认。
- 同一个视频可能在同一人物下出现多次，每个独立区间一次。
:::note 区间是由抽帧结果拼出来的，所以边界是近似的 —— 精度大约在一个抽帧间隔左右。 :::
提升视频结果的技巧
- 人物只短暂出现时用 0.5–1 秒间隔。
- 长时间静止拍摄（课程、会议、固定机位）用 2–5 秒就够了。
- 画面太暗、运动模糊严重，或人脸小于约 60 像素时，提取不到可靠的特征。
- 视频分析主要吃 CPU；按分辨率与间隔不同，大致在实时到慢于实时数倍之间。
处理超长素材
- 先用 5 秒间隔对整个归档跑第一遍，找出值得关注的文件。
- 只把这些文件加进第二轮，间隔收紧到 0.5–1 秒。
- 用暂停/继续让它在后台跑完 —— 参见 大素材库。
导出
导出命中的素材时，视频命中会复制完整的原视频文件。每条命中的时间区间仍可在结果视图里看到，双击即可预览到具体那一秒。
试用限制
未激活时结果上限为每位人物 5 条、每次搜索 20 条，且累计最多发起 100 次分析。激活即解锁已经找到的匹配。参见 软件激活。