Qt/C++开发监控GB28181系统/图像抓拍/报警自动抓拍图像/警情...

liudianwu

## 一、前言说明
图像抓拍的协议是gb28181-2022版本新加的，为何2016版本没有？估计当时这个需求不是非常强烈，尽管最开始onvif协议中是包含了这个的，后面随着监控设备的增多，使用场景的增加，尤其是4G监控设备的增加，很多地方为了节约流量，希望就是仅仅报警的时候抓拍图片上传到服务器即可，其他时间的录像等，只存储在本地，而且这种需求越来越强烈，顺义民意，专家组只好在新的协议中增加了这个交互协议。所以在使用这个图像抓拍功能的时候，务必看清楚设备是否支持2022，不支持的肯定是没有这个功能的，死命的发送抓拍指令左调试右调试，是不会有半点反应的。尤其是要告知现场的用户，不然还要怪软件写的有问题。

通信流程：

1. 图像抓拍是gb28181-2022新增的功能，需要支持2022版本的设备才支持，主流厂家大概从2024年开始才可能支持这个版本。
2. 选择某个设备某个通道，图像抓拍必须是对单个通道，而不是对某个设备。
3. 发送图像抓拍通知，通过MESSAGE指令，xml数据对应cmdtype=DeviceConfig，信息带上SnapShotConfig节点，里面包含了SnapNum-抓拍张数、Interval-抓拍间隔、UploadURL-上传地址、SessionID-信息编号。
4. 服务端打开监听端口，等待设备端上传图片，通过http指令post过来，也可以选择ftp方式上传。
5. post请求数据中带了SessionID=9a7d3a146a1e420dbd00020ed01b39e7，filename="34020000001310000001022025081609220800000.jpg" 这两个关键数据。
6. 如果指定了抓拍多张，则每一张都会有一个post请求，对应SessionID相同，filename不同，收到图片后可以存储到本地，按照指定的文件名。
7. 全部抓拍上传完成，设备端发送MESSAGE指令，带xml数据，对应cmdtype=UploadSnapShotFinished，里面有SnapShotList节点指明上传了哪些图片，以便对照进行分类。

通信协议：

```cpp
//请求抓拍：服务端-》设备端
MESSAGE sip:34020000001320000001@192.168.0.65:5060 SIP/2.0
Via: SIP/2.0/UDP 192.168.0.110:15060;branch=z9hG4bKf19df7a91ae147e9a6097361dfb4878a
From: <sip:34020000002000000001@192.168.0.110:15060>;tag=1003
To: <sip:34020000001320000001@192.168.0.65:5060>
Call-ID: 90ba9bf6b96f429d879c9584c3795cca
CSeq: 4 MESSAGE
User-Agent: wx_feiyangqingyun
Max-Forwards: 70
Content-Length: 375
Content-Type: application/MANSCDP+xml
Contact: <sip:34020000002000000001@192.168.0.110:15060>

<?xml version="1.0" encoding="GB2312"?>
<Control>
  <CmdType>DeviceConfig</CmdType>
  <SN>10003</SN>
  <DeviceID>34020000001310000001</DeviceID>
  <SnapShotConfig>
    <SnapNum>1</SnapNum>
    <Interval>1</Interval>
    <UploadURL>http://192.168.0.110:9999/snap</UploadURL>
    <SessionID>3cffba1f5df14a47acb6594b2375c5c7</SessionID>
  </SnapShotConfig>
</Control>

//请求应答：设备端-》服务端
MESSAGE sip:34020000002000000001@3402000000 SIP/2.0
Via: SIP/2.0/UDP 192.168.0.65:5060;rport;branch=z9hG4bK113097658
From: <sip:34020000001320000001@3402000000>;tag=2122550998
To: <sip:34020000002000000001@3402000000>
Call-ID: 1066186907
CSeq: 20 MESSAGE
Content-Type: Application/MANSCDP+xml
Max-Forwards: 70
User-Agent: IP Camera
Content-Length:   173

<?xml version="1.0" encoding="GB18030"?>
<Response>
<CmdType>DeviceConfig</CmdType>
<SN>10003</SN>
<DeviceID>34020000001310000001</DeviceID>
<Result>OK</Result>
</Response>

//抓拍结束：设备端-》服务端
MESSAGE sip:34020000002000000001@3402000000 SIP/2.0
Via: SIP/2.0/UDP 192.168.0.65:5060;rport;branch=z9hG4bK1404287512
From: <sip:34020000001320000001@3402000000>;tag=1058173213
To: <sip:34020000002000000001@3402000000>
Call-ID: 21190318
CSeq: 20 MESSAGE
Content-Type: Application/MANSCDP+xml
Max-Forwards: 70
User-Agent: IP Camera
Content-Length:   321

<?xml version="1.0" encoding="GB18030"?>
<Notify>
<CmdType>UploadSnapShotFinished</CmdType>
<SN>10003</SN>
<DeviceID>34020000001310000001</DeviceID>
<SessionID>3cffba1f5df14a47acb6594b2375c5c7</SessionID>
<SnapShotList>
<SnapShotFileID>34020000001310000001022025081815045400000</SnapShotFileID>
</SnapShotList>
</Notify>
```

