海康威视视频组件使用帮助.docx

1、海康威视视频组件使用帮助海康视频监控组件使用帮助 北京三维力控科技有限公司海康威视视频组件使用帮助支持设备型号：客户端 SDK是嵌入式网络硬盘录像机、视频服务器、 IP 设备的配套产品，用于设备远程访问及远程控制软件的开发，适用于以下产品型号：DS-95xx、 DS-96xxNVR； DS-90xx 混合型硬盘录像机； DS-91xx、 DS-81xx、 DS-80xx、 DS-70xx 、DS-71xx 、DS-7116、 DS-72xx 硬盘录像机； DS-60xx、 DS-61xx 视频服务器、编 / 解码器； IDS6002-HF/B 双摄像机跟踪、 IDS6101-HF/B 智能设备

2、（行为分析） 、 IDS52xx 智能分析仪、 IDS90XX、IDS91XX； DS630x_D多路解码器；IP 摄像机（以下简称“ IPC”）： DS-2CD71xx、 DS-2CD81xx、 DS-2CD7xx、 DS-2CD8xx、DS-2CD9xx；其他 IP 设备：包含 IP 模块、 IP 快球等 。1. 功能说明1.1. 功能介绍图像预览通过摄像头获取视频信号显示在界面中。云台控制对于云台可以进行控制操作， 向上下左右四个方向转动， 并可以设置预制轨迹使其自行运动。布防/撤防对选定的设备进行布防、 撤防， 布防后 SDK主动连接设备产生报警信息， 撤防将不再连接同时也不会再产生报

3、警信息。参数配置包括通道配置、设备配置、报警参数配置、串口参数配置、用户配置、异常配置、交易配置以及 ATM配置。报警报警可分为“布防”和“监听”两种方式。 采用两种报警方式都可以接收到设备上传的移动侦测报警、视频信号丢失报警、遮挡报警和信号量报警等信息。语音对讲、转发语音对讲能实现 PC 机与设备间音频的发送和接收。语音转发功能实现将待编码后的发送的音频数据转发给设备。日志显示操作的日志信息， 可选择全部的信息日志或者只显示报警信息日志。 提示操作发生的时间、是否成功、具体操作以及错误信息的错误号。具体错误号对应的错误见附录1.2. 专业名词介绍SDK Software Developmen

4、t Kit 的缩写， 即“软件开发工具包”在此组件中位海康威视提供的 4.0.0 版本的开发包。布防 是指 SDK主动连接设备， 并发起报警上传命令， 设备发生报警立即发送给 SDK。监听 是指 SDK不主动发起连接设备， 只是在设定的端口上监听接收设备主动上传的报警信息。2. 使用环境1/ 25海康视频监控组件使用帮助 北京三维力控科技有限公司ForceControl6.0海康威视客户端 SDK4.0.03. 静态特性3.1. 安装或添加组件将 DsSdk.dll 、 HCNetSDK.dll 、 PlayCtrl.dll 、 hpr.dll 放 在 力 控 安 装 目 录 下 ，FCNet

5、Video_HC.dll 放在 sysysub 下。请参照力控用户手册组件安装部分帮助。3.2. 添加组件请参照力控用户手册组件添加部分帮助3.3. 组件属性页设置说明隐藏设备列表与操作： 可以固定分辨率也可以选择自定义通过拖拉组件随意选择大小（视频画面最小分辨率为 800*600 ，且比例固定为 4:3 ），如果没有选择只显示视频画面则在视频画面的右侧显示已连接的设备列表和操作按钮，组件大小通过拖拉随意调整。只有在隐藏设备列表与操作的情况下才可以设置分辨率。画面窗口个数：根据选择进行初始的布局设计，组件可选窗口数位 1、 4、 9、 16、25、36、 49、 64、 81 个。抓图文件保存

