清远环境保护局污染源在线监控监测平台

1、清远市环境保护局污染源在线监控、监测平台现场视频数据上报通讯协议清远市环境保护污染源在线监控、监测平台使用的是有别于其他地区的历史图片上报模式。该模式要求现场视频服务器（或摄像枪）以5分钟为间隔，上报一张现场端实时高清图片（4CIF）及远程实时视频结合，现场端不保存历史数据。1、摄像枪要求：具备D1、4CIF、CIF多种实时视频效果；具备定时抓拍及上报功能；安装位置能涵盖环保部门日常监管要求；2、现场视频服务器（或摄像枪）至少每天一次，向中国国家授时中心进行对时，确保视频服务器时间正确；3、5分钟历史图片上报历史图片定时5分钟抓拍一张具有4CIF效果的现场图片，要求图片内标注有排污企业名称、抓

2、拍时间、排放口名称信息；历史图片采用FTP方式实时上报到清远市环境保护局平台，上报时只需按固定的用户名、密码上报即可。图片文件名无须特别格式化，平台收到文件后将自动按照上报的用户名（MN码）及平台时间统一生成新的文件名予以保存。图片文件格式为4CIF大小的JPG文件。34、实时视频我局平台采用WEB方式结合现场数据显示现场视频。现场端必须按照特定的函数接口与平台对接。4.1、供应商须向清远市环境保护局监察分局提供基于WEB接口的OCX插件；4.2、OCX插件必须满足以下要求：属性（Proper）（参数性质：rw-可读写，ro-只读）名称参数类型参数性质说明WidthlongRWOCX宽度Hei

3、ghtlongRWOCX高度WidthBSlongRO接收到的视频的宽度HeightBSlongRO接收到的视频的高度SourceBSTRRW视频源，有三种格式：1只有IP地址和端口号，如：“28:553”，连接播放相应设备的第一个码流是音视频数据；2.“ltsp:/:/ch-s”，其中是指设备的IP地址，:指设备的音视频端口号，是指通道号，播放的码流号，如：“ltsp:/28:553/ch1-sT表示播放设备的通道1的第1个码流；3文件名的形式输入，如“c:rec-2008-09-21.esf”，表示播放相应的录像文件AudioCodingRulelongRWAudioBitRulelong

4、RWAudioVolumelongRW音量的大小FrameRatelongRO每秒显示的帧数BitRatelongRO每秒接收到的音视频流的位数IsPlayinglongRO是否正在回放，1=是0=否，方法Play会把该值置1DisconnectionTimeOutlongRW多长时间收不到数据就断开连接，缺省5秒ReconnectionDurationlongRW断开后等待多长时间重连，缺省5秒UseRGBlongRWOcxVerBSTRRWOCX版本号OcxLastWriteBSTRRWOCX的最后一次生成时间OcxFileNameBSTRRWOCX的文件名，包括路径EnableAudio

5、longRW板端发送过来或者录像文件的音频是否在PC端播放，1：Enable；0：Disable，如果是Disable则OCX不作音频解码PlayFrameRatefloatRW播放帧率ClientCodelongRO值为0SaveAvilongRWShowWatermarklongRW显示水印UnicodeOSDlongRWExceptStatelongRWOcxAddrlongROOCX地址EnableReceiveHttpDatalongRWUserAndPwdBSTRRW连接设备的用户名和密码，格式是“:”，例如用户名是admin，密码是1234，则相应的内容是“admin:1234”

6、RecordVolumelongRO录音音量ZoomRatelongRW缩放等级ShowPlayerStatelongRW显示播放状态RecFileTimeExtlongRW生成的录像文件名是否包含日期和时间；1：是；0：否EnableAlarmPreRecordlongRW是否允许报警预录功能，1：是；0：否AlarmPreRecordTimelongRW预录的时间(030秒)，必须EnableAlaramPreRecord=1才有效EnableFullscreenbooleanRW双击鼠标左键是否全屏显示，1：是；0：否SilentModebooleanRW客户端模式SafeDisplay

7、ModebooleanRW显示模式方法(Functions)1.函数：longVSTPlay()参数：无返回值：1调用成功，-1Source未设置说明：播放视频(包括实时播放和录像回放)，Source必须先设置2函数：longVSTStop()参数：无返回值：1：调用成功，说明：停止播放视频函数：longVSTSnapShot(longlFileType,longlAddTimeLabel,longulColor,LPCTSTRstrPathname)参数：IFileType生成的图片文件格式，0：BMP；1：JPGstrPathname：生成的文件名(包含文件路径)lAddTimeLabel

