监控球机开发指导文档格式.docx

1、DEVIP192.168.1.2DEVPORT12345回调函数定义typedef long （_stdcall *fMsgCallback）（int nMsg, void* pUserData, char* pBuf, int nLen, int nParam）;nMsg消息号，定义见附录pUserData用户数据数据指针数据长度nParam常用数据格式TIME: YYYYMMDDHHMMSS表示年月日时分秒调用流程N9直通模式的调用流程模块初始化（INIT）登录设备（LOGIN）视频预览（REALPLAY）录像检索（SEARCHALL）按天检索（SEARCHDAY）录像下载（DOWNLOA

2、DVIDEO）远程回放（REMOTEPLAY）获取进度（GETPROGRESS）停止预览（REALPLAYSTOP）停止命令（STOPCOMMAND）停止回放（REMOTEPLAYSTOP）断开设备（LOGOUT）模块反初始化（UNINIT）初始化模块初始化INIT程序启动时调用一次名字类型含义必须字段CALLBACKUINT回调函数，接收消息USERDATA启用设备发现DEVICEDISCOVER设备UDP端口7971连接注册服务器CONNECTREGISTER 反向模式需要，内部自动重连，只需调用一次IPSTRINGIP地址PORT端口回调函数，接收注册服务器上下线消息NMSG_REG_O

3、NLINENMSG_REG_OFFLINE连接NAT服务器CONNECTNATSERVERN9 NAT模式需要，内部自动重连，只需调用一次回调函数，接收服务器上下线消息监听端口LISTEN反向模式需要MYIP本机IP地址模块反初始化UNINIT程序退出时调用一次登录设备LOGIN设备句柄返回在pulRet,所有对设备的操作都通过此句柄进行N9非阻塞模式会自动重连，回调上下线消息DEVTYPE设备类型0：N9 TCP直连模式1：X11协议2：808协议3：N9 - TCP反向模式4：N9 - NAT模式DEVIP设备IP或IDDEVPORT设备端口USERNAME用户名PASSWORD密码回调函

4、数fMsgCallback回调函数用户数据TRANSIP转发IP地址TRANSPORT转发端口BLOCK非阻塞模式阻塞模式（默认值）CLIENTID客户端ID断开设备LOGOUTHDEV设备句柄设备在线状态ISONLINE服务器模式有效，结果返回在pulRet，为1在线获取设备序列号GETDEVSERIAL返回字符串到pBuf视频预览视频预览开始REALPLAY非阻塞连接，预览句柄返回在pulRet，是否真正成功需要通过回调函数CHANNEL通道号，从0开始STREAMTYPE码流类型子码流主码流手机码流HWND窗口句柄NMSG_FILE_HEADNMSG_VIDEO_STREAMNMSG_D

5、EV_CODENMSG_DISCONNECT视频预览抓图CAPTUREPICHPLAY预览句柄FILENAME保存文件名，完整路径，需用/分割符请求I帧REQUESTIFRAME通道号，按位表示切换码流REALPLAYSWITCHSTREAM暂停网络REALPLAYPAUSEVAL恢复暂停开始录像RECORDSTART停止录像RECORDSTOP获取解码器句柄GETDECODER（如果成功返回句柄在pulRet，当HPLAY被关闭后此句柄不能再使用）播放句柄视频预览停止REALPLAYSTOP录像检索下载及回放搜索有录像的天（所有）SEARCHALL流类型COUNT数组个数CALENDERYY

6、YYMMDDXXXXXXXX格式，YYYY为年，MM为月，DD为天，后8字符为16进制整数。bit0:普通视频文件bit1:报警文件 bit2:图片 bit3:打卡记录搜索有录像的天（按月）SEARCHMONTH（如果成功返回结果在pulRet，按位表示）YEAR年MONTH月搜索某天录像SEARCHDAYSTARTTIME开始时间ENDTIME结束时间文件合计FILENAME文件名CHANNEL通道号TYPE正常录像报警录像SIZE文件大小（暂无）STARTTIMEENDTIME下载录像文件DOWNLOADVIDEO（下载句柄返回在pulRet，下载进度通过GETPROGRESS获取）DEV

7、FILENAME设备文件名SAVEFILENAME开始时间，仅剪辑需要，下载整个文件可为空，为绝对时间APPEND0: 正常下载（默认）断点续传远程多路回放REMOTEPLAY（回放句柄返回在pulRet）HWNDUINT数组FILETYPE文件类型正常和报警录像NMSG_JSON远程多路回放拖动REMOTEPLAYSEEK回放句柄播放时间远程多路回放网络丢帧REMOTEPLAYLOSE恢复正常丢帧远程多路回放停止REMOTEPLAYSTOP语音对讲语音对讲开始TALKSTART语音对讲停止TALKSTOP数据透传信令指令透传SENDTODEVICE透传指令放到pBuf，如果有返回数据，也通过

8、pBuf返回KEYNAME指令关键字，用于等待应答TIMEOUT等待设备应答时间，单位毫秒，为0不等待UDP指令透传SENDTODEVICE2设备IP创建链路CREATETRANSLINK句柄返回在pulRetNMSG_TRANS_DATA发送数据SENDTRANSDATApBuf数据指针，nLen数据长度HANDLE链路句柄关闭链路CLOSETRANSLINK808命令回拨电话DIALBACKTELNUM电话号码设备配置获取设备配置GETCONFIGN9设备返回json字符串到pBuf，详见设备协议文档TYPE网络参数报警参数存储参数视频参数5：设备管理参数以下应答为808协议，N9返回设备

9、定义的JSON字符串LIMITSPEED限速（km/h）GPSINTERVALGPS时间间隔（秒）SLEEPGPSINTERVAL休眠时GPS时间间隔（秒）LIVEINTERVAL心跳包时间间隔（秒）TCPPORTTCP端口UDPPORTUDP端口GPSTYPE定时定距定时和定距APN拨号APNAPNUSERNAME拨号用户名APNPASSWORD拨号密码SERVERADDR服务器地址GPSDISTANCEGPS距离汇报间隔（米）CORNER拐点补传角度 180OVERSPEEDTIME超速持续时间（秒）DRIVETIMEALONG连续驾驶时间上限（秒）DRIVETIMEDAY一天累计驾驶时间

10、上限（秒）MILEAGE里程表（公里）CARNUMBER车牌号保存设备配置SETCONFIG808协议参数和获取相同，N9协议通过pBuf传入JSON字符串导出设备配置文件GETCONFIGFILE导出文件名，完整路径，需用/分割符导入设备配置文件SETCONFIGFILE导入文件名，完整路径，需用/分割符获取视频参数GETVIDEOPARAM通道数BRIGHTMININT亮度最小值BRIGHTMAX亮度最大值CHORMAMIN色度最小值CHORMAMAX色度最大值CONTRASTMIN对比度最小值CONTRASTMAX对比度最大值SATURAMIN饱和度最小值SATURAMAX饱和度最大值BRIGHT通道亮度CHORMA通道色度CONTRAST通道对比度SATURA通道饱和度设置视频参数SETVIDEOPARAM文本下发SENDTEXTTEXT文本信息围栏下发（多边形）SETPOLYGONAREAID区域ID限速ALARMMODE进入报警离开报警NODECOUNT顶点数LONGITUDE经度LATITUDEST