## 二、效果图


## 三、相关地址
1. 国内站点：[https://gitee.com/feiyangqingyun](https://gitee.com/feiyangqingyun)
2. 国际站点：[https://github.com/feiyangqingyun](https://github.com/feiyangqingyun)
3. 个人作品：[https://blog.csdn.net/feiyangqingyun/article/details/97565652](https://blog.csdn.net/feiyangqingyun/article/details/97565652)
4. 文件地址：[https://pan.baidu.com/s/1d7TH_GEYl5nOecuNlWJJ7g](https://pan.baidu.com/s/1d7TH_GEYl5nOecuNlWJJ7g) 提取码：01jf 文件名：bin_video_gb28181。

## 四、功能特点
1. 支持设备注册、注销、心跳、校时、注册认证、注销认证等。
2. 设备上线后可以手动获取设备状态、设备信息、配置信息、预置位信息等。
3. 设备上线后自动获取设备通道信息，包括中文通道名称。识别到通道上线离线变化，会重新获取该设备的所有通道信息。
4. 支持视频点播，可以分别点播主码流和子码流，内置rtp解包线程，解包后发给视频播放组件解码播放。
5. 每个设备每个通道支持点播多个视频，通过ssrc区分，支持共用端口和不同端口收流。
6. 支持对某个设备下面所有通道、某个通道、某个通道对应的某个流分别关闭。
7. 支持录像文件查询和回放，回放控制支持暂停播放、继续播放、倍速播放、切换播放进度。
8. 支持录像文件下载，支持倍速比如8倍速下载，可同时多线程批量下载。
9. 回放和下载同时支持IPC和NVR，比如摄像头自带的SD存储卡录像文件回放，NVR上的硬盘录像文件回放。
10. 支持云台控制，向上、向下、向左、向右、左上、右上、左下、右下方位移动，镜头放大缩小，光圈放大缩小，镜头聚焦放焦。
11. 支持预置位信息的查询、调用、添加、修改、删除等操作。
12. 自动目录订阅功能，通道上线下线都有对应的信号通知。
13. 内置定时读取通道信息机制，以保证通道信息是最新的，比如有些NVR是不断更新的通道信息。
14. 内置订阅警情和位置移动功能，订阅后各种警情事件比如运动目标检测报警、入侵检测报警、徘徊检测报警等自动上报。
15. 支持语音对讲功能，可以直接在视频窗体的悬浮条上单击语音对讲按钮，再次单击关闭对讲，对讲期间悬浮条常驻显示。
16. 支持设备布防撤防，布防后警情信息会主动上报。
17. 国标服务同时支持udp和tcp方式，可选只监听一种或者两种都监听，tcp方式自动处理粘包问题。
18. 国标拉流同时支持udp、tcp被动、tcp主动三种方式，每个通道都可以自由选择何种拉流方式。
19. 内置拉流端口池，每次拉流从中取出一个，关闭流自动回收端口号，重复利用。
20. 收流端口自动纠错，自动跳过被占用的端口，不会出现端口占用导致收流失败的情况。
21. 支持三种取流方式自动检测离线重连，检测到离线后，自动重启点播拉流整个流程。
22. 录像文件回放，上一个完成后自动切换到下一个继续回放，直到所有回放完成。支持高达8倍速回放。
23. 视频播放自适应硬解码，极低资源占用，实时性极好，带悬浮条显示视频流信息，可以直接在悬浮条单击按钮保存录像文件到本地。
24. 支持几千路国标消息交互并发，实时视频流支持64路同时显示，可以拓展更多路数。
25. 支持阿里云等云服务器，可以分别设置内NETJ听地址和外网访问地址，一般云服务器上是监听地址用内网，对外访问用外网地址。
26. 支持视频分发，也就是推流，视频通道打开后可以自动推流到流媒体服务器，其他需要的地方拉流即可，支持rtsp、rtmp、hls、webrtc等方式拉流。
27. 实时预览和录像回放都支持推流，推流支持叠加文字和图片水印以及各种ffmpeg支持的滤镜效果，支持多个水印同时叠加。
28. 同时支持gb28181-2011、gb28181-2016、gb28181-2022以及后续可能的所有协议版本。
29. SIP解析和交互采用纯Qt底层代码实现，udp/tcp通信交互，祖传原创代码解析，不依赖任何第三方。
30. 代码量少，gb28181交互部分共几千行代码，注释详细，接口友好，使用极其简单，提供非常详细的使用示例。
31. 支持海康、大华、宇视、华为、天地伟业等所有国标设备，包括一些没有ssrc的设备。
32. 支持所有Qt版本和编译器以及操作系统，包括但不限于win、linux、mac、android、嵌入式linux、树莓派香橙派、国产os等。