[网络协议]GB28181 安卓移动设备位置上报实现(订阅和通知实现)

GB28181中事件订阅和通知机制是基于RFC3265 中的SIP扩展方法SUBSCRIBE和NOTIFY实现的。代码实现之前，先了解下相关协议.

这里先简单说明下RFC3265:

1.SUBSCRIBE请求中应该包含"Expires“头, 快到期的时候，需要在重新发送SUBSCRIBE刷新订阅有效期（有效期单位是秒）。

2.SUBSCRIBE 2xx响应中也必须包含"Expires”，这个值可以比请求中的小，但不能比它大。

3.SUBSCRIBE请求中"Expires“为0表示取消订阅.

4.SUBSCRIBE请求必须包含"Event"头，对于GB28181来说，移动设备位置订阅这个值是"presence", 也可能包含一个"id"参数，这个"id"参数仅在一个Dialog范围内有效(Dialog概念请参考RFC3261), GB28181中域间目录订阅通就有"id“参数，例如:

Event:Catalog;id=3177

移动设备位置订阅：

Event:presence

5.SUBSCRIBE 请求可能会创建Dialog(INVITE也可能创建Dialog), 订阅被Notifier接受的话要响应一个2xx最终响应(SIP中临时响应是1xx), 如果收到非2xx的最终响应，表示没有订阅成功或相应的Dialog已经被创建，并且没有后续的NOTIFY消息被发送。收到489 Bad Event 表示订阅事件不能被Notifier理解。如果SUBSCRIBE 请求是一个刷新请求，收到481响应表示订阅会话已经被终止。还有一点要注意，使用UDP传输SIP消息时，NOTIFY messages可能会比SUBSCRIBE 200 response先到达，实现中要处理好这一点。

6.取消订阅只要"Expires“头设置为0即可，要注意的是取消订阅成功的话，也会发一个最终的NOTIFY message.

7,Notifier会检查SUBSCRIBE请求中"Expires"值是不是太小，当且仅当这个值大于0且小于1小时，并且小于Notifier配置的最小值时，Notifier可能会返回一个"423 Interval too ?small"错误，并包含一个""Min-Expires" 头域。

8.发送SUBSCRIBE 2xx响应后，要立即发送一个NOTIFY message.

9.前面已经提过订阅到期之前，需要在同一个Dialog中发送刷新SUBSCRIBE请求，需要包含"Expires"头，值可以和上一次的不一样，如果这个值太小，Notifier应该响应423("423 Subscription Too Brief"), 如果订阅到期之前没有收到刷新请求，这个订阅需要被移除，移除时需要发送一个NOTIFY message，消息要包含"Subscription-State",具体格式如下：

Subscription-State:terminated;reason=timeout

相应的Dialog也要终止.

10.NOTIFY请求也要有"Event"头，这个头必须和对应的SUBSCRIBE请求中的"Event"头匹配，如果有"id"参数的话，"id"参数也要匹配.

11.NOTIFY?request 超时的话，notifier应该移除这个订阅.

12.NOTIFY?request响应非2xx的话，响应没有"Retry-After"头，并且也没有其他暗示让重新发送request, notifier必须移除这个订阅.

13.NOTIFY request收到一个481响应,?notifier必须移除这个订阅.

14.NOTIFY request必须包含"Subscription-State"头，有三个可选的值:"active", "pending", "terminated". 当值是"active"或"pending"时，应该也包含一个”expires“参数，显示订阅剩余时间，例如：

Subscription-State:active;expires=120
Subscription-State:pending;expires=70

15.对于NOTIFY request中?"Subscription-State" 头参数,RFC3265 3.2.4节中有这么一句：

The "retry-after" and "reason" parameters have no semantics for "active".

The "retry-after" and "reason" parameters have no semantics for "pending".

不过我在GB28181事件通知消息示范中(可以看下GB28181-2016 J.21)看到类似如下示例：

