监控球机开发指导文档格式.docx
《监控球机开发指导文档格式.docx》由会员分享,可在线阅读,更多相关《监控球机开发指导文档格式.docx(49页珍藏版)》请在冰豆网上搜索。
DEVIP"
192.168.1.2"
DEVPORT"
12345}}
回调函数定义
typedeflong(_stdcall*fMsgCallback)(intnMsg,void*pUserData,char*pBuf,intnLen,intnParam);
nMsg
消息号,定义见附录
pUserData
用户数据
数据指针
数据长度
nParam
常用数据格式
TIME:
YYYYMMDDHHMMSS表示年月日时分秒
调用流程
N9直通模式的调用流程
模块初始化(INIT)
登录设备(LOGIN)
视频预览(REALPLAY)
录像检索(SEARCHALL)
……
按天检索(SEARCHDAY)
录像下载(DOWNLOADVIDEO)
远程回放(REMOTEPLAY)
获取进度(GETPROGRESS)
停止预览(REALPLAYSTOP)
停止命令(STOPCOMMAND)
停止回放(REMOTEPLAYSTOP)
断开设备(LOGOUT)
模块反初始化(UNINIT)
初始化
模块初始化
INIT
程序启动时调用一次
名字
类型
含义
必须字段
CALLBACK
UINT
回调函数,接收消息
USERDATA
启用设备发现
DEVICEDISCOVER
设备UDP端口7971
连接注册服务器
CONNECTREGISTER
反向模式需要,内部自动重连,只需调用一次
IP
STRING
IP地址
√
PORT
端口
回调函数,接收注册服务器上下线消息
NMSG_REG_ONLINE
NMSG_REG_OFFLINE
连接NAT服务器
CONNECTNATSERVER
N9–NAT模式需要,内部自动重连,只需调用一次
回调函数,接收服务器上下线消息
监听端口
LISTEN
反向模式需要
MYIP
本机IP地址
模块反初始化
UNINIT
程序退出时调用一次
登录设备
LOGIN
设备句柄返回在pulRet,所有对设备的操作都通过此句柄进行
N9非阻塞模式会自动重连,回调上下线消息
DEVTYPE
设备类型
0:
N9–TCP直连模式
1:
X11协议
2:
808协议
3:
N9-TCP反向模式
4:
N9-NAT模式
DEVIP
设备IP或ID
DEVPORT
设备端口
USERNAME
用户名
PASSWORD
密码
回调函数fMsgCallback
回调函数用户数据
TRANSIP
转发IP地址
TRANSPORT
转发端口
BLOCK
非阻塞模式
阻塞模式(默认值)
CLIENTID
客户端ID
断开设备
LOGOUT
HDEV
设备句柄
设备在线状态
ISONLINE
服务器模式有效,结果返回在pulRet,为1在线
获取设备序列号
GETDEVSERIAL
返回字符串到pBuf
视频预览
视频预览开始
REALPLAY
非阻塞连接,预览句柄返回在pulRet,是否真正成功需要通过回调函数
CHANNEL
通道号,从0开始
STREAMTYPE
码流类型
子码流
主码流
手机码流
HWND
窗口句柄
NMSG_FILE_HEAD
NMSG_VIDEO_STREAM
NMSG_DEV_CODE
NMSG_DISCONNECT
视频预览抓图
CAPTUREPIC
HPLAY
预览句柄
FILENAME
保存文件名,完整路径,需用/分割符
请求I帧
REQUESTIFRAME
通道号,按位表示
切换码流
REALPLAYSWITCHSTREAM
暂停网络
REALPLAYPAUSE
VAL
恢复
暂停
开始录像
RECORDSTART
停止录像
RECORDSTOP
获取解码器句柄
GETDECODER
(如果成功返回句柄在pulRet,当HPLAY被关闭后此句柄不能再使用)
播放句柄
视频预览停止
REALPLAYSTOP
录像检索下载及回放
搜索有录像的天(所有)
SEARCHALL
流类型
COUNT
数组个数
CALENDER[]
YYYYMMDDXXXXXXXX格式,YYYY为年,MM为月,DD为天,后8字符为16进制整数。
bit0:
普通视频文件
bit1:
报警文件
bit2:
图片
bit3:
打卡记录
搜索有录像的天(按月)
SEARCHMONTH
(如果成功返回结果在pulRet,按位表示)
YEAR
年
MONTH
月
搜索某天录像
SEARCHDAY
STARTTIME
开始时间
ENDTIME
结束时间
文件合计
FILENAME[]
文件名
CHANNEL[]
通道号
TYPE[]
正常录像
报警录像
SIZE[]
文件大小(暂无)
STARTTIME[]
ENDTIME[]
下载录像文件
DOWNLOADVIDEO
(下载句柄返回在pulRet,下载进度通过GETPROGRESS获取)
DEVFILENAME
设备文件名
SAVEFILENAME
开始时间,仅剪辑需要,下载整个文件可为空,为绝对时间
APPEND
0:
正常下载(默认)
断点续传
远程多路回放
REMOTEPLAY
(回放句柄返回在pulRet)
HWND[]
UINT数组
FILETYPE
文件类型
正常和报警录像
NMSG_JSON
远程多路回放拖动
REMOTEPLAYSEEK
回放句柄
播放时间
远程多路回放网络丢帧
REMOTEPLAYLOSE
恢复正常
丢帧
远程多路回放停止
REMOTEPLAYSTOP
语音对讲
语音对讲开始
TALKSTART
语音对讲停止
TALKSTOP
数据透传
信令指令透传
SENDTODEVICE
透传指令放到pBuf,如果有返回数据,也通过pBuf返回
KEYNAME
指令关键字,用于等待应答
TIMEOUT
等待设备应答时间,单位毫秒,为0不等待
UDP指令透传
SENDTODEVICE2
设备IP
创建链路
CREATETRANSLINK
句柄返回在pulRet
NMSG_TRANS_DATA
发送数据
SENDTRANSDATA
pBuf数据指针,nLen数据长度
HANDLE
链路句柄
关闭链路
CLOSETRANSLINK
808命令
回拨电话
DIALBACK
TELNUM
电话号码
设备配置
获取设备配置
GETCONFIG
N9设备返回json字符串到pBuf,详见设备协议文档
TYPE
网络参数
报警参数
存储参数
视频参数
5:
设备管理参数
以下应答为808协议,N9返回设备定义的JSON字符串
LIMITSPEED
限速(km/h)
GPSINTERVAL
GPS时间间隔(秒)
SLEEPGPSINTERVAL
休眠时GPS时间间隔(秒)
LIVEINTERVAL
心跳包时间间隔(秒)
TCPPORT
TCP端口
UDPPORT
UDP端口
GPSTYPE
定时
定距
定时和定距
APN
拨号APN
APNUSERNAME
拨号用户名
APNPASSWORD
拨号密码
SERVERADDR
服务器地址
GPSDISTANCE
GPS距离汇报间隔(米)
CORNER
拐点补传角度<
180
OVERSPEEDTIME
超速持续时间(秒)
DRIVETIMEALONG
连续驾驶时间上限(秒)
DRIVETIMEDAY
一天累计驾驶时间上限(秒)
MILEAGE
里程表(公里)
CARNUMBER
车牌号
保存设备配置
SETCONFIG
808协议参数和获取相同,N9协议通过pBuf传入JSON字符串
导出设备配置文件
GETCONFIGFILE
导出文件名,完整路径,需用/分割符
导入设备配置文件
SETCONFIGFILE
导入文件名,完整路径,需用/分割符
获取视频参数
GETVIDEOPARAM
通道数
BRIGHTMIN
INT
亮度最小值
BRIGHTMAX
亮度最大值
CHORMAMIN
色度最小值
CHORMAMAX
色度最大值
CONTRASTMIN
对比度最小值
CONTRASTMAX
对比度最大值
SATURAMIN
饱和度最小值
SATURAMAX
饱和度最大值
BRIGHT[]
通道亮度
CHORMA[]
通道色度
CONTRAST[]
通道对比度
SATURA[]
通道饱和度
设置视频参数
SETVIDEOPARAM
文本下发
SENDTEXT
TEXT
文本信息
围栏下发(多边形)
SETPOLYGON
AREAID
区域ID
限速
ALARMMODE
进入报警
离开报警
NODECOUNT
顶点数
LONGITUDE[]
经度
LATITUDE[]
ST