对 视频文件 与 摄像头 进行 打开、查询属性、按帧/时间读取、跳转、导出帧、简单编辑（剪切/转码/缩放） 及 场景/运动/亮度 等分析。读出的帧多为 OLAImage 或文件，可再交给 图像处理、图像识别。
选型：磁盘上的 mp4/avi 等 → OpenVideo；实时采集 → OpenCamera / OpenCameraByName。
| 接口 | 内容 |
|---|
GetVideoInfo | 综合信息（以详情页字段为准）。 |
GetVideoWidth、GetVideoHeight | 像素尺寸。 |
GetVideoFPS | 帧率。 |
GetVideoTotalFrames、GetVideoDuration | 总帧数、时长。 |
差异：部分格式 可变帧率 或 元数据缺失 时，返回值可能与实际逐帧遍历略有出入，以详情页说明为准。
| 接口 | 差异 |
|---|
ReadNextFrame | 顺序 下一帧，适合顺序扫描。 |
ReadFrameAtIndex、ReadFrameAtTime | 随机访问：按 帧号 或 时间戳。 |
ReadCurrentFrame | 当前位置一帧（配合 Seek 后使用）。 |
SeekToFrame、SeekToTime、SeekToBeginning、SeekToEnd | 定位；部分容器 关键帧对齐，非逐帧精确见详情页。 |
GetCurrentFrameIndex、GetCurrentTimestamp | 查询当前读指针位置。 |
选型：顺序抽帧 → ReadNextFrame；要做 剪辑点检测 → SeekToTime + 读帧对比。
| 接口 | 差异 |
|---|
ExtractFramesToFiles、ExtractFramesByInterval | 批量落盘，按列表或 时间间隔。 |
ExtractKeyFrames | 关键帧 提取，体积小于逐帧。 |
SaveCurrentFrame、SaveFrameAtIndex | 单帧保存。 |
ExtractSingleFrame、ExtractThumbnail、GetVideoInfoFromPath | 免完全打开 的快速信息/首帧（以详情页能力为准）。 |
| 接口 | 说明 |
|---|
ConvertVideo、ResizeVideo、TrimVideo | 转码、分辨率、剪切时间片段。 |
CreateVideoFromImages | 由 图片序列 生成视频。 |
| 接口 | 用途 |
|---|
CalculateFrameSimilarity | 两帧相似度。 |
DetectSceneChanges | 场景切换点。 |
DetectMotion | 运动区域/强度（见详情页）。 |
CalculateAverageBrightness | 平均亮度。 |
IsValidVideoFile | 文件是否可读。 |
与 图像识别 区别：本分类偏 视频时间轴；Match*/Find* 偏 单帧内找模板。
| 需求 | 建议 |
|---|
| 抽第 N 秒一帧做 OCR | SeekToTime + ReadCurrentFrame + 文字识别 |
| 监控摄像头是否断流 | IsVideoOpened + 定时 ReadNextFrame 失败重试 |
| 只要封面图 | ExtractThumbnail 或 ReadFrameAtIndex(0) |
