Android平台GB28181设备接入端预置位查询（PresetQuery）探讨和技术实现

之前blog介绍了GB28181云台控制（PTZCmd）相关，本文主要是介绍下GB28181预置位查询。

预置位这块，在处理带云台的设备非常必要，我们主要是做Android平台的GB28181的设备接入端，也可以转发RTSP摄像头接入到国标平台，如果摄像头带云台，这块的处理就非常必要。

废话不多说，我们先看看GB/T28181规范里面，是怎么说的：

请求命令消息体

Message消息头 Content-type头域为 Content-type:Application/MANSCDP+xml。

设备预置位查询命令采用 MANSCDP协议格式定义,详细描述见 A.2.4预置位查询请求。 用设备预置位查询请求命令应包括命令类型(CmdType)、命令序列号(SN)、设备编码(DeviceID),采 IETFRFC3428的 Message方法的消息体携带。 相关设备在收到 Message消息后,应立即返回200OK 应答,200OK 应答均无消息体。

应答命令消息体

Message消息头 Content-type头域为 Content-type:Application/MANSCDP+xml。 设备预置位查询应答命令采用 MANSCDP 协议格式定义,详细描述见 A.2.6 设备预置位查询  应答。 设备预置位查询应答命令应包括目标设备编码(DeviceID)、命令类型(CmdType)、命令序列号  (SN)、设备预置位列表(PresetList)等,设备预置位列表应包括预置位编码(PresetID)、预置位名称(PresetName),采用 Message方法的消息体携带。  相关设备在收到 Message消息后,应立即返回200OK 应答，200OK 应答均无消息体。

查询命令

国标平台侧发来RresetQuery：

MESSAGE sip:34020000001380000001@3402000000 SIP/2.0Via: SIP/2.0/UDP 192.168.0.103:15060;rport;branch=z9hG4bK86811279From: <sip:34020000002000000001@3402000000>;tag=373811279To: <sip:34020000001380000001@3402000000>Call-ID: 633811279CSeq: 707 MESSAGEContent-Type: Application/MANSCDP+xmlMax-Forwards: 70User-Agent: GBS AgentContent-Length: 161<?xml version="1.0" encoding="GB2312"?><Query> <CmdType>PresetQuery</CmdType> <SN>777811279</SN> <DeviceID>34020000001380000001</DeviceID></Query>

Android平台GB28181接入端先回个200 OK：

SIP/2.0 200 OKCSeq: 707 MESSAGECall-ID: 633811279From: <sip:34020000002000000001@3402000000>;tag=373811279To: <sip:34020000001380000001@3402000000>Via: SIP/2.0/UDP 192.168.0.103:15060;rport=15060;branch=z9hG4bK86811279;received=192.168.0.103Content-Length: 0

Android平台GB28181接入端准备发设备预置位查询应答：

大牛直播SDK针对PresetQuery处理如下：

@Override public void ntsOnDevicePresetQueryCommand(String fromUserName, String fromUserNameAtDomain, String sn, String deviceId) { handler_.postDelayed(new Runnable() { @Override public void run() { Log.i(TAG, "DaniuSDK ntsOnDevicePresetQueryCommand from_user_name:" + from_user_name_ + ", sn:" + sn_ + ", device_id:" + device_id_); List<com.gb.ntsignalling.PresetItem> preset_list = new LinkedList<>(); preset_list.add(new com.gb.ntsignalling.PresetItem("1", "Android PreSet1")); preset_list.add(new com.gb.ntsignalling.PresetItem("2", "Android PreSet2")); if (gb28181_agent_ != null ) gb28181_agent_.respondDevicePresetQueryCommand(this.from_user_name_, this.from_user_name_at_domain_, this.sn_, this.device_id_, preset_list); } private String from_user_name_; private String from_user_name_at_domain_; private String sn_; private String device_id_; public Runnable set(String from_user_name, String from_user_name_at_domain,String sn, String device_id) { this.from_user_name_ = from_user_name; this.from_user_name_at_domain_ = from_user_name_at_domain; this.sn_ = sn; this.device_id_ = device_id; return this; } }.set(fromUserName, fromUserNameAtDomain, sn, deviceId),0); }

