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

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

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

3、名称 参数类 型 参数性质 说 明Width long RW OCX 宽度Height long RW OCX 高度WidthBS long RO 接收到的视频的宽度HeightBS long RO 接收到的视频的高度Source BSTR RW视频源，有三种格式：1.只有 IP 地址和端口号，如：“192.168.1.128:553”，连接播放相应设备的第一个码流是音视频数据；2.“ltsp:/:/ch-s”，其中是指设备的 IP 地址， :指设备的音视频端口号，是指通道号，播放的码流号，如：“ltsp:/192.168.1.128:553/ch1-s1”表示播放设备的通道 1 的第 1个码

4、流；3.文件名的形式输入，如“c:rec-2008-09-21.esf ”，表示播放相应的录像文件AudioCodingRule long RWAudioBitRule long RWAudioVolume long RW 音量的大小FrameRate long RO 每秒显示的帧数BitRate long RO 每秒接收到的音视频流的位数IsPlaying long RO 是否正在回放，1=是 0=否，方法 Play 会把该值置 1DisconnectionTimeOut long RW 多长时间收不到数据就断开连接，缺省 5 秒ReconnectionDuration long RW 断开

5、后等待多长时间重连，缺省 5 秒UseRGB long RWOcxVer BSTR RW OCX 版本号OcxLastWrite BSTR RW OCX 的最后一次生成时间OcxFileName BSTR RW OCX 的文件名，包括路径EnableAudio long RW 板端发送过来或者录像文件的音频是否在 PC 端播放，1：Enable ；0：Disable，如果是 Disable 则 OCX 不作音频解码PlayFrameRate float RW 播放帧率ClientCode long RO 值为 0SaveAvi long RWShowWatermark long RW 显示水印

6、UnicodeOSD long RWExceptState long RWOcxAddr long RO OCX 地址EnableReceiveHttpData long RWUserAndPwd BSTR RW 连接设备的用户名和密码，格式是“: ”，例如用户名是 admin，密码是 1234，则相应的内容是“admin:1234”RecordVolume long RO 录音音量ZoomRate long RW 缩放等级ShowPlayerState long RW 显示播放状态RecFileTimeExt long RW 生成的录像文件名是否包含日期和时间；1：是；0：否EnableAl

7、armPreRecord long RW 是否允许报警预录功能，1：是；0：否AlarmPreRecordTime long RW 预录的时间（030 秒），必须 EnableAlaramPreRecord=1 才有效EnableFullscreen boolean RW 双击鼠标左键是否全屏显示，1：是；0：否SilentMode boolean RW 客户端模式SafeDisplayMode boolean RW 显示模式方法（Functions）1.函 数： long VSTPlay()参 数： 无返回值： 1：调 用成功，-1：Source 未设置说 明： 播放视频（包括实时播放和录像

8、回放） ，Source 必须先设置2函 数： long VSTStop()参 数： 无返回值： 1：调 用成功， 说 明： 停止播放视频3函 数： long VSTSnapShot(long lFileType, long lAddTimeLabel, long ulColor, LPCTSTR strPathname)参 数： lFileType：生成的图片文件格式，0：BMP； 1：JPGstrPathname：生成的文件名（包含文件路径）lAddTimeLabel，ulColor 暂未使用返回值： 0：调 用成功说 明： 对当前画面进行截图，生成 BMP 或 JPG 的图片文件4函 数：

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

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

11、howTime(long lEnable, long ulColor)参 数： lEnable：是否显示时间，0 ：否；1：是ulColor：字体颜色，其数值是蓝、绿、红 3 色相加，即 0xBBGGRR，其中BB 是蓝色的数值，GG 是绿色的数值，RR 是红色的数值，例如 0xFF0000 表示蓝色，0x00FF00 表示绿色，0x0000FF 表示红色返回值： 无说 明： 在画面上显示时间，如果是实时播放则显示 PC 当前时间，如果是录像回放，则显示录像时的时间（从录像文件里获取）7函 数： void VSTShowOcx(long lShow)参 数： lShow：是否显示， 0：否；1

12、：是返回值： 无说 明： 是否显示 OCX 控件8函 数： void VSTSetStopState(long lState)参 数： lState: 停止时是保留最后一幅画面还是黑屏0: 黑屏1: 保留最后一幅画面返回值： 无说 明： 停止时是保留最后一幅画面还是黑屏9函 数： void VSTFilePause()参 数： 无返回值： 无说 明： 回放录像时暂停10函 数： void VSTFileContinue ()参 数： 无返回值： 无说 明： 在回放录像暂停时恢复播放11函 数： long VSTStartInterPhone(LPCTSTR peerip)参 数： peerip

