视频会议H323和SIP相关接口协议Word下载.docx

1、3.5.2 应答包 143.5.3 返回码 143.5.4 说明 143.6 请求信息数据 153.6.1 请求包 153.6.2 应答包 153.6.3 返回码 153.6.4 说明 153.7 查询设备配置 153.7.1 请求包 153.7.2 应答包 163.7.3 返回码 163.7.4 说明 163.8 保存设备配置 163.8.1 请求包 163.8.2 应答包 163.8.3 返回码 163.8.4 说明 163.9 CU向NCMC登录设备 173.9.1 请求包 173.9.2 应答包 173.9.3 返回码 173.10 NCMC登录设备 173.10.1 请求包 173.

2、10.2 应答包 183.10.3 返回码 183.11 CU向NTDC登录设备 183.11.1 请求包 183.11.2 应答包 183.11.3 返回码 193.11.4 说明 193.12 设备登出 193.12.1 请求包 193.12.2 应答包 193.12.3 返回码 193.13 设备连接状态通知 203.13.1 请求包 203.13.2 应答包 203.13.3 返回码 203.13.4 说明 203.14 查询权限 203.14.1 请求包 203.14.2 应答包 213.14.3 返回码 213.15 开始实时监视 213.15.1 请求包 213.15.2 应答包

3、 213.15.3 返回码 223.15.4 说明 223.16 媒体数据通道验证 223.16.1 请求包 223.16.2 应答包 223.16.3 返回码 223.16.4 说明 223.17 关闭实时监视 233.17.1 请求包 233.17.2 应答包 233.17.3 返回码 233.18 多画面预览 233.18.1 请求包 233.18.2 应答包 243.18.3 返回码 243.19 关闭多画面预览 243.19.1 请求包 243.19.2 应答包 243.19.3 返回码 243.20 录像查询 253.20.1 请求包 253.20.2 应答包 253.20.3 返

4、回码 253.21 网络回放 253.21.1 请求包 253.21.2 应答包 263.21.3 返回码 263.21.4 说明 263.22 关闭回放 263.22.1 请求包 263.22.2 应答包 273.22.3 返回码 273.23 回放暂停 273.23.1 请求包 273.23.2 应答包 273.23.3 返回码 273.24 回放定位 283.24.1 请求包 283.24.2 应答包 283.24.3 返回码 283.25 回放进度 283.25.1 请求包 283.25.2 应答包 293.25.3 返回码 293.25.4 说明 293.26 设备重启 293.26

5、.1 请求包 293.26.2 应答包 293.26.3 返回码 293.27 开始设备语音对讲 303.27.1 请求包 303.27.2 应答包 303.27.3 返回码 303.28 停止设备语音对讲 303.28.1 请求包 303.28.2 应答包 303.28.3 返回码 313.29 设备12V控制 313.29.1 请求包 313.29.2 应答包 313.29.3 返回码 313.30 云台控制 313.30.1 请求包 313.30.2 应答包 323.30.3 返回码 323.31 报警信息上报 323.31.1 请求包 323.31.2 应答包 323.31.3 返回码

6、 323.31.4 说明 323.32 新建会议 333.32.1 请求包 333.32.2 应答包 333.32.3 返回码 333.33 参加会议 333.33.1 请求包 333.33.2 应答包 343.33.3 返回码 343.34 退出会议 343.34.1 请求包 343.34.2 应答包 343.34.3 返回码 343.35 会议信息通知 343.35.1 请求包 343.35.2 应答包 353.35.3 返回码 353.35.4 说明 353.36 日志系统目录信息查询 353.36.1 请求包 353.36.2 应答包 353.36.3 返回码 353.37 日志文件信

