海康威视视频组件使用帮助汇总.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智能设备（行为分析）、IDS52xx智能分析仪、IDS90XX、IDS91XX；DS630x_D多

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

3、“布防”和“监听”两种方式。采用两种报警方式都可以接收到设备上传的移动侦测报警、视频信号丢失报警、遮挡报警和信号量报警等信息。语音对讲、转发语音对讲能实现PC机与设备间音频的发送和接收。语音转发功能实现将待编码后的发送的音频数据转发给设备。 日志 显示操作的日志信息，可选择全部的信息日志或者只显示报警信息日志。提示操作发生的时间、是否成功、具体操作以及错误信息的错误号。具体错误号对应的错误见附录1.2. 专业名词介绍SDK Software Development Kit 的缩写，即“软件开发工具包”在此组件中位海康威视提供的4.0.0版本的开发包。布防 是指SDK主动连接设备，并发起报警上传

4、命令，设备发生报警立即发送给SDK。监听 是指SDK不主动发起连接设备，只是在设定的端口上监听接收设备主动上传的报警信息。2. 使用环境ForceControl6.0海康威视客户端SDK4.0.03. 静态特性3.1. 安装或添加组件将DsSdk.dll、HCNetSDK.dll、PlayCtrl.dll、hpr.dll放在力控安装目录下，FCNetVideo_HC.dll放在sysysub下。请参照力控用户手册组件安装部分帮助。3.2. 添加组件请参照力控用户手册组件添加部分帮助3.3. 组件属性页设置说明隐藏设备列表与操作：可以固定分辨率也可以选择自定义通过拖拉组件随意选择大小（视频画面最

5、小分辨率为800*600，且比例固定为4:3），如果没有选择只显示视频画面则在视频画面的右侧显示已连接的设备列表和操作按钮，组件大小通过拖拉随意调整。只有在隐藏设备列表与操作的情况下才可以设置分辨率。画面窗口个数：根据选择进行初始的布局设计，组件可选窗口数位1、4、9、16、25、36、49、64、81个。抓图文件保存路径：默认为工程目录下的Pic文件夹。用户可根据需求修改。录像文件保存路径：默认为工程目录下的Record文件夹。用户可根据需求修改。设备列表文件：选择配置设备列表文件，选择后此文件将拷贝到工程目录的bmp文件夹下。用来初始运行程序时读入以及网络发布时进行发布。 显示控制按钮：选

6、择是否显示主功能按钮 即配置、布防、监听等功能。 显示日志： 选择是否在运行时显示日志，启动监听：初始是否启动监听。 报警响应处理：调用脚本编辑器，用户自定义报警的处理。报警结束处理：调用脚本编辑器，用户自定义报警的处理。 设备列表文件：选择配置文件，可在程序启动时自动加载配置文件，文件格式为XML格式。 模拟报警次数时间(过滤重复报警)：报警触发后在设定的时间内同样的报警的信息不回再次触发。3.4. 运行环境使用初始运行状态右键点击设备树根节点添加设备双击摄像头则将该摄像头的视频内容在当前已选视频窗口中播放，如果双击视频节点则将改视频服务器中所有摄像头的视频在无预览画面的窗口中显示。顺序由左

7、至右，由上至下。若全部预览框均有预览画面则再双击视频节点则不再显示。除非停止了某个预览框的预览画面。选中某一通道后读取设备布防信息，若为布防状态则按钮上显示撤防，否则显示布防。停止设备播放后可以改变窗口个数以及网络时延等配置，如下图将预览框个数更改设置为9个。在播放的过程中可以实时录像和抓图，可以播放/停止所有视频；如果该摄像头支持云台控制功能，可以通过按钮对摄像头进行操作。点击主功能按钮“配置”弹出配置，通道配置中显示信息如图，其中可以配置压缩参数，录像参数，图像参数，选择是否显示OSD（屏幕菜单调节）、通道名等。改变压缩参数配置中的视频编码类型后需要单击重启按钮重启按钮才会生效，若设备录像

