GBHub 国标视频平台 — 定时截图与定时录像功能解决方案

GBHub 国标视频平台 — 定时截图与定时录像功能解决方案

📄 文档信息

一、功能概述

在视频监控管理中，定时截图与定时录像是最常用、最刚需的自动化运维能力。无论是为了降低存储成本、提升巡检效率，还是为了满足合规留存要求，自动化任务都是不可或缺的工具。

GBHub 国标视频平台内置了完整的定时任务调度引擎，支持对国标设备通道和拉流代理两种目标类型，灵活配置 定时截图 和 定时录像 两种自动化任务。

核心价值

二、核心功能详解

2.1 定时截图

自动抓拍指定通道的当前画面，保存为 JPG 图片，用于日常巡检、证据留存、对比分析等场景。

功能特点

截图质量示例

2.2 定时录像

自动录制指定通道的实时视频流，保存为 MP4 文件，用于完整记录、事件回放、合规审计等场景。

功能特点

录制参数配置

2.3 任务管理

通过统一的任务管理界面或 API，轻松管理所有定时任务。

管理功能

Cron 表达式示例

三、典型应用场景

3.1 日常巡检

• 需求：安保人员每天定时检查重点区域画面，确认设备正常运行。
• 方案：设置定时截图任务，每天 8:00、12:00、18:00 自动抓拍重点通道画面。
• 收益：无需人工逐个查看，5 分钟完成全厂区巡检，问题早发现早处理。

3.2 证据留存

• 需求：对关键出入口、财务室等敏感区域，定期留存画面用于审计追溯。
• 方案：设置定时截图任务，每小时自动截图一次，永久保留。
• 收益：满足合规审计要求，发生异常时可直接追溯历史画面。

3.3 值班交接

• 需求：每个班次交接时，需要记录当前所有重点区域状态。
• 方案：设置定时截图任务，每班次交接时刻（8:00/16:00/0:00）自动截图。
• 收益：交接记录可追溯，减少推诿扯皮。

3.4 夜间无人值守

• 需求：夜间无人值守时，对重点区域进行录像，次日复查。
• 方案：设置定时录像任务，每晚 22:00-06:00 每小时录制 5 分钟片段。
• 收益：降低存储压力，同时保留关键时段证据。

3.5 关键事件记录

• 需求：对重要事件（如领导视察、大型活动）保留完整视频记录。
• 方案：设置定时录像任务，在活动期间对覆盖通道持续录制。
• 收益：完整留存活动视频，便于后期制作或审计。

3.6 代理流监控

• 需求：对 RTSP/RTMP 拉流代理进行定时监控，确保流源正常。
• 方案：设置定时截图任务，对拉流代理通道定时截图，检查画面是否正常。
• 收益：提前发现流源异常，保障业务连续性。

四、操作指南

4.1 创建定时截图任务

方式一：通过 Web 管理后台

方式二：通过 API

# 对国标设备通道定时截图
POST /api/schedule/tasks
Authorization: Bearer <token>
{
"action": "snapshot",
"device_id": "34020000001320000001",
"channel_id": "34020000001310000001",
"cron_expr": "0 8 * * *",
"concurrency": 5
}

4.2 创建定时录像任务

# 对国标设备通道定时录像
POST /api/schedule/tasks
Authorization: Bearer <token>
{
"action": "record",
"device_id": "34020000001320000001",
"channel_id": "34020000001310000001",
"cron_expr": "0 8 * * *",
"duration_secs": 60,
"concurrency": 5
}

# 对拉流代理定时截图
POST /api/schedule/tasks
Authorization: Bearer <token>
{
"action": "snapshot",
"app": "live",
"stream": "camera1",
"cron_expr": "0 8 * * *"
}

4.3 查看截图结果

通过 Web 后台：设备管理 → 点击设备 → 截图历史标签

通过移动端：通道列表 → 点击通道 → 查看截图

通过 API：GET /api/snapshot-list?device_id=xxx&channel_id=xxx

4.4 查看录像结果

通过 Web 后台：云端录像标签 → 查询

通过移动端：通道列表 → 点击通道 → 查看录像

通过 API：POST /api/records

五、技术架构

系统架构

任务生命周期

创建任务 → 存入Redis → 调度器扫描 → Cron匹配 → 执行任务 → 保存结果 → 回调通知（可选）

六、产品优势

6.1 对比传统人工操作

对比项 传统人工操作 GBHub 定时任务 执行时间 依赖人员到位 全自动，分秒不差 执行精度 容易遗漏、忘记 精准执行 人力成本 需专人值守 零人力成本 可追溯性 手工记录易丢失 自动记录，永久可查 一致性 因人而异 每次完全一致

6.2 对比其他产品

对比项 其他产品 GBHub 定时截图 部分支持 ✅ 支持（国标+代理） 定时录像 部分支持 ✅ 支持（国标+代理） 并发控制 少 ✅ 支持可配置并发 Cron 表达式 固定间隔 ✅ 完整 Cron 支持 回调通知 少 ✅ HTTP 回调 移动端查看 少 ✅ 原生支持 任务管理 API 少 ✅ 完整 RESTful API

6.3 技术亮点

亮点 说明 防重入机制 同一任务不会重复执行，避免资源浪费 并发控制 可配置最大并发数，保护系统资源 容错机制 单任务失败不影响其他任务 实时监控 任务执行状态可通过回调获取 灵活扩展 支持通过 API 集成第三方系统

七、部署要求

7.1 软件环境

组件 版本要求 说明 操作系统 Linux / macOS / Windows 推荐 Linux (Ubuntu 20.04+) Rust 1.70+ 编译环境 Redis ≥ 6.0 任务存储与调度 ZLMediaKit 最新 stable 媒体服务 浏览器 Chrome/Firefox/Edge 最新版 管理后台

7.2 服务组件

服务 说明 是否必须 gbhub-mgr 管理服务，处理任务创建与执行 ✅ 必须 gbhub-sip 信令服务，处理国标设备通信 ✅ 必须 gbhub-scheduler 调度服务，定时触发任务 ✅ 必须 ZLMediaKit 媒体服务，提供截图与录制能力 ✅ 必须

7.3 关键环境变量

变量名 说明 默认值 SCHEDULER_SCAN_INTERVAL_SECS 调度器扫描间隔（秒） 30

附录：常用 Cron 表达式参考 需求 表达式 每分钟 * * * * * 每 5 分钟 */5 * * * * 每 30 分钟 */30 * * * * 每小时整点 0 * * * * 每天 8:00 0 8 * * * 每天 12:00 和 18:00 0 12,18 * * * 每天 8:00-18:00 每小时 0 8-18 * * * 每周一 9:00 0 9 * * 1 每月 1 日 0:00 0 0 1 * * 每年 1 月 1 日 0:00 0 0 1 1 * 工作日 8:00 0 8 * * 1-5 官方网站 https://gb.automate.org.cn © 2026 GBHub 国标视频平台 · 保留所有权利