6、路径：默认为工程目录下的 Pic 文件夹。用户可根据需求修改。录像文件保存路径：默认为工程目录下的 Record 文件夹。用户可根据需求修改。设备列表文件：选择配置设备列表文件，选择后此文件将拷贝到工程目录的 bmp文件夹下。用来初始运行程序时读入以及网络发布时进行发布。2/ 25海康视频监控组件使用帮助 北京三维力控科技有限公司显示控制按钮：选择是否显示主功能按钮 即配置、布防、监听等功能。显示日志： 选择是否在运行时显示日志，启动监听：初始是否启动监听。报警响应处理：调用脚本编辑器，用户自定义报警的处理。报警结束处理：调用脚本编辑器，用户自定义报警的处理。设备列表文件：选择配置文件，可在程

7、序启动时自动加载配置文件，文件格式为XML 格式。模拟报警次数时间 (过滤重复报警 )：报警触发后在设定的时间内同样的报警的信息不回再次触发。3.4. 运行环境使用初始运行状态右键点击设备树根节点添加设备3/ 25海康视频监控组件使用帮助 北京三维力控科技有限公司双击摄像头则将该摄像头的视频内容在当前已选视频窗口中播放，如果双击视频节点则将改视频服务器中所有摄像头的视频在无预览画面的窗口中显示。 顺序由左至右， 由上至下。若全部预览框均有预览画面则再双击视频节点则不再显示。 除非停止了某个预览框的预览画面。选中某一通道后读取设备布防信息，若为布防状态则按钮上显示撤防，否则显示布防。停止设备播放

8、后可以改变窗口个数以及网络时延等配置， 如下图将预览框个数更改设置为 9个。4/ 25海康视频监控组件使用帮助 北京三维力控科技有限公司在播放的过程中可以实时录像和抓图，可以播放 / 停止所有视频；如果该摄像头支持云台控制功能，可以通过按钮对摄像头进行操作。点击主功能按钮 “配置” 弹出配置， 通道配置中显示信息如图， 其中可以配置压缩参数，录像参数，图像参数，选择是否显示 OSD（屏幕菜单调节） 、通道名等。改变压缩参数配置中的视频编码类型后需要单击重启按钮重启按钮才会生效， 若设备录像最大保存天数无效则保存时间编辑框不可用5/ 25海康视频监控组件使用帮助 北京三维力控科技有限公司选中定时

9、录像后，定制录像后设置按钮生效，点击设置按钮显示如下界面，默认选中，取消选中后可以设置时间段。并可以选择录像类型。点击遮挡报警按钮配置遮挡报警参数， 选中显示遮盖区域显示已设置的遮盖区域， 选中6/ 25海康视频监控组件使用帮助 北京三维力控科技有限公司设置遮盖区域后按住键盘的 ”Ctrl”键拖动鼠标设置遮挡区域。点击确定保存遮挡。点移动侦测设置可设置移动侦测参数， 除了可配置侦测区域外还可以配置布防时间， 报警处理方式以及灵敏度等。同样的方式可以设置其他的报警类型。单击报警参数配置页切换到报警参数配置，此页功能为对报警的输入输出进行配置7/ 25海康视频监控组件使用帮助 北京三维力控科技有限

10、公司在报警输出触发时间中海康目前提供最多的时间段位 8 个，同时每两个时间段之间不能有交集。配置好某一天后点击确定日期选择， 此时复制按钮才有效， 可选择将当前配置好的时间段复制到某天或者整个星期。点击确定用来保存参数。单击设备参数配置页切换到设备参数配置页， 此页可读取出设备信息并显示出来， 若设备没有 ESata硬盘则下拉框不支持操作。 网络配置中科选择报警主机的地址以及端口用于返回报警信息。 IP 地址为设备的 IP 地址。在该界面可以配置 RS232和 RS485的相关参数。参数设置完成后，点击 “确定 ”。需要重新启动服务器后生效的参数，点击 “重新启动 ”按钮。8/ 25海康视频监

