1、XX 组件使用帮助 北京三维力控科技有限公司1 / 10海康威视视频组件使用帮助1. 功能说明连接海康视频服务器,实时显示视频并能执行一些基本的摄像头操作1.1. 功能介绍( 组件实现的功能介绍 )1.2. 专业名词介绍( 涉及到的专业名词介绍等 )2. 使用环境ForceControl6.03. 静态特性3.1. 安装或添加组件将 DsSdk.dll、HCNetSDK.dll、 PlayCtrl.dll 放在力控安装目录下, FCNetVideo_HC.dll 放在 sysysub 下。请参照力控用户手册组件安装部分帮助。3.2. 添加组件( 如何在组态环境添加组件,使用图片或文字说明添加过
2、程 )请参照力控用户手册组件添加部分帮助3.3. 组件属性页设置说明只显示视频画面:可以固定分辨率也可以选择自定义通过拖拉组件随意选择大小(视频画面最小分辨率为 800*600,切比例固定为 4:3) ,如果没有选择只显示视频画面则在视频画面的右侧显示已连接的设备列表和操作按钮,组件大小通过拖拉随意调整。3.4. 运行环境使用XX 组件使用帮助 北京三维力控科技有限公司2 / 10双击摄像头则将该摄像头的视频内容在当前已选视频窗口中播放,如果双击视频节点则将改视频服务器中所有摄像头的视频在当前所有的视频窗口中播放当视频没有播放的时候可以改变画面窗口个数和网络延时,在播放的过程中可以实时录像和抓
3、图,可以播放/停止所有视频;如果该摄像头支持云台控制功能,可以通过按钮对摄像头进行操作。XX 组件使用帮助 北京三维力控科技有限公司3 / 104. 动态特性( 组件的属性、方法和事件的用途及帮助 )4.1. 组件属性4.1.1. 属性列表功能类别 属性名称 功能介绍基本属性 DrawBK 是否绘制背景色4.1.2. 属性说明( 组件所有属性功能、名称、类型、示例的分项详细说明 )属性 :描述 :类型 :(string,int,double)说明 :(详细的使用说明和注意事项)示例 :(写上示例说明)关联方法:(可以不写)关联属性:XX 组件使用帮助 北京三维力控科技有限公司4 / 104.2
4、. 组件方法4.2.1. 方法列表功能类别 方法名称 功能介绍4.2.2. 方法说明4.2.2.1. 添加并注册设备函数原型:#FCNetVideo_HC.AddDevice(CString csDeviceName,CString csIP, int nPort,CString csUserName, CString csPassWord)函数描述:添加并注册设备返回值 :int 0-失败 1-成功参数 :csDeviceName-设备名称csIP-IP 地址nPort-端口号csUserName-用户名csPassWord-密码说明 :添加并注册设备示例 :#FCNetVideo_HC.A
5、ddDevice(“dev00“,“192.168.0.1“,8000,admin, 12345);/添加并注册名 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-设备索引号nChanInde
6、x-通道索引号nPresetIndex-预置点索引号说明 :添加并注册设备示例 :#FCNetVideo_HC.AdjustPreset(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-通道索引
7、号nPresetIndex-预置点索引号说明 :删除预置点示例 :#FCNetVideo_HC.DelPreset(0,0,1,5);/删除第一个窗口中第一个XX 组件使用帮助 北京三维力控科技有限公司5 / 10设备中第 2 个通道的视频的第 5 个预置点4.2.2.4. 导出网络设备配置文件函数原型:FCNewVideo_HC.ExportFile(int nWithDlg, CString csFilePath)函数描述:导出网络设备配置文件返回值 :void参数 :nWithDlg-是否需要对话框 0-不需要 1-需要csFilePath-文件路径名称说明 :导出网络设备配置文件,nW
8、ithDlg 为 1 时 csFilePath 无效示例 :FCNewVideo_HC.ExportFile(1,“);/导出配置文件4.2.2.5. 导入网络设备配置文件函数原型:FCNewVideo_HC.ImportFile(int nWithDlg, CString csFilePath)函数描述:导入网络设备配置文件返回值 :void参数 :nWithDlg-是否需要对话框 0-不需要 1-需要csFilePath-文件路径名称说明 :导入网络设备配置文件,nWithDlg 为 1 时 csFilePath 无效示例 :FCNewVideo_HC.ImportFile(1,“);/导
9、入配置文件4.2.2.6. 注册/注销设备函数原型:#FCNetVideo_HC.LogInOut(int nDeviceIndex,int nLogInOut)函数描述:注册/注销设备返回值 :int 0-失败 1-成功参数 :nDeviceIndex-设备索引号,索引号从 0 开始nLogInOut 0-注销 1-注册说明 :注册/注销设备示例 :#FCNetVideo_HC.LogInOut(1,0);/注销设备列表中第二个设备4.2.2.7. 注册/注销设备函数原型:#FCNetVideo_HC.LogInOutEx(CString csDeviceName,int nLogInOut
10、)函数描述:注册/注销设备返回值 :int 0-失败 1-成功参数 :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. 云台控制操作
11、函数原型:#FCNetVideo_HC.PTZControl(int nWndIndex, int XX 组件使用帮助 北京三维力控科技有限公司6 / 10nDeviceIndex,int nChanIndex,int nControlIndex)函数描述:云台控制操作返回值 :int 0-失败 1-成功参数 :nWndIndex-窗口索引号nDeviceIndex-设备索引号nChanIndex-通道索引号nPresetIndex-动作标记 0-云台上 1-云台下 2-云台左 3-云台右 4-调焦缩 5-调焦伸 6-聚焦近 7-聚焦远 8-光圈大 9-光圈小说明 :云台控制操作示例 :#FC
12、NetVideo_HC.PTZControl(0,0,1,0);/将第一个窗口中第一个设备中第 2 个通道的视频向上移动4.2.2.10. 设置预置点函数原型:#FCNetVideo_HC.SetPreset(int nWndIndex, int nDeviceIndex,int nChanIndex,int nPresetIndex)函数描述:设置预置点返回值 :int 0-失败 1-成功参数 :nWndIndex-窗口索引号nDeviceIndex-设备索引号nChanIndex-通道索引号nPresetIndex-预置点索引号说明 :设置预置点示例 :#FCNetVideo_HC.Set
13、Preset(0,0,1,5);/设置第一个窗口中第一个设备中第 2 个通道的视频的当前位置为第 5 个预置点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.ShowVideo(int nWndI
14、ndex,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);/全屏播放第一个设备中第二个通道的视频4.2.2.13. 播放视频函数原型:#
15、FCNetVideo_HC.ShowVideoEx(int nWndIndex,CString XX 组件使用帮助 北京三维力控科技有限公司7 / 10csDeviceName, CString csChanName,int nFullScreen)函数描述:播放视频返回值 :int 0-失败 1-成功参数 :nWndIndex-播放视频的窗口索引号,索引号从 0 开始csDeviceName-设备名称csChanName-通道名称nFullScreen-是否全屏 0-正常显示 1-全屏显示说明 :在指定窗口播放指定设备中指定通道的视频示例 :#FCNetVideo_HC.ShowVideoE
16、x(1,“dev00“,“camera1“,0);/在第二个视频窗口中正常播放 dev00 设备中 camera1 通道中的视频4.2.2.14. 抓图函数原型:#FCNetVideo_HC.SnathBMP(int nWndIndex)函数描述:抓图返回值 :void参数 :nWndIndex-窗口索引,0 为起始索引号说明 :将索引号为 nIndex 的窗口进行抓图示例 :#FCNetVideo_HC.SetWndNum(5);/对索引号为 5 的窗口进行抓图;XX 组件使用帮助 北京三维力控科技有限公司8 / 104.3. 组件事件4.3.1. 事件列表功能类别 事件名称 功能介绍鼠标操
17、作 OnClick 鼠标单击时触发4.3.2. 事件说明( 组件所有事件功能、名称、参数、类型、示例的分项详细说明 )函数原型:函数描述:返回值 :(void,int,float,string)参数 :(每个参数都要说明)触发条件:说明 :(详细的使用说明和注意事项)示例 :(写上示例说明)关联属性:关联方法:XX 组件使用帮助 北京三维力控科技有限公司9 / 105. 应用实例( 添加示例工程,或用示例介绍组件难点功能使用方法 )6. 常见问题处理( 常见问题的现象、处理的一般步骤,尽量结合图片,用文字详细说明 )XX 组件使用帮助 北京三维力控科技有限公司10 / 10/*注 */1. 所有红色字体字代表必须填写部分;所有蓝色字体,代表注明部分,需要开发人员删除所有蓝色字体后自己填写;橙色为示例部分,按照自己需要做相应修改。2. 如实如期填写文档版本信息3. 根据组件名称修改对应文件名称后 (文件名称 =组件名称 +”_”+文档名称 +组件版本号 ),进入文档,双击页眉,右键选择更新域后就可以更换页眉为当前文件名称。