完美支持GSM、CDMA双网络;支持长短信、送达报告
支持语音、USSD、STK及她们的批处理,可检测空号
免费下载快速入门发号施令捕捉事件高级设置常见问题开发例程配套设备软件授权付款方式联系我们
 从中间件捕获事件的唯一途径是在事件目录EVENT中检索新文件。中间件输出事件文件时遵循如下规范:


通信服务业万能中间件事件输出规范
 

通信服务业万能中间件输出事件文件的规范如下:1、每个事件文件的扩展名均为.txt,文件名由15位阿拉伯数字组成,从0开始递增,不足15位的前面补0至15位,达到最大值999999999999999后重新从0开始。2、文件内容均为纯文本格式,编码为ANSI;3、每个文件由多行组成,每行为一个字段,行与行之间以标准回车换行符分隔;4、用户自己开发的程序在读取事件文件之后,应立即将其删除以节省系统资源。

以下是通信服务业万能中间件到目前为止所支持的全部事件列表及其详细书写规范。在今后系统的升级过程中,我们将坚持向下兼容的原则。因此,您完全不必担忧以后系统升级导致您现在编写的程序不能再继续使用。

 
  


事件0:任务执行失败
 

本事件的目的是通知贵系统,您最近所提交的某项任务执行失败。本事件文件的输出遵循如下规范:

行号所输出内容
0固定格式:“0,任务执行失败”,代表您最近所提交的某项任务执行失败。
1端口号。本次事件是发生在哪个端口之上,0表示尚未分配或端口无效。
2提交任务类型。表示被执行失败的任务的原始任务类型。
3被执行失败任务的原始任务ID。有了她,我们才能够准确跟踪具体是哪个任务执行失败了,以便做出相应的处理。请注意,如果被执行的任务是发送长短信,由于长短信内部发送时实际上是将其拆分为多条普通短信发送,因此当长短信发送失败时本系统将同时返回两条失败记录,其中一条的任务ID是在原始ID的基础上尾随“(当前这是发送的第几条/总共被拆分为了多少条)”,另外一条的任务ID跟在通常情况下一样与原始ID完全一致。
4失败原因代码。
5失败原因描述。
6宣告失败时间。
7失败特征。在批处理任务中,返回未执行指令。“-”表示无特征。
8执行任务失败的资费卡号码,如果存在的话,否则为0。
9是否绝对失败,“1”表示绝对失败,“0”表示可能失败。

失败原因代码与失败原因描述的可能情况及对照关系如下表:

代码失败原因描述
0当前不存在活动的通话
1任务过期
2指定的端口无效
3自动分配端口失败
4任务无效
5设备忙
6未知
7对方没有应答
8对方挂断电话
9对方占线、关机、停机或是空号
10当前活动进程的ID与您指定的ID不一致
11无效的按键
12当前状态下不允许的操作
13短信中心地址错误或运营商拒绝服务
14菜单序号不存在(仅在执行STK任务时产生)
15当前端口没有等待输入开机密码
16欠费停机
17设备或网络,超时或停止响应
18非STK卡(仅在执行STK任务时产生)
19输入数据部分或全部无效或错误
20已经是主菜单(仅在执行STK任务时产生)
21系统服务停止
22系统紊乱
23电力不足
24硬件不支持
25与运营商对话失败
26串口错误
27资费卡松动
28目标不可达
29运营商拒绝服务
30用户取消
31任务已执行或不存在
32设备内部故障
33运营商或网络异常
34运营商返回数据异常
35网络不支持该指令
36设备状态异常
 
  


事件1:任务执行成功
 

本事件的目的是通知贵系统,您最近所提交的某项任务执行成功。本事件文件的输出遵循如下规范:

行号所输出内容
0固定格式:“1,任务执行成功”,代表您最近所提交的某项任务执行成功。
1端口号。表示本次事件是发生在哪个端口之上的。
2提交任务类型。表示被执行成功的任务的原始任务类型。
3被执行成功任务的原始任务ID。有了她,我们才能够准确跟踪具体是哪个任务执行成功了,以便做出相应的处理。请注意,如果被执行的任务是发送长短信,由于长短信内部发送时实际上是将其拆分为多条普通短信发送,因此当长短信发送成功时本系统将同时返回多条成功记录,其中一条的任务ID跟在通常情况下一样与原始ID完全一致,另有多条的任务ID是在原始ID的基础上尾随“(当前这是发送的第几条/总共被拆分为了多少条)”。
4执行成功时间。
5执行任务成功的资费卡号码,如果存在的话,否则为0。
 
  


