海康威视视频组件使用帮助汇总.docx
《海康威视视频组件使用帮助汇总.docx》由会员分享，可在线阅读，更多相关《海康威视视频组件使用帮助汇总.docx（31页珍藏版）》请在冰豆网上搜索。
海康威视视频组件使用帮助汇总
海康威视视频组件使用帮助
支持设备型号：
客户端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多路解码器；
IP摄像机（以下简称“IPC”）：
DS-2CD71xx、DS-2CD81xx、DS-2CD7xx、DS-2CD8xx、DS-2CD9xx；
其他IP设备：
包含IP模块、、IP快球等。
1.功能说明
1.1.功能介绍
图像预览
通过摄像头获取视频信号显示在界面中。
云台控制
对于云台可以进行控制操作，向上下左右四个方向转动，并可以设置预制轨迹使其自行运动。
布防/撤防
对选定的设备进行布防、撤防，布防后SDK主动连接设备产生报警信息，撤防将不再连接同时也不会再产生报警信息。
参数配置
包括通道配置、设备配置、报警参数配置、串口参数配置、用户配置、异常配置、交易配置以及ATM配置。
报警
报警可分为“布防”和“监听”两种方式。
采用两种报警方式都可以接收到设备上传的移动侦测报警、视频信号丢失报警、遮挡报警和信号量报警等信息。
语音对讲、转发
语音对讲能实现PC机与设备间音频的发送和接收。
语音转发功能实现将待编码后的发送的音频数据转发给设备。
日志
显示操作的日志信息，可选择全部的信息日志或者只显示报警信息日志。
提示操作
发生的时间、是否成功、具体操作以及错误信息的错误号。
具体错误号对应的错误
见附录
1.2.专业名词介绍
SDKSoftwareDevelopmentKit的缩写，即“软件开发工具包”在此组件中位海康威视提供的4.0.0版本的开发包。
布防是指SDK主动连接设备，并发起报警上传命令，设备发生报警立即发送给SDK。
监听是指SDK不主动发起连接设备，只是在设定的端口上监听接收设备主动上传的报警信息。
2.使用环境
ForceControl6.0
海康威视客户端SDK4.0.0
3.静态特性
3.1.安装或添加组件
将DsSdk.dll、HCNetSDK.dll、PlayCtrl.dll、hpr.dll放在力控安装目录下，FCNetVideo_HC.dll放在sysysub下。
请参照力控用户手册组件安装部分帮助。
3.2.添加组件
请参照力控用户手册组件添加部分帮助
3.3.组件属性页设置说明
隐藏设备列表与操作：
可以固定分辨率也可以选择自定义通过拖拉组件随意选择大
小（视频画面最小分辨率为800*600，且比例固定为4:
3），如果没有选择只显示视频画面则在视频画面的右侧显示已连接的设备列表和操作按钮，组件大小通过拖拉随意调整。
只有在隐藏设备列表与操作的情况下才可以设置分辨率。
画面窗口个数：
根据选择进行初始的布局设计，组件可选窗口数位1、4、9、16、
25、36、49、64、81个。
抓图文件保存路径：
默认为工程目录下的Pic文件夹。
用户可根据需求修改。
录像文件保存路径：
默认为工程目录下的Record文件夹。
用户可根据需求修改。
设备列表文件：
选择配置设备列表文件，选择后此文件将拷贝到工程目录的bmp
文件夹下。
用来初始运行程序时读入以及网络发布时进行发布。
显示控制按钮：
选择是否显示主功能按钮即配置、布防、监听等功能。
显示日志：
选择是否在运行时显示日志，
启动监听：
初始是否启动监听。
报警响应处理：
调用脚本编辑器，用户自定义报警的处理。
报警结束处理：
调用脚本编辑器，用户自定义报警的处理。
设备列表文件：
选择配置文件，可在程序启动时自动加载配置文件，文件格式为
XML格式。
模拟报警次数时间（过滤重复报警）：
报警触发后在设定的时间内同样的报警的信息
不回再次触发。
3.4.运行环境使用
初始运行状态
右键点击设备树根节点添加设备
双击摄像头则将该摄像头的视频内容在当前已选视频窗口中播放，如果双击视频节
点则将改视频服务器中所有摄像头的视频在无预览画面的窗口中显示。
顺序由左至右，由上至下。
若全部预览框均有预览画面则再双击视频节点则不再显示。
除非停止了某个预览框的预览画面。
选中某一通道后读取设备布防信息，若为布防状态则按钮上显示撤防，否则显示
布防。
停止设备播放后可以改变窗口个数以及网络时延等配置，如下图将预览框个数更改设置为9个。
在播放的过程中可以实时录像和抓图，可以播放/停止所有视频；如果该摄像头支持
云台控制功能，可以通过按钮对摄像头进行操作。
点击主功能按钮“配置”弹出配置，通道配置中显示信息如图，其中可以配置压缩参数，录像参数，图像参数，选择是否显示OSD（屏幕菜单调节）、通道名等。
改变压缩参数配置中的视频编码类型后需要单击重启按钮重启按钮才会生效，若设备录像最大保存天数无效则保存时间编辑框不可用
选中定时录像后，定制录像后设置按钮生效，点击设置按钮显示如下界面，默认选中，取消选中后可以设置时间段。
并可以选择录像类型。
点击遮挡报警按钮配置遮挡报警参数，选中显示遮盖区域显示已设置的遮盖区域，选中设置遮盖区域后按住键盘的”Ctrl”键拖动鼠标设置遮挡区域。
点击确定保存遮挡。
点移动侦测设置可设置移动侦测参数，除了可配置侦测区域外还可以配置布防时间，报警处理方式以及灵敏度等。
同样的方式可以设置其他的报警类型。
单击报警参数配置页切换到报警参数配置，此页功能为对报警的输入输出进行配置
在报警输出触发时间中海康目前提供最多的时间段位8个，同时每两个时间段之间不能有交集。
配置好某一天后点击确定日期选择，此时复制按钮才有效，可选择将当前配置好的时间段复制到某天或者整个星期。
点击确定用来保存参数。
单击设备参数配置页切换到设备参数配置页，此页可读取出设备信息并显示出来，若设备没有ESata硬盘则下拉框不支持操作。
网络配置中科选择报警主机的地址以及端口用于返回报警信息。
IP地址为设备的IP地址。
在该界面可以配置RS232和RS485的相关参数。
参数设置完成后，点击“确定”。
需要重新启动服务器后生效的参数，点击“重新启动”按钮。
在远程配置选择“用户权限”，在该界面可以对服务器的用户进行管理。
包括用户的名称，密码，权限等。
可以查看用户的权限，选中用户时查看该用户的权限。
如果用户已经存在，右键用户节点时弹出菜单，选择“修改”时对用户进行管理。
选择“删除”则删除该用户。
超级用户不能被删除。
如果用户不存在，选择“修改”时对用户进行添加，选择“取消”则退出配置。
异常配置中科选择产生报警的异常信息，例如硬盘满等，报警的处理方式有监视器上警告、声音警告、上传中心、触发报警输出、发送邮件这五种方式。
该功能为ATM机专用。
在该界面可以对服务器的交易信息进行配置。
参数设置完成后，点击“确定”。
此时重启按钮设为有效使用的状态。
需要重新启动服务器后生效的参数，点击“重启”按钮。
单击主功能按钮“布防”弹出布防/撤防页面，页面显示出所有以加载的设备，点击所有设备则选择所有设备，选择后点击布防/撤防组件根据选择的设备信息取反，即所设备为布防状态则撤防该设备，否则布防该设备。
点击监听同样根据设备信息，若为停止监听则启动监听，若已经启动了监听则停止监听。
在操作页中单击播放录像按钮，显示如下界面，选择开始时间及结束时间后单击查找按钮按钮所有录像会显示在列表中选择播放即可。
4.动态特性
4.1.组件属性
4.1.1.属性列表
功能类别
属性名称
功能介绍
基本属性
ShowButton
是否显示主功能按钮
ShowLog
是否显示日志
4.1.2.属性说明
属性:
ShowButton
描述:
是否显示主功能按钮
类型:
BOOL
说明:
ShowButton置为TRUE运行后显示主功能按钮，置为FALSE则不显示
示例:
#FCNetVideo_HC.ShowButton=FALSE//运行时隐藏主功能控制按钮
属性:
ShowLog
描述:
是否显示日志
类型:
BOOL
说明:
ShowLog置为TRUE运行后显示日志，置为FALSE则不显示
示例:
#FCNetVideo_HC.ShowLog=FALSE//运行时隐藏日志
4.2.组件方法
4.2.1.方法列表
功能类别
方法名称
功能介绍
基本功能
AddDevice
添加并注册设备
AdjustPreset
调用预置点
DelPreset
删除预置点
ExportFile
导出网络设备配置文件
ImportFile
导入网络设备配置文件
LogInOut
注册/注销设备
LogInOutEx
注册/注销设备
Play
播放/停止
PTZControl
云台控制操作
SetPreset
设置预置点
SetWndNum
设置视频窗口个数
ShowVideo
播放视频
ShowVideoEx
播放视频
SnathBMP
抓图
PlayRecord
播放录像文件
GetAlarmDevice
获得产生报警设备索引
GetAlarmChannel
获得产生报警的通道号
GetAlarmType
获得产生报警类型
OpenFortifyDlg
设备布防
SetMonitor
设置监听
OpenConfigDlg
打开配置页
GetAlarmInput
获得报警输入号
4.2.2.方法说明
4.2.2.1.添加并注册设备
函数原型:
#FCNetVideo_HC.AddDevice（CStringcsDeviceName,CStringcsIP,intnPort,CStringcsUserName,CStringcsPassWord）
函数描述:
添加并注册设备
返回值:
int0-失败1-成功
参数:
csDeviceName-设备名称
csIP-IP地址
nPort-端口号
csUserName-用户名
csPassWord-密码
说明:
添加并注册设备
示例:
#FCNetVideo_HC.AddDevice（"dev00","192.168.0.1",8000,admin,12345）;//添加并注册名dev00，IP为192.168.0.1，端口号为8000，用户名为admin，密码为12345的设备
4.2.2.2.调用预置点
函数原型:
#FCNetVideo_HC.AdjustPreset（intnWndIndex,int
nDeviceIndex,intnChanIndex，intnPresetIndex）
函数描述:
调用预置点
返回值:
int0-失败1-成功
参数:
nWndIndex-窗口索引号
nDeviceIndex-设备索引号
nChanIndex-通道索引号
nPresetIndex-预置点索引号
说明:
添加并注册设备
示例:
#FCNetVideo_HC.AdjustPreset（0,0,1,5）;//调用第一个窗口中第一个设备中第2个通道的视频的第5个预置点
4.2.2.3.删除预置点
函数原型:
#FCNetVideo_HC.DelPreset（intnWndIndex,int
nDeviceIndex,intnChanIndex，intnPresetIndex）
函数描述:
删除预置点
返回值:
int0-失败1-成功
参数:
nWndIndex-窗口索引号
nDeviceIndex-设备索引号
nChanIndex-通道索引号
nPresetIndex-预置点索引号
说明:
删除预置点
示例:
#FCNetVideo_HC.DelPreset（0,0,1,5）;//删除第一个窗口中第一个设备中第2个通道的视频的第5个预置点
4.2.2.4.导出网络设备配置文件
函数原型:
FCNewVideo_HC.ExportFile（intnWithDlg,CStringcsFilePath）
函数描述:
导出网络设备配置文件
返回值:
void
参数:
nWithDlg-是否需要对话框0-不需要1-需要
csFilePath-文件路径名称
说明:
导出网络设备配置文件，nWithDlg为1时csFilePath无效
示例:
FCNewVideo_HC.ExportFile（1,""）;//导出配置文件
4.2.2.5.导入网络设备配置文件
函数原型:
FCNewVideo_HC.ImportFile（intnWithDlg,CStringcsFilePath）
函数描述:
导入网络设备配置文件
返回值:
void
参数:
nWithDlg-是否需要对话框0-不需要1-需要
csFilePath-文件路径名称
说明:
导入网络设备配置文件，nWithDlg为1时csFilePath无效
示例:
FCNewVideo_HC.ImportFile（1,""）;//导入配置文件
4.2.2.6.注册/注销设备
函数原型:
#FCNetVideo_HC.LogInOut（intnDeviceIndex,intnLogInOut）
函数描述:
注册/注销设备
返回值:
int0-失败1-成功
参数:
nDeviceIndex-设备索引号，索引号从0开始
nLogInOut0-注销1-注册
说明:
注册/注销设备
示例:
#FCNetVideo_HC.LogInOut（1,0）;//注销设备列表中第二个设备
4.2.2.7.注册/注销设备
函数原型:
#FCNetVideo_HC.LogInOutEx（CStringcsDeviceName,int
nLogInOut）
函数描述:
注册/注销设备
返回值:
int0-失败1-成功
参数:
csDeviceName-设备名称
nLogInOut0-注销1-注册
说明:
注册/注销设备
示例:
#FCNetVideo_HC.LogInOutEx（"dev00",0）;//注销设备列表中名称为dev00的设备
4.2.2.8.播放/停止
函数原型:
#FCNetVideo_HC.Play（intnPlay）
函数描述:
播放/停止
返回值:
void
参数:
nPlay-是否播放，0-停止1-播放
说明:
播放/停止当前所有视频
示例:
#FCNetVideo_HC.Play
（1）;//播放当前视频
4.2.2.9.云台控制操作
函数原型:
#FCNetVideo_HC.PTZControl（intnWndIndex,int
nDeviceIndex,intnChanIndex，intnControlIndex）
函数描述:
云台控制操作
返回值:
int0-失败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（intnWndIndex,int
nDeviceIndex,intnChanIndex，intnPresetIndex）
函数描述:
设置预置点
返回值:
int0-失败1-成功
参数:
nWndIndex-窗口索引号
nDeviceIndex-设备索引号
nChanIndex-通道索引号
nPresetIndex-预置点索引号
说明:
设置预置点
示例:
#FCNetVideo_HC.SetPreset（0,0,1,5）;//设置第一个窗口中第一个设备中第2个通道的视频的当前位置为第5个预置点
4.2.2.11.设置视频窗口个数
函数原型:
#FCNetVideo_HC.SetWndNum（intnWndNum）
函数描述:
设置视频窗口个数
返回值:
int1-成功0-失败
参数:
nWndNum-窗口个数（只能为1，4，9，16，25，36，49，64，81）
说明:
设置窗口个数
示例:
#FCNetVideo_HC.SetWndNum（16）;//将窗口个数设置为16;
4.2.2.12.播放视频
函数原型:
#FCNetVideo_HC.ShowVideo（intnWndIndex,intnDeviceIndex,intnChanIndex,intnFullScreen）
函数描述:
播放视频
返回值:
int0-失败1-成功
参数:
nWndIndex-播放视频的窗口索引号，索引号从0开始
nDeviceIndex-设备索引号，索引号从0开始
nChanIndex-通道索引号，索引号从0开始
nFullScreen-是否全屏0-正常显示1-全屏显示
说明:
在指定窗口播放指定设备中指定通道的视频
示例:
#FCNetVideo_HC.ShowVideo（1,0,1,1）;//全屏播放第一个设备中第二个通道的视频
4.2.2.13.播放视频
函数原型:
#FCNetVideo_HC.ShowVideoEx（intnWndIndex,CString
csDeviceName,CStringcsChanName,intnFullScreen）
函数描述:
播放视频
返回值:
int0-失败1-成功
参数:
nWndIndex-播放视频的窗口索引号，索引号从0开始
csDeviceName-设备名称
csChanName-通道名称
nFullScreen-是否全屏0-正常显示1-全屏显示
说明:
在指定窗口播放指定设备中指定通道的视频
示例:
#FCNetVideo_HC.ShowVideoEx（1,"dev00","camera1",0）;//在第二个视频窗口中正常播放dev00设备中camera1通道中的视频
4.2.2.14.抓图
函数原型:
#FCNetVideo_HC.SnathBMP（intnWndIndex）
函数描述:
抓图
返回值:
void
参数:
nWndIndex-窗口索引，0为起始索引号
说明:
将索引号为nIndex的窗口进行抓图
示例:
#FCNetVideo_HC.SetWndNum（5）;//对索引号为5的窗口进行抓图;
4.2.2.15.播放录像文件
函数原型:
#FCNetVideo_HC.PlayRecord（intnPlayRecord）
函数描述:
播放录像文件
返回值:
void
参数:
nPlayRecord1-播放录像文件0-显示预览视频
说明:
播放录像文件
示例:
#FCNetVideo_HC.PlayRecord
（1）;//播放录像文件
4.2.2.16获得产生报警设备号
函数原型:
#FCNetVideo_HC.GetAlarmDevice（）
函数描述:
获得产生报警设备索引
返回值:
int
参数:
无
说明:
获得产生报警的设备0-0号设备产生报警
示例:
device=#FCNetVideo_HC.GetAlarmDevice（）;//将报警信息存在变量
device中
4.2.2.17获得产生报警通道号
函数原型:
#FCNetVideo_HC.GetAlarmChannel（）
函数描述:
获得产生报警的通道索引
返回值:
int
参数:
无
说明:
获得产生报警的通道索引号当报警类型为2、3、6、9、10时有效
即发生信号丢失、移动侦测、遮挡报警、视频信号异常、录像异常时
才会得到通道号
示例:
chan=#FCNetVideo_HC.GetAlarmChannel（）;//返回报警的通道号
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（intnOperation,intnDeviceIndex）
函数描述:
布防操作函数
返回值:
int0-失败1-成功
参数:
intnOperation操作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报警输入号
升级会员 