一、登录海康开放平台下载web开发包,下载需要先登录海康账号,没有的需先注册一个。
海康开放平台web开发包下载地址:https://open.hikvision.com/download/5cda567cf47ae80dd41a54b3?type=10&id=4c945d18fa5f49638ce517ec32e24e24
二、将web开发包引入vue项目
下载后解压的包目录如下:
将把webs下的整个codebase文件夹和jquery-1.7.1.min.js都复制到public文件夹下,在index.html下引入对应文件,必须引入的只有jquery-1.7.1.min.js和webVideoCtrl.js
三、安装webs/codebase/WebComponentsKit.exe(可不做此操作)
四、运行解压包的nginx-1.10.2/start.bat,nginx启动端口可以自行修改;此处默认80,其中为了方便开发环境下测试,我把nginx-1.10.2放到项目中与public文件夹同级,因此nginx的root路径设置为../dist(项目打包路径,根据需要自行修改)
开发环境配置:在vue.config.js文件下配置nginx对应的反向代理,以下webSocketVideoCtrlProxy反向配置暂未配置成功,因此开发过程看不了视频,但可以进行登录等其他与websocket无关的接口的调用,想要成功拉流看视频得先打包部署,这个有弄懂的小伙伴可以告知一下
"/ISAPI": {target: "http://127.0.0.1/ISAPI", // 本地nginx服务changeOrigin: true,ws: true,pathRewrite: {"^/ISAPI": "/",},},"/SDK": {target: "http://127.0.0.1/SDK", // 本地nginx服务changeOrigin: true,ws: true,pathRewrite: {"^/SDK": "/",},},// webSocketVideoCtrlProxy反向配置暂未配置成功,当前配置在开发过程不需要打包就可实现除播放视频外的其他功能
注意:
1、本地开发过程nginx服务必须运行
2、开发过程运行项目地址必须是本地ip地址,不能用localhost那个,否则登录不成功
3、开发过程想要预览监控视频,需要先打包,然后访问部署后的项目路径,访问ip必须是服务器ip地址,不能用localhost或者127.0.0.1,否则登录不成功
五、初始化
注意:Dom元素ID必须是divPlugin,不然会出问题
初始化函数如下:
/** * 初始化 * @param {number} iWndowType 分屏类型:1 - 1*1,2 - 2*2,3 - 3*3,4 - 4*4,默认值1,单画面 * @param {number} width 插件的宽度(单位为”px”, 100%表示撑满插件容器) * @param {number} height 插件的高度(单位为”px”, 100%表示撑满插件容器) * @returns null */let init = (iWndowType, width, height) => {console.log("window.WebVideoCtrl-------", window.WebVideoCtrl, width, height);// 检查浏览器是否支持无插件if (!webVideoCtrl.I_SupportNoPlugin()) {Message.warning("当前浏览器不支持无插件预览监控视频,已自动切换成插件模式,如果还未安装插件请安装");// 检查插件是否已经安装const isInstall = webVideoCtrl.I_CheckPluginInstall();if (isInstall == -1) {Message.warning("您还未安装过插件,请先下载WebComponentsKit.exe双击安装!");return;}}// 初始化插件webVideoCtrl.I_InitPlugin(width, height, {szColorProperty:"plugin-background:ffffff; sub-background:00000; sub-border:D0DAE4; sub-border-select:409EFF", // 表示插件的背景颜色,插件子窗口的背景颜色,窗口边框的颜色,窗口边框选中后的颜色iWndowType,bNoPlugin: true, // 支持无插件cbSelWnd: (xmlDoc) => {let iWndIndex = parseInt($(xmlDoc)" /> {let szInfo = "当前放大的窗口编号:" + iWndIndex;if (!bFullScreen) {szInfo = "当前还原的窗口编号:" + iWndIndex;}console.log(szInfo);},cbInitPluginComplete: () => {// 嵌入播放插件webVideoCtrl.I_InsertOBJECTPlugin("divPlugin");console.log("初始化成功--------");resize();// 检查插件是否最新if (webVideoCtrl.I_CheckPluginVersion() == -1) {Message.warning("检测到新的插件版本,双击WebComponentsKit.exe升级!");return;}}, // 插件初始化完成回调,必须要定义});};
在实际使用过程,iWndowType不管怎么设置都不起效,只有在窗口resize后才起作用,所以在初始化成功后手动加了resize()给它调整大小,resize()函数封装在下面可以找到。
六、主要函数封装
调整大小
/** * 调整大小 */let resize = () => {webVideoCtrl.I_Resize($("#divPlugin").width(), $("#divPlugin").height());};
登录:初始化成功后调用,登录成功后根据需要获取通道信息,这里我获取的是数字通道的数据
/** * 登录 * @param {string} ip 设备的 IP 地址或者普通域名 * @param {number} prototocol http 协议,1 表示 http 协议 2 表示 https 协议 * @param {number} port 登录设备的 http/https 端口号,根据 iPrototocol 选择传入不同的端口 * @param {string} userName 登录用户名称 * @param {string} password 用户密码 */let login = (ip, prototocol, port, userName, password) => {webVideoCtrl.I_Login(ip, prototocol, port, userName, password, {async: true, // http 交互方式,true 表示异步,false 表示同步cgi: 1, // CGI 协议选择,1 表示 ISAPI,2 表示 PSIA,如果不传这个参数,会自动选择一种设备支持的协议.// 登录成功回调success: (xmlDoc) => {console.log("login success-----------", xmlDoc);// getAnalogChannelInfo(`${ip}_${port}`, {// async: true,// success: (analogChannelInfo) => {// let analogCameras = analysisAnalogChannelInfo(analogChannelInfo);// console.log(// "获取模拟通道----------",// analogChannelInfo,// analogCameras// );// },// error: (statusA, xmlDocA) => {// console.log("获取模拟通道 error-----------", statusA, xmlDocA);// },// });getDigitalChannelInfo(`${ip}_${port}`, {async: true,success: (digitalChannelInfo) => {let digitalCameras = analysisDigitalChannelInfo(digitalChannelInfo);console.log("获取数字通道----------",digitalChannelInfo,digitalCameras);},error: (statusD, xmlDocD) => {console.log("获取数字通道 error-----------", statusD, xmlDocD);},});// getZeroChannelInfo(`${ip}_${port}`, {// async: true,// success: (zeroChannelInfo) => {// let zeroCameras = analysisZeroChannelInfo(zeroChannelInfo);// console.log("获取零通道----------", zeroChannelInfo, zeroCameras);// },// error: (statusZ, xmlDocZ) => {// console.log("获取零通道 error-----------", statusZ, xmlDocZ);// },// });},// 失败函数回调error: () => {console.log("login error-----------");},});};
登出
/** * 登出 * @param {string} deviceIdentify 设备标识(IP_Port) * @returns成功返回 0,失败返回-1 */let logout = (deviceIdentify) => {return webVideoCtrl.I_Logout(deviceIdentify);};
获取模拟通道
/** * 获取模拟通道 * @param {string} deviceIdentify设备标识(IP_Port) * @param {*} options 可选参数对象: * * async http 交互方式,true 表示异步,false 表示同步; * * success 成功回调函数,有一个参数,表示返回的 XML 内容。; * * error 失败回调函数,有两个参数,第一个是 http 状态码,第二个是设备返回的 XML(可能为空) */let getAnalogChannelInfo = (deviceIdentify, options) => {webVideoCtrl.I_GetAnalogChannelInfo(deviceIdentify, options);};
解析模拟通道XML内容
/** * 解析模拟通道XML内容 * @param {XMLDocument} xmlDoc XML内容 * @returns cameraList: 监控列表 */let analysisAnalogChannelInfo = (xmlDoc) => {let cameraList = [];let channels = $(xmlDoc)?.find("VideoInputChannel");$.each(channels, (i, channel) => {let id = $(channel).find("id").eq(0).text();let name = $(channel).find("name").eq(0).text();if (name == "") {name = "Camera " + (i < 9 ? "0" + (i + 1) : i + 1);}cameraList.push({id,name,});});return cameraList;};
获取数字通道
/** * 获取数字通道 * @param {string} deviceIdentify设备标识(IP_Port) * @param {*} options 可选参数对象: * * async http 交互方式,true 表示异步,false 表示同步; * * success 成功回调函数,有一个参数,表示返回的 XML 内容。; * * error 失败回调函数,有两个参数,第一个是 http 状态码,第二个是设备返回的 XML(可能为空) */let getDigitalChannelInfo = (deviceIdentify, options) => {webVideoCtrl.I_GetDigitalChannelInfo(deviceIdentify, options);};
解析数字通道XML内容
/** * 解析数字通道XML内容 * @param {XMLDocument} xmlDoc XML内容 * @param {boolean} filterOnline 是否过滤禁用的数字通道 * @returns cameraList: 监控列表 */let analysisDigitalChannelInfo = (xmlDoc, filterOnline) => {let cameraList = [];let channels = $(xmlDoc)?.find("InputProxyChannelStatus");$.each(channels, (i, channel) => {let id = $(channel).find("id").eq(0).text();let name = $(channel).find("name").eq(0).text();let online = $(channel).find("online").eq(0).text();if (filterOnline && online == "false") {// 过滤禁用的数字通道return true;}if (name == "") {name = "IPCamera " + (i < 9 ? "0" + (i + 1) : i + 1);}cameraList.push({id,name,online,});});return cameraList;};
获取零通道
/** * 获取零通道 * @param {string} deviceIdentify设备标识(IP_Port) * @param {*} options 可选参数对象: * * async http 交互方式,true 表示异步,false 表示同步; * * success 成功回调函数,有一个参数,表示返回的 XML 内容。; * * error 失败回调函数,有两个参数,第一个是 http 状态码,第二个是设备返回的 XML(可能为空) */let getZeroChannelInfo = (deviceIdentify, options) => {webVideoCtrl.I_GetZeroChannelInfo(deviceIdentify, options);};
解析零通道XML内容
/** * 解析零通道XML内容 * @param {XMLDocument} xmlDoc XML内容 * @param {boolean} filterEnabled 是否过滤禁用的零通道 * @returns cameraList: 监控列表 */let analysisZeroChannelInfo = (xmlDoc, filterEnabled) => {let cameraList = [];let channels = $(xmlDoc)?.find("ZeroVideoChannel");$.each(channels, (i, channel) => {let id = $(channel).find("id").eq(0).text();let name = $(channel).find("name").eq(0).text();if (name == "") {name = "Zero Channel " + (i < 9 ? "0" + (i + 1) : i + 1);}let enabled = $(channel).find("enabled").eq(0).text();if (filterEnabled && enabled == "false") {// 过滤禁用的零通道return true;}cameraList.push({id,name,enabled,});});return cameraList;};
开始预览
/** * 开始预览 * @param {string} deviceIdentify 设备标识(IP_Port) * @param {*} options 可选参数对象: * * iWndIndex 播放窗口,如果不传,则默认使用当前选择窗口播放(默认选中窗口 0) * * iStreamType 码流类型 1-主码流,2-子码流,默认使用主码流预览 * * iChannelID 播放通道号,默认通道 1 * * bZeroChannel 是否播放零通道,默认为 false * * iPort RTSP 端口号,可以选择传入,如果不传,开发包会自动判断设备的 RTSP 端口 * * success 成功回调函数 * * error 失败回调函数 */let startRealPlay = (deviceIdentify, options) => {webVideoCtrl.I_StartRealPlay(deviceIdentify, options);};
停止播放
/** * 停止播放 * @param {*} options 可选参数对象: * * iWndIndex 播放窗口号,可不传,表示操作当前选中窗口 * * success 成功回调函数 * * error 失败回调函数 */let stopPlay = (options) => {webVideoCtrl.I_Stop(options);};
常用函数封装文件下载地址:https://download.csdn.net/download/weixin_46653941/87555074
详细API可以看自己下载的开发包内的Web3.2_控件开发包编程指南.pdf,上面这个下载地址只是我自己二次封装的一些API。
实操结果图(涉及隐私加了马赛克):