事件2:收到常规短信
 

本事件的目的是通知贵系统:通信终端中收到了一条新短信。本事件文件的输出遵循如下规范:

行号所输出内容
0固定格式:“2,收到常规短信”,代表通信终端中收到了一条新短信。
1端口号。表示本次事件是发生在哪个端口之上。
2发送方号码。表示本条信息是从哪个号码发来的。
3短信内容。表示本条信息的正文部分。其中可能会包含“{{回车}}”、“{{换行}}”或“{{制表}}”等字样,她们分别表示回车、换行或制表等特殊字符。
4接收时间。表示系统在何时收到了这条短信。
5参考信息。如果本条信息是用户基于对您曾经发送给他的短信的回复,并且您在向他发送短信时曾经设置过一个参考信息,那么此时该信息就会在此被原样传回。
6优先级别。只有在CDMA通信终端收到C网用户发来的短信时方支持本功能。取值1~4,数值越大越优先。0表示不支持。
7回拨号码。同上,仅C网网内短信支持,0表示不支持。
8数据编码。此值可能为7、8或16,分别表示当前短信是采用7BIT、8BIT或者16BIT的编码方式发来的。
9发送方号码归属地。表示发送方号码归属于哪个城市。
10收到短信的资费卡号码。
 
  


事件3:收到残缺短信
 

本事件的目的是通知贵系统:通信终端中收到了一条残缺短信。所谓残缺短信,是指该短信原本是一组由多条普通短信组成的长短信,但是由于某个原因,其中的部分成员系统未能收到,导致该长短信内容残缺不全,此即残缺短信。本事件文件的输出遵循如下规范:

行号所输出内容
0固定格式:“3,收到残缺短信”,代表通信终端中收到了一条残缺短信。
1端口号。表示本次事件是发生在哪个端口之上。
2发送方号码。表示本条信息是从哪个号码发来的。
3短信内容。表示本条信息的正文部分。其中可能会包含“{{残缺}}”字样,她代表丢失的正文单元。
4接收时间。表示系统在何时收到了这条短信。
5参考信息。如果本条信息是用户基于对您曾经发送给他的短信的回复,并且您在向他发送短信时曾经设置过一个参考信息,那么此时该信息就会在此被原样传回。
6优先级别。只有在CDMA通信终端收到C网用户发来的短信时方支持本功能。取值1~4,数值越大越优先。0表示不支持。
7回拨号码。同上,仅C网网内短信支持,0表示不支持。
8数据编码。此值可能为7、8或16,分别表示当前短信是采用7BIT、8BIT或者16BIT的编码方式发来的。
9发送方号码归属地。表示发送方号码归属于哪个城市。
10收到短信的资费卡号码。
 
  


事件4:短信送达通知
 

本事件的目的是通知贵系统:您之前发送的某条短信用户已经收到,目前已经到达至用户的手机。这个功能有着非常重大的意义,但是目前只有GSM通信终端支持本事件,CDMA通信终端暂不支持短信送达通知。本事件文件的输出遵循如下规范:

行号所输出内容
0固定格式:“4,短信送达通知”,代表您之前发送的某条短信用户已经收到。
1端口号。表示本次事件是发生在哪个端口之上。
2具体哪一条短信用户已经收到?这里是与之对应的发送任务ID。有了她,我们才能够准确跟踪具体是哪条短信用户已经收到,以便做出相应的处理。请注意,如果先前发送的短信是长短信,由于长短信内部发送时实际上是将其拆分为多条普通短信发送,因此当用户收到长短信后系统会返回多条送达通知,这里的任务ID将在原始ID的基础上尾随“(当前这是发送的第几条/总共被拆分为了多少条)”。
3接收方号码。意指哪个手机已经收到该条短信。
4运营商系统受理发送该短信的时间。
5用户收到该短信的时间。
6接收方号码归属地。表示接收方号码归属于哪个城市。
7参考信息。涵义同
8发送短信的资费卡号码。
 
  