7、息查询 353.37.1 请求包 353.37.2 应答包 363.37.3 返回码 363.38 实时监视解码卡上墙 363.38.1 请求包 363.38.2 应答包 363.38.3 返回码 373.39 多画面预览解码卡上墙 373.39.1 请求包 373.39.2 应答包 373.39.3 返回码 374 全局资源 374.1 单元类型 374.2 配置文件类型定义 384.3 请求信息类型定义 384.4 权限类型定义 384.5 会议消息类型 394.6 设备登录返回码 391 引言1.1 目的 本协议用于指导专业网络视频监控平台的开发，定义了平台所支持的操作。1.2 范围 本

8、协议适用于专业网络视频监控平台中各单元之间的通讯。1.3 定义名称描述CU客户端PU前端设备NCMC中心控制核心NTDC流媒体转发核心NRU存储管理单元NMU配置管理单元CARD_SVR解码卡上墙服务1.4 资料 中心管理平台3.0 用户接入协议0.3.doc2 内部协议2.1 总体机制 协议采用HTTP协议承载 传输层使用TCP的长连接 协议采用应答机制 使用HTTP的GET和POST方法 协议头部信息包含在HTTP的扩展头部 请求包数据单元采用HTTP URL格式封装 应答包数据单元PDU，采用XML封装 Content-type在content为xml的情况下为text/xml，二进制流

9、的情况下为octet-stream 单条记录数据单元的数据项顺序无关 忽略不认识的数据域2.2 HTTP扩展头定义EPSS_Version协议版本号EPSS_UnitType单元的类型，见4.1 单元类型EPSS_Operation操作码EPSS_SessionId会话标识EPSS_Sequence操作顺序号2.3 PDU格式 PDU由XML封装，只包含操作的特定信息。 XML的格式如下： /body2.4 HTTP URL格式 HTTP的URL格式为 http:/ip:port/unitType/operation?attr1=value1&attr2=value2&.。举例，从监控单元发送

10、一条监控请求到NTDC，NTDC的IP为192.168.0.1，端口在38888上，则对应的URL为http:/192.168.0.1:38888/NSU/monitorStart?devid=1&channelno=0。则HTTP的请求行为： GET http:channelno=0 HTTP/1.12.5 示例2.5.1 一般控制 以监控模块到转发的监控请求为例。2.5.1.1 请求 Content-type:text/xml Content-length: Agent: HTTP agent EPSS_Version:4.0.0.1 EPSS_UnitType:NSU EPSS_Oper

11、ation:monitorStart EPSS_SessionId:1 EPSS_Sequence:1002.5.1.2 应答 HTTP/1.1 200 OK 1channelno0 2.6 文件或数据流读取 以NMU向NCMC请求设备数据xml为例。2.6.1.1 请求39999/NMU/getConfigFile?type=0&name=data.xml HTTP/1.1HTTP agentgetConfigFile2.6.1.2 应答octet-stream1024 data.2.6.2 文件上载保存 以NMU向NCMC保存用户管理xml为例。2.6.2.1 请求 POST http:3

12、9999/NMU/saveConfigFile?type=1&name=user.xml HTTP/1.1saveConfigFile Data.2.6.2.2 应答text-xmltype/type3 协议操作3.1 用户登录 用户登录操作，登录成功将创建一个正式的会话，获得系统使用权限。3.1.1 请求包操作代码EPSS_CU_NCMC_LOGIN方向CU - NCMC索引名字类型长度unitIdString32各单元的唯一标识2UserName64用户名3Password密码4LocalIp16CU的本机IP5localPortInt32CU的本机侦听端口，只对NTDC和NRU有效6lo

13、calMaskstringCU的本机子网掩码7Expires心跳超时8Capability网卡能力3.1.2 应答包TimeUint32同步时间3.1.3 返回码值DHRC_HAVE_LICENCE已注册证书DHRC_NO_LICENCE未注册证书DHRC_USER_NOT_EXIST用户不存在DHRC_PASSWORD_ERROR密码错误3.2 登出 一般来讲，一个登录操作应该对应一个登出操作。3.2.1 请求包EPSS_CU_NCMC_LOGOUT3.2.2 应答包 只有包头，包含应答码，无包体。3.2.3 返回码 无特殊返回码。3.3 心跳 心跳是系统获得用户在线状态的重要途径。在用户意

