GB/T28181-2022图像抓拍规范解读及技术实现

音视频牛哥

于 2023-03-06 12:14:10 发布

阅读量2k

点赞数

分类专栏： GB28181接入大牛直播SDK SmartGBD 文章标签： GB28181 2022 GB28181推流大牛直播SDK GB28181抓拍 GB28181快照 Powered by 金山文档

本文链接：https://blog.csdn.net/renhui1112/article/details/129359248

版权

大牛直播SDK 同时被 3 个专栏收录

351 篇文章 48 订阅

订阅专栏

GB28181接入

128 篇文章 20 订阅

订阅专栏

SmartGBD

123 篇文章 1 订阅

订阅专栏

文章详细介绍了GB28181-2022规范中关于图像抓拍的增强内容，包括设备软件升级、图像抓拍的命令流程和协议接口。具体命令流程涉及SIP服务器和目标设备间的交互。技术实现部分以Android平台为例，展示了如何按照GB28181标准进行快照操作，包括快照文件的命名、格式转换以及事件回调机制。

摘要由CSDN通过智能技术生成

规范解读

GB28181-2022相对2016，增加了设备软件升级、图像抓拍信令流程和协议接口。我们先回顾下规范说明：

图像抓拍基本要求

源设备向目标设备发送图像抓拍配置命令,携带传输路径、会话ID等信息。目标设备完成图像传输后,发送图像抓拍传输完成通知命令,采用IETF RFC 3428中的MESSAGE方法实现,命令流程见9.14.2。图像文件命名规则宜采用“设备编码(20位)、图像编码(2位)、时间编码(17位)、序列码(2位)”的形式,抓拍图像文件命名规则应符合表4的要求。图像格式宜使用JPEG，图像分辨率宜采用与主码流相同的分辨率。

命令流程

命令流程描述如下:

a)l:源设备向SIP服务器发送图像抓拍配置命令,该命令采用MESSAGE方法携带;

b)2:SIP服务器收到命令后回复200 OK响应﹔

c)3:SIP服务器向目标设备发送图像抓拍配置命令,该命令采用MESSAGE方法携带;

d)4:目标设备收到消息3后回复200 OK响应﹔

e)5:目标设备向SIP服务器发送图像抓拍配置响应命令﹔

f)6:SIP服务器收到命令后返回200 OK;

g)7:SIP服务器向源设备转发图像抓拍配置响应命令﹔

h)8:源设备收到命令后返回200 OK;

i)9:目标设备完成图像传输后发送Message消息,通知SIP服务器图像传输已完成,消息格式应符合A.2.5.7抓拍图像传输完成通知的要求;

j)10:SIP服务器收到消息9后回复200 OK响应;k)11:SIP服务器向源设备转发消息9;

l)12:源设备收到命令11后回复200 OK。

协议接口

图像抓拍协议接口满足以下要求。

a)MESSAGE消息头Content-type头域为Content-type:Application/MANSCDP+xml。

b)图像抓拍配置命令采用MANSCDP协议格式定义:配置命令消息体采用XML封装﹐消息体元数据序列格式符合A.2.3.2.1和A.2.3.2.12的格式规定。

c)图像传输方式宜采用http。当报警触发图像抓拍时,可将报警信息携带在上传路径中,用于关联抓拍的图像。

d)图像抓拍传输完成通知命令采用MANSCDP协议格式定义:配置命令消息体采用XML,封装,XML消息体格式定义符合A.2.5.1规定的前导声明,消息体元数据序列格式符合A.2.5.7的格式规定。其中,SessionID应与图像抓拍配置命令中的SessionID一致。

技术实现

快照分两部分，一部分是按照GB28181的规范要求，平台侧需要快照的时候，本地编码需要的jpeg格式上传到平台侧的图像存储服务器，另外也可以接入端本地发起快照，本地存储。

本文以Android平台GB28181设备接入模块为例，默认，我们采用的是png格式，如果需要，也可以数据回上来，编码保存成协议规范要求的jpeg格式。