事件5:有人打来电话
 

本事件的目的是通知贵系统:有人打来电话。本事件文件的输出遵循如下规范:

行号所输出内容
0固定格式:“5,有人打来电话”,代表有人打来了一个电话。
1端口号。表示本次事件是发生在哪个端口之上。
2本次呼叫的唯一ID,由系统自动分配。当您需要接听该电话时,可以传送此ID以便获得更加准确地控制。
3主叫号码,表示谁打来的这个电话。
4主叫号码归属地。表示主叫方号码归属于哪个城市。
5参考信息。涵义同
6被呼叫的资费卡号码。
 
  


事件6:对方挂断电话
 

本事件的目的是通知贵系统:对方挂断了电话。此事件在您打电话或者接电话的过程中均有可能发生。本事件文件的输出遵循如下规范:

行号所输出内容
0固定格式:“6,对方挂断电话”,代表当前通话对方挂断了电话。
1端口号。表示本次事件是发生在哪个端口之上。
2被挂断电话所对应的呼叫ID。如果您正在打电话,这个ID就是在任务2中您发起常规呼叫的ID;如果您正在接电话,这个ID就是在事件5中有人打来电话的ID
3被挂断的资费卡号码。
 
  


事件7:对方接听电话
 

本事件的目的是通知贵系统:对方接听了电话。本事件文件的输出遵循如下规范:

行号所输出内容
0固定格式:“7,对方接听电话”,代表对方接听了电话。
1端口号。表示本次事件是发生在哪个端口之上。
2被接听电话所对应的呼叫ID。即您在任务2中发起常规呼叫的ID
3发起呼叫的资费卡号码。
 
  


事件8:成功退出系统
 

本事件的目的在于告知贵软件:中间件已经安全退出系统,服务已经停止,所有数据已妥善保存。本事件文件的输出遵循如下规范:

行号所输出内容
0固定格式:“8,成功退出系统”,代表中间件已经安全退出。
1与之对应的退出请求ID。中间件不会无缘无故的退出服务,一般是基于您的人为请求或者因为系统发生某种问题而被迫退出,这里的ID对应着退出缘由(任务事件)的原始ID。
2成功退出时间。
 
  


事件9:被迫退出系统
 

本事件的目的在于告知贵软件:中间件迫于某种无奈即将退出系统。请注意,此时系统尚未安全退出,可能还需要进行一些退出前的数据处理,直到系统再输出一个“成功退出系统”的事件。本事件文件的输出遵循如下规范:

行号所输出内容
0固定格式:“9,被迫退出系统”,代表中间件迫于某种无奈即将停止服务。
1退出ID,由系统自动分配。
2被迫退出原因代码。
3被迫退出原因描述。
4被迫退出时间。

被迫退出代码与被迫退出原因描述的可能情况及对照关系如下表:

代码被迫退出原因描述
1未发现支持设备
2操作环境会话结束
3应用程序被强行中止
 
  


事件A:等待开机密码
 

本事件的目的在于告知贵软件:某个端口中的资费卡正在等待您输入开机密码,输入正确的开机密码后才能使用该端口。本事件文件的输出遵循如下规范:

行号所输出内容
0固定格式:“A,等待开机密码”,代表某端口正在等待您输入开机密码。
1端口号。表示本次事件是发生在哪个端口之上。
2等待ID,由系统自动分配。
3PIN或PUK。PIN表示用户此时需要输入的是PIN码;PUK表示用户此时需要输入的是PUK码。一般来说,刚开始系统是要求输入PIN码,如果PIN码连续输入错误3次,系统会要求输入PUK码。如果PUK码输入正确,系统会将PIN码重置为初始值“1234”。如果PUK码连续输入错误10次,对应的资费卡将报废。
4开始等待时间。

温馨提示:如果您在要求输入开机密码后5分钟内没有输入开机密码,系统将自动关闭对应的端口。

 
  


事件B:被迫关闭端口
 

本事件的目的在于告知贵软件:由于某种原因,某端口已经被迫关闭。本事件文件的输出遵循如下规范:

