技术背景
在实现本文提到的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国标接入设备通过获取到实时经纬度信息，按照一定的间隔上报到国标服务平台，国标服务平台通过如电子地图，实时动态显示前端设备的定位信息，从而实现前端接入设备的可视可控管理。
交互流程
首先了解下订阅通知流程：
基本流程和注意事项：
- 国标服务平台向Android国标接入终端发送SUBSCRIBE消息体，并携带Expire头域指定订阅过期时间；
- Android国标接入终端收到SUBSCRIB后，发送200 OK响应；
- 紧接着，Android国标接入终端发送 NOTIFY 消息相关的位置信息，并使用Event头域描述订阅事件，国标GB28181的移动设备位置订阅这个值是"presence"；
- 国标服务平台收到 Android国标接入端NOTIFY消息后，回复200 OK响应；
- NOTIFY...200 OK...NOTIFY...200 OK...
- 国标服务平台在订阅过期之前，向Android国标接入终端发送刷新订阅 SUBSCRIBE 消息，消息头域中使用 Event头域描述订阅事件,消息体中携带订阅的详细参数，使用 Expire头 域指定订阅过期时间;
- Android接入终端收到订阅消息后，向国标服务平台发送200 OK响应;
- NOTIFY...200 OK...NOTIFY...200 OK...
- 如国标服务平台需要取消订阅，可以向Android国标接入终端发送取消订阅SUBSCRIBE消息，消息头域中使用Event头域描述订阅事件，消息体中携带订阅的详细参数，Expire头域值为0;
- Android国标接入终端收到订阅消息后,向国标服务平台发送200 OK响应,取消向国标服务平台发送实时位置通知消息，取消订阅成功的话，也会发一个最终的NOTIFY给国标服务端；
- 需要注意的是：Android国标接入终端收到SUBSCRIBE请求后，会检查SUBSCRIBE请求中"Expires"值的大小，当且仅当这个值大于0且小于1小时，并且小于Notifier配置的最小值时，Notifier可能会返回一个"423 Interval too small"错误，并包含一个""Min-Expires" 头域；
- Android国标接入端发送的NOTIFY请求超时的话，应该移除这个订阅；
- 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：
public void ntsOnDevicePositionRequest(String deviceId, int interval) {
handler.postDelayed(new Runnable() {
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，感兴趣的开发者，可酌情参考。
