Android国标接入终端实现GB28181实时位置(MobilePosition)上报

简介: 在实现本文提到的Android平台国标GB28181接入终端的实时位置上报之前,之前已经完成了Android终端GB28181常规功能接入,采集到实时音视频数据,编码PS打包后,按需传到GB28281服务平台,媒体流支持最新GB28181-2016的UDP和TCP被动模式,参数配置,支持注册有效期、心跳间隔、心跳间隔次数、TCP/UDP信令设置,支持RTP Sender IP地址类型、RTP Socket本地端口、SS-R-C、RTP socket 发送Buffer大小、RTP时间戳时钟频率设置,支持注册成功、注册超时、INVITE、ACK、BYE状态回调等。

技术背景

在实现本文提到的Android平台国标GB28181接入终端的实时位置上报之前,之前已经完成了Android终端GB28181常规功能接入,采集到实时音视频数据,编码PS打包后,按需传到GB28281服务平台,媒体流支持最新GB28181-2016的UDP和TCP被动模式,参数配置,支持注册有效期、心跳间隔、心跳间隔次数、TCP/UDP信令设置,支持RTP Sender IP地址类型、RTP Socket本地端口、SS-R-C、RTP socket 发送Buffer大小、RTP时间戳时钟频率设置,支持注册成功、注册超时、INVITE、ACK、BYE状态回调等。


本文主要是介绍实时位置订阅(SUBSCRIBE)和上报(NOTIFY)功能更新时的一些注意事项,感兴趣的开发者可酌情参考。


实时位置订阅和上报,对GB28281设备接入终端尤其重要,如移动单兵设备、执法记录仪、智能安全帽、车载终端等,Android国标接入设备通过获取到实时经纬度信息,按照一定的间隔上报到国标服务平台,国标服务平台通过如电子地图,实时动态显示前端设备的定位信息,从而实现前端接入设备的可视可控管理。

交互流程

首先了解下订阅通知流程:

e13f9fb04f4f4dc6b400b822f47a5232.png

基本流程和注意事项:


  1. 国标服务平台向Android国标接入终端发送SUBSCRIBE消息体,并携带Expire头域指定订阅过期时间;
  2. Android国标接入终端收到SUBSCRIB后,发送200 OK响应;
  3. 紧接着,Android国标接入终端发送 NOTIFY 消息相关的位置信息,并使用Event头域描述订阅事件,国标GB28181的移动设备位置订阅这个值是"presence";
  4. 国标服务平台收到 Android国标接入端NOTIFY消息后,回复200 OK响应;
  5. NOTIFY...200 OK...NOTIFY...200 OK...
  6. 国标服务平台在订阅过期之前,向Android国标接入终端发送刷新订阅 SUBSCRIBE 消息,消息头域中使用 Event头域描述订阅事件,消息体中携带订阅的详细参数,使用 Expire头 域指定订阅过期时间;
  7. Android接入终端收到订阅消息后,向国标服务平台发送200 OK响应;
  8. NOTIFY...200 OK...NOTIFY...200 OK...
  9. 如国标服务平台需要取消订阅,可以向Android国标接入终端发送取消订阅SUBSCRIBE消息,消息头域中使用Event头域描述订阅事件,消息体中携带订阅的详细参数,Expire头域值为0;
  10. Android国标接入终端收到订阅消息后,向国标服务平台发送200 OK响应,取消向国标服务平台发送实时位置通知消息,取消订阅成功的话,也会发一个最终的NOTIFY给国标服务端;
  11. 需要注意的是:Android国标接入终端收到SUBSCRIBE请求后,会检查SUBSCRIBE请求中"Expires"值的大小,当且仅当这个值大于0且小于1小时,并且小于Notifier配置的最小值时,Notifier可能会返回一个"423 Interval too  small"错误,并包含一个""Min-Expires" 头域;
  12. Android国标接入端发送的NOTIFY请求超时的话,应该移除这个订阅;
  13. NOTIFY request必须包含"Subscription-State"头,有三个可选的值:"active", "pending", "terminated". 当值是"active"或"pending"时,应该也包含一个”expires“参数,显示订阅剩余时间。


GB/T28181-2016针对MobilePosition描述