//Author: daniusdk.com
class ButtonCaptureImageListener implements View.OnClickListener {
  @SuppressLint("SimpleDateFormat")
  public void onClick(View v) {
    if(isPushingRtmp || isRecording || isRTSPPublisherRunning || isGB28181StreamRunning)
    {
      String timeStamp = new SimpleDateFormat("yyyyMMdd_HHmmss").format(new Date());
      String imageFileName = "dn_" + timeStamp;    //创建以时间命名的文件名称

      String imagePath = imageSavePath + "/" + imageFileName + ".png";

      Log.i(TAG, "imagePath:" + imagePath);

      libPublisher.SmartPublisherSaveCurImage(publisherHandle, imagePath);
    }
    else
    {
      Log.e(TAG, "快照失败，请确保在推送、录像或内置RTSP服务发布状态..");
    }
  }
}

快照成功后，会有相应的Event回调上来，对应的事件EVENT_DANIULIVE_ERC_PUBLISHER_CAPTURE_IMAGE：

class EventHandePublisherV2 implements NTSmartEventCallbackV2 {
  @Override
  public void onNTSmartEventCallbackV2(long handle, int id, long param1, long param2, String param3, String param4, Object param5) {

    Log.i(TAG, "EventHandeV2: handle=" + handle + " id:" + id);

    String publisher_event = "";

    switch (id) {
      case NTSmartEventID.EVENT_DANIULIVE_ERC_PUBLISHER_STARTED:
        publisher_event = "开始..";
        break;
      case NTSmartEventID.EVENT_DANIULIVE_ERC_PUBLISHER_CONNECTING:
        publisher_event = "连接中..";
        break;
      case NTSmartEventID.EVENT_DANIULIVE_ERC_PUBLISHER_CONNECTION_FAILED:
        publisher_event = "连接失败..";
        break;
      case NTSmartEventID.EVENT_DANIULIVE_ERC_PUBLISHER_CONNECTED:
        publisher_event = "连接成功..";
        break;
      case NTSmartEventID.EVENT_DANIULIVE_ERC_PUBLISHER_DISCONNECTED:
        publisher_event = "连接断开..";
        break;
      case NTSmartEventID.EVENT_DANIULIVE_ERC_PUBLISHER_STOP:
        publisher_event = "关闭..";
        break;
      case NTSmartEventID.EVENT_DANIULIVE_ERC_PUBLISHER_RECORDER_START_NEW_FILE:
        publisher_event = "开始一个新的录像文件 : " + param3;
        break;
      case NTSmartEventID.EVENT_DANIULIVE_ERC_PUBLISHER_ONE_RECORDER_FILE_FINISHED:
        publisher_event = "已生成一个录像文件 : " + param3;
        break;

      case NTSmartEventID.EVENT_DANIULIVE_ERC_PUBLISHER_SEND_DELAY:
        publisher_event = "发送时延: " + param1 + " 帧数:" + param2;
        break;

      case NTSmartEventID.EVENT_DANIULIVE_ERC_PUBLISHER_CAPTURE_IMAGE:
        publisher_event = "快照: " + param1 + " 路径：" + param3;

        if (param1 == 0) {
          publisher_event = publisher_event + "截取快照成功..";
        } else {
          publisher_event = publisher_event + "截取快照失败..";
        }
        break;
      case NTSmartEventID.EVENT_DANIULIVE_ERC_PUBLISHER_RTSP_URL:
        publisher_event = "RTSP服务URL: " + param3;
        break;
      case NTSmartEventID.EVENT_DANIULIVE_ERC_PUSH_RTSP_SERVER_RESPONSE_STATUS_CODE:
        publisher_event ="RTSP status code received, codeID: " + param1 + ", RTSP URL: " + param3;
        break;
      case NTSmartEventID.EVENT_DANIULIVE_ERC_PUSH_RTSP_SERVER_NOT_SUPPORT:
        publisher_event ="服务器不支持RTSP推送, 推送的RTSP URL: " + param3;
        break;
    }

    String str = "当前回调状态：" + publisher_event;

    Log.i(TAG, str);

    Message message = new Message();
    message.what = PUBLISHER_EVENT_MSG;
    message.obj = publisher_event;
    handler_.sendMessage(message);
  }
}