GB28181 平台录像任务调度与设备录像查询机制详解

2 阅读5分钟

GB28181 平台录像任务调度与设备录像查询机制详解

1. 简介

在基于 GB/T 28181 国家标准构建的视频监控平台中,录像功能是核心业务之一,主要分为两类:

  • 平台侧计划录像:由平台主动发起,通过媒体服务器向设备请求实时流,并在平台侧(本地或云存储)进行录制。适用于需要集中存储或长期备份的场景。
  • 设备端历史录像查询与回放:前端通过信令服务器向设备请求其磁盘或NVR中已存储的历史录像文件。适用于取证查询或设备离线时的数据回溯。

本文将完整覆盖 从录像任务创建、分布式调度执行,到设备端历史录像分批查询 的全流程,结合流程图、时序图与真实SIP信令日志,帮助深入理解国标平台的录像机制设计与实现细节。


2. 平台侧录像任务调度机制

平台侧录像的核心在于 “任务配置 -> 分布式调度 -> 流媒体操作” 的闭环。

2.1 录像计划配置与持久化

用户在前端界面配置录像策略,如选择摄像头、设定录像时间段(如每天 00:00–24:00)、录像类型(定时/移动侦测/报警)以及存储策略。

  • 数据流转:前端提交配置 -> 后端服务校验 -> 持久化至数据库。

  • 任务状态:录像计划在数据库中通常包含启用/禁用、开始时间、结束时间、重复周期等字段。

2.2 分布式任务调度与执行流程

在分布式微服务架构中,如何避免多个服务实例同时对同一个摄像头执行录像任务,是设计的关键。通常采用 “定时扫描 + 分布式锁” 的机制。

以下是任务执行流程图:

graph TD
    A[定时任务触发<br>如每分钟扫描一次] --> B{查询数据库<br>获取所有启用状态的录像计划}
    B --> C{遍历每个计划的摄像头}

    subgraph 分布式锁竞争与执行
        D[尝试获取分布式锁<br>Key: record:计划ID] --> E{锁获取成功?}
        E -- 否 --> F[其他实例正在处理<br>跳过本次循环]
        E -- 是 --> G[执行录像任务逻辑]
        G --> H[查询设备在线状态及<br>上次拉流记录]
        H --> I{是否已在录制中?}
        I -- 是 --> J[无需重复操作<br>记录状态]
        I -- 否 --> K[调用Media Server API<br>发起开始拉流并录像请求]
        K --> L{API调用结果}
        L -- 失败 --> M[记录错误日志<br>更新任务状态为异常]
        L -- 成功 --> N[更新任务状态为录制中<br>记录媒体流SSRC等信息]
    end

    C --> D
    F --> O[结束本次遍历]
    J --> O
    M --> O
    N --> O
    O --> P[释放分布式锁]
    P --> Q[等待下一个调度周期]
2.2.1 关键细节
  • 创建录像计划录像计划配置
  • 定时粒度:调度器通常每分钟运行一次,检查当前时间是否落在某个录像计划的开始-结束时间范围内。
  • 分布式锁:使用或Redis乐观锁,确保一个摄像头在同一时间只有一个服务实例在处理其录像任务,防止重复拉流。
  • 状态机管理:每个录像计划应有明确的状态(待执行、录制中、已停止、异常),以便系统恢复或人工干预。
  • 与Media Server交互
    • 开始录像:调用媒体服务器的api/record/start。
    • 停止录像:当系统时间超过计划结束时间,或用户手动停用计划时,调度器应调用api/record/stop接口,并更新状态。

3. 设备端历史录像查询与点播机制

3.1 核心交互流程(SIP + RTSP/RTP)

整个流程分为“查询”与“点播”两个阶段:

  • 查询阶段:平台向设备发送SIP消息,询问某段时间内的录像文件列表。
  • 点播阶段:用户选择某个录像文件,平台向设备发送INVITE请求,开始播放历史流。

3.2 时序图

