对接熊迈SDK工作记录之后台管理开发(开发文档和后台集成)

通过完成前面对接熊迈SDK工作记录之集成准备对接熊迈SDK工作记录之实时视频和云录像功能集成,那么接下来就是对接IPTV管理后台,实现监控设备和IPTV机顶盒统一管理。

再小的项目也不能少了开发文档,那么开发文档最不能少的当然是数据库设计通讯协议。那么简单的项目我一般都会留如以下文档,方便自己对项目的更新动向有长久的记忆,对进行二次开发的同事也少一点口角之争。

TVEye开发文档

说明:

  1. 实现电视端多屏监控效果,可使用遥控器上下键进行切换显示摄像头;
  2. 实现电视端云录像播放;
  3. 实现与IPTV后台统一管理,对监控进行区域分类管理(VIP表),设备管理等;
  4. 实现监控用户和IPTV用户统一认证,监控功能无需再次认证;

更新说明:

操作员时间内容备注
吴明辉20181128 初始版本
    


数据库设计

表名:my_table
属性类型是否为空备注
idint 主键
namevarchar 名字
、、、  、、、
    

通讯协议

概述

本协议机顶盒与服务器的通讯协议,通讯过程中需要严格按照协议内容进行通信,通讯是按照Json字符串进行传输,并严格注意大小写,大小写敏感,文档中,红色的字需要特别注意。

规范

通讯路径:http://127.0.0.1:880/webapp/mydata?typestr=命令字

              (本路径是测试路径,正式路径需要部署后生成)

通讯方式:POST

通讯内容:Json字符串

区域分类列表(vip)

【功能描述】

请求vip分类列表,如对各个村子、小区进行分类,用于第一次用户登录时区域选择。

【命 令 字】

viptype

【提交数据】

【返回数据】

{

"code": "返回码0成功1失败",

  "msg": "消息内容",

"nfo": [

{

"Id": "vip分类 区域",

"Name": "vip名称 区域名"

},{

"Id": "vip分类 区域",

"Name": "vip名称 区域名"

}

]

}

 

修改用户区域

【功能描述】

第一次登录时根据用户信息进行设置用户区域,如果用户不填写,可由后台管理员进行设置,也可作为后期用户更换地址时更改区域设备。

【命 令 字】

updatedevinfo

【提交数据】

{

"userName": "用户名(必填项)",

"userAddr": "用户详细地址和电话(必填项)",

"vipId": "vip分类 区域(必填项)",

"vipName": "vip名称 区域名"

}

【返回数据】

{

"code": "返回码0成功1失败",

  "msg": "消息内容"

}

请求设备列表

【功能描述】

请求设备列表。

【命 令 字】

info

【提交数据】

{

"mac": "机器唯一编码(必填项)"

}

【返回数据】

{

"code": "返回码0成功1失败",

  "msg": "消息内容",

"Info": [

{

"Name": "设备名称",

"Sn": "设备序列号",

"Name": "设备登录名称",

"Psw": "设备登录密码",

"Port": "端口号",

"Ip": "设备ip"

},{

"Name": "设备名称",

"Sn": "设备序列号",

"Name": "设备登录名称",

"Psw": "设备登录密码",

"Port": "端口号",

"Ip": "设备ip"

}

]

}

SSH(struts+spring+hibernate)框架 搭建后台

习惯性的MVC模式,首先构建Model和View最后通过Controller来进行控制,简单说Model就是与数据库对应的对象、View就是(视图)显示数据(数据库记录)、Controller(控制器)处理输入(写入数据库记录)。

实现起来也就是一个界面罢了,如下图

那么最后再来处理一下数据接口(开发文档中的通讯协议模块),实际上这个模块应该属于Controller的范畴了,只不过目的性有点不一样,这个是根据客户端(apk)的需求来处理数据和响应apk的请求操作罢了,看下面方法。

    @RequestMapping(value = "data", method = RequestMethod.POST)
	@ResponseBody
	@SuppressWarnings({ "unchecked", "unused", "null" })
	public Map<String, Object> getData(String typestr, HttpServletRequest req, HttpServletResponse rsp) throws Exception {
        //在这里处理DataAction
    }

没错就是用map、HashMap来处理的,这里就不多说了,处理完把map数据return回去就好了。

THE END 谢谢查看

编辑:吴明辉

  • 2
    点赞
  • 2
    收藏
    觉得还不错? 一键收藏
  • 打赏
    打赏
  • 0
    评论
