威视达康网络摄像机开发包说明.docx
《威视达康网络摄像机开发包说明.docx》由会员分享，可在线阅读，更多相关《威视达康网络摄像机开发包说明.docx（20页珍藏版）》请在冰豆网上搜索。
威视达康网络摄像机开发包说明
网络摄像机组件属性和接口
版本：
2.25
属性列表
1．ShowTitle
是否显示视频窗口标题栏
2．ShowStatus
是否显示视频窗口状态栏
3．ShowToolBar
是否显示视频窗口工具栏
4．ShowOSDName
是否在视频显示区显示设备名称
5．ShowOSDTime
是否在视频显示区显示当前时间
6．ShowFPS
是否在视频窗口状态栏显示帧率
7．ShowRate
是否在视频窗口状态拉显示网络速率
8．Lan
插件使用的语言
目前支持
简体中文：
cn
英文：
en
繁体中文：
b5
9．Ver
插件当前版本号
只读属性
10．DevState
当前网络摄像机的状态
返回值
表示状态
-1
还没有添加网络摄像机
0
还未进入工作状态
2
正在工作状态，还未连接上网络摄像机
3
已经连接上网络摄像机
只读属性
11．IsRecing
是否正在录像
只读属性
*在AddDev之后使用该属性才有效。
12．TurnImg
视频图像是否倒转。
*在AddDev之后使用该属性才有效。
13．CanPopupMenu
视频窗口上是否允许鼠标右键弹出菜单.
14．SavePath
录像和抓图保存路径，当调用StartRec和Capture时，如果保存的文件名参数指定为”savrepath”，录像和图片就会被保存在SavePath目录下，并且文件名自动取当前时间。
缺省为Windows“我的文档”目录，如果设置时指定为空，会弹出目录选择对话框。
15．Selected
是否被选中，当同时存在多个实例时，通过这个属性来表示当前哪个实例是选中状态。
16．EnableAlarm
是否启用报警检测。
启用后，当设备发送了报警，就会触发事件OnAlarm。
注：
该方法只有使用机身编码方式时有效。
*在AddDev之后使用该属性才有效。
17．RecMpeg4
是否采用MPEG4格式进行录像。
该设置只对格式为JPEG的设备才有效。
采用MPEG4压缩格式，可以大幅减小录像文件大小，不过需要占用更多的CPU和内存。
*在AddDev之后使用该属性才有效。
18．IsFullScreen
当前是否全屏状态
19．TransServer
转发服务器地址和端口。
当ConnMode为1时有效。
20．VideoFixedRate
显示画面是否保持视频分辨率。
21．IsTalking
是否在对讲中。
22．Listen
是否监听声音。
*在AddDev之后使用该属性才有效。
23．TCPMode
访问网络摄像机的数据获取方式。
ConnMode
连接方式
0
UDP方式，用于穿透网关
1
TCP方式
2
自动判断，首先判断TCP方式是否可连接，不能连接的话，尝试UDP方式
注：
目前F系列对有效
*在AddDev之后使用该属性才有效。
24．VideoRecv
是否接收网络摄像机音视频数据。
如果设置为不接收音视频数据，控件也会连接上网络摄像机，进行报警信息的监听。
该属性目前只针对F系列有效，并且TCPMode=1；
当VideoRecv从0切换为1时，控件立即从摄像机获取数据。
目前还不支持从1切换为0。
25．PTZProtocol
云台解码板协议。
为0时表示不支持云台，1为Pelco-D，2为Pelco-P。
当设置为0时，控制面板上的云台控制按钮会隐藏掉。
*在AddDev之后使用该属性才有效。
26．VideoRate
设置视频数据的最高帧率。
*在AddDev之后，ConnectAll之前使用该属性才有效。
27．SDPlayListPanel
是否显示SD卡文件回放界面里的文件列表面板。
*在调用SDPlay之后调用才有效。
方法列表
1．AddDev4
添加网络摄像机
参数说明：
参数
类型
说明
nDevType
整型
设备类型,见下表
bLan
整型
是否以局域网方式连接，非0为局域网方式
szID
字符串
网络摄像机机身编码，如果以局域网方式访问，则填入网络摄像机的局域网IP地址。
如果是穿山甲系列，填入UID
nTCPPort
整型
保留，设置为0
szDevName
字符串
网络摄像机名称，显示在视频窗口左上角
szAcc
字符串
访问权限帐号
szPwd
字符串
访问权限密码
nChannelID
整型
通道数，第一个通道为1，后面的依此类推。
返回值为0；
网络摄像机类型:
网络摄像机类型
类型定义
不指定
0
F系列
902
Q系列
906
V（H3）系列
912
H系列
918
PnP穿山甲系列
922
T系列非PnP
924
2．AddDev5
添加网络摄像机
参数说明：
参数
类型
说明
nDevType
整型
设备类型,见下表
bLan
整型
是否以局域网方式连接，非0为局域网方式
szID
字符串
网络摄像机机身编码，如果以局域网方式访问，则填入网络摄像机的局域网IP地址。
nTCPPort
整型
保留，设置为0
szDevName
字符串
网络摄像机名称，显示在视频窗口左上角
szAcc
字符串
访问权限帐号
szPwd
字符串
加密后的访问权限密码
nPwdEncKey
整型
访问权限密码解密Key，如果指定为0，表示访问权限密码没有进行加密。
nChannelID
整型
通道数，第一个通道为1，后面的依此类推。
nLocPort
整型
0（保留）
返回值为0；
网络摄像机类型:
网络摄像机类型
类型定义
不指定
0
F系列
902
Q系列
906
V（H3）系列
912
H系列
918
PnP穿山甲系列
922
T系列非PnP
924
C系列非PnP
926
加密算法：
Encrypt之后再使用Base64编码
functionEncrypt（constS:
String;Key:
Word）:
String;
var
I:
Integer;
begin
Result:
=S;
forI:
=1toLength（S）do
begin
Result[I]:
=char（byte（S[I]）xor（Keyshr8））;
Key:
=（byte（Result[I]）+Key）*C1+C2;
end;
end;
3．ConnectAll
连接网络摄像机
无参数
无返回值
4．DisConnectAll
断开与网络摄像机的连接
无参数
无返回值
5．DevSet
显示网络摄像机设置界面
无参数
返回值:
返回值
表示状态
0
正常显示,并且用户点击”确定”按钮返回
-1
正常显示,并且用户点击”取消”按钮返回
-2
无法显示该窗口
6．NetSet
显示网络设置界面
无参数
返回值:
返回值
表示状态
0
正常显示,并且用户点击”确定”按钮返回
-1
正常显示,并且用户点击”取消”按钮返回
-2
无法显示该窗口
7．ClearDevs
清除网络摄像机设置
无参数
无返回值
8．StartRec
开始录像。
参数说明：
参数
类型
说明
szFileName
字符串
录像文件保存路径，如果szFileName为空，控件会弹出文件保存路径选择对话框。
如果szFileName为savepath，文件会被保存在属性SavePath目录下。
返回值：
返回值
表示状态
-1
还没有添加网络摄像机或者网络摄像机还没有连接。
-2
录像保存文件路径为空。
0
正常
9．StopRec
停止录像。
没有参数
返回值：
返回值
表示状态
-1
还没有添加网络摄像机或者网络摄像机还没有连接。
0
正常
10．Capture
抓取当前图片。
参数说明：
参数
类型
说明
szFileName
字符串
图片保存路径，可以保存为bmp格式和jpg格式，通过传入的文件名扩展名来自动判断。
如果szFileName为空，控件会弹出文件保存路径选择对话框。
如果szFileName为savepath，文件会被保存在属性SavePath目录下。
返回值：
返回值
表示状态
-1
还没有添加网络摄像机或者网络摄像机还没有连接。
-2
没有抓到图片。
-3
保存文件发生错误，可能为磁盘不可写或磁盘空间已满。
0
正常
11．CaptureTool
显示插件的抓图工具。
无参数
返回值：
返回值
表示状态
-1
还没有添加网络摄像机或者网络摄像机还没有连接。
0
正常
12．FullScreen
全屏显示视频窗口
无参数
无返回值
13．PTZ
云台、变焦镜头控制
参数说明：
参数
类型
说明
nPro
整型
云台协议，1：
Pelco-D，2：
Pelco-P，标配Pelco-D
nAddr
整型
解码板地址码，标配1
nDir
整型
动作，详细见下表
nSpeed
整型
运动速度，1~255
nParam
整型
预置点操作时使用的参数
bWithStop
整型
发送动作之后是否发送停止命令。
0：
不发送，1：
发送
（只有M系列的支持该参数）
无返回值
控制动作内容
nDir值
动作
-1
停止
0
向上
1
向左
2
向右
3
向下
4
焦距拉远
5
焦距拉近
6
视角变窄
7
视角变宽
8
自动扫描开
9
自动扫描关
10
光圈小
11
光圈大
12
灯光关
13
灯光开
14
转至预置点nParam
15
设置预置点n
16
删除预置点n
17
同时向上，向左
18
同时向下，向右
19
同时向上，向右
20
同时向下，向左
14．SetOSD
设置在屏显示内容，这个显示的内容是扩展内容，并不能控制显示的设备名称和当前时间，如果要隐藏控件自身显示的设备名称和当前时间，可以设置控件属性ShowOSDName和ShowOSDTime。
参数说明：
参数
类型
说明
nPos
整型
显示区域位置（0..8），如下图索引
OffsetX
整型
在基于nPos的位置基础上，水平偏移距离
OffsetY
整型
在基于nPos的位置基础上，垂直偏移距离
nStr
整型
显示内容索引（0..8）。
支持同时显示9条信息
Str
字符串
需要显示的字符串内容
整个显示区域划分为9个区域
无返回值
15．StartTalk
开始对讲。
无参数
无返回值
16．StopTalk
停止对讲。
无参数
无返回值
17．SDPlay
显示摄像机端SD卡录像回放界面
参数说明：
参数
类型
说明
nDevType
整型
网络摄像机类型，参看下表
szDevName
字符串
摄像机名称，摄像机类型为918时，会用于SD卡文件下载时的文件名。
摄像机ID为925时无效
szUrl
字符串
摄像机类型为918时，为摄像机的访问地址，含端口。
摄像机类型为925时，为摄像机的UID
szAcc
字符串
摄像机访问账号，摄像机类型为925时，忽略。
szPwd
字符串
摄像机访问密码
网络摄像机类型:
网络摄像机类型
类型定义
H系列
918
TPnP系列
925
18．RefreshSDFile
刷新SD卡文件列表。
19．SDPlayFile
播放指定的SD卡文件。
参数说明：
参数
类型
说明
szFile
字符串
需要播放的文件名，通过OnGetSDFileCallBack获取到
nFileLen
整型
需要播放的文件的长度，通过OnGetSDFileCallBack获取到
20．SetSDSearchTime
设置查找SD卡文件的时间段。
参数说明：
参数
类型
说明
nSYear
整型
查询起始时间的年
nSMonth
整型
查询起始时间的月
nSDay
整型
查询起始时间的日
nSHour
整型
查询起始时间的小时
nEYear
整型
查询结束时间的年
nEMonth
整型
查询结束时间的月
nEDay
整型
查询结束时间的日
nEHour
整型
查询结束时间的小时
事件列表
1．OnAlarm
当设备发生报警时，该事件被调用。
参数说明：
参数
类型
说明
bStart
整型
1表示开始报警，0表示报警结束。
报警时间长度由配置文件决定。
F系列支持IP和机身编码方式。
E，M系列只支持机身编码方式访问。
2．OnVideoConnected
当连接上设备，并开始接受视频数据时，该事件被调用。
参数说明：
参数
类型
说明
BmpInfo
整型
BITMAPINFOHEADER结构指针
AudioFmt
整型
AUDIOFOMRATEX结构指针
3．OnVideoDisconnect
当和设备的连接断开时，该事件被调用。
无参数
4．OnVideoSample
解码后的视频数据回调函数。
参数说明：
参数
类型
说明
nFrameID
整型
视频帧序号
IsVideo
整型
1：
视频数据。
否则为音频数据
pData
指针
视频数据指针，PBYTE
nDataLen
整型
视频数据长度
5．OnPreVideoSample
原始视频数据回调函数。
参数说明：
参数
类型
说明
nFrameID
整型
视频帧序号
bDecode
整型
是否对视频数据进行解码，如果置为0，控件就不对原始数据进行解码。
bShow
整型
是否显示视频，如果置为0，控件就不显示视频画面。
如果置为1，会对原始数据进行解码，并显示画面。
pData
指针
原始视频数据指针，PBYTE
nDataLen
整型
原始视频数据长度
6．OnGetSDFileCallBack
返回查找到的SD文件。
参数说明：
参数
类型
说明
szFileName
字符串
文件名
nFileDate
字符串
文件创建时间
nFileLen
整型
文件长度，字节数
nRecNum
指针
当前查询返回的文件数
无效接口（下列接口已经作废）
1．Start
2．SwitchLayout
实体文件列表
文件
说明
ipcamax.ocx
插件，安装时需要注册，
AudioCodec.dll
声音处理
AviWriter.dll
录像处理
Com1024.dll
网络摄像机通讯相关
ddisp.dll
显示相关
ipcamax.lb5
繁体中文语言
ipcamax.lcn
简体中文语言
ipcamax.len
英文语言
ijl15.dll
JPEG函数库
LPng.dll
图像函数库
oemopt.dat
配置文件
Option.ini
配置文件
vcore.dll
视频相关
vvfw.dll
视频相关
ZPlayer.exe
视频播放器,程序调用方式ZPlayer.exe播放文件路径
ZPlayer.lb5,ZPlayer.lcn,ZPlayer.len
视频播放器语言文件
分发时，这些文件需要在同一个目录下。
升级会员 