sequenceDiagram
    participant Frontend as 前端界面
    participant SignalServer as 信令服务器(SIP)
    participant MediaServer as 媒体服务器
    participant Device as 前端设备/NVR

    Note over Frontend,Device: 1. 录像列表查询

    Frontend->>SignalServer: 请求设备录像列表<br>(设备ID, 开始时间, 结束时间)
    SignalServer->>Device: SIP Message (携带录像目录查询请求)
    Device-->>SignalServer: SIP 200 OK (确认收到)
    Device->>SignalServer: SIP Message (返回录像目录结果,XML格式)
    SignalServer->>Frontend: 解析XML并返回格式化后的录像列表

    Note over Frontend,Device: 2. 历史录像点播

    Frontend->>SignalServer: 选择某个录像文件开始回放<br>(携带“开始时间”作为码流标识)
    SignalServer->>MediaServer: 分配媒体端口,准备接收流
    MediaServer-->>SignalServer: 返回SDP信息(含接收端口)
    SignalServer->>Device: SIP INVITE (SDP中包含媒体服务器端口,<br>并指定“开始时间”为录像播放点)
    Device-->>SignalServer: SIP 100 Trying
    Device-->>SignalServer: SIP 200 OK (携带设备端的SDP)
    SignalServer->>Device: SIP ACK
    Device->>MediaServer: RTP推流 (发送历史录像数据)
    MediaServer->>Frontend: WebRTC/FLV/HLS 转发给前端播放

    Note over Frontend,Device: 3. 控制与结束
    Frontend->>SignalServer: 暂停/快进/停止
    SignalServer->>Device: SIP INFO/INVITE (更新播放位置)
    Frontend->>SignalServer: 停止回放
    SignalServer->>Device: SIP BYE

3.3 核心信令详解

3.3.1 录像目录查询请求 (SIP Message)

平台向设备发送MESSAGE请求,其消息体为XML格式,用于查询历史录像。

Type 录像类型:time(定时),alert(报警),all(全部)

<?xml version="1.0"?>
<Query>
  <CmdType>RecordInfo</CmdType>
  <SN>1</SN>
  <DeviceID>34020000001320000104</DeviceID>
  <StartTime>2026-03-13T00:00:00</StartTime>
  <EndTime>2026-03-13T23:59:59</EndTime>
  <Type>all</Type>
</Query>
3.3.2 设备侧录像目录响应 (SIP Message)

设备收到查询后,会以另一个MESSAGE请求回复录像列表。录像文件可能很多,设备不会一次性全部返回,而是分批次返回(整理流程和catalog类似)。

<?xml version="1.0"?>
<Response>
  <CmdType>RecordInfo</CmdType>
  <SN>2</SN>
  <DeviceID>34020000001320000104</DeviceID>
  <SumNum>3</SumNum>
  <RecordList>
    <Item>
      <DeviceID>34020000001320000104</DeviceID>
      <Name>通道01录像</Name>
      <StartTime>2026-03-13T08:00:00</StartTime>
      <EndTime>2026-03-13T10:00:00</EndTime>
      <FileSize>1048576</FileSize>
    </Item>
    <!-- 更多Item... -->
  </RecordList>
</Response>
3.3.3 历史录像点播 (SIP INVITE)

与点播实时流不同,点播历史流需要在SDP中携带startTime和endTime参数,以告诉设备需要播放哪一段。

参考/core/app/sev/vss/internal/pkg/sip/gbs_send.go:858

v=0
o=34020000001320000104 0 0 IN IP4 192.168.1.100
s=Play
c=IN IP4 192.168.1.200
t=1696147200 1696150800  // 开始和结束时间的NTP格式
m=video 6000 RTP/AVP 96 97 98
a=recvonly
a=rtpmap:96 PS/90000
a=rtpmap:97 H264/90000
a=rtpmap:98 MPEG4/90000
y=0200000001  // ssrc

4. 总结与设计要点

在设计国标设备录像相关模块时,建议重点关注以下几点:

  • 资源隔离与锁:在分布式录像任务调度中,必须引入分布式锁,避免对同一设备的重复拉流,造成资源浪费或设备异常。
  • 异步处理:无论是调用媒体服务器拉流,还是与设备进行SIP交互,都应采用异步机制,避免阻塞核心调度线程。
  • 状态持久化:录像任务的状态需要持久化到数据库,以便系统重启后能够恢复任务。
  • 分页处理:对于录像目录查询,必须实现分批查询逻辑,以应对海量录像文件的场景。

通过以上机制,一个稳定、高效的国标录像系统才能被构建出来,满足安防监控领域多样化的业务需求。