<elementname="TargetID"type="tg:deviceIDType"/>移动设备位置数据通知
<! -- 命令类型:移动设备位置数据通知(必选)-->
<elementname="CmdType"fixed="MobilePosition"/>
<! -- 命令序列号(必选)-->
<elementname="SN" type="integer"minInclusivevalue= "1"/>
<! -- 产生通知时间(必选)--> 
<elementname="Time" type="dateTime"/> 
<! --经度(必选)--> <elementname="Longitude"type="double"/> 
<! -- 纬度(必选)--> <elementname="Latitude"type="double"/> 
<! --速度,单位:km/h(可选)--> 
<elementname="Speed"type="double"/> 
<!--方向,取值为当前摄像头方向与正北方的顺时针夹角,取值范围0°~360°,单位:(°)(可选)-->
<elementname="Direction"type="double"/>
<! --海拔高度,单位:m(可选)-->
<elementname="Altitude"type="tg:deviceIDType"/>

SUBSCRIBE请求XML描述

<?xml version="1.0" encoding="GB2312" ?>
<Query>
<CmdType>MobilePosition</CmdType>
<SN>55674</SN>
<DeviceID>31011500991320000099</DeviceID>
<Interval>5</Interval>
</Query>

Android国标接入端上报NOTIFY请求示例


请求体XML示例如下

<?xml version="1.0" encoding="GB2312" ?>
<Notify>
<CmdType>MobilePosition</CmdType>
<SN>71339</SN>
<TargetID>31011500991320000099</TargetID>
<Time>2022-03-19T12:22:20</Time>
<Longitude>143.507222</Longitude>
<Latitude>33.99011311</Latitude>
</Notify>

代码实现

Android国标接入端DevicePosition基本结构如下:

/*
 * DevicePosition.java
 * DevicePosition
 *
 * WebSite: https://daniusdk.com
 * Github: https://github.com/daniulive/SmarterStreaming
 *
 */
public class DevicePosition {
    private String mTime; // 产生位置信息的时间,格式如:2022-03-16T10:37:21, yyyy-MM-dd'T'HH:mm:ss
    private String mLongitude; // 经度
    private String mLatitude; //纬度
    private String mSpeed; // 速度,单位:km/h
    private String mDirection; // 方向,取值为当前摄像头方向与正北方的顺时针夹角,取值范围0°~360°,单位:(°)
    private String mAltitude; // 海拔高度,单位:m
    public String getTime() {
        return mTime;
    }
    public void setTime(String time) {
        this.mTime = time;
    }
    public String getLongitude() {
        return mLongitude;
    }
    public void setLongitude(double longitude) {
        this.mLongitude = String.valueOf(longitude);
    }
    public void setLongitude(String longitude) { this.mLongitude =longitude; }
    public String getLatitude() {
        return mLatitude;
    }
    public void setLatitude(double latitude) {
        this.mLatitude = String.valueOf(latitude);
    }
    public void setLatitude(String latitude) { this.mLatitude = latitude;}
    public String getSpeed() {
        return mSpeed;
    }
    public void setSpeed(double speed) {
        this.mSpeed = String.valueOf(speed);
    }
    public String getDirection() {
        return mDirection;
    }
    public void setDirection(double direction) {
        this.mDirection = String.valueOf(direction);
    }
    public String getAltitude() {
        return mAltitude;
    }
    public void setAltitude(double altitude) {
        this.mAltitude = String.valueOf(altitude);
    }
}

当有SUBSCRIBE request请求位置更新,把请求回到上层:

/*
 * 设备位置请求, 这个主要用在移动设备位置订阅上
 * @param interval 请求间隔, 单位是毫秒
 */
void ntsOnDevicePositionRequest(String deviceId, int interval);

对外提供个更新设备位置信息的接口:

/*
 *更新设备位置信息 
 */
boolean updateDevicePosition(String deviceId, DevicePosition position)

上层具体处理ntsOnDevicePositionRequest:

@Override
 public void ntsOnDevicePositionRequest(String deviceId, int interval) {
    handler.postDelayed(new Runnable() {
        @Override
        public void run() {
            getLocation(myContext);
            Log.i(TAG, "ntsOnDevicePositionRequest, deviceId:" + this.device_id_ + ", Longitude:" + mLongitude + ", Latitude:" + mLatitude + ", Time:" + mLocationTime);
            if (mLongitude != null && mLatitude != null) {
                com.gb28181.ntsignalling.DevicePosition device_pos = new com.gb28181.ntsignalling.DevicePosition();
                device_pos.setTime(mLocationTime);
                device_pos.setLongitude(mLongitude);
                device_pos.setLatitude(mLatitude);
                if (gb28181_agent_ != null ) {
                    gb28181_agent_.updateDevicePosition(device_id_, device_pos);
                }
            }
        }
        private String device_id_;
        private int interval_;
        public Runnable set(String device_id, int interval) {
            this.device_id_ = device_id;
            this.interval_ = interval;
            return this;
        }
    }.set(deviceId, interval),0);
}