8、最大保存天数无效则保存时间编辑框不可用选中定时录像后，定制录像后设置按钮生效，点击设置按钮显示如下界面，默认选中，取消选中后可以设置时间段。并可以选择录像类型。点击遮挡报警按钮配置遮挡报警参数，选中显示遮盖区域显示已设置的遮盖区域，选中设置遮盖区域后按住键盘的”Ctrl”键拖动鼠标设置遮挡区域。点击确定保存遮挡。点移动侦测设置可设置移动侦测参数，除了可配置侦测区域外还可以配置布防时间，报警处理方式以及灵敏度等。同样的方式可以设置其他的报警类型。单击报警参数配置页切换到报警参数配置，此页功能为对报警的输入输出进行配置在报警输出触发时间中海康目前提供最多的时间段位8个，同时每两个时间段之间不能有交

9、集。配置好某一天后点击确定日期选择，此时复制按钮才有效，可选择将当前配置好的时间段复制到某天或者整个星期。点击确定用来保存参数。单击设备参数配置页切换到设备参数配置页，此页可读取出设备信息并显示出来，若设备没有ESata硬盘则下拉框不支持操作。网络配置中科选择报警主机的地址以及端口用于返回报警信息。IP地址为设备的IP地址。在该界面可以配置RS232和RS485的相关参数。参数设置完成后，点击“确定”。需要重新启动服务器后生效的参数，点击“重新启动”按钮。在远程配置选择“用户权限”，在该界面可以对服务器的用户进行管理。包括用户的名称，密码，权限等。可以查看用户的权限，选中用户时查看该用户的权限

10、。如果用户已经存在，右键用户节点时弹出菜单，选择“修改”时对用户进行管理。选择“删除”则删除该用户。超级用户不能被删除。如果用户不存在，选择“修改”时对用户进行添加，选择“取消”则退出配置。 异常配置中科选择产生报警的异常信息，例如硬盘满等，报警的处理方式有监视器上警告、声音警告、上传中心、触发报警输出、发送邮件这五种方式。 该功能为ATM机专用。在该界面可以对服务器的交易信息进行配置。参数设置完成后，点击“确定”。此时重启按钮设为有效使用的状态。需要重新启动服务器后生效的参数，点击“重启”按钮。单击主功能按钮“布防”弹出布防/撤防页面，页面显示出所有以加载的设备，点击所有设备则选择所有设备，

11、选择后点击布防/撤防组件根据选择的设备信息取反，即所设备为布防状态则撤防该设备，否则布防该设备。点击监听同样根据设备信息，若为停止监听则启动监听，若已经启动了监听则停止监听。在操作页中单击播放录像按钮，显示如下界面，选择开始时间及结束时间后单击查找按钮按钮所有录像会显示在列表中选择播放即可。4. 动态特性4.1. 组件属性4.1.1. 属性列表功能类别属性名称功能介绍基本属性ShowButton是否显示主功能按钮ShowLog是否显示日志4.1.2. 属性说明属性 :ShowButton描述 :是否显示主功能按钮类型 :BOOL说明 :ShowButton置为TRUE运行后显示主功能按钮，置为

12、FALSE则不显示示例 : #FCNetVideo_HC.ShowButton=FALSE / 运行时隐藏主功能控制按钮 属性 :ShowLog 描述 :是否显示日志 类型 :BOOL 说明 :ShowLog置为TRUE运行后显示日志，置为FALSE则不显示 示例 :#FCNetVideo_HC.ShowLog=FALSE / 运行时隐藏日志4.2. 组件方法4.2.1. 方法列表功能类别方法名称功能介绍基本功能AddDevice添加并注册设备AdjustPreset调用预置点DelPreset删除预置点ExportFile导出网络设备配置文件ImportFile导入网络设备配置文件LogIn