属性: Language 语言版本. English—英文,SimpChinese—简体中文, TradChinese—繁体中文 方法: 1.注册 1.1注册 long Login (LPCTSTR lpServerIp,long lPort, LPCTSTR lpUserName, LPCTSTR lpPassword) 功能:登陆到硬盘录像机 参数说明: lpServerIP:硬盘录像机的IP地址或者域名 lPort:硬盘录像机端口号 lpUserName:登陆的用户名 lpPassword:登陆的密码 返回值:lUserID提供给其他接口使用。-1表示注册失败 2.注销 2.1 注销 BOOL Logout() 功能:从硬盘录像机上注销某个用户 返回值:TRUE表示成功,FALSE表示失败。 3.预览 3.1开始单通道预览 BOOL StartChannelRealPlay(long nChannel,long lProtocolType, long lStreamType); 功能:开始某个通道的预览 参数说明: nChannelNum:播放通道号, 0 – 代表通道1,1 – 代表通道2 lProtocolType:协议类型,0 – TCP, 1 – UDP,目前只支持TCP lStreamType: 码流类型,0 表示主码流, 1 表示子码流 返回值:TRUE表示成功,FALSE表示失败。 3.2开始全通道预览 BOOL StartPlayAll(); 功能:开始全部通道的预览 返回值:TRUE表示成功,FALSE表示失败。 3.3停止单通道预览 BOOL StopChannelRealPlay(long nChannel) 功能:停止某个通道的预览 参数说明: nChannel:通道号,0 – 代表通道1,1- 代表通道2 返回值:TRUE表示成功,FALSE表示失败。 3.4停止所有通道的预览 BOOL StopRealPlayAll() 功能:停止所有已经开启的预览 返回值:TRUE表示成功,FALSE表示失败。 4.声音控制 4.1 打开声音 BOOL OpenChannelSound(long nChannel ,long lSoundMode) 功能:打开声音,需要预览开启 参数说明: nChannel:通道号,0 – 代表通道1,1- 代表通道2 返回值:TRUE表示成功,FALSE表示失败。 lSoundMode: 打开声音模式。 1 – 独占模式 , 2 – 共享模式, 目前只支持共享模式(没有考虑这个值) 4.2 关闭声音 BOOL CloseChannelSound(long nChannel, long lSoundMode) 功能:关闭声音,需要预览开启 参数说明: nChannel:通道号,0 – 代表通道1,1- 代表通道2 返回值:TRUE表示成功,FALSE表示失败。 lSoundMode: 打开声音模式。 1 – 独占模式 , 2 – 共享模式, 目前只支持共享模式(没有考虑这个值) 5.对讲 5.1开始对讲 BOOL StartTalk() 功能:开始对讲 返回值:TRUE表示成功,FALSE表示失败。 5.2停止对讲 BOOL StopTalk() 功能:停止对讲 返回值:TRUE表示成功,FALSE表示失败。 6.录像 6.1开始某个通道的录像 BOOL StartChannelRecord(long nChannel ,LPCTSTR lpSaveFile,long nType) 功能:对指定通道进行录像,预览打开才有效 参数说明: nChannel: 通道号,0 – 代表通道1,1- 代表通道2 lpSaveFile:保存录像的路径,(当设值为“”时:路径取配置文件路径,如果没有配置文件将用默认路径“C:\record”) nType:录像类型:0 – 带私有头h264;1 – 纯h264;2 – AVI;(目前只支持0和2两种情况;)(-1使用配置文件提供的设置类型) 返回值:TRUE表示成功,FALSE表示失败。 6.2开始全录像 BOOL StartRecordAllChannel(LPCTSTR lpSaveFile,long nType) 功能说明:对正在预览的所有通道进行录像,保存录像文件的路径由客户端页面配置 参数说明: lpSaveFile:保存录像的路径,(当设值为“”时:路径取配置文件路径,如果没有配置文件将用默认路径“C:\record”) nType:录像类型:0 – 带私有头h264;1 – 纯h264;2 – AVI;(目前只支持0和2两种情况;)(-1时使用配置文件提供的设置类型) 返回值:TRUE表示成功,FALSE表示失败。 6.3开始设备录像 StartRemoteRecord(long nChannel) 功能说明:开启设备端指定通道的录像 参数说明: nChannel: 通道号,0 – 代表通道1,1- 代表通道2 返回值:TRUE表示成功,FALSE表示失败。 6.4停止设备录像 StopRemoteRecord(long nChannel) 功能说明:停止设备端指定通道录像 参数说明: nChannel: 通道号,0 – 代表通道1,1- 代表通道2 返回值:TRUE表示成功,FALSE表示失败。 6.5停止指定通道录像 BOOL StopChannelRecord(long nChannel); 功能说明:停止指定通道的录像 参数说明: nChannel: 通道号,0 – 代表通道1,1- 代表通道2 返回值:TRUE表示成功,FALSE表示失败。 6.6停止所有录像 BOOL StopRecordAllChannel(); 功能说明:停止所有通道的录像 返回值:TRUE表示成功,FALSE表示失败。 7.窗口调整 7.1改变窗口数 BOOL ChangeShowWndNum(long nShowNum, BOOL bChange, long nSplit, long nPreview); 功能说明:调整窗口数 参数说明: nShowNum: 窗口数:例:1,4,9,16,25,36 bChange: 是否改变窗口,目前只有为ture函数才起作用 nSplit:无特殊需要推荐用0;0: 单画面;1: 1/2画面; 2: 1/4画面; nPreview:无特殊需要推荐用0;特殊设备需求。 返回值:TRUE表示成功,FALSE表示失败。 7.2最大化窗口 void Fullscreen(BOOL bFull) 功能说明:最大话显示窗口 参数说明: bFull:TRUE全屏,FALSE:退出全屏 8.抓图 BOOL BMPChannelCapturePicture(long nChannel ,LPCTSTR lpSaveFile); 功能:抓BMP图,在预览或者回放时才有效,路径由客户端页面设置 参数说明: lpSaveFile:保存录像的路径,(当设值为“”时:路径取配置文件路径,如果没有配置文件将用默认路径“C:\BMP”) 返回值:TRUE表示成功,FALSE表示失败。 9.云台控制 9.1 云台控制开始 BOOL PTZCtrlStart(long lChannle, long lCtrlType, long lSpeed) 功能:云台开始控制命令,在预览时才有效 参数说明: nChannel:通道号,0 – 代表通道1,1 – 代表通道2 lCtrlType:为云台动作:0 -- 云台向上,1 -- 云台向下,2 -- 云台向左,3 -- 云台向右, 4 - 云台左上, 5- 云台左下, 6- 云台右上, 7 - 云台右下, 8 -- 焦距拉远,9-- 焦距缩进, 10 -- 焦点远,11-- 焦点近, 12 -- 光圈大,13 -- 光圈小 lSpeed:云台速度,范围为1 – 8。 返回值:TRUE表示成功,FALSE表示失败。 9.2 云台控制停止 PTZCtrlStop(long nChannel, long lCtrlType, long lSpeed) 功能:云台停止控制命令,在预览时才有效 参数说明: nChannel:通道号,0 – 代表通道1,1 – 代表通道2 lCtrlType: 为云台动作:0 -- 云台向上,1 -- 云台向下,2 -- 云台向左,3 -- 云台向右, 4 - 云台左上, 5- 云台左下, 6- 云台右上, 7 - 云台右下, 8 -- 焦距拉远,9-- 焦距缩进, 10 -- 焦点远,11-- 焦点近, 12 -- 光圈大,13 -- 光圈小 lSpeed:云台速度,范围为1 –8。 返回值:TRUE表示成功,FALSE表示失败。 9.3 设置预置点 BOOL PTZCtrlSetPreset(long nChannel, long lPresetNumb,BOOL bAdd) 功能:设置云台预置位,需要预览 参数说明: nChannel:通道号,0 – 代表通道1,1 – 代表通道2 lPresetNumber:云台预置位号,最多支持128个。 bAdd:增或删,TRUE :增加预置点;FALSE:删除预置点 返回值:TRUE表示成功,FALSE表示失败。 9.4 调用预置点 BOOL PTZCtrlGotoPreset(long nChannel, long lPresetNumb) 功能:调用云台预置位,需要预览 参数说明: nChannel:通道号,0 – 代表通道1,1 – 代表通道2 lPresetNumber:云台预置位号,最多支持128个。 返回值:TRUE表示成功,FALSE表示失败。 9.5调用轮询 BOOL PTZCtrlTour(long nChannel, long lTourNumber, BOOL bStart); 功能:调用云台轮询,需要预览 参数说明: nChannel:通道号,0 – 代表通道1,1 – 代表通道2 lTourNumber:巡航线路 bStart:TURE:开始巡航,FALSE:停止巡航 返回值:TRUE表示成功,FALSE表示失败。 9.6巡航编辑 BOOL PTZEditTure(long lTureNumber); 功能:弹出巡航线路编辑框,对巡航线路进行增删改 参数说明: lTureNumber:巡航线路(1-255) 返回值:TRUE表示成功,FALSE表示失败。 10.色彩调节 10.1设置视频参数 BOOL SetColor(long nChannel, long lBrightValue, long lContrastValue, long lSaturationValue, long lHueValue) 功能:设置视频参数,需要预览 参数说明: nChannel: 通道号,0 – 代表通道1,1- 代表通道2 lBrightValue:亮度 ( 取值为 1 – 128 ) lContrastValue:对比度 ( 取值为 1- 128 ) lSaturationValue:饱和度 ( 取值为 1- 128 ) lHueValue:色调 ( 取值为 1 - 128 ) 返回值:TRUE表示成功,FALSE表示失败 10.2获取视频参数 BSTR GetColor(long nChannel) 功能:获取视频参数,需要预览 参数说明: nChannel: 通道号,0 – 代表通道1,1- 代表通道2 返回值:返回字符串,格式为:“亮度值,对比度值,饱和度值,色度值”(各值间用逗号隔开) 11.功能模块调用 11.1回放 BOOL ShowPlayBack(); 功能:显示回放相关对话框,需要先登入 对话框有各类录像的查询,回放,下载操作。 返回值:成功返回true,失败返回false 11.2日志 BOOL ShowLog(); 功能:显示日志对话框(报警日志,操作日志) 返回值:成功返回true,失败返回false 11.3设备配置 BOOL ShowDeviceConfig(); 功能:设备配置对话框,需要先登入 返回值:成功返回true,失败返回false 11.4客户端配置 BOOL ShowClientConfig(); 功能:客户端配置对话框,需要先登入 返回值:成功返回true,失败返回false 12.重启 BOOL RebootServer() 功能:重新启动硬盘录像机 返回值:TRUE表示成功,FALSE表示失败 13.翻译字符串 BSTR Translate(LPCTSTR str) 功能:翻译字符串,翻译文件中要有相应的翻译字符串 参数说明: str:要翻译的字符串 返回值:翻译后的字符串 14.获取所有通道名 BSTR GetChannelName() 功能:得到所有通道的名称 返回值:所有通道名连成一个字符串返回,ascII码9分隔通道号和通道名,ascII码16分隔通道与通道: Format("%d%c%s%c",通道号,9,通道名,16) 15.通过窗口获取通道号 Long GetCurChannel () 功能:获取选中窗口对应的通道号 返回值:-1–代表窗口未预览没有对应通道号,0 – 代表通道1,1- 代表通道2 事件: 1.RbuttonDown 右键按下触发事件 2.Click 左键按下触发事件 3.DblClick 双击左键触发事件 4.OpenMainStream (long nChannel) 某个通道主码流被打开触发事件 参数说明: nChannel:通道号,0 – 代表通道1,1- 代表通道2 5.OpenSubStream (long nChannel) 某个通道辅码流被打开触发 参数说明: nChannel:通道号,0 – 代表通道1,1- 代表通道2 6.CloseStream(long nChannel) 某个通道被关闭触发事件 参数说明: nChannel:通道号,0 – 代表通道1,1- 代表通道2 7.RecoverPlay(long lChannel, BOOL bSubStream) 打开上次退出时开着的通道触发事件 参数说明: lChannel:通道号 bSubStream:码流类型 8.DvrRecord(boolean bRecord) 打开或关闭设备录像触发事件 参数说明: bRecord:true - 打开;false - 关闭 9.AllChannelPlayCtrl(boolean bPlay, long lStreamType) 全通道播放事件 参数说明: bPlay:true - 打开;false - 关闭 lStreamType:0 – 主码流;1 – 辅码流(只有打开时才有效) 10.AllChannelRecordCtrl(boolean bRecord) 全通道录像事件 参数说明: bRecord:true - 打开;false - 关闭 11.SoundCtr(long nChannel ,boolean bOpen) 打开或关闭某个窗口声音时候触发事件 参数说明: nChannel:通道号,0 – 代表通道1,1- 代表通道2 bOpen: true - 打开;false - 关闭 12.ReName(long nChannel) 通道重命名时候触发事件 参数说明: nChannel:通道号,0 – 代表通道1,1- 代表通道2 13.ReBoot() 重启时候触发的事件
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

玉念聿辉

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付:¥1
获取中
扫码支付

您的余额不足,请更换扫码支付或充值

打赏作者

实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值