行号所输出内容
0固定格式:“B,被迫关闭端口”,代表中间件已经安全退出。
1端口号。表示本次事件是发生在哪个端口之上。
2被迫关闭原因代码。
3被迫关闭原因描述。
4被迫关闭时间。
5被迫关闭的资费卡号码,如果存在的话,否则为0。

被迫关闭代码与被迫关闭原因描述的可能情况及对照关系如下表:

代码被迫关闭端口原因描述
1开机密码错误
2因连续输入开机密码错误次数超限资费卡已作废
3等待开机密码超时
4欠费停机
5资费卡信息满或设备老化
6资费卡已作废
7设备无法激活
8资费卡未插入或接触不良
9资费卡与设备不兼容或接触不良
10设备停止响应
11信号不足或运营商不支持当前操作
12网络故障、运营商禁止或资费卡接触不良
13检测本机号码失败
14执行任务连续失败十次
15设备老化
16电力不足
17信号不足
18设备内部故障
19网络注册失败
20短信中心号码错误
21资费卡已损坏或接触不良
22设备不支持
23资费卡内部错误或接触不良
24端口无响应
25资费卡隐身
26设备老化或电力不足
27资费卡已损坏
28短信中心号码错误或欠费停机
29设备内部松动或资费卡接触不良
30资费卡与设备不兼容
31模块内部故障
32资费卡未插入或设备死机
33设备重复
34设备状态异常
 
  


事件C:发现支持设备
 

本事件的目的是通知贵系统:中间件在您的电脑上扫描到了一台有效可用的短信设备。如果在您的电脑上安装有多台有效设备,系统会产生多次发现有效设备事件。本事件文件的输出遵循如下规范:

行号所输出内容
0固定格式:“C,发现支持设备”,代表系统在您的电脑上扫描到了一台有效可用的短信设备。
1端口号。表示本次事件是发生在哪个端口之上。
2设备内核型号。
3设备波特率。
4设备信号强度。以百分比表示。100%表示满信号,0%表示一点信号也没有。
5短信中心号码。0表示不支持。温馨提示:CDMA设备不支持也不需要短信中心号码。
6本机号码。即本设备中所安装的资费卡的号码。
7本机资费卡归属地。即开户城市。
8运营商名称。
9本设备的国际移动设备身份码,即串号。
10发现时间。
 
  


事件D:当前菜单项目
 

本事件的目的是列出当前菜单项目,仅在进行STK操作的时候发生。本事件文件的输出遵循如下规范:

行号所输出内容
0固定格式:“D,当前菜单项目”,代表系统输出了当前菜单项目。
1端口号。表示本次事件是发生在哪个端口之上。
2与之关联的应用工具调用ID,表明本事件的归属。
3当前菜单的标题。
4当前菜单项目列表。由项目编号+、+项目主题构成,多个项目之间以|分隔。如:“1、动感地带|2、短信发送|3、聊天交友”。
5当前菜单是主菜单还是子菜单。0表示是主菜单,1表示是子菜单。
6读取菜单的时间。
7菜单所属资费卡号码。
 
  


事件E:收到菜单消息
 

本事件的目的是告诉您,系统收到了一条来自STK工具的消息。仅在进行STK操作的时候发生。本事件文件的输出遵循如下规范:

行号所输出内容
0固定格式:“E,收到菜单消息”,表示系统收到了一条来自STK工具的消息。
1端口号。表示本次事件是发生在哪个端口之上。
2与之关联的应用工具调用ID,表明本事件的归属。0表示自发产生的消息,没有归属。
3消息正文内容。
4本消息是否需要用户确认。0表示不需要,1表示需要用户确认。
5收到消息的时间。
6菜单所属资费卡号码。
 
  


事件F:等待输入数据
 

本事件的目的是告诉您,STK工具正在等待您输入某项数据。仅在进行STK操作的时候发生。本事件文件的输出遵循如下规范:

行号所输出内容
0固定格式:“F,等待输入数据”,表示STK工具正在等待您输入某项数据。
1端口号。表示本次事件是发生在哪个端口之上。
2与之关联的应用工具调用ID,表明本事件的归属。
3需求数据描述,用以告诉用户应该输入何种信息。
4需求数据类型。可能值为0、1或者2,分别代表纯数字、数字或英文字符、中英文字符。
5需求数据的最小长度。0表示没有限制。
6需求数据的最大长度。0表示没有限制。
7请求输入的时间。
8等待数据的资费卡号码。
 
  