11、控组件使用帮助 北京三维力控科技有限公司在远程配置选择 “用户权限 ”，在该界面可以对服务器的用户进行管理。 包括用户的名称，密码，权限等。可以查看用户的权限，选中用户时查看该用户的权限。如果用户已经存在，右键用户节点时弹出菜单，选择 “修改 ”时对用户进行管理。选择 “删除 ”则删除该用户。超级用户不能被删除。 如果用户不存在， 选择 “修改 ”时对用户进行添加， 选择 “取消 ”则退出配置。9/ 25海康视频监控组件使用帮助 北京三维力控科技有限公司异常配置中科选择产生报警的异常信息， 例如硬盘满等， 报警的处理方式有监视器上警告、声音警告、上传中心、触发报警输出、发送邮件这五种方式。该功

12、能为 ATM 机专用。在该界面可以对服务器的交易信息进行配置。参数设置完成后，点击 “确定 ”。此时重启按钮设为有效使用的状态。需要重新启动服务器后生效的参数，点击“重启 ”按钮。10/25海康视频监控组件使用帮助 北京三维力控科技有限公司单击主功能按钮“布防”弹出布防 / 撤防页面，页面显示出所有以加载的设备，点击所有设备则选择所有设备，选择后点击布防 / 撤防组件根据选择的设备信息取反，即所设备为布防状态则撤防该设备， 否则布防该设备。 点击监听同样根据设备信息， 若为停止监听则启动监听，若已经启动了监听则停止监听。在操作页中单击播放录像按钮，显示如下界面，选择开始时间及结束时间后单击查找

13、按钮按钮所有录像会显示在列表中选择播放即可。11/25海康视频监控组件使用帮助 北京三维力控科技有限公司12/25海康视频监控组件使用帮助 北京三维力控科技有限公司4. 动态特性4.1. 组件属性4.1.1. 属性列表功能类别属性名称功能介绍基本属性ShowButton是否显示主功能按钮ShowLog是否显示日志4.1.2. 属性说明属性:ShowButton描述:是否显示主功能按钮类型:BOOL说明:ShowButton 置为 TRUE运行后显示主功能按钮， 置为 FALSE则不显示示例: #FCNetVideo_HC.ShowButton=FALSE / 运行时隐藏主功能控制按钮属性:Sh

14、owLog描述:是否显示日志类型:BOOL说明:ShowLog 置为 TRUE运行后显示日志，置为FALSE则不显示示例:#FCNetVideo_HC.ShowLog=FALSE / 运行时隐藏日志13/25海康视频监控组件使用帮助 北京三维力控科技有限公司4.2. 组件方法4.2.1. 方法列表功能类别方法名称功能介绍基本功能AddDevice添加并注册设备AdjustPreset调用预置点DelPreset删除预置点ExportFile导出网络设备配置文件ImportFile导入网络设备配置文件LogInOut注册 / 注销设备LogInOutEx注册 / 注销设备Play播放/停止PTZ

15、Control云台控制操作SetPreset设置预置点SetWndNum设置视频窗口个数ShowVideo播放视频ShowVideoEx播放视频SnathBMP抓图PlayRecord播放录像文件GetAlarmDevice获得产生报警设备索引GetAlarmChannel获得产生报警的通道号GetAlarmType获得产生报警类型OpenFortifyDlg设备布防SetMonitor设置监听OpenConfigDlg打开配置页GetAlarmInput获得报警输入号4.2.2. 方法说明4.2.2.1. 添加并注册设备函数原型 :#FCNetVideo_HC.AddDevice(CStri

16、ng csDeviceName,CString csIP, int nPort,CString csUserName, CString csPassWord)函数描述 : 添加并注册设备返回值 :int 0- 失败 1- 成功参数 :csDeviceName- 设备名称csIP-IP 地址nPort- 端口号csUserName- 用户名csPassWord- 密码说明 : 添加并注册设备示例 :#FCNetVideo_HC.AddDevice(dev00,192.168.0.1,8000,admin,12345);/ 添加并注册名 dev00， IP 为 192.168.0.1 ，端口号为