对应的MESSAGE信令：

MESSAGE sip:34020000002000000001@3402000000 SIP/2.0Call-ID: 1b5a50faff369b89c45a5f212a1d45ee@192.168.0.101CSeq: 1524938865 MESSAGEFrom: <sip:31011500991320000069@3402000000>;tag=15640a33To: <sip:34020000002000000001@3402000000>Via: SIP/2.0/UDP 192.168.0.101:5060;rport;branch=z9hG4bK-393533-93979b9fc4dcf1edee6742c861522fb4Max-Forwards: 70User-Agent: NT GB UserAgent V1.9-20221027Content-Type: Application/MANSCDP+xmlContent-Length: 364<?xml version="1.0" encoding="GB2312"?><Response><CmdType>PresetQuery</CmdType><SN>777811279</SN><DeviceID>34020000001380000001</DeviceID><PresetList Num="2"><Item><PresetID>1</PresetID><PresetName>Android PreSet1</PresetName></Item><Item><PresetID>2</PresetID><PresetName>Android PreSet2</PresetName></Item></PresetList></Response>

国标平台侧回个200 OK：

SIP/2.0 200 OKVia: SIP/2.0/UDP 192.168.0.101:5060;rport=5060;received=192.168.0.101;branch=z9hG4bK-393533-93979b9fc4dcf1edee6742c861522fb4From: <sip:31011500991320000069@3402000000>;tag=15640a33To: <sip:34020000002000000001@3402000000>;tag=578811338CSeq: 1524938865 MESSAGECall-ID: 1b5a50faff369b89c45a5f212a1d45ee@192.168.0.101User-Agent: GBS AgentContent-Length: 0

国标平台侧拿到预置位信息后，可以针对预置位进行设置、调用或删除，GB/T28181-2016技术规范书上对应的预置位指令如下：

我们以设置预置位为例：

国标平台侧发来设置指令：

MESSAGE sip:34020000001380000001@3402000000 SIP/2.0 Via: SIP/2.0/UDP 192.168.0.103:15060;rport=15060;branch=z9hG4bK615818572;received=192.168.0.103 From: <sip:34020000002000000001@3402000000>;tag=696818572 To: <sip:34020000001380000001@3402000000> Call-ID: 578818572 CSeq: 709 MESSAGE Content-Type: Application/MANSCDP+xml Max-Forwards: 70 User-Agent: GBS Agent Content-Length: 267 <?xml version="1.0" encoding="GB2312"?> <Control> <CmdType>DeviceControl</CmdType> <SN>347818572</SN> <DeviceID>34020000001380000001</DeviceID> <PTZCmd>A50F018100010037</PTZCmd> <Info> <ControlPriority>5</ControlPriority> </Info> </Control>

Android平台GB28181设备接入端处理如下：

@Override public void ntsOnDeviceControlPTZCmd(String deviceId, String typeValue) { handler_.postDelayed(new Runnable() { @Override public void run() { Log.i(TAG, "DaniuSDK ntsOnDeviceControlPTZCmd device_id:" + device_id_ + " PTZType:" + ptz_type_); if (null == ptz_type_) return; ptz_type_ = ptz_type_.trim(); if (ptz_type_.length() != 16) return; int instruction = hexStringToInt(ptz_type_.substring(6, 8)); int combination_code2 = hexStringToInt(ptz_type_.substring(12, 14)); //Android平台GB28181设备接入端，针对性的解析处理即可，这里不再赘述 private String device_id_; private String ptz_type_; public Runnable set(String device_id, String ptz_type) { this.device_id_ = device_id; this.ptz_type_ = ptz_type; return this; } }.set(deviceId, typeValue),0); }

预置位调用、删除也是上述类似处理。

总结

Android平台GB28181设备接入端，特别是针对RTSP转GB28181的场景下，如摄像头带云台，预置位的查询、调用设置可酌情考虑添加。当然，单纯地Android平台GB28181设备接入端，也可以针对预置位这块，做技术层面的扩展，通过技术拉通，让设备测接入端更灵活，更能满足客制化需求。