查询、回放、下载和裁剪录像

先确认录像来自哪里：平台本地录像在录像中心按文件索引查询；GB28181 设备端录像要先向设备查询历史，再发起设备回放。两者不是同一个列表。

查询平台本地录像

按编号操作：① 选通道；② 选时间；③ 查询；④ 选文件；⑤ 播放核对。查询为空时，先检查前 3 项，不要直接判断录像丢失。

1. 打开 录像中心，先选通道。
2. 选择尽量小的开始和结束时间，确认页面显示的时区。
3. 点击查询，再从右侧文件列表选择结果。
4. 点击播放，核对画面内容、文件时间和播放器时长。
5. 需要交付原文件时，再执行下载。

查不到时先放宽时间范围并确认时区。磁盘有文件、页面没有结果，说明应检查 WebHook、文件扫描或索引积压，不要立即重录。

播放和下载为什么会失败

flowchart LR
    A[用户点击文件] --> B{有权限?}
    B -->|否| C[拒绝访问]
    B -->|是| D{路径在允许根内?}
    D -->|否| E[安全门禁拒绝]
    D -->|是| F[Range 播放或下载]

平台会核对用户权限、文件所属节点、允许录像根、规范化路径和物理文件状态。大文件播放依赖 HTTP Range；反向代理必须保留 Range、Content-Length，并避免把整个文件缓冲到代理内存。

离开页面后继续正确时间进度

录像正在播放时，页面会记录离开前的文件位置、离开时刻和播放倍速。返回前台后按真实经过时间推进：目标仍在当前 MP4 内就直接定位；跨过文件边界就选择正确片段；落在无录像区间会跳到下一段；超过查询范围则落到最后一段末尾。这样不会因为浏览器后台冻结而继续显示几分钟前的旧录像画面。

如果离开前是手工暂停，返回后保持暂停且不推进。此规则适用于平台本地录像文件；GB28181 设备端回放仍取决于设备对暂停、倍速和定位命令的实现。

删除与恢复

批量物理删除前先导出目标清单，核对通道、时间、节点和总大小。不要用模糊条件直接永久删除。

裁剪或合并一段录像

1. 在同一时间线上选择源文件和目标起止时间。
2. 创建裁剪/合并任务，记住任务 ID。
3. 在后台任务中等待成功或失败的最终状态。
4. 播放输出文件，检查时长、画面和音视频同步。
5. 下载结果，或按保留策略清理。

源文件缺失、编码不兼容、磁盘不足、FFmpeg 不可用或队列积压都会让任务失败。先看任务错误，不要无限重复同一个无效任务。

GB28181 设备端录像

先向设备发送历史录像查询，拿到设备返回的时间段后，再发起回放 INVITE 和 RTP 媒体。倍速、拖动定位和时间格式取决于设备协议版本与厂商实现，必须按目标型号验收。

做完后这样验收

• 普通用户能在一分钟内找到指定通道和时间段。
• 浏览器播放和文件下载都能在真实网络完成。
• 不同权限账号不能越权读取录像。
• 软删除可以恢复，物理删除只影响明确目标。
• 裁剪任务有最终结果，输出能追溯到源文件。