ADK 云台控件接口说明.docx
- 文档编号:12012708
- 上传时间:2023-04-16
- 格式:DOCX
- 页数:12
- 大小:18.84KB
ADK 云台控件接口说明.docx
《ADK 云台控件接口说明.docx》由会员分享,可在线阅读,更多相关《ADK 云台控件接口说明.docx(12页珍藏版)》请在冰豆网上搜索。
ADK云台控件接口说明
ADK2.1云台控件接口说明
时间
版本
说明
作者
2009-7-26
2.0
ADK2.0云台控件接口说明
俞露
2009-7-28
2.0.0.1
修正接口说明,增加参数说明
陈利军,俞露
2009-8-31
2.0.0.1
增加备注信息
俞露
2010-6-09
2.1.0.1
优化库,重新打包
陈利军
目录
控件方法3
1.添加DMS服务器3
2.添加摄像头3
3.设置当前控制的摄像头4
4.设置控件界面参数4
5.界面使能4
6.隐藏界面5
7.发功SIT三维定位命令5
8.发功定位命令6
9.发功摄像头命令6
10.发功预置点命令6
11.登陆DDNS服务器7
12.获取版本号7
控件事件8
1.错误通知8
2.SIT按钮界面状态事件8
控件属性8
错误码9
备注9
控件方法
1.添加DMS服务器
名称
AddDmsServer
定义
LONGAddDmsServer(LPCTSTRstrDmsIp,LONGnDmsPort,LPCTSTRstrDmsPsw);
描述
登陆指定的DMS服务器
参数说明
名字
类型
长度
说明
1
strDmsIp
String
DMS服务器IP
2
nDmsPort
int
4
DMS服务器端口
3
strDmsPsw
int
4
DMS服务器登陆密码,暂无用
返回值
小于0失败,具体原因请参照错误码(下同);大于0,为此次成功会话的ID,即nDmsId
2.添加摄像头
名称
AddCamera
定义
LONGAddCamera(LONGnDmsId,LPCTSTRstrDevIp,LONGnDevPort,LPCTSTRstrUserName,LPCTSTRstrPsw,LONGnChannel)
描述
对指定的DMS服务器,添加指定摄像头,添加成功即默认当前控制为该摄像头
参数说明
名字
类型
长度
说明
1
nDmsId
String
DMSId,即AddDmsServer方法的成功返回值
2
strDevIp
String
4
设备IP
3
nDevPort
int
4
设备端口
4
strUserName
String
设备登录名,请确保为可复用账户
5
strPsw
String
设备登录密码
6
nChannel
Int
4
摄像头从属于设备的通道号,从0开始;
返回值
小于0失败;大于0为,此次成功订阅的会话ID,即nCameraId
3.设置当前控制的摄像头
名称
SetCurCamera
定义
LONGSetCurCamera(LONGnCameraId);
描述
设置当前控制的摄像头,nCameraId即为AddCamera的成功返回值
参数说明
名字
类型
长度
说明
1
nCameraId
int
4
成功添加的会话值,即SetCurCamera的成功返回值
返回值
小于0失败,等于0成功
4.设置控件界面参数
名称
SetParameter
定义
LONGSetParameter(LONGnKey,LONGnValue);
描述
设置控件参数
参数说明
名字
类型
长度
说明
1
nKey
Int
4
参数类型。
1为SIT功能是否存在;2为(SIT工能存在的情况下)SIT功能开启与否
2
nValue
Int
4
1为开启功能(或者功能存在);0为关闭功能(或者功能不存在)
返回值
小于0失败,等于0成功
5.界面使能
名称
EnablePanel
定义
LONGEnablePanel(LONGnEnable)
描述
在使用默认界面的情况下,设定界面为不可用或可用
参数说明
名字
类型
长度
说明
1
nEnable
Int
4
0为不可用,1为可用
返回值
小于0失败,等于0成功
6.隐藏界面
名称
HidePanel
定义
LONGHidePanel(LONGnEnable)
描述
在使用默认界面的情况下,设定界面为显示与否
参数说明
名字
类型
长度
说明
1
nEnable
Int
4
0为隐藏,1为显示
返回值
小于0失败,等于0成功
7.发功SIT三维定位命令
名称
SendSITCommand
定义
LONGSendSITCommand(LONGnWndHandle,LONGnLeft,LONGnTop,LONGnRight,LONGnBottom,LONGnReverse)
描述
对当前控制的摄像头发送SIT三维定位命令,此功能需要ADK视频控件配合使用
参数说明
名字
类型
长度
说明
1
nWndHandle
Int
4
窗口句柄
2
nLeft
Int
4
视频控件SIT命令传出参数
3
nTop
Int
4
视频控件SIT命令传出参数
2
nRight
Int
4
视频控件SIT命令传出参数
2
nBottom
Int
4
视频控件SIT命令传出参数
nReverse
Int
4
视频控件SIT命令传出参数
返回值
小于0失败,等于0成功
8.发功定位命令
名称
SendDirectionCommand
定义
LONGSendDirectionCommand(LONGnDirection,LONGnStep)
描述
对当前控制的摄像头发送定位命令
参数说明
名字
类型
长度
说明
1
nDirection
Int
4
方向值。
1为上;2为下;3为左;4为右;5为左上;6为左下;
7为右上;8为右下
2
nStep
Int
4
步长;范围为1-8
返回值
小于0失败,等于0成功
9.发功摄像头命令
名称
SendCameraCommand
定义
LONGSendCameraCommand(LONGnOperation,LONGnAct)
描述
对当前控制的摄像头发送摄像头相关命令
参数说明
名字
类型
长度
说明
1
nOperation
Int
4
类型。
1为变倍;2为变焦;3为光圈
2
nAct
Int
4
1为增大;2为减小
返回值
小于0失败,等于0成功
10.发功预置点命令
名称
SendPrepointCommand
定义
LONGSendPrepointCommand(LONGnOperation,LONGnNum)
描述
对当前控制的摄像头发送预置点相关命令
参数说明
名字
类型
长度
说明
1
nOperation
Int
4
类型。
1为预置点定位;2为设置预置点
2
nNum
Int
4
预置点编号
返回值
小于0失败,等于0成功
11.登陆DDNS服务器
名称
AddDDNSServer
定义
LONGAddDDNSServer(LONGnDmsId,LPCTSTRstrIp,LONGnPort,LPCTSTRstrVersion);
描述
添加登陆指定的DDNS服务
参数说明
名字
类型
长度
说明
1
stpId
String
Ddns服务IP
2
nPort
Int
4
Ddns服务端口
3
strVersion
String
Ddns服务版本号,暂无用
4
nDmsId
Int
4
DMSID
返回值
小于0失败,等于0成功
12.获取版本号
名称
GetVersion
定义
BSTRGetVersion(void);
描述
获取控件版本号
参数说明
名字
类型
长度
说明
1
无
返回值
返回控件版本信息,格式为“OcxVersion:
2.0.0.1”
控件事件
1.错误通知
名称
OnError
定义
voidOnError(LONGnError,LPCTSTRstrTime,LONGnSessionId,LONGnParam)
描述
通知报警事件
参数说明
名字
类型
长度
说明
1
nError
Int
4
错误类型
2
strTime
String
发生时间
3
nSessionId
Int
4
会话ID
4
nParam
Int
4
备用参数
返回值
无
2.SIT按钮界面状态事件
名称
OnSITStatus
定义
voidOnSITStatus(LONGsitSwitch)
描述
SIT按钮界面状态事件
参数说明
名字
类型
长度
说明
1
sitSwitch
Int
4
0为关闭,1为打开(即按下,使能)
返回值
无
控件属性
暂无
错误码
//////////////////////////////////////////////////////////////////////////
#definePTZ_ERROR_BEGIN-101
#definePTZ_ERROR_DEFAULT-102//控件内部错误,默认值
#definePTZ_ERROR_STRING_EMPTY-103//用户传入字符串参数为空
#definePTZ_ERROR_CURCAMERA_EMPTY-104//当前控制的摄像头ID为空
#definePTZ_ERROR_IP_EMPTY-103//参数IP字符串为空
#definePTZ_ERROR_USERNAME_EMPTY-104//参数用户名为空
#definePTZ_ERROR_INVALID_SESSION-105//无效的会话ID
#definePTZ_ERROR_INVALID_WINHANDLE-106//SIT中无效的窗口句柄
#definePTZ_ERROR_INVALID_BOOL-107
#definePTZ_ERROR_PTZPANEL_GRAY-108//在云台界面灰色的时候,调控SIT功能存在与否失败
#definePTZ_ERROR_WITHOUT_SIT-109//没有SIT功能,标志位为FALSE;如果有界面的话按钮式灰的;
#definePTZ_ERROR_SIT_DISABLE-110//SIT功能无效(被灰)
#definePTZ_ERROR_LINE-150//分割线下部分部分主要为空间内部错误,上部分主要为借口参数错误
#definePTZ_ERROR_RESPONSE_TIMEOUT-151//控件接口等待应答超时
#definePTZ_ERROR_RESPONSE_FAILED-152//收到应答但显示命令失败,没有成功
#definePTZ_ERROR_RESPONSE_LOST-153//没有应答超时,但是FetchResult未收到response消息
#definePTZ_ERROR_CTRLDATA_NULL-154
#definePTZ_ERROR_END-200
//////////////////////////////////////////////////////////////////////////
备注
●在一般情况下,建议用户以一台专门的PC运行ADK的服务程序,保证整个系统的流畅运转;
●部署系统时,该控件的DMS服务器与报警控件的DMS通用;
●云台控件默认提供一套图形界面;如果用户不需要,则可以调用隐藏接口进行隐藏,或者直接删除PTZCtrl.ocx控件(请勿在未删除PTZCtrl.ocx的情况下删除Interface下的资源);
●若用户不需要默认图形界面,则可以自行调用相关的接口以实现云台功能;注,如需实现摄像头连续转动,则需要向控件连续发送定位命令;
●云台控件的SIT功能需要和ADK视频控件协同工作才能实现;具体方式是,打开两个控件中对SIT功能的使能(调用相应的接口),在视频控件中在窗口中拉动鼠标,用户接口视频控件OnSelectRect事件,并将所得参数应用于云台控件的SendSITCommand,即可;关闭该功能时,可能涉及到两个控件的功能使能调用;
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- ADK 云台控件接口说明 控件 接口 说明