OCX控件接口说明
V2.3版本(20100611)
控件版本更新说明：
1. 版本号改为2.3.9.1
2. 增加接口：BMPCapturePicV23、JPEGCapturePicV23、StartRecordV23
3. 支持第三方IPC的添加
20100115更新：
1. 增加添加数字通道时获取第三方IPC协议的接口
2. 增加GetServerIPByIPServer接口通过IP-SERVER模式获取IP地址接口
20100405更新：
1. GetServerInfo接口中增加获取零通道个数的节点
2. 增加零通道相关接口，开始零通道预览、停止零通道预览、零通道预览画面翻页
20100510更新：
1． GetIPCConfig和SetDigitChannel接口增加是否启用快速添加节点。用于95NVR
2． 增加通过SADP获取在线IPC信息列表接口：GetIPCInfoBySadp
3． 增加修改SADP获取的在线IPC信息接口：SetIPCameraInfo
方法:
1.注册
1.1 注册
        long Login(LPCTSTR lpServerIP, long  lPort, LPCTSTR lpUserName, LPCTSTR lpPassword)
功能：注册用户到硬盘录像机
        参数说明：
lpServerIP：硬盘录像机的IP地址
lPort：硬盘录像机端口号
lpUserName：登陆的用户名
lpPassword：登陆的密码
        返回值：lUserID提供给其他接口使用。-1表示注册失败。
1.2 设置UserID
        BOOL SetUserID(long lUserID)
        功能：设置UserID，如果注册成功，可以通过该接口传入UserID.
        参数说明：
        lUserID：要传入的UserID值
        返回值：TRUE表示成功，FALSE表示失败。
2.注销
2.1 注销
BOOL Logout()
        功能：从硬盘录像机上注销某个用户
        返回值：TRUE表示成功，FALSE表示失败。
2.2 释放OCX
        BOOL ClearOCX()
        功能：停止一切操作，例如录像、预览等操作
        返回值：TRUE表示成功，FALSE表示失败。
3.解析IP地址
3.1 利用普通域名解析IP地址
BSTR GetServerIP(LPCTSTR  lpURL)
    功能：域名方式登陆时解析所连接硬盘录像机的IP
    参数说明：
    lpURL：域名地址
    返回值：返回解析到的硬盘录像机的IP地址，返回空表示失败。
3.2 利用IP-SERVER模式获取IP地址
BSTR GetServerIPByIPServer (LPCTSTR lpDNSIP, LPCTSTR lpServerName, LPCTSTR lpSerialNumber)
    功能：从IP-Server服务器上获取IP地址，序列号和设备名称不能同时为空。
    参数说明：
    lpDNSIP：    DNS IP地址
    lpServerName：    设备名称
    lpSerialNumber：序列号
        返回值：返回解析到的硬盘录像机的IP地址，返回空表示失败
4.获取硬盘录像机的信息
BSTR GetServerInfo()
    功能：获取硬盘录像机的信息,注册成功后才有效
    返回值：以XML形式记录硬盘录像机信息的一个字符串。
    形式：
<?xml version='1.0'?>
        <ServerInfo>
                    < ChannelNumber> byChanNum </ChannelNumber >//模拟通道个数
                    < DVRType> byDVRType </DVRType>            //类型
                  < DiskNumber> byDiskNum </DiskNumber>        //硬盘数
                  < SerialNumber> bySerialNumber </SerialNumber>    //序列号
                  < AlarmInPortNum> byAlarmInPortNum </AlarmPortNum>                                                                //模拟通道报警输入个数
                  <AlarmOutPortNum> byAlarmOutPortNum </AlarmOutPortNum>                                                            //模拟通道报警输出个数
                  < StartChannel> byStartChan </StartChannel>        //起始通道号
                <AudioChanNum>byAudioChanNum</AudioChanNum>
                                                        //语音通道个数
                <MaxDigitChannelNum>byMaxDigitChannelNum</MaxDigitChannelNum>
                                                        //最大数字通道插槽数
                <ZeroChanNum>byZeroChanNum</ZeroChanNum>//零通道个数
            </ServerInfo>
5.预览
5.1 开始预览
        BOOL StartRealPlay(long lChannelNum ,long lProtocolType, long lStreamType)   
        功能：开始预览(如果调用了SetPlayWndType接口，预览画面就按照设置的比例显示。如果没有，当前预览通道是HD720p或者HD900p的分辨率，预览画面自动变成16：9的比例；如果获取不到分辨率，预览画面大小就是当前控件大小；其他分辨率时，预览画面为4：3的比例)
