要求
- 源设备向目标设备发送信息查询命令,目标设备将结果通过查询应答命令返回给源设备;
- 设备信息查询命令包括:
- 设备目录
- 设备信息
- 设备状态信息
- 设备配置
- 预置位、看守位
- 巡航轨迹列表
- 巡航轨迹
- PTZ精准状态
- 存储卡状态等
- 信息查询的范围:本地SIP监控域、跨SIP监控域;
- 网络设备信息查询命令均采用MESSAGE方法;
- 目录查询应答命令支持多响应消息传输;
- 源设备:
- SIP客户端
- 网关或联网系统
- 目标设备:
- SIP设备端
- 网关或联网系统
流程
具体流程:
- 源设备向SIP服务器发送设备查询命令;
- SIP服务器收到命令,返回200 OK;
- SIP服务器向目标设备转发设备查询命令;
- 目标设备收到命令,返回200 OK;
- 目标设备向SIP服务器发送设备查询响应命令;
- SIP服务器收到命令,返回200 OK;
- SIP服务器向源设备转发查询响应命令;
- 源设备收到命令,返回200 OK;
接口
请求
- 消息头Content-type头域:Content-type:Application/MANSCDP+xml;
- 设备信息查询命令采用MANSCDP协议格式;
- 收到MESSAGE消息后,立即返回200 OK,200 OK应答无消息体;
应答
- 消息头Content-type头域:Content-type:Application/MANSCDP+xml;
- 设备信息查询应答命令采用MANSCDP协议格式;
- 收到MESSAGE消息后,立即返回200 OK,200 OK应答无消息体;
测试
设备目录(Catalog)、设备信息(DeviceInfo)、设备状态(DeviceStatus)已自测通过。
设备目录
流程
- 添加国标id和本地ip,开始注册(界面端—>mysipsdk—>相机设备);
- 界面显示注册成功(mysipsdk—>界面端);
- 界面端发起请求设备目录(Catalog:界面端—>mysipsdk—>相机设备);
- 界面显示设备目录信息(相机设备—>mysipsdk—>界面端);
界面
注册成功:
获取设备目录:
xml分析
- 查询设备目录请求(107—>111)
<?xml version="1.0" encoding="UTF-8"?>
<Query>
<CmdType>Catalog</CmdType>
<SN>xx</SN>
<DeviceID>xxx</DeviceID>
</Query>
- 查询设备目录应答(111—>107)
SIP/2.0 200 OK
Via: SIP/2.0/UDP 192.168.0.107:5060;rport=5060;branch=
From: <sip:xxx@192.168.0.107:5060>;tag=
To: <sip:xxx@xx>;tag=
Call-ID:
CSeq: 24464 MESSAGE
User-Agent: IP Camera
Content-Length: 0
- 设备目录返回(111—>107)
<?xml version="1.0" encoding="GB2312"?>
<Response>
<CmdType>Catalog</CmdType>
<SN>xx</SN>
<DeviceID>xxx</DeviceID>
<SumNum>1</SumNum>
<DeviceList Num="1">
<Item>
<DeviceID>xxx</DeviceID>
<Name>Camera 01</Name>
<Manufacturer>Hikvision</Manufacturer>
<Model>IP Camera</Model>
<Owner>Owner</Owner>
<CivilCode>xx</CivilCode>
<Address>Address</Address>
<Parental>0</Parental>
<ParentID>xxx</ParentID>
<SafetyWay>0</SafetyWay>
<RegisterWay>1</RegisterWay>
<Secrecy>0</Secrecy>
<Status>ON</Status>
</Item>
</DeviceList>
</Response>
- 设备目录返回应答(107—>111)
SIP/2.0 200 OK
Via: SIP/2.0/UDP 192.168.0.107:5060;rport=5060;branch=
From: <sip:xxx@192.168.0.107:5060>;tag=
To: <sip:xxx@xx>;tag=
Call-ID:
CSeq: 24464 MESSAGE
User-Agent: IP Camera
Content-Length: 0
设备信息
流程
- 添加国标id和本地ip,开始注册(界面端—>mysipsdk—>相机设备);
- 界面显示注册成功(mysipsdk—>界面端);
- 界面端发起请求设备信息(DeviceInfo:界面端—>mysipsdk—>相机设备);
- 界面显示设备信息(相机设备—>mysipsdk—>界面端);
界面
获取设备信息:
xml分析
- 查询设备信息请求(107—>111)
<?xml version="1.0" encoding="UTF-8"?>
<Query>
<CmdType>DeviceInfo</CmdType>
<SN>xx</SN>
<DeviceID>xxx</DeviceID>
</Query>
- 查询设备信息应答(111—>107)
SIP/2.0 200 OK
Via: SIP/2.0/UDP 192.168.0.107:5060;rport=5060;branch=
From: <sip:xxx@192.168.0.107:5060>;tag=
To: <sip:xxx@xx>;tag=
Call-ID:
CSeq: xx MESSAGE
User-Agent: IP Camera
Content-Length: 0
- 设备信息返回(111—>107)
<?xml version="1.0" encoding="GB2312"?>
<Response>
<CmdType>DeviceInfo</CmdType>
<SN>xx</SN>
<DeviceID>xxx</DeviceID>
<Result>OK</Result>
<DeviceName>IP CAMERA</DeviceName>
<Manufacturer>Hikvision</Manufacturer>
<Model>xxx</Model>
<Firmware>xx</Firmware>
<Channel>1</Channel>
</Response>
- 设备信息返回应答(107—>111)
SIP/2.0 200 OK
Via: SIP/2.0/UDP 192.168.0.107:5060;rport=5060;branch=
From: <sip:xxx@192.168.0.107:5060>;tag=
To: <sip:xxx@xx>;tag=
Call-ID:
CSeq: xx MESSAGE
User-Agent: IP Camera
Content-Length: 0
设备状态
流程
- 添加国标id和本地ip,开始注册(界面端—>mysipsdk—>相机设备);
- 界面显示注册成功(mysipsdk—>界面端);
- 界面端发起请求设备状态(DeviceStatus:界面端—>mysipsdk—>相机设备);
- 界面显示设备状态(相机设备—>mysipsdk—>界面端);
界面
xml分析
- 查询设备状态请求(107—>111)
MESSAGE sip:xxx@192.168.0.111:5060 SIP/2.0
Via: SIP/2.0/UDP 192.168.0.107:5060;rport;branch=
Max-Forwards: 70
From: <sip:xxx@192.168.0.107:5060>;tag=
To: <sip:xxx@xx>
Contact: <sip:xxx@192.168.0.107:5060>
Call-ID:
CSeq: 26500 MESSAGE
Content-Type: Application/MANSCDP+xml
Content-Length: 145
<?xml version="1.0" encoding="UTF-8"?>
<Query>
<CmdType>DeviceStatus</CmdType>
<SN>xxx</SN>
<DeviceID>xxx</DeviceID>
</Query>
- 查询设备状态应答(111—>107)
SIP/2.0 200 OK
Via: SIP/2.0/UDP 192.168.0.107:5060;rport=5060;branch=
From: <sip:xxx@192.168.0.107:5060>;tag=
To: <sip:xxx@xx>;tag=
Call-ID:
CSeq: 26500 MESSAGE
User-Agent: IP Camera
Content-Length: 0
- 设备状态返回(111—>107)
MESSAGE sip:xxx@xx SIP/2.0
Via: SIP/2.0/UDP 192.168.0.111:5060;rport;branch=
From: <sip:xxx@xx>;tag=
To: <sip:xxx@xx>
Call-ID:
CSeq: 20 MESSAGE
Content-Type: Application/MANSCDP+xml
Max-Forwards: 70
User-Agent: IP Camera
Content-Length: 339
<?xml version="1.0" encoding="GB2312"?>
<Response>
<CmdType>DeviceStatus</CmdType>
<SN>xx</SN>
<DeviceID>xxx</DeviceID>
<Result>OK</Result>
<Online>ONLINE</Online>
<Status>OK</Status>
<DeviceTime>2023-09-15T21:30:15</DeviceTime>
<Alarmstatus Num="0">
</Alarmstatus>
<Encode>ON</Encode>
<Record>OFF</Record>
</Response>
- 设备状态返回应答(107—>111)
SIP/2.0 200 OK
Via: SIP/2.0/UDP 192.168.0.111:5060;rport=5060;received=192.168.0.111;branch=
Call-ID:
From: <sip:xxx@xx>;tag=
To: <sip:xxx@xx>;tag=
CSeq: 20 MESSAGE
Content-Length: 0
设备树展示
- 在注册之前添加”组织1“;
- 注册并获取设备目录和设备信息成功后,在设备/通道树展示区展示设备和通道信息;
- 双击通道可进行视频预览;