8、,ulColor暂未使用返回值：0：调用成功说明：对当前画面进行截图，生成BMP或JPG的图片文件4函数：longVSTRecord(longlDoRecord,LPCTSTRstrFilename,longlDurationTime)参数：IDoRecord：开始或停止录像，0：停止；1：开始strFilename:生成的录像文件名(包含文件路径)lDurationTime:每个录像文件的时长，即录像文件达到指定时长时会自动生成一个新的文件，单位为秒，如果为0表示不分割返回值：0：调用成功说明：把音视频数据保存到磁盘，文件名是否增加日期时间由属性RecFileTimeExt决定5函数：lon

9、gVSTRecord2(longlDoRecord,LPCTSTRstrFilename,longlDurationTime,longlAddTimeToFileName)参数：lDoRecord：开始或停止录像，0：停止；1：开始strFilename:生成的录像文件名(包含文件路径)lDurationTime:每个录像文件的时长，即录像文件达到指定时长时会自动生成一个新的文件，单位为秒，如果为0表示不分割lAddTimeToFileName文件名是否自动增加日期时间，0：否；1：是返回值：1：调用成功，说明：把音视频数据保存到磁盘，增加一个参数，不受属性RecFileTimeExt影响6函

10、数：voidVSTShowTime(longlEnable,longulColor)参数：IEnable:是否显示时间，0：否；1：是ulColor:字体颜色，其数值是蓝、绿、红3色相加，即0 xBBGGRR，其中BB是蓝色的数值，GG是绿色的数值，RR是红色的数值，例如0 xFF0000表示蓝色，0 x00FF00表示绿色，0 x0000FF表示红色返回值：无说明：在画面上显示时间，如果是实时播放则显示PC当前时间，如果是录像回放，则显示录像时的时间(从录像文件里获取)7函数：voidVSTShowOcx(longlShow)参数：IShow:是否显示，0：否；1：是返回值：无20说明：是否

11、显示OCX控件8函数：voidVSTSetStopState(longlState)参数：lState:停止时是保留最后一幅画面还是黑屏0:黑屏1:保留最后一幅画面返回值：无说明：停止时是保留最后一幅画面还是黑屏9函数：voidVSTFilePause()参数：无返回值：无说明：回放录像时暂停10函数：voidVSTFileContinue()参数：无返回值：无说明：在回放录像暂停时恢复播放11函数：longVSTStartInterPhone(LPCTSTRpeerip)参数：peerip:暂未使用返回值：0：调用成功说明：启动对讲，PC端麦克风的声音在板端播放12函数：longStopIn

12、terPhone()参数：无返回值：0：调用成功说明：停止对讲13函数：longIsInterPhoneRun()参数：无返回值：是否正在对讲，0：否，1：是说明：是否正在对讲14函数：longGetRecTotalTime()参数：无返回值：录像文件的总时长，单位是秒说明：获取录像文件的录像总时长，调用前必须在在Source里设置录像文件名15函数：longGetCurPlaybackTime()参数：无返回值：返回从开始回放录像到当前的时长(单位为秒)说明：查询从开始回放录像到当前的时长16函数：voidSetPlaybackLoop(longloop)参数：loop：是否循环回放，0：否

13、，1：是返回值：无说明：回放录像时是否循环回放17函数：voidFileJump(longpos)参数：pos:跳转的指定位置，单位是秒返回值：无说明：回放录像时跳转到指定位置18函数：longFileForward(longspeed)参数：speed:回放的速度，speed数值与播放速度对应如下：1：正常播放2：2倍速度3：4倍速度4：8倍速度5：16倍速度6：32倍速度7：1/2倍速度8：1/4倍速度9：1/8倍速度10：1/16倍速度11：逐帧播放，调用一次前进一帧返回值：0：调用成功说明：回放录像时改变回放速度19函数：longFileRewind(longspeed)参数：spee

14、d:倒播时跳过的关键帧数，数值越大播放速度越快返回值：0：调用成功说明：倒播回放录像函数：voidSetMDRegionBegin(longcol)参数：col：进入设置后显示的已经设置的边框颜色，其数值可参考方法ShowTime中参数ulColor的说明返回值：无说明：进入移动侦测区域设置21函数：shortSetEditMDRegionIndex(longnIndex)参数：nlndex：要设置的区域号，数值范围：04返回值：0：调用成功说明：指定要设置的区域，调用该方法后可以用鼠标在画面上画区域边框22函数：voidRemoveMDRegion(longnIndex)参数：nlndex:

