Achor120V7InnerComm安克120内部通信规范

安克120V5内部通信规范 1. 修改记录 日期 姓名 说明 2006-8-10 涂建刚 创建 2008-1-7 涂建刚 为兼容分站，修改命令单 2010-7-1 涂建刚 分站收到消息回复修改 2010-07-12 涂建刚 添加分站状态广播 2011/2/15 涂建刚 广播电话信息 2. 概述 新版系统内部通信统一采用UDP协议，消息分为广播和点对点两种，涉及到WebService业务的由WebService发送，不涉及到WebService业务的由各WinForm程序自己发送。 虽然有WebService层提供数据读取服务，为了降低WebService的访问次数，提高整个系统的运行效率，我们设计大部分的通信包附带数据，只有收到事件、车辆等较少种类的消息时需要各客户端程序来调用WebService获取数据。 数据类型定义 数据类型 说明 String[n] 定长字符串，长度为n个字节 Byte 1字节无符号整形，本机字节编码 Word 2字节无符号整形，本机字节编码 Int 4字节有符号整形，本机字节编码 Bool 定长1字节无符号整形，0-False，1-True ActiveItem 不定长项，格式：项长度(Word)+项内容(不定长字符串) [] 表示可以重复的项，一般前面会有数量字段 3. 协议描述 安克内部协议格式：[安克消息头（1B）+信息长度（2B）+发送消息台号（2B）+ 消息类型（1B）+命令标识（1B）+ 消息体（见说明）] 3.1. 安克消息头 固定编码：0xFF，代表安克消息头 3.2. 信息长度 Word类型，代表整个消息长度； 3.3. 发送消息台号 String[2] 3.4. 消息类型 Byte类型 消息类型编码 内容说明 0 CTI消息 1 车载消息 2 其他消息 3 广播消息 4 GPS消息 3.5. 命令标识 Byte类型，要根据消息类型来判别； CTI消息 命令标识 内容说明 S->C E 发送错误消息 A 坐席状态变化 C 话机状态变化 R 录音号传送 N Q 排队通知 F 自动呼救消息 Z 当前座席状态请求返回 T 从中继呼入本系统 C->S M 请求呼出 D 应答来话 S 坐席控制请求 B 挂机 T 转移 Y 会议 W 取消正在执行的转移或会议操作 I 恶意电话 V 保持 U 取消保持 P 拦截 C 转分中心 录音->CTI L 发送录音号 车载终端消息 命令标识 内容说明 0 命令单 1 补发命令单 2 通知单 3 通知状态改变 4 下传字典表 5 电话拨打权限 6 下传电话热键表 7 车台显示名称 8 ACC熄火后供电时间 9 TCP上传间隔 10 华强车台初始化 11 华强免提权限 12 华强重连间隔 其他消息 命令标识 内容说明 0 分站收到消息回复 1 分站人员确认收到命令单(在V7版被删除这一条) 2 内部心跳请求 3 内部心跳回复 4 生成地图信息 5 地图辖区统计 6 分站请求同步数据 7 同步分站数据 8 二调发送命令单到分站 9 发送传真信息 10 分站/分中心通知单 11 短信息 12 自动呼救握手 13 短信呼救 广播消息 命令标识 内容说明 0 事件改变广播 1 车辆改变广播 2 人员改变广播 3 台状态改变广播 4 描述数据改变广播 5 GPS数据改变广播 6 WebService更新了所有缓存数据 7 广播提示信息 8 分站二调派车广播 9 广播监控消息 10 台通知广播 11 车辆连接状态 12 单个车载改变状态（区别1指令，添加这个指令期待不做整体刷新） 13 所有分站状态广播 14 单个分站状态广播 18 广播电话信息 小交换消息 命令标识 内容说明 小交换->受理台 A 震铃时发送主叫号码 B 摘机时发送主叫号码:被叫为120 C 摘机时发送主叫号码:被叫为指定的呼入线或指定的被叫号码 D 发送录音号 E 返回电话呼出结果 F 拦截恶意电话 G 早释通知 H 坐席状态 I 内线话机未挂机或受理时间过长 受理台->小交换 1 请求电话呼出 2 就绪 3 离席 4 退出坐席控制 5 播放录音 6 生成恶意电话 7 坐席状态查询 3.6. 消息体 3.6.1. CTI消息 3.6.1.1发送错误消息 项名称 数据类型 接收台号 String[2] 错误编码 Byte 错误信息 ActiveItem 3.6.1.2坐席状态变化 项名称 数据类型 接收台号 String[2] 状态编码 Byte 3.6.1.3话机状态变化 项名称 数据类型 接收台号 String[2] 状态编码 Byte 参数串 ActiveItem 3.6.1.4录音号传送 项名称 数据类型 3.6.1.5通知 项名称 数据类型 接收台号 String[2] 通告级别 Byte 通告内容 ActiveItem 3.6.1.6自动呼救 项名称 数据类型 厂商标识 Byte 姓名 ActiveItem 性别 ActiveItem 年龄 ActiveItem 身份 ActiveItem 身份证号码 ActiveItem 社会保险号码 ActiveItem 家庭住址 ActiveItem 家庭电话 ActiveItem 家庭电话分机 ActiveItem 等车地点 ActiveItem 职务 ActiveItem 血型 ActiveItem 联系人姓名 ActiveItem 联系人关系 ActiveItem 联系人电话 ActiveItem 医院1名称 ActiveItem 合同医院2名称 ActiveItem 既往病史 ActiveItem 用药情况 ActiveItem X坐标项 ActiveItem Y坐标项 ActiveItem 3.6.1.7排队 项名称 数据类型 接收台号 String[2] 排队数量 WORD 排队电话 ActiveItem 3.6.1.8呼出 项名称 数据类型 被叫号码 ActiveItem 3.6.1.9应答来话 项名称 数据类型 3.6.1.10坐席控制请求 项名称 数据类型 请求状态编码 Byte 调度员工号 ActiveItem 3.6.1.11挂机 项名称 数据类型 3.6.1.12转移 项名称 数据类型 目的号码 ActiveItem 3.6.1.13会议 项名称 数据类型 目的号码 ActiveItem 3.6.1.14取消当前正在执行的转移或会议操作 项名称 数据类型 3.6.1.15恶意电话 项名称 数据类型 恶意电话号码 ActiveItem 3.6.1.16保持 项名称 数据类型 3.6.1.17取消保持 项名称 数据类型 3.6.1.18拦截 项名称 数据类型 3.6.1.19发送录音号（命令标识：L） 项名称 数据类型 录音台号 String[2] 录音号 ActiveItem 3.6.1.20转台 项名称 数据类型 目的台号 String[2] 3.6.1.21当前座席状态请求返回 项名称 台号 String[2] 参数串 ActiveItem 3.6.1.22 中继呼入本系统 项名称 数据类型 用户主叫号码 ActiveItem 3.6.1.23电话转台 项名称 数据类型 目标台 String[2] 3.6.1.24电话转分中心 项名称 数据类型 分中心编码 Byte 目的电话号码 ActiveItem 3.6.1.25保持并呼叫 项名称 数据类型 呼叫电话号码 ActiveItem 车载消息 3.6.2.1. 命令单 项名称 数据类型 车辆数量 Byte [车辆编码列表] String[5*车辆数量] 事件类型编码 Byte 现场地址 ActiveItem 等车地址 ActiveItem 送往地点 ActiveItem 呼救电话 ActiveItem 联系人 ActiveItem 联系电话 ActiveItem 分机 ActiveItem 患者姓名 ActiveItem 性别 ActiveItem 年龄 ActiveItem 民族 ActiveItem 国籍 ActiveItem 呼救原因 ActiveItem 初步判断 ActiveItem 病情编码 Byte 是否需要担架 Bool 特殊要求 ActiveItem 患者人数 Byte 是否标注 Bool X坐标 ActiveItem Y坐标 ActiveItem 事件编码 String[16] 车辆实际标识 ActiveItem 身份名称(2008-1-7) ActiveItem 病情名称(2008-1-7) ActiveItem 备注(2008-1-7) ActiveItem 备注：此命令不仅是WebService发送到通信服务程序的通信协议，也是通信服务程序发送到分站程序的通信协议，但是分站收到后需要过滤其他分站的车辆。 3.6.2.2. 通知单 项名称 数据类型 去向编码 Byte 操作员编码 String[5] 中心数量 Byte [中心编码列表] String[3*中心数量] 车辆数量 Byte [车辆编码列表] String[5*车辆数量] 分站数量 Byte [分站编码列表] String[3*分站数量] 通知单内容 ActiveItem 3.6.2.3. 改变车辆状态 项名称 数据类型 车辆编码 String[5] 车辆状态 Byte 3.6.2.4. 下传字典表 项名称 数据类型 车辆编码 String[5] 字典表编码 Byte 字典表项目数量 Byte [字典表内容] M×项目内容 项目内容 项名称 数据类型 项目编码 Byte（数据库字典表的编码） 项目名称 ActiveItem 3.6.2.5. 电话拨打权限 项名称 数据类型 车辆编码 String[5] 权限编码 Byte 3.6.2.6. 下传电话热键表 项名称 数据类型 车辆编码 String[5] 电话号码数量 Byte 电话表 M×电话项 电话项 项名称 数据类型 按键号码 Byte 电话名称 ActiveItem 电话号码 ActiveItem 3.6.2.7. 车台显示名称 项名称 数据类型 车辆编码 String[5] 显示中心名称 ActiveItem 显示车台名称 ActiveItem 3.6.2.8. ACC熄火后供电时间 项名称 数据类型 车辆编码 String[5] 供电时间 4*Word 1、当班状态，显示器供电 2、当班状态，主机供电； 3、未当班状态，显示器供电； 4、未当班状态，主机供电； 单位：秒； 3.6.2.9. TCP上传间隔 项名称 数据类型 车辆编码 String[5] 间隔时间 3*Word 1任务中，2站内待命，3未当班 3.6.2.10. 车台初始化 项名称 数据类型 车辆编码 String[5] 短信中心号 ActiveItem 特服号 ActiveItem 应用识别标识 ActiveItem 校验码 Byte 新增m_CenterName 没用到 3.6.2.11. 免提权限 项名称 数据类型 车辆编码 String[5] 免提权限 Byte 注：1允许免提并优先；2拒绝免提 3.6.2.12. 重连间隔 项名称 数据类型 车辆编码 String[5] 重连间隔 Ushort 3.6.3. 其他消息 3.6.3.1. 分站收到消息回复 项名称 数据类型 发送消息台号 String[2] 分站编码 String[3] 分站名称 ActiveItem 消息类型 Byte 注： 消息类型 0（命令单自动回复） 1（命令单手工回复） 2（通知单自动回复） 3.6.3.2. 分站人员确认收到命令单(v7版删除) 3.6.3.3. 内部心跳请求 项名称 数据类型 唯一标志 WORD 3.6.3.4. 内部心跳回复 项名称 数据类型 唯一标志 WORD 是否正常运行 BOOL 异常文本 ActiveItem 注：唯一标志是3.6.3.3消息体发过来的 3.6.3.5. 生成地图(发送此消息需要指定发送目的地址) 项名称 数据类型 地图路径 ActiveItem X坐标 ActiveItem Y坐标 ActiveItem 3.6.3.6. 地图辖区统计（发送此消息需要指定发送目的地址） 项名称 数据类型 地图路径 ActiveItem 统计标题 ActiveItem 辖区数量 WORD [辖区编码+数量] [ActiveItem+Int] 注：[辖区编码+数量]可以重复 3.6.3.7. 分站请求同步数据 无消息体 3.6.3.8. 同步分站数据 项名称 数据类型 分站编码 String[3] 分站名称 ActiveItem 车辆数量 WORD [车辆编码+实际标识] [String[5]+ActiveItem] 3.6.3.9. 二调派车到分站命令单 项名称 数据类型 事件编码 String[16] 受理序号 Int 分站编码 String[3] 事件类型编码 Byte 现场地址 ActiveItem 等车地址 ActiveItem 送往地点 ActiveItem 呼救电话 ActiveItem 联系人 ActiveItem 联系电话 ActiveItem 分机 ActiveItem 患者姓名 ActiveItem 性别 ActiveItem 年龄 ActiveItem 身份编码 Byte 初步判断 ActiveItem 病情编码 Byte 是否需要担架 Bool 特殊要求 ActiveItem 患者人数 Byte 是否标注 Bool X坐标 ActiveItem Y坐标 ActiveItem 3.6.3.10. 发送传真信息 项名称 数据类型 传真号码 ActiveItem 传真标题 ActiveItem 传真内容 ActiveItem 3.6.3.11. 分站分中心通知单信息 [分站编码列表] String[3*分站数量] [中心编码列表] String[3*中心数量] 通知单内容 ActiveItem 发送目的地类型 Byte 3.6.3.12. 短信息 [电话号码列表] String[3*分站数量] 短信内容 ActiveItem 3.6.3.13. 自动呼救握手 是否正常 Bool 3.6.3.14. 短信呼救 姓名 ActiveItem 性别 ActiveItem 年龄 ActiveItem 身份 Byte 民族 Byte 国籍 ActiveItem 联系人 ActiveItem 联系电话 ActiveItem 等车地址 ActiveItem 既往病史 ActiveItem 特殊要求 ActiveItem 备注 ActiveItem 短信手机号 ActiveItem 是否标注 Bool X坐标 ActiveItem Y坐标 ActiveItem 3.6.4. 广播消息 3.6.4.1. 事件改变广播 无消息体 3.6.4.2. 车辆改变广播 项名称 数据类型 车辆数量 Byte [车辆编码+新状态] [String[5]+Byte] 注：[车辆编码+新状态]可以重复 3.6.4.3. 人员改变广播 项名称 数据类型 人员编码 String[5] 是否上班 Bool 车辆编码 String[5] 提示信息 ActiveItem 3.6.4.4. 台状态改变广播 项名称 数据类型 台状态 Byte 备注： 台状态：0未知、1退出、2就绪、3受理中、4其他操作中、5初始化 3.6.4.5. 描述数据改变广播 项名称 数据类型 描述内容 ActiveItem 3.6.4.6. GPS数据改变广播 项名称 数据类型 车辆编码 String[5] 实际标志 ActiveItem 工作状态编码 Byte 时间 String[14] X坐标 ActiveItem Y坐标 ActiveItem 高度 ActiveItem 速度 ActiveItem 方向 ActiveItem 备注： 时间：年（4B）+月（2B）+日（2B）+时（2B）+分（2B）+秒（2B） 3.6.4.7. WebService更新了所有缓存数据 无消息体 3.6.4.8. 广播提示信息 项名称 数据类型 提示信息 ActiveItem 3.6.4.9. 分站二调派车广播 项名称 数据类型 事件编码 String[16] 分站编码 String[3] 3.6.4.10. 广播监控消息 项名称 数据类型 消息级别 Int 消息内容 ActiveItem 3.6.4.11. 台通知广播消息 项名称 数据类型 广播通知类型标识 Byte 提示内容 ActiveItem 3.6.4.12. 车辆连接状态消息 项名称 数据类型 车辆编码 ActiveItem 是否连接 Bool 3.6.4.13. 单个车辆改变状态消息 项名称 数据类型 车辆编码 ActiveItem 状态 Byte 按键时刻 ActiveItem 3.6.4.14所有分站状态广播 项名称 数据类型 分站数量 Int [分站编码+状态] [Sting[3]+Byte] 注：状态0表示断开、1表示连接 3.6.4.15单个分站状态广播 项名称 数据类型 分站编码 Sting[3] 状态 Byte 3.6.4.19广播电话信息 项名称 数据类型 电话号码 ActiveItem 姓名 ActiveItem 性别 ActiveItem 年龄 ActiveItem 家庭住址 ActiveItem 等车地点 ActiveItem 既往病史 ActiveItem 联系人 ActiveItem 联系电话 ActiveItem 联系电话分机 ActiveItem 是否VIP BOOL 是否标注 BOOL X坐标 ActiveItem Y坐标 ActiveItem 备注 ActiveItem 最后呼入时刻 ActiveItem 最后呼入类型 ActiveItem 3.6.5. 小交换消息 3.6.5.1发送主叫号码（命令标识：A、B、C、G） 项名称 数据类型 接收台号 String[2] 主叫号码 ActiveItem 注：当来电被分配上台后，如果没有摘机应答，当主叫挂机时，则发出早释通知(G)。 3.6.5.2发送录音号（命令标识：D） 项名称 数据类型 接收台号 String[2] 录音号 ActiveItem 3.6.5.3返回电话呼出结果（命令标识：E） 项名称 数据类型 接收台号 String[2] 结果标志 Byte 注：结果标志= “1”(成功；“2”(本地无外线；“3”(外线(对方话机)占线；“4”(外线震铃时内线挂机。 3.6.5.4拦截恶意电话（命令标识：F） 项名称 数据类型 恶意电话号码 ActiveItem 3.6.5.5坐席状态（命令标识：H） 项名称 数据类型 接收台号 String[2] 状态编码 Byte 注：状态编码= “1”(就绪；“2”(离席。 3.6.5.6内线话机未挂机或受理时间过长（命令标识：I） 项名称 数据类型 接收台号 String[2] 3.6.5.7请求电话呼出（命令标识：1） 项名称 数据类型 被叫号码 ActiveItem 3.6.5.8就绪/离席/退出坐席控制/坐席状态查询（命令标识：2/3/4/7） 无消息体 注：退出坐席控制时，小交换话机按键操作就绪/离席有效。 3.6.5.9播放录音（命令标识：5） 项名称 数据类型 录音号 ActiveItem 3.6.5.10生成恶意电话（命令标识：6） 项名称 数据类型 恶意电话号码 ActiveItem