参数说明：
lChannelNum：播放通道号， 0 – 代表通道1，1 – 代表通道2
lProtocolType：协议类型，0 – TCP， 1 - UDP
lStreamType： 码流类型，0 表示主码流， 1 表示子码流
返回值：TRUE表示成功，FALSE表示失败。
5.2 停止预览
BOOL StopRealPlay()getsavefilename
功能：停止预览
返回值：TRUE表示成功，FALSE表示失败。
5.3 设置播放器帧缓冲区的个数
        BOOL SetRealPlayBufNumber(long lBufNumber)
        功能：设置播放器帧缓冲区的个数，在预览时才有效
        参数说明：
        lBufNumber：设置播放器帧缓冲区最大的帧数，取值为1-50。缓冲区越大，                图象越流畅；缓冲区越小，实时性越好。若是复合流建议最                    小值设置成6。
        返回值：TRUE表示成功，FALSE表示失败。
5.4 设置预览时丢B帧个数
        BOOL RealPlayThrowBFrame(long lThrowBType)
        功能：设置解码时丢弃B帧的个数，在预览时才有效
        参数说明：
        lThrowBType：丢B帧个数，0 - 不丢，1 – 丢一个， 2 – 丢2个
        返回值：TRUE表示成功，FALSE表示失败。
5.5 动态产生一个关键帧
        BOOL MakeKeyFrame(long lChannelNum)
        功能：网络预览时动态产生一个关键帧
        参数说明：
        lChannelNum：通道号
        返回值：TRUE表示成功，FALSE表示失败。
5.6 开始零通道预览
BOOL StartZeroRealPlay(long lZeroChannelNum, long lProtocolType, long lStreamType)
        功能：开始零通道预览(画面比例为4：3，暂时不支持子码流预览，零通道不能控制云台，视频参数调节)
参数说明：
lZeroChannelNum:    播放零通道号， 0 - 代表通道1，1 - 代表通道2
lProtocolType：协议类型，0 – TCP， 1 - UDP
lStreamType： 码流类型，0 表示主码流， 1 表示子码流
返回值：TRUE表示成功，FALSE表示失败。
5.7 停止零通道预览
BOOL StopZeroRealPlay()
功能：停止零通道预览
返回值：TRUE表示成功，FALSE表示失败。
5.7 零通道预览画面翻页
BOOL ZeroTurnOver(long lZeroChannelNum, BOOL bNextPreview)
功能：零通道预览画面翻页
参数说明：
lZeroChannelNum    零通道号
bNextPreview    翻页， TRUE - 下一页， FALSE - 上一页
返回值：TRUE表示成功，FALSE表示失败。
6.抓图
6.1 抓BMP图
        BOOL BMPCapturePicture(LPCTSTR  lpSavePath, BOOL bShowSaveFile)
        功能：抓BMP图，在预览时才有效
参数说明：
lpSavePath：设置保存图片的路径。默认为"C:\OCXBMPCaptureFiles" ，图片保存在写入路径的BMPCapture文件夹中
bShowSaveFile:抓图成功后是否弹出保存图片文件的文件夹
返回值：TRUE表示成功，FALSE表示失败。
6.2 抓JPEG图
            BOOL JPEGCapturePicture(long lChannelNum, short iPicSize, short iPicQuality,  LPCTSTR  lpSavePath, BOOL  bShowSaveFile)
            功能：抓JPEG图，不需要预览。当图像压缩分辨率为VGA时，支持0=CIF, 1=QCIF, 2=4CIF抓图，当分辨率为3=UXGA(1600x1200), 4=SVGA(800x600), 5=HD720p(1280x720),6=VGA,7=XVGA, 8=HD900p仅支持当前分辨率的抓图
            参数说明：
            lChannelNum：通道号。1 - 代表通道1，2 – 代表通道2
            iPicSize：分辨率 0=CIF, 1=QCIF, 2=4CIF 3=UXGA(1600x1200), 4=SVGA(800x600), 5=HD720p(1280x720),6=VGA
        iPicQuality：图片质量    0-最好 1-较好 2-一般
            lpSavePath：设置保存图片的路径。默认为"C:\OCXJPEGCaptureFiles"。图片保存在写入路径的JPEGCapture文件夹中。
            bShowSaveFile:抓图成功后是否弹出保存图片文件的文件夹
            返回值：TRUE表示成功，FALSE表示失败。
6.3 按传入文件名抓BMP图

版权声明：本站内容均来自互联网，仅供演示用，请勿用于商业和其他非法用途。如果侵犯了您的权益请与我们联系QQ:729038198，我们将在24小时内删除。