15、要删除的区域号，数值范围：04返回值：无说明：删除指定的侦测区域23函数：voidSetMDRegionEnd()参数：无返回值：无说明：结束移动侦测区域设置并把设置的区域信息发送到前端设备24函数：voidShowMDRegion(longshow)参数：show：0=发生移动侦测时不显示边框1=发生移动侦测时显示边框2=无论是否发生移动侦测都显示边框返回值：无说明：发生移动侦测时是否显示边框25函数：longAddNewMDRegion()参数：无返回值：1：调用成功；0：超过最大侦测区域数范围(最多只能5个)说明：增加一个移动侦测区域26函数：longGetMDCount()参数：无返回

16、值：当前设置的移动侦测区域数说明：获取当前设置的移动侦测区域数27函数：longSetMotionRegion(longRegion,longl,longt,longr,longb)参数：Region：移动侦测区域号，数值范围：04I,t,r,b：侦测区域框左，上，右，下4个位置的坐标返回值：0：调用成功说明：设置移动侦测区域，调用该方法将把相应数据发送到前端设备28函数：longGetMDSensitivity()参数：无返回值：移动侦测灵敏度说明：获取移动侦测的灵敏度29函数：longSetMDSensitivity(longnSensitivity)参数：nSensitivity：要设置

17、的灵敏度数值，范围是0-100返回值：1：调用成功，0：参数超出范围(0-100)说明：设置移动侦测的灵敏度，设置后需要调用SetMDRegionEnd才能发送到前端设备生效30函数：voidSetAccountsPassword(LPCTSTRaccounts,LPCTSTRpassword)参数：accounts:用户名，password:密码返回值：无说明：设置连接设备的用户名和密码，其功能与设置属性UserAndPwd是一样的31函数：voidMoveOcx(longleft,longtop,longright,longbottom)参数：left,top，right，bottom分别

18、表示显示的方框左，上，右，下4个位置的坐标返回值：无说明：指定OCX的大小和位置32函数：voidRotateImage(longrotateFlag)参数：rotateFlag，0：正常，180：180度垂直翻转返回值：无说明：图像翻转33函数：voidPtzControl(LPCTSTRszPtzCtlCmd)参数：szPtzCtICmd：要发送的内容格式ptzcmd&baud=2400n81&cmd=ff010004200025&pause=2000&cmd=ff010000000001其中“baud=2400n81”是设置RS485串口的参数，“2400”是串口的波特率,可改为其他数值

19、，包括：1200、2400、4800、9600、19200,“n81”分别表示串口的校验位，数据位和停止位，一般情况不需要更改；“&cmd=ff010004200025”是向RS485发送的数据，每两个字符表示一个数据，以16进制表示，5010004200025”表示向RS485发送FF010004200025这7个16进制的数据；“&pause=2000”表示向RS485发送下一串数据的间隔时间，单位是毫秒；“&cmd=ff010000000001”是指间隔pause时间后发送的下一串数据。以上命令表示串口以2400bps的波特率先发送FF010004200025这7个16进制的数据，等待2

20、000毫秒后再发送FF010000000001这7个16进制的数据；注：“&pause=2000&cmd=ff010000000001”是为了方便某些云台的设置才增加的，如果所用云台控制正常，可以不增加，只需要前面的命令就可以。返回值：无说明：把指定的内容发送到设备的485串口(PTZ)34函数：voidDrawRect(longIndex,longlEnable,longLX,longLy,longRX,longRy,longulColor,longPenWidth)参数：Index:方框序号，数值范围0-4IEnable：是否显示该序号的方框LX,Ly：方框的左上角坐标RX，Ry：方框的右

21、下角坐标ulColor：方框边沿线颜色，其数值可参考方法ShowTime中参数ulColor的说明PenWidth：方框边沿线宽度返回值：无说明：在画面上显示方框35函数：longAlarmRecord(longlDoRecord,LPCTSTRstrFileName,longlDurativeTime,longlAddTimeToFileName)参数：lDoRecord：0=停止录像，1=开始录像strFileName：录像文件名IDurativeTime：录像时长lAddTimeToFileName：文件名是否自动增加日期时间，0=否；1=是返回值：1：调用成功；-1：正在录像说明：进行