17、8000，用户名为 admin，密码为 12345 的设备4.2.2.2. 调用预置点函数原型 :#FCNetVideo_HC.AdjustPreset(int nWndIndex, int14/25海康视频监控组件使用帮助 北京三维力控科技有限公司nDeviceIndex,int nChanIndex ， int nPresetIndex)函数描述 : 调用预置点返回值 :int 0- 失败 1- 成功参数 :nWndIndex- 窗口索引号nDeviceIndex- 设备索引号nChanIndex- 通道索引号nPresetIndex- 预置点索引号说明: 添加并注册设备示例:#FCNet

18、Video_HC.AdjustPreset(0,0,1,5);/调用第一个窗口中第一个设备中第 2 个通道的视频的第5 个预置点4.2.2.3.删除预置点函数原型 :#FCNetVideo_HC.DelPreset(int nWndIndex, intnDeviceIndex,int nChanIndex， int nPresetIndex)函数描述 : 删除预置点返回值:int 0- 失败 1- 成功参数:nWndIndex- 窗口索引号nDeviceIndex-设备索引号nChanIndex-通道索引号nPresetIndex-预置点索引号说明: 删除预置点示例:#FCNetVideo_H

19、C.DelPreset(0,0,1,5);/删除第一个窗口中第一个设备中第2 个通道的视频的第5 个预置点4.2.2.4.导出网络设备配置文件函数原型 :FCNewVideo_HC.ExportFile(int nWithDlg, CString csFilePath)函数描述 : 导出网络设备配置文件返回值:void参数:nWithDlg- 是否需要对话框0- 不需要1- 需要csFilePath-文件路径名称说明: 导出网络设备配置文件，nWithDlg 为 1 时 csFilePath无效示例:FCNewVideo_HC.ExportFile(1,);/导出配置文件4.2.2.5.导入网

20、络设备配置文件函数原型 :FCNewVideo_HC.ImportFile(int nWithDlg, CString csFilePath)函数描述 : 导入网络设备配置文件返回值:void参数:nWithDlg- 是否需要对话框0- 不需要1- 需要csFilePath-文件路径名称说明: 导入网络设备配置文件，nWithDlg 为 1 时 csFilePath无效示例:FCNewVideo_HC.ImportFile(1,);/导入配置文件4.2.2.6.注册 / 注销设备函数原型 :#FCNetVideo_HC.LogInOut(int nDeviceIndex,int nLogInO

21、ut)函数描述 : 注册 / 注销设备返回值:int 0- 失败 1- 成功参数:nDeviceIndex-设备索引号，索引号从0 开始nLogInOut 0-注销 1- 注册15/25海康视频监控组件使用帮助 北京三维力控科技有限公司说明 : 注册 / 注销设备示例 :#FCNetVideo_HC.LogInOut(1,0);/ 注销设备列表中第二个设备4.2.2.7. 注册 / 注销设备函数原型 :#FCNetVideo_HC.LogInOutEx(CString csDeviceName, intnLogInOut)函数描述 : 注册 / 注销设备返回值:int 0- 失败 1-成功参数

22、:csDeviceName-设备名称nLogInOut 0- 注销 1- 注册说明 : 注册 / 注销设备示例 :#FCNetVideo_HC.LogInOutEx(dev00,0);/ 注销设备列表中名称为 dev00 的设备4.2.2.8. 播放 / 停止函数原型 :#FCNetVideo_HC.Play(int nPlay)函数描述 : 播放 / 停止返回值 :void参数 :nPlay- 是否播放， 0- 停止 1- 播放说明 : 播放 / 停止当前所有视频示例 :#FCNetVideo_HC.Play(1);/ 播放当前视频4.2.2.9. 云台控制操作函数原型 :#FCNetVid

