之前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.0
Via: SIP/2.0/UDP 192.168.0.103:15060;rport;branch=z9hG4bK86811279
From: <sip:34020000002000000001@3402000000>;tag=373811279
To: <sip:34020000001380000001@3402000000>
Call-ID: 633811279
CSeq: 707 MESSAGE
Content-Type: Application/MANSCDP+xml
Max-Forwards: 70
User-Agent: GBS Agent
Content-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 OK
CSeq: 707 MESSAGE
Call-ID: 633811279
From: <sip:34020000002000000001@3402000000>;tag=373811279
To: <sip:34020000001380000001@3402000000>
Via: SIP/2.0/UDP 192.168.0.103:15060;rport=15060;branch=z9hG4bK86811279;received=192.168.0.103
Content-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.0
Call-ID: [email protected]
CSeq: 1524938865 MESSAGE
From: <sip:31011500991320000069@3402000000>;tag=15640a33
To: <sip:34020000002000000001@3402000000>
Via: SIP/2.0/UDP 192.168.0.101:5060;rport;branch=z9hG4bK-393533-93979b9fc4dcf1edee6742c861522fb4
Max-Forwards: 70
User-Agent: NT GB UserAgent V1.9-20221027
Content-Type: Application/MANSCDP+xml
Content-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 OK
Via: SIP/2.0/UDP 192.168.0.101:5060;rport=5060;received=192.168.0.101;branch=z9hG4bK-393533-93979b9fc4dcf1edee6742c861522fb4
From: <sip:31011500991320000069@3402000000>;tag=15640a33
To: <sip:34020000002000000001@3402000000>;tag=578811338
CSeq: 1524938865 MESSAGE
Call-ID: [email protected]
User-Agent: GBS Agent
Content-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设备接入端,也可以针对预置位这块,做技术层面的扩展,通过技术拉通,让设备测接入端更灵活,更能满足客制化需求。