如何添加设备:

private void addTestDevice() {
com.gb28181.ntsignalling.Device gb_device = new com.gb28181.ntsignalling.Device("34020000001380000037", "某安卓设备", Build.MANUFACTURER, Build.MODEL,
                    "宇宙","火星1","火星", true);
     if (mLongitude != null && mLatitude != null) {
          com.gb28181.ntsignalling.DevicePosition device_pos = new com.gb28181.ntsignalling.DevicePosition();
          device_pos.setTime(mLocationTime);
          device_pos.setLongitude(mLongitude);
          device_pos.setLatitude(mLatitude);
          gb_device.setPosition(device_pos);
          gb_device.setSupportMobilePosition(true); // 设置支持移动位置上报
      }
      gb28181_agent_.addDevice(gb_device);
}

总结

以上就是Android设备接入端实现MobilePostion实时订阅和上报的大概流程和具体实现,在有了基础框架后,加这块并不是太麻烦,主要是熟悉相关的spec,感兴趣的开发者,可酌情参考。

相关文章
|
5月前
|
数据采集 前端开发 Android开发
Android平台RTMP推送或GB28181设备接入端如何实现采集audio音量放大?
我们在做Android平台RTMP推送和GB28181设备对接的时候,遇到这样的问题,有的设备,麦克风采集出来的audio,音量过高或过低,特别是有些设备,采集到的麦克风声音过低,导致播放端听不清前端采集的audio,这时候,就需要针对采集到的audio,做音量放大处理。
|
1月前
|
编解码 测试技术 开发工具
如何实现Android视音频数据对接到GB28181平台(SmartGBD)
如何实现Android视音频数据对接到GB28181平台(SmartGBD)
|
1月前
|
开发工具 Android开发
Android平台RTMP推送|轻量级RTSP服务|GB28181设备接入模块之实时快照保存JPG还是PNG?
Android平台RTMP推送|轻量级RTSP服务|GB28181设备接入模块之实时快照保存JPG还是PNG?
|
5月前
|
编解码 网络协议 Android开发
Android平台GB28181设备接入端如何支持跨网段语音对讲
如果你是音视频开发者亦或寻求这块技术方案的公司,在探讨这个问题之前,你可能网上看了太多关于语音广播和语音对讲相关的资料,大多文章认为语音对讲和语音广播无本质区别,实现思路也大同小异。
|
4月前
|
XML 网络协议 开发工具
Android平台GB28181设备接入侧如何实现SIP校时
Android平台GB28181设备接入侧如何实现SIP校时
|
5月前
|
监控 网络协议 Java
Android中使用JT808协议进行车载终端通信的实现
Android中使用JT808协议进行车载终端通信的实现
73 0
|
5月前
|
编解码 监控 网络协议
Android平台GB28181设备接入侧如何实现按需打开视音频采集传输
Android平台GB28181设备接入侧如何实现按需打开视音频采集传输
113 2
|
5月前
|
网络协议 开发工具 Android开发
​​Android平台GB28181历史视音频文件下载规范探讨及技术实现
​​Android平台GB28181历史视音频文件下载规范探讨及技术实现
|
5月前
|
开发工具 Android开发 开发者
Android平台GB28181历史视音频文件检索规范探讨及技术实现
Android平台GB28181历史视音频文件检索规范探讨及技术实现
|
5月前
|
编解码 监控 开发工具
Android平台GB28181接入模块技术接入说明
今天,我们主要讲讲Android平台GB28181接入模块的技术对接,Android平台GB28181接入模块设计的目的,可实现不具备国标音视频能力的 Android终端,通过平台注册接入到现有的GB/T28181—2016服务,可用于如智能监控、智慧零售、智慧教育、远程办公、生产运输、智慧交通、车载或执法记录仪等场景。

相关产品

  • 云迁移中心