14、外掉线地情况下，系统在心跳逻辑的控制下，可以主动关闭连接，释放用户资源。 心跳间隔：推荐值，1分钟。3.3.1 请求包EPSS_CU_HEARTBEAT NCMC，CU - NTDC超时时间，单位是秒3.3.2 应答包 3.3.3 返回码3.3.4 说明3.4 请求配置文件 客户端登录成功之后，需要向中心请求设备列表、地图等信息，以进行客户端的初始化。3.4.1 请求包EPSS_CU_ ACQUIRE_CONF_FILEtypeByte查询类型，详见4.2 配置文件类型定义Filename文件名称，请求图片时，必须填写3.4.2 应答包 直接返回数据3.4.3 返回码DHRC_FILE_NOT

15、_EXIST无此文件DHRC_FILE_OPEN_FAILED文件打开失败3.4.4 说明 使用HTTP GET下载文件，请求包的字段填写在URL，文件数据作为应答包的content。 电子地图图片，在需要的时候才去请求，使用后保存在本地，因为图片的改动不会太大，所以，可以避免下次运行程序时重复请求。3.5 请求保存配置 配置管理单元完成配置之后，需要将配置保存到中心。3.5.1 请求包EPSS_CU_ SAVE_CONF_FILENMU - NCMC， NAU -查询类型4.2 配置文件类型定义String 文件名称，电子地图图片时必须填写3.5.2 应答包EPSS_CU_ACQUIRE_C

16、ONF_FILE查询类型3.5.3 返回码3.5.4 说明 使用HTTP POST上传文件，请求包的字段填写在URL中，文件数据作为请求包的包体发送3.6 请求信息数据 有些模块，如NFU，只要获得部分配置数据即可，不需要整个配置文件；还有一些信息，如证书信息、存储服务、转发服务列表等，它们应该以内存数据的形式存在。3.6.1 请求包EPSS_CU_ ACQUIRE _INFO查询类型，详见4.3 请求信息类型定义3.6.2 应答包 直接返回数据。3.6.3 返回码 无特殊返回码3.6.4 说明 使用HTTP GET获取信息，信息作为应答包的content3.7 查询设备配置3.7.1 请求包

17、EPSS_CU_ QUERY _DEV_CONF配置类型，详见网络SDK里的定义Devidint32设备标识channelNO通道号Size配置长度3.7.2 应答包 直接发送数据3.7.3 返回码3.7.4 说明 使用HTTP GET。3.8 保存设备配置3.8.1 请求包EPSS_CU_ SAVE _DEV_CONF3.8.2 应答包3.8.3 返回码3.8.4 说明 使用HTTP POST。3.9 CU向NCMC登录设备 实际上是请求分配转发的过程。3.9.1 请求包EPSS _CU_ACQUIRE_NTDC3.9.2 应答包IP转发服务IPPort转发服务端口Token操作令牌，以后所

18、有关于该设备的操作请求都要携带该字段，转发服务会对此进行验证3.9.3 返回码DHRC_NO_POWER无登录该设备的权限DHRC_NO_NTDC_TO_USE无转发可用3.10 NCMC登录设备3.10.1 请求包EPSS _NCMC_LOGIN_DEVNCMC -Type设备类型。0：大华设备；1：海康设备Addr地址devPort设备端口ipOrDomainAddr字段存储的是IP还是domainisDdns是否用DDNS登录，如果是，addr字段存的是DDNS的地址ddnsName设备在DDNS上的名称ddnsPortDDNS端口9操作令牌，NTDC用于对CU关于该设备的操作进行验证3.10.2 应答包操作令牌3.10.3 返回码3.11 CU向NTDC登录设备3.11.1 请求包EPSS _CU_LOGIN_DEV