13、Out注册/注销设备LogInOutEx注册/注销设备Play播放/停止PTZControl云台控制操作SetPreset设置预置点SetWndNum设置视频窗口个数ShowVideo播放视频ShowVideoEx播放视频SnathBMP抓图PlayRecord播放录像文件GetAlarmDevice获得产生报警设备索引GetAlarmChannel获得产生报警的通道号GetAlarmType获得产生报警类型OpenFortifyDlg设备布防SetMonitor设置监听OpenConfigDlg打开配置页GetAlarmInput获得报警输入号4.2.2. 方法说明4.2.2.1. 添加并注

14、册设备函数原型:#FCNetVideo_HC.AddDevice(CString 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);/添加并注册

15、名dev00，IP为192.168.0.1，端口号为8000，用户名为admin，密码为12345的设备4.2.2.2. 调用预置点函数原型:#FCNetVideo_HC.AdjustPreset(int nWndIndex, int nDeviceIndex,int nChanIndex，int nPresetIndex)函数描述:调用预置点返回值 :int 0-失败 1-成功参数 :nWndIndex-窗口索引号 nDeviceIndex-设备索引号 nChanIndex-通道索引号 nPresetIndex-预置点索引号说明 :添加并注册设备示例 :#FCNetVideo_HC.Adju

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

17、,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. 导入网络设备配置文件函数原型:FCNewVi

18、deo_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 nLogInOut)函数描述:注册/注销设备返回值 :int 0

19、-失败 1-成功参数 :nDeviceIndex-设备索引号，索引号从0开始 nLogInOut 0-注销 1-注册说明 :注册/注销设备示例 :#FCNetVideo_HC.LogInOut(1,0);/注销设备列表中第二个设备4.2.2.7. 注册/注销设备函数原型:#FCNetVideo_HC.LogInOutEx(CString csDeviceName, int nLogInOut)函数描述:注册/注销设备返回值 :int 0-失败 1-成功参数 :csDeviceName-设备名称 nLogInOut 0-注销 1-注册说明 :注册/注销设备示例 :#FCNetVideo_HC.L

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

21、作返回值 :int 0-失败 1-成功参数 :nWndIndex-窗口索引号 nDeviceIndex-设备索引号 nChanIndex-通道索引号 nPresetIndex-动作标记 0-云台上 1-云台下 2-云台左 3-云台右 4-调焦缩 5-调焦伸 6-聚焦近 7-聚焦远 8-光圈大 9-光圈小说明 :云台控制操作示例 :#FCNetVideo_HC.PTZControl(0,0,1,0);/将第一个窗口中第一个设备中第2个通道的视频向上移动4.2.2.10. 设置预置点函数原型:#FCNetVideo_HC.SetPreset(int nWndIndex, int nDeviceIn

22、dex,int nChanIndex，int nPresetIndex)函数描述:设置预置点返回值 :int 0-失败 1-成功参数 :nWndIndex-窗口索引号 nDeviceIndex-设备索引号 nChanIndex-通道索引号 nPresetIndex-预置点索引号说明 :设置预置点示例 :#FCNetVideo_HC.SetPreset(0,0,1,5);/设置第一个窗口中第一个设备中第2个通道的视频的当前位置为第5个预置点4.2.2.11. 设置视频窗口个数函数原型:#FCNetVideo_HC.SetWndNum(int nWndNum)函数描述:设置视频窗口个数返回值 :i

23、nt 1-成功 0-失败参数 :nWndNum-窗口个数(只能为1，4，9，16，25，36，49，64，81)说明 :设置窗口个数示例 :#FCNetVideo_HC.SetWndNum(16);/将窗口个数设置为16;4.2.2.12. 播放视频函数原型:#FCNetVideo_HC.ShowVideo(int nWndIndex,int nDeviceIndex, int nChanIndex, int nFullScreen)函数描述:播放视频返回值 :int 0-失败 1-成功参数 :nWndIndex-播放视频的窗口索引号，索引号从0开始 nDeviceIndex-设备索引号，索引

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

