第 7 章 云端录像

7.1 功能说明

云端录像管理平台自己录制的视频文件，即「平台从设备拉流并落盘到媒体节点」产生的 MP4 文件。本章覆盖录像文件的查询、播放、下载、删除，以及「正在录像」通道的查看与停止。

与另外两种录像方式的区别：

方式	数据在哪	存储周期	对应章节
云端录像	平台媒体节点磁盘	按「云端录像默认保留天数」自动清理	本章
录像计划	触发云端录像的规则	—	第 9 章
设备录像回放	设备存储卡	由设备容量决定	第 10 章
录像缓存	从设备转存到平台	按缓存任务保留期	第 8 章

菜单路径：「云端录像」（路由 /gb28181/cloud-recordings）。 所需权限：查看 gb28181:recording:view；对账 gb28181:recording:reconcile；下载 gb28181:recording:download；删除 gb28181:recording:delete；停止录像 gb28181:recording:stop。

7.2 页面结构

区域	内容
顶部工具条	分段开关「录像文件 N」「正在录像 N」；右侧对账汇总、「对账」、「刷新 Ns」
查询筛选区	仅在「录像文件」视图显示
批量操作条	勾选后出现「已选 N 个录像文件」
数据表格	按视图切换
错误提示条	加载失败时在表格上方显示

无 gb28181:recording:view 权限时，整页只显示提示「无权查看云端录像，请联系管理员分配录像查看权限。」

界面如图 7-1 所示。

图 7-1 云端录像页

界面如图 7-3 所示。

图 7-3 录像文件表格

7.3 查询录像文件

7.3.1 筛选条件

条件	选项	默认
时间范围	可选日期与时分的区间，格式 YYYY-MM-DD HH:mm，可清空	空
存储节点	全部已注册节点；非活跃节点后缀标注「离线」或「维护中」	空
可用状态	「可播放」「节点离线」「节点已移除」「文件已缺失」「暂不可访问」	空
信息状态	「信息完整」「待完善」	空
关键词	文件名／设备名称或编号／通道名称或编号	空
分页	10／20／50／100	第 1 页，每页 10

1. 设置筛选条件。
2. 点击「查询」，列表重置到第 1 页。
3. 需要清空全部条件时点击「重置」。

7.3.2 表格列

列	说明
「录像时间」	开始时间与结束时间分两行显示
「时长」	如「1时20分」
「设备」	设备名称 + 编码；两者皆空时显示「归属待补全」
「通道」	通道名称
「文件」	文件名
「大小」	文件大小
「节点」	所在媒体节点
「信息」	「信息完整」（蓝色标签）／「待完善」（橙色标签）
「状态」	见下表
「操作」	行内按钮

状态标签颜色：

状态	颜色	含义	能否播放／下载
可播放	绿色	文件存在且节点在线	可以
节点离线	橙色	节点当前不可达	不可
节点已移除	灰色	节点已从平台删除	不可
文件已缺失	红色	索引存在但磁盘文件不存在	不可
暂不可访问	橙色	其他不可用原因	不可

界面如图 7-2 所示。

图 7-2 查询条件区

7.4 行操作与按钮

按钮	位置	前置条件	行为	提示
「播放」	行操作	状态为「可播放」	打开播放弹窗	失败「播放失败，请重试」
「详情」	行操作	—	打开「录像详情」弹窗	弹窗内可「重试」
「下载」	行操作	「可播放」+ recording:download	加入下载队列并开始浏览器下载	见 7.7
「删除」	行操作	recording:delete	删除单个文件	见 7.5

不可访问的状态不显示「播放」「下载」按钮。

界面如图 7-4 所示。

图 7-4 录像播放弹窗

7.5 删除录像

7.5.1 单个删除

1. 点击行内「删除」。
2. 确认框标题「删除录像文件」，正文「将从 ZLMediaKit 节点物理删除”{文件名}“，删除后不可恢复。」。
3. 点击「删除」，成功提示「录像文件已删除」。

7.5.2 批量删除

1. 勾选多行。
2. 点击批量条「批量删除」。
3. 确认框标题「批量删除录像文件」，正文「将从 ZLMediaKit 节点物理删除选中的 N 个录像文件，删除后不可恢复。」。
4. 点击「删除」。
5. 结果：全部成功「已删除 N 个录像文件」；部分成功「已删除 N 个，M 个删除失败」。

注意 - 删除是物理删除，文件从媒体节点磁盘移除，无法通过任何方式恢复。执行前请确认已完成必要的转存或下载。 - 删除录像不影响设备的本地录像，只影响平台侧文件。

界面如图 7-7 所示。

