GIS平台连接WSBrowser视频服务器遥控台遥控协议
  1. 工作方式:

如果在WSBrowser软件设置中启用了控制台遥控服务,WSBrowser软件启动后会按设置的参数打开一个UDP端口并侦听。主控程序如果要遥控WSBrowser的功能,可按控制台遥控协议向该UDP端口发送遥控命令字符串,WSBrowser在接收到正确的遥控指令后立即执行并按协议规定的格式回传执行结果消息。

  1. 软件设置

WSBrowser软件设置对话盒中选择数据接口卡页,选择启用控制台遥控服务,同时设置可用的本地网络和端口用于打开接收命令的UDP端口。

  1. 控制台遥控协议

1. 遥控协议命令串是标准的ASCII码字符串,用UDP包封装。一个指令串一般由3个部分组成:
1-   CODE(命令码):
格式为CODE=命令码,比如:CODE=LOGON,该部分不区分大小写

  1. HANDLE(句柄):可选

句柄为任意整数,用于区分各条命令。WSBrowser在回传命令执行结果时也会将命令的句柄包含在回送消息内。该部分不区分大小写

  1. 命令参数字串:

由一个或多个参数组成,格式为:参数名=参数值,比如ACTION=OPEN 或
DEVNAME=SN(1234)  等等。参数名不区分大小写,但参数值是大小写相关的
有些命令没有参数字串部分。
命令字串的各个字段之间用逗号“,“分隔,下面以登录服务器指令举例:
CODE=LOGON,HANDLE=10,SERVER=60.29.250.90,PORT=3001,USERNAME=demo,
PASSWORD=1234

       2. WSBrowser执行命令后会向控制程序回送执行结果,其格式如下:
ECHO=命令字,HANDLE=命令句柄,ERROR=执行结果(0=成功)
举例说明:
控制主程序发送一个控制WSBrowser选择4画面分割显示方式的命令:
CODE=VIEWPORT, HANDLE=12, ACTION=LAYOUT, PLAN=1
WSBrowser执行后回送:
ECHO=VIEWPORT, HANDLE=12, ERROR=0
如果主程序发送的命令中没有包含HANDLE,则WSBrowser回送:
ECHO=VIEWPORT, HANDLE=N/A, ERROR=0
       3. 命令码解释:

              》LOGON  - 登录服务器,包含以下参数:
SERVER:           视频服务器IP地址
PORT:               视频服务器端口
USERNAME:     登录账户用户名
PASSWORD:     登录账户密码
例子:
code=logon, hande=1, server=60.29.250.90, port=3001,
username=demo, password=1234

              》LOGOUT  - 登出服务器,无参数
例子:
code=logout, handle=1

              》EXIT          - 关闭WSBrowser程序,无参数
例子:
code=exit, handle=1

              》VIEWPORT – 视频浏览控制,根据ACTION参数的不同,命令所包含的参数也不相同
ACTION=OPEN   :   在指定视频窗口中按所给设备名称显示该设备视频
参数:    INDEX 窗口索引,0~15对应1-16号窗口
DEVNAME 设备名称
DEVSN  设备序号
* DEVNAME和DEVSN任选一个就可以了
例子:   code=viewport, handle=1, action=open,
index=0, devname=SN1234                              
ACTION=CLOSE  :   关闭某个窗口的视频显示
参数:    INDEX 窗口索引,0~15对应第1-16号窗口
例子:   code=viewport, handle=1, action=close, index=0
ACTION=LAYOUT: 选择视频窗口分割排布形式
参数:    PLAN 方案索引,0~5对应6种窗口分割方式
例子:   code=viewport, handle=1, action=clayout,
plan=1

 

 

              》WINDOW – WSBrowser程序窗口控制,根据ACTION参数的不同,命令所包含的参数
也不相同
ACTION=SHOW :   显示WSBrowser程序窗口
参数:    无
例子:   code=window, handle=1, action=show
ACTION=HIDE    :   隐藏WSBrowser程序窗口
参数:    无
例子:   code=window, handle=1, action=hide
ACTION=MIN     :   最小化显示WSBrowser程序窗口
参数:    无
例子:   code=window, handle=1, action=min
ACTION=NORMAL :     WSBrowser程序窗口恢复普通显示格式
参数:    无
例子:   code=window, handle=1, action=normal
ACTION=SIZE     :   改变WSBrowser程序窗口的位置和尺寸
参数:    X/Y/W/H: 窗口左上角坐标及窗口宽/高
例子:   code=window, handle=1, action=size,
X=10, y=10, w=800, h=600
ACTION=LAYOUT: 改变WSBrowser程序窗口的布局
参数:    PLAN  0~3
0: 隐藏控制面板和事件日志列表
1 :  只显示控制面板
2: 只显示事件日志列表
3: 同时显示隐藏控制面板和事件日志列表
例子:   code=window, handle=1, action=layout, plan=0

 

  1. 操作流程示例

>1  登录服务器:
code=logon, handle=1, server=60.29.250.90, port=3001,username=demo,
password=1234
>2  改变窗口布局:
隐藏控制面板及事件日志列表:
code=window, handle=2, action=layout, plan=0
单窗口模式:
code=viewport, handle=3, action=layout, plan=0
移动程序主窗口并改变大小:
code=window, handle=4 action=size, x=10, y=100, w=600, h=500
>3  选择设备并显示在指定1号窗口里:
code=viewport, handle=5, action=open, index=0, devname=SN(MU728M_000)
>4 关闭1号显示窗口:
code=viewport, handle=6, action=close, index=0
>5 关闭WSBrowser程序:
code=exit, handle=7

 

使用TCPUDP调试工具手工发遥控命令,执行完第3步后的效果:

 

下载TCPTUP调试工具       下载说明文档       下载WSBrowser浏览器
 
index