13、：暂未使用返回值： 0：调用成功说 明： 启动对讲，PC 端麦克风的声音在板端播放12函 数： long StopInterPhone()参 数： 无返回值： 0：调用成功说 明： 停止对讲13函 数： long IsInterPhoneRun()参 数： 无返回值： 是否正在对讲，0：否，1：是说 明： 是否正在对讲14函 数： long GetRecTotalTime ()参 数： 无返回值： 录像文件的总时长，单位是秒说 明： 获取录像文件的录像总时长，调用前必须在在 Source 里设置录像文件名15函 数： long GetCurPlaybackTime ()参 数： 无返回值： 返

14、回从开始回放录像到当前的时长（单位为秒） 说 明： 查询从开始回放录像到当前的时长16函 数： void SetPlaybackLoop(long loop)参 数： loop：是否循环回放，0：否，1：是返回值： 无说 明： 回放录像时是否循环回放17函 数： void FileJump(long pos)参 数： pos：跳转的指定位置，单位是秒返回值： 无说 明： 回放录像时跳转到指定位置18函 数： long FileForward(long speed)参 数： speed：回放的速度，speed 数值与播放速度对应如下：1：正常播放2：2 倍速度3：4 倍速度4：8 倍速度5：16

15、 倍速度6：32 倍速度7：1/2 倍速度8：1/4 倍速度9：1/8 倍速度10：1/16 倍速度11：逐帧播放，调用一次前进一帧返回值： 0：调用成功说 明： 回放录像时改变回放速度19函 数： long FileRewind(long speed)参 数： speed：倒播时跳过的关键帧数，数值越大播放速度越快返回值： 0：调用成功说 明： 倒播回放录像20函 数： void SetMDRegionBegin(long col)参 数： col：进入设置后显示的已经设置的边框颜色，其数值可参考方法 ShowTime 中参数 ulColor 的说明返回值： 无说 明： 进入移动侦测区域设置

16、21函 数： short SetEditMDRegionIndex(long nIndex)参 数： nIndex：要设置的区域号，数值范围：04返回值： 0：调用成功说 明： 指定要设置的区域，调用该方法后可以用鼠标在画面上画区域边框22函 数： void RemoveMDRegion(long nIndex)参 数： nIndex：要删除的区域号，数值范围：04返回值： 无说 明： 删除指定的侦测区域23函 数： void SetMDRegionEnd()参 数： 无返回值： 无说 明： 结束移动侦测区域设置并把设置的区域信息发送到前端设备24函 数： void ShowMDRegion(

17、long show)参 数： show：0=发生移动侦测时不显示边框1=发生移动侦测时显示边框2=无论是否发生移动侦测都显示边框返回值： 无说 明： 发生移动侦测时是否显示边框25函 数： long AddNewMDRegion()参 数： 无返回值： 1：调用成功；0：超过最大侦测区域数范围（最多只能 5 个）说 明： 增加一个移动侦测区域26函 数： long GetMDCount()参 数： 无返回值： 当前设置的移动侦测区域数说 明： 获取当前设置的移动侦测区域数27函 数： long SetMotionRegion(long Region, long l, long t, long

18、r, long b)参 数： Region：移动侦测区域号，数值范围：04l,t,r,b：侦测区域框左，上，右，下 4 个位置的坐标返回值： 0：调用成功说 明： 设置移动侦测区域，调用该方法将把相应数据发送到前端设备28函 数： long GetMDSensitivity()参 数： 无返回值： 移动侦测灵敏度说 明： 获取移动侦测的灵敏度29函 数： long SetMDSensitivity(long nSensitivity)参 数： nSensitivity：要设置的灵敏度数值，范围是 0-100返回值： 1：调用成功，0：参数超出范围（0-100）说 明： 设置移动侦测的灵敏度，设

19、置后需要调用 SetMDRegionEnd 才能发送到前端设备生效30函 数： void SetAccountsPassword(LPCTSTR accounts, LPCTSTR password)参 数： accounts：用户名，password：密码返回值： 无说 明： 设置连接设备的用户名和密码，其功能与设置属性 UserAndPwd 是一样的31函 数： void MoveOcx(long left, long top, long right, long bottom)参 数： left，top ，right， bottom 分别表示显示的方框左，上，右，下 4 个位置的坐标返回值

20、： 无说 明： 指定 OCX 的大小和位置32函 数： void RotateImage(long rotateFlag)参 数： rotateFlag，0：正常，180：180 度垂直翻转返回值： 无说 明： 图像翻转33函 数： void PtzControl(LPCTSTR szPtzCtlCmd)参 数： szPtzCtlCmd：要发送的内容格式：ptzcmd参 数： lEnable: in whether enable OSDSet 1: 显示Set 0: 不显示lX: in 显示字符串的 X 坐标lY: in 显示字符串的 Y 坐标ulColor: in 用于显示 OSD 字符串的颜色，颜色值从 0 到 16777215 nFontSize: in 字体大小strData: in 要显示的字符串内容ulColor = r | g 8 | b 16返回值： 无