25、放视频的窗口索引号，索引号从0开始 csDeviceName-设备名称 csChanName-通道名称 nFullScreen-是否全屏 0-正常显示 1-全屏显示说明 :在指定窗口播放指定设备中指定通道的视频示例 :#FCNetVideo_HC.ShowVideoEx(1,dev00,camera1,0);/在第二个视频窗口中正常播放dev00设备中camera1通道中的视频4.2.2.14. 抓图函数原型:#FCNetVideo_HC.SnathBMP(int nWndIndex)函数描述:抓图返回值 :void参数 :nWndIndex-窗口索引，0为起始索引号说明 :将索引号为nInd

26、ex的窗口进行抓图示例 :#FCNetVideo_HC.SetWndNum(5);/对索引号为5的窗口进行抓图;4.2.2.15. 播放录像文件函数原型:#FCNetVideo_HC.PlayRecord(int nPlayRecord)函数描述: 播放录像文件返回值 :void参数 :nPlayRecord 1-播放录像文件 0-显示预览视频说明 :播放录像文件示例 :#FCNetVideo_HC.PlayRecord(1);/播放录像文件 4.2.2.16 获得产生报警设备号 函数原型: #FCNetVideo_HC.GetAlarmDevice() 函数描述: 获得产生报警设备索引 返回

27、值 : int 参数 :无 说明 :获得产生报警的设备 0-0号设备产生报警示例 :device = #FCNetVideo_HC.GetAlarmDevice();/将报警信息存在变量device中 4.2.2.17 获得产生报警通道号 函数原型: #FCNetVideo_HC.GetAlarmChannel() 函数描述:获得产生报警的通道索引 返回值 :int 参数 :无 说明 :获得产生报警的通道索引号 当报警类型为2、3、6、9、10时有效 即发生信号丢失、移动侦测、遮挡报警、视频信号异常、录像异常时 才会得到通道号 示例 :chan=#FCNetVideo_HC.GetAlarmC

28、hannel();/返回报警的通道号 4.2.2.18 获得报警信息 函数原型: #FCNetVideo_HC.GetAlarmType(); 函数描述:获得产生报警类型 返回值 :int 参数 :无 说明 :获得产生报警类型 0信号量报警 1硬盘满 2信号丢失3移动侦测4硬盘未格式化5读写硬盘出错6遮挡报警7制式不匹配8非法访问； 9视频信号异常； 10-录像异常 示例 :alarm=#FCNetVideo_HC.GetAlarmType()/返回报警类型 4.2.2.19 设备布防 函数原型: #FCNetVideo_HC.OpenFortifyDlg(int nOperation, in

29、t nDeviceIndex) 函数描述:布防操作函数 返回值 :int 0-失败 1-成功 参数 :int nOperation 操作 0-布防 1-撤防 -1-打开配置布防撤防界面 说明 :对设备进行布防撤防的操作 示例 : #FCNetVideo_HC.OpenFortifyDlg(0,0) /对设备0设置布防 4.2.2.20 设置监听 函数原型:#FCNetVideo_HC.SetMonitor() 函数描述:设置监听 返回值 :void 参数 :无 说明 :判断当前设备状态 若为无监听状态则启动监听 若为有监听状态则 停止监听 示例 : #FCNetVideo_HC.SetMonitor() /设置监听 4.2.2.21 打开配置页 函数原型: #FCNetVideo_HC.OpenConfigDlg() 函数描述:打开配置页 返回值 :void 参数 :无 说明 :打开配置也可显示当前的设备信息通道信息等，同时可对各类报警 进行配置 示例 : #FCNetVideo_HC.OpenConfigDlg() /打开配置页进行配置 4.2.2.22 获得报警输入 函数原型:#FCNetVideo_HC.GetAlarmInput() 函数描述:获得信号量报警时的报警输入 返回值 :int 报警输入号