23、eo_HC.PTZControl(int nWndIndex, intnDeviceIndex,int nChanIndex， int nControlIndex)函数描述 : 云台控制操作返回值:int 0- 失败 1- 成功参数:nWndIndex- 窗口索引号nDeviceIndex-设备索引号nChanIndex-通道索引号nPresetIndex-动作标记 0-云台上 1- 云台下 2- 云台左 3- 云台右4- 调焦缩 5- 调焦伸 6- 聚焦近 7- 聚焦远 8- 光圈大9- 光圈小说明: 云台控制操作示例:#FCNetVideo_HC.PTZControl(0,0,1,0);/

24、将第一个窗口中第一个设备中第2 个通道的视频向上移动4.2.2.10.设置预置点函数原型 :#FCNetVideo_HC.SetPreset(int nWndIndex, intnDeviceIndex,int nChanIndex， int nPresetIndex)函数描述 : 设置预置点返回值:int 0- 失败 1- 成功参数:nWndIndex- 窗口索引号nDeviceIndex-设备索引号nChanIndex-通道索引号nPresetIndex-预置点索引号说明: 设置预置点示例:#FCNetVideo_HC.SetPreset(0,0,1,5);/设置第一个窗口中第一个设备中第

25、2 个通道的视频的当前位置为第5 个预置点16/25海康视频监控组件使用帮助 北京三维力控科技有限公司4.2.2.11. 设置视频窗口个数函数原型 :#FCNetVideo_HC.SetWndNum(int nWndNum)函数描述 : 设置视频窗口个数返回值 :int 1- 成功 0- 失败参数 :nWndNum-窗口个数 ( 只能为 1， 4，9， 16， 25， 36， 49， 64， 81)说明 : 设置窗口个数示例 :#FCNetVideo_HC.SetWndNum(16);/ 将窗口个数设置为 16;4.2.2.12. 播放视频函 数 原 型 :#FCNetVideo_HC.Sho

26、wVideo(int nWndIndex,int nDeviceIndex,int nChanIndex, int nFullScreen)函数描述 : 播放视频返回值 :int 0- 失败 1- 成功参数 :nWndIndex- 播放视频的窗口索引号，索引号从 0 开始nDeviceIndex- 设备索引号，索引号从 0 开始nChanIndex- 通道索引号，索引号从 0 开始nFullScreen- 是否全屏 0- 正常显示 1- 全屏显示说明 : 在指定窗口播放指定设备中指定通道的视频示例 :#FCNetVideo_HC.ShowVideo(1,0,1,1);/ 全屏播放第一个设备中第

27、二个通道的视频4.2.2.13. 播放视频函数原型 :#FCNetVideo_HC.ShowVideoEx(int nWndIndex,CString csDeviceName, CString csChanName,int nFullScreen)函数描述 : 播放视频返回值 :int 0- 失败 1- 成功参数 :nWndIndex- 播放视频的窗口索引号，索引号从 0 开始csDeviceName- 设备名称csChanName- 通道名称nFullScreen- 是否全屏 0- 正常显示 1- 全屏显示说明: 在指定窗口播放指定设备中指定通道的视频示例:#FCNetVideo_HC.S

28、howVideoEx(1,dev00,camera1,0);/在第二个视频窗口中正常播放dev00 设备中 camera1 通道中的视频4.2.2.14.抓图函数原型 :#FCNetVideo_HC.SnathBMP(int nWndIndex)函数描述 : 抓图返回值:void参数:nWndIndex- 窗口索引， 0 为起始索引号说明: 将索引号为 nIndex 的窗口进行抓图示例:#FCNetVideo_HC.SetWndNum(5);/ 对索引号为5 的窗口进行抓图 ;4.2.2.15.播放录像文件函数原型 :#FCNetVideo_HC.PlayRecord(int nPlayRecord)函数描述 :