图 7-7 删除确认

7.6 录像详情

点击行内「详情」，打开「录像详情」弹窗（宽度自适应，最大 820px）。

区块	字段
顶部三栏	「通道」「设备」「存储节点」（含名称与编码；节点状态未知时显示「状态未知」）
「文件信息」	可用状态标签、「信息完整／待完善」
文件字段	「文件名」「开始时间」「结束时间」「录像时长」「文件大小」「索引来源」「最近发现」
「索引来源」取值	「录像完成通知」——由媒体节点录制完成后回调写入；「目录对账」——由对账任务扫描发现

加载失败时显示错误消息与「重试」按钮。

界面如图 7-5 所示。

图 7-5 录像详情抽屉

7.7 下载

7.7.1 操作步骤

1. 在可播放的行点击「下载」。
2. 系统创建下载任务，并交由浏览器原生下载。
3. 顶部出现「下载任务」浮层，显示任务状态与进度。
4. 浏览器下载完成后，文件保存在默认下载目录。

7.7.2 下载任务状态

状态	含义
排队中	等待空闲下载位
等待浏览器开始	已生成链接，等待浏览器接收
下载中	正在传输，显示「百分比 · 已发/总量 · 速率/s · 剩余x分x秒」
已完成	传输结束
下载失败	传输中断或链接失效
已取消	用户取消
已过期	下载链接超时失效

7.7.3 下载限制

项目	规则
并发数	最多 2 个任务同时下载
轮询间隔	1.5 秒刷新一次任务状态
重复点击	同一文件重复点击会被去重，不会重复创建任务
操作	浮层内可「取消下载」「重新下载」

注意 - 下载走浏览器原生通道，不会打包成压缩包。浏览器若开启了「每次下载前询问保存位置」，每个文件都会弹一次对话框。 - 下载速度受浏览器与服务器之间的网络带宽限制，与平台内部网络无关。跨公网下载大文件时建议错峰。 - 「已完成」仅表示浏览器已接收完毕，文件完整性以本地文件大小与平台显示「文件大小」一致为准。

7.8 正在录像视图

切换到「正在录像」，展示当前仍在进行的录制。

列	说明
「开始时间」	本次录制开始时间
「通道」	通道名称
「设备编码」	设备国标编码
「节点」	录制所在节点
「状态」	固定显示「正在录制」（绿色）
「更新时间」	心跳或最后写入时间
「操作」	「停止录像」

7.8.1 停止录像

1. 在行内点击「停止录像」。
2. 确认框标题「停止录像」，正文「将停止”{通道名}“在 ZLMediaKit 上的录像，并关闭该通道的云端录像开关。」。
3. 点击「停止录像」，成功提示「录像已停止」。

注意 - 停止录像会同时关闭该通道的云端录像开关。若该通道由「录像计划」驱动，计划在下个时段会重新开启录制。 - 已录制的片段会正常收尾并生成文件，不会丢失已录部分。

空态：「当前没有正在录像的通道」。

界面如图 7-8 所示。

图 7-8 「正在录像」视图

7.9 录像对账

对账用于修复「数据库有索引但文件不存在」或「文件存在但数据库无索引」的不一致。

1. 设置需要核对的时间范围（建议与怀疑丢失的时间段一致）。
2. 点击工具条「对账」。
3. 提示「录像目录对账已进入队列」。
4. 工具条右侧显示对账汇总：

汇总文案	含义
「N 个节点正在对账」	有任务进行中
「N 个节点对账需关注」	存在不一致，需人工介入
「节点目录已对账」	全部完成且一致

注意 - 对账是后台任务，耗时与文件数量相关。对账期间不影响正常录制与播放。 - 「需关注」通常意味着节点磁盘上的文件被外部删除或节点离线，需登录服务器核实。

界面如图 7-9 所示。

图 7-9 录像对账

7.10 自动刷新

工具条「刷新 Ns」带 10 秒倒计时，到点自动重载当前视图。点击按钮立即刷新并重置倒计时。

7.11 常见问题

现象	原因	处理
录像列表为空但确实在录	时段筛选过窄，或录制尚未收尾	放宽时间范围；录制中的文件在收尾后才入库
设备／通道列显示「归属待补全」	写入时快照的通道已被删除且无编码可反查	属历史数据，无法自动补齐
状态为「文件已缺失」	磁盘文件被清理而索引未同步	执行「对账」，或联系管理员清理索引
下载一直「等待浏览器开始」	浏览器拦截了自动下载	在地址栏允许本站下载后重试
无法播放，提示「暂无可播放内容」	节点正在维护或文件已被移走	换节点或执行对账

---