Subscription-State:active;expires=xx;retry-after=yy

多了个"retry-after"参数，不过应该不影响实际应用.

16.多个订阅能关联同一个Dialog上, 多个订阅也可以存在于INVITE创建的Dialog，如果订阅销毁后，没有其他应用状态和Dialog关联，那Dialog也终止.反过来也是,这里要注意一点是使用INVITE创建的Dialog不一定会在收到BYE时终止;多个订阅关联一个Dialog,要等到所有关联订阅销毁后，Dialog才终止.

GB28181事件订阅和通知规定简单说明:

1.事件源接受事件订阅，并发通知。事件观察者订阅事件，接受通知。事件源可以是安卓移动设备等。事件观察者可以是SIP服务器等。事件包括移动设备位置通知等事件。

2.观察者发SUBSCRIBE请求，返回200OK 表示订阅成功，按文档说明返回400应该是订阅没成功吧，或者在刷新订阅的时候，返回400表示订阅会话结束. 关于返回失败状态码问题, RFC3265也有讨论，具体实现还是看实际系统吧。

3.SUBSCRIBE 请求消息Content-type:Application/MANSCDP+xml.

4.移动设备位置上报事件的SUBSCRIBE请求消息体采用 MANSCDP协议格式, 注意这个事件的响应消息没有消息体,而报警事件响应消息有消息体的。

5.事件源接受事件订阅后,在事件触发后立即通知观察者（RFC3265是说事件源发送SUBSCRIBE 2xx响应后，要立即发送一个NOTIFY消息，这里我建议立即发送NOTIFY消息，不要等到事件触发后再发送，有一个原因就是订阅者收到NOTIFY请求（如果还没有收到SUBSCRIBE 2xx)就可以创建一个新的Dialog和Subscription).

6.NOTIFY 请求消息Content-type:Application/MANSCDP+xml.

7,移动设备位置通知的NOTIFY 请求消息体采用 MANSCDP协议格式定义,注意响应没有消息体.

8.移动设备位置上报 SUBSCRIBE 请求示例(这个是我补充的,GB28181中没有给出位置上报相关消息示例)：

请求头片段:

? ? CSeq:3 SUBSCRIBE
?? ?Expires:600
? ? Event:presence
? ? Content-type:Application/MANSCDP+XML

? ? 请求体XML：

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

9.移动设备位置上报 NOTIFY 请求示例(这个是我补充的,GB28181中没有给出位置上报相关消息示例)：

请求头片段:

? ? CSeq:71 NOTIFY
? ? Subscription-State:active;expires=301
? ? Event:presence
? ? Content-type:Application/MANSCDP+XML

? ?请求体XML:

<?xml version="1.0" encoding="GB2312" ?>
<Notify>
<CmdType>MobilePosition</CmdType>
<SN>71339</SN>
<TargetID>31011500991320000177</TargetID>
<Time>2022-03-08T11:21:39</Time>
<Longitude>143.507222</Longitude>
<Latitude>33.99011311</Latitude>
</Notify>

10. GB28181 A.2.5-e?中定义:

<! --海拔高度,单位:m(可选)-->
<element name="Altitude"? type="tg:deviceIDType" />

type可能是"double", ?定义可能是：

<element name="Altitude"? type="double" />

具体以实际系统为准吧.

? GB28181位置上报订阅通知相关说明到此为止，接下来是具体代码实现了，毕竟文字说明并不适合描述代码细节，代码才是干货.

移动位置订阅，我安卓上的实现接口如下：

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);
    }
}

public interface GBSIPAgent {
   // 其他相关接口
   // ..........

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


public interface GBSIPAgentListener
{
  
   // 其他相关接口
   // ..........

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

}

? ? ?demo 代码如下:

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);
}


  @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);
    }

?从协议到代码实现，还是要花些精力的，?更多问题可以联系qq:?1130758427,? ?github