视频监控cs架构通信协议.doc

CS架构通信协议第1页共25页CS架构通信协议PE90CSP/102012618视频机柜API接口CS架构通信协议第2页共25页概述________________________________________________________________3报文封装____________________________________________________________3NOP________________________________________________________________3LOGIN_______________________________________________________________4DEVICECONFIG________________________________________________________5SCHEMECONFIG________________________________________________________6CALLSCHEME__________________________________________________________7ADDSCHEME__________________________________________________________8UPDATESCHEME_______________________________________________________9HARDUPDATE________________________________________________________10GETROUTEMAP_______________________________________________________11CREATEWINDOW_UI___________________________________________________12CREATEWINDOW______________________________________________________13DESTROYWINDOW______________________________________________________15SETWINDOWRECT______________________________________________________15SETWINDOWALPHA____________________________________________________16SETWINDOWSOURCE_UI________________________________________________17SETWINDOWSOURCE____________________________________________________18SELECTWINDOWSOURCE_________________________________________________19BRINGTOFRONT_______________________________________________________20SENDTOBACK________________________________________________________21PTZCONTROL_________________________________________________________21PRESETCONTROL_______________________________________________________22VIDEOEFFECT_________________________________________________________23CS架构通信协议第3页共25页概述以TCPC/S模式通信，服务器端口指定为10200，客户机端口由机器自动分配。客户机连上服务器后，双方以2种方式传递消息1．命令/响应由客户端主动发起，服务器需应答。DIRECTION“CALL“表示命令消息，DIRECTION“RETURN“表示响应消息。2．通知服务器或客户机均可主动发送通知消息，对方无需应答。通知消息不指定DIRECTION属性。注CS之间传递的消息封装在报文中，报文格式借鉴自HTTP协议。报文封装MESSAGEPE90CSP/10\R\NCONTENTLENGTH12345\R\N\R\N报文由报文头和报文内容两部分组成。报文头一共3行，以状态行开始，之后是长度行，以空行结束。报文内容即为传递的消息，XML语法结构注本文档描述报文时使用到的一些符号表示空格符，ASCII码0X20\R\N表示回车换行，ASCII码0X0D0X0ANOP无操作类型通知适用范围CS架构通信协议第4页共25页CSSC格式KEEPALIVE参数无流程流程1S发送消息C检查参数刷新对方活动时间流程2C发送消息S检查参数刷新对方活动时间说明服务器或客户端若长时间未发送消息，可以发送NOP消息保活连接。LOGIN登录类型命令/响应适用范围CSCALLSCRETURN格式0CS架构通信协议第5页共25页ADMIN12345200OK参数USERID用户编号，““表示未提供USERNAME用户名，““表示未提供PASSWORD密码CODE返回码DESC返回信息描述流程C发送CALL消息S检查参数若用户名/密码核对错误或用户被禁用，返回“401UNAUTHORIZED“若登录成功，返回“200OK“C等待RETURN消息（“200OK“或其他）说明若服务器验证用户编号/用户名/密码无误，则返回“200OK“，并依次发出下列通知消息针对设备配置，发送DEVICECONFIG针对方案配置，发送SCHEMECONFIG遍历视频参数表针对每组视频参数，发送VIDEOEFFECT遍历窗口表针对每个窗口，发送CREATEWINDOWDEVICECONFIGCS架构通信协议第6页共25页设备配置类型通知适用范围CSSC格式AABBCCDDEEFF参数DATA二进制数据的16进制编码流程流程1S发送消息C检查参数保存到内存流程2C发送消息S检查参数保存到内存保存到数据库通知其他客户端DEVICECONFIG说明无SCHEMECONFIGCS架构通信协议第7页共25页方案配置类型通知适用范围CSSC格式AABBCCDDEEFF参数DATA二进制数据的16进制编码流程流程1S发送消息C检查参数保存到内存流程2C发送消息S检查参数保存到内存保存到数据库通知其他客户端SCHEMECONFIG说明无CALLSCHEME方案调用CS架构通信协议第8页共25页类型通知适用范围CS格式01参数PLANEID位面编号SCHEMEID方案编号流程C发送消息S检查参数删除所有窗口，并按方案要求新建窗口刷新硬件广播DESTROYWINDOW0消息针对所有新建窗口