事件G:设备初始完成
 

每次启动中间件,系统将进行一系列设备初始化工作。当所有设备均已全部初始化完成时,就会产生本事件。只有在才收到本事件之后,才表明中间件已经完全进入到正式工作状态,才能确保您所提交的所有指令都能被完全正确无误地执行。本事件文件的输出遵循如下规范:

行号所输出内容
0固定格式:“G,设备初始完成”,表示所有设备均已全部初始化完成。
1有效设备总数。
2完成时间。
3与上轮设备初始化完成相比,本轮增加了哪些资费卡。如有多个,相互间已“、”分隔。“-”表示没有增加。
4与上轮设备初始化完成相比,本轮减少了哪些资费卡。如有多个,相互间已“、”分隔。“-”表示没有减少。
 
  


事件H:应用工具超时
 

本事件的目的是告诉您,在您打开STK工具之后,由于超过15分钟没有操作,应用工具已经自动关闭。如果您还需要继续操作,只能重新调用应用工具然后从头再来。本事件文件的输出遵循如下规范:

行号所输出内容
0固定格式:“H,应用工具超时”,表示STK应用工具因等待超时已自动退出。
1端口号。表示本次事件是发生在哪个端口之上。
2与之关联的应用工具调用ID,表明本事件的归属。
3自动退出的时间。
4超时的资费卡号码。
 
  


事件I:手机卡通讯录
 

本事件输出手机卡通讯录查询结果,仅在执行任务读出卡通讯录后发生。本事件文件的输出遵循如下规范:

行号所输出内容
0固定格式:“I,手机卡通讯录”。
1端口号。表示本次事件是发生在哪个端口之上。
2与之关联的请求读出卡通讯录任务ID,表明本事件的起因。
3通讯录内容。输出格式为:“编号|号码|姓名;编号|号码|姓名;……”。
4查询时间。
5通讯录所在资费卡号码。
 
  


事件J:系统开始启动
 

每次启动通信服务业万能中间件时,将输出此事件,代表通信服务业万能中间件已经开始启动。本事件文件的输出遵循如下规范:

行号所输出内容
0固定格式:“J,系统开始启动”。
1启动ID,由系统自动分配。
2启动时间。
 
  


事件K:汇报工作状态
 

本事件输出通信服务业万能中间件的当前工作状态,仅在执行任务查询工作状态后发生。本事件文件的输出遵循如下规范:

行号所输出内容
0固定格式:“K,汇报工作状态”。
1与之关联的查询工作状态任务ID,表明本事件的起因。
2工作状态代码。“0”表示“系统正在启动”;“1”表示“正在初始化设备”;“2”表示“正常工作中”;“3”表示“正在退出系统”。
3工作状态描述。
4本次查询时间。
 
  


事件L:收到USSD消息
 

本事件的目的是告诉您,系统收到了一条来自USSD的消息。仅在进行USSD操作的时候发生。本事件文件的输出遵循如下规范:

行号所输出内容
0固定格式:“L,收到USSD消息”,表示系统收到了一条来自USSD的消息。
1端口号。表示本次事件是发生在哪个端口之上。
2与之关联的USSD调用ID,表明本事件的归属。
3消息正文内容。
4接收到本消息时的USSD会话状态。0表示无需回复,1表示需要回复,2表示会话已经关闭,4表示操作不支持。
5收到消息的时间。
6USSD所属资费卡号码。
 
  


支持中国移动 支持中国联通 支持中国电信 网站备案 365安全防范网 中国互联网违法和不良信息举报中心 四川省互联网不良与违法信息举报中心 营业执照 网络110报警服务
晴朗旗下网站: 通信设备商城空中充值系统晴朗短信网关短信发送系统网络货币兑换系统空中充值联盟虚拟主机专卖店
版权所有: 四川射洪晴朗软件有限责任公司 ©2018  服务热线: 18982513577  短信咨询: 13778745236  QQ: 307082114
营业执照: 510922000018264   组织机构代码: 69919469-6   蜀ICP备05026557号  

川公网安备 51092202000046号