22、报警录像36函数：longRebootServer()参数：无返回值：1：调用成功说明：重启前端设备424237函数：longSyncServer()参数：无返回值：1：调用成功说明：把前端设备的时间调整为当前计算机的时间38函数：longSetPlayMode(longnPlayMode,longnModeParam)参数：nPlayMode：播放模式，0=正常播放，3=只录不播，此时前端设备会有音视频数据传送过来，但是计算机不会解码播放，用于只录像不播放；nModeParam：暂未使用返回值：1：调用成功说明：设置播放模式39函数：longGetCamColor(longnType)参数：

23、nType：需获取参数类型，0=亮度，1=对比度，2=色度，3=饱和度返回值：相应类型的参数值说明：获取前端设备亮度、对比度、色度和饱和度的数值40函数：longSetCamColor(longnType,longnValue)参数：nType：需获取参数类型，0=亮度，1=对比度，2=色度，3=饱和度nValue：相应类型的参数值返回值：1：调用成功说明：设置前端设备亮度、对比度、色度和饱和度的数值41函数：voidShowOSD(LONGlEnable,LONGlX,LONGlY,ULONGulColor,LONGnFontSize,BSTRstrData);参数：lEnable:inwh

24、etherenableOSDSet1:显示Set0:不显示lX:in显示字符串的X坐标lY:in显示字符串的Y坐标ulColor:in用于显示OSD字符串的颜色，颜色值从0到16777215nFontSize:in字体大小strData:in要显示的字符串内容ulColor=r|g8|b16返回值：无说明：显示OSD函数：voidShowOSD2(LONGIndex,LONGlEnable,LONGLx,LONGLy,ULONGulColor,LONGnFontSize,BSTRstrData)参数：Index:OSD的个数，范围：04lEnable:1:显示0:不显示Lx:X坐标Ly:Y坐标

25、ulColor:用于显示OSD字符串的颜色nFontSize:字体大小strData:要显示的字符串内容返回值：无说明：显示OSD，同一时间可以显示5串字符43函数：voidSetCutPixels(USHORTnD1Left,USHORTnD1Right,USHORTnCIFLeft,USHORTnCIFRight,USHORTnFIELDLeft,USHORTnFIELDRight,USHORTnQCIFLeft,USHORTnQCIFRight);参数：nD1Left:in需裁剪的D1的左侧宽度nD1Right:in需裁剪的D1的右侧宽度nCIFLeft:in需裁剪的CIF的左侧宽度nC

26、IFRight:in需裁剪的CIF的右侧宽度nFIELDleft:in需裁剪的FIELD的左侧宽度nFIELDRight:in需裁剪的FIELD的右侧宽度nQCIFLeft:in需裁剪的QCIF的左侧宽度nQCIFRight:in需裁剪的QCIF的右侧宽度返回值：无说明：切掉部分边框44函数：LONGGetRecTotalTime()参数：无返回值：返回总的录像时间说明：查询从开始录像到当前的时长(单位为秒)，该数值会一直累加到停止录像为止，就是说如果是分割录像也不会影响该数值。45函数：LONGGetCurPlaybackTime()参数：无返回值：返回-1为失败(如不是在回放状态)说明：查

27、询从开始回放录像到当前的时长(单位为秒)46函数：LONGGetFileRecTime(LPCTSTRfname)参数：无返回值：说明：获取指定录像文件的总时长，单位为秒47函数：voidDrawRect(LONGIndex,LONGlEnable,LONGLX,LONGLY,LONGRX,LONGRY,ULONGulColor,LONGPenWidth);参数：Index:框的个数，范围：04lEnable:1:画框0:不画框LX:左上角的X坐标Ly:左上角的Y坐标Rx:右上角的X坐标Ry:右上角的Y坐标ulColor:框的颜色PenWidth:画笔的宽度返回值：无说明：在画面显示边框，最多

28、显示5个事件(Event)48函数：voidCreateFinish()参数：无返回值：无说明：OCX创建完成49函数：voidEmdMotion(LPCTSTRdesc)参数：desc：事件信息的内容，其格式如下：ALARM：流水号rnType:信息类型rnTime:产生时间rnDescribe:信息描述rn其中：流水号表示是第几条告警信息，以10进制数字表示，用户可以通过该数值来判断每次查询到的信息是不是同一条；信息类型表示该条告警信息的类型，以字符串表示，其中“md”表示该条信息是移动侦测报警的信息；产生时间表示产生该条信息时的时间，以10进制数字表示，单位是秒，是指从1970年1月1日

29、0:0:00到信息产生时所经过的秒数；信息描述是对该告警信息的详细描述，以字符串表示，每一项以逗号相隔，不同的信息类型有不同的内容格式；的格式是：Channel=通道号,Stream=,Areald=,Area,宽,是指视频输入的通道号，以10进制数字表示，由于本摄像机只有一路视频输入，所以该值恒为0；是指哪一路码流发生移动侦测报警，以10进制数字表示，从0开始，如果是第一路码流，该数值为0，如果是第二路码流，该数值为1；是指发生报警的侦测区域号，其数值范围是04；,高是指发生移动侦测报警时相应侦测区域的X,Y坐标,以及宽度和高度。返回值：无说明：发生移动侦测事件时上报50函数：voidLBu

30、ttonDblClk()参数：无返回值：无说明：鼠标左键双击51函数：voidLButtonDown()参数：无返回值：无说明：鼠标左键按下52函数：voidLButtonUp()参数：无返回值：无说明：鼠标左键弹起53函数：voidRButtonDblClk()参数：无返回值：无说明：鼠标右键双击54函数：voidRButtonDown()参数：无返回值：无说明：鼠标右键按下55函数：voidRButtonUp()参数：无返回值：无说明：鼠标右键弹起56函数：voidReceiveFirstVOL()参数：无返回值：无说明：打开前端设备的音视频通道成功，此时可以获取音视频信息，如WidthB

31、S，HeightBS57函数：voidPlayStop()参数：无返回值：无说明：播放停止58函数：voidRecordAlarmBegin(LPCTSTRfilename)参数：filename报警录像的文件名返回值：无说明：开始报警录像59函数：voidRecordAlarmStop()参数：无返回值：无说明：停止报警录像60函数：voidRecordBegin(LPCTSTRfilename)参数：filename：录像文件名返回值：无说明：开始录像增加的函数61函数：voidInvalidate(longbErase)参数：bErase：返回值：无说明：62函数：voidShowTim

32、e2(longlEnable,longLx,longLy,longulColor,longlFontSize)参数：lEnable：Lx：显示的X坐标Ly：显示的Y坐标ulColor：颜色IFontSize:字体的大小返回值：无说明：设置显示时间63函数：voidStartOnlyConnect();参数：无返回值：无说明：仅接收音视频数据，不作解码和播放，调用Record或Record2可录像，调用Stop可断开连接，调用前必须设置Source属性。64函数：shortGetOcxInfo(BSTR*ver,BSTR*time,BSTR*name)参数：ver:存放OCX的版本信息time:

33、时间name：返回值：1：调用成功说明：获取OCX的信息65函数：voidSetSlaveControlAddress(shortidx,longaddress)参数：idx：address：返回值：无说明：设置子空件地址/本身是父,子销毁的时候要通知父设置父播放器的句柄，句柄存放于nParam166函数：longResetServer()参数：无返回值：0：调用成功说明：将服务器恢复到出厂时的设置67函数：longUpdateServer()参数：无返回值：1：调用成功，0：调用不成功说明：更新前端服务器68函数：longDoServerSet(BSTRtsServSet)参数：tsServ

34、Set：要发送的命令返回值：1：调用成功说明：给IPCam发送参数如MAINrnAudiolnType=%drn,并执行该操作69函数：BSTRGetDVSetup()参数：无返回值：说明：获取DV设置/如果子获取不到,就从父里面得到,用户点选中的播放器70函数：shortSearchCam(shortbSearch)参数：bSearch：返回值：0：调用成功说明：搜索IPcam71函数：longRecordEx(BSTRlpszName,longnType,longnTotalSeconds,longnFlags)参数：IpszName:录像保存的文件名nType:录像类型nTotalSec

35、onds：录像总时间长度nFlags：录像标志返回值：说明：录像72函数：booleanStopRecord(BSTRlpszFileName,longnType)参数：lpszFileName：nType：返回值：0：调用失败说明：停止录像73函数：longSetAudioInputType(longnInputType)参数：nInputType:音频输入类型,0-linein,1-mic差分，2-mic单声道返回值：0：调用成功说明：设置音频输入类型74函数：BSTRGetDevCfgDirect()参数：无返回值：返回设备的配置参数说明：直接单独获取设备的配置参数(无需连接视频，注意是同步执行),用于设备端无法启动编码器时校正设备参数75函数：longSetDevCfgDirect(BSTRlpszDevCfg)参数：IpszDevCfg：设备参数文件的指针返回值：FALSE：调用失败，TRUE:调用成功说明：直接单独设置设备的参数(无需连接视频，注意是同步执行),用于设备端无法启动编码器时校正设备参数76函数：BSTRGetUriByName(BSTRpszName)参数：pszName：返回值：说明：通过名称获取URI77函数：BSTRGetServerDevLi