《接口使用说明文档.docVIP

中国移动短信网关 SP端接口使用手册 China Mobile Shot Message Gateway Interface for SP Manual 作者：沈岗 日期：2004年1月 版本：V1.2 CMSMIF.CMPPApp 简要说明： 该类采用CMPP协议(V2.0)实现了SP端与移动短信网关的连接处理。 本类中，采用长连接方式与ISMG通讯。通信双方以客户-服务器方式建立TCP连接，用于双方信息的相互提交。当信道上没有数据传输时，通信双方应每隔时间C发送链路检测包以维持此连接，当链路检测包发出超过时间T后未收到响应，立即再发送链路检测包，再连续发送N-1次后仍未得到响应则断开此连接。参数C、T、N可通过属性配置。 消息发送时采用并发方式，即发送一条消息不等待网关回复确认，继续向网关发送短信，这样发送消息速度非常快，完全取决于网关的处理速度及网络速度。为避免消息丢失，同时采用了滑动窗口流量控制，窗口大小可通过属性设置。 消息接收、网络断开等采用事件触发方式，不需应用程序轮询，在此接口基础之上编程方便。 类中运用了多线程技术，如一条线程处理发送网络包，而另一条线程处理从网关上接收网络包，其他还有一些线程处理检测包、网络连接情况监测等，使程序思路明确、执行效率很高、运行非常稳定。 属性 ActiveInterval 说明：检测包发送时间间隔，单位：毫秒。默认值为120000，即120秒。为上述类说明中的C参数。 MaxNetworkPackSize 说明：与ISMG通讯时最大网络包大小，单位：字节。默认值为512Byte。 MaxRetryTimes 说明：网络超时最大重发次数,单位：次。默认值为3次。为类说明中的N。 OverTime 说明：网络包发送超时时间,单位:毫秒,超过此值还未收到回复则重发。默认值为60000，即60秒。为类说明中的T。 QueueLength 说明：网络队列大小，单位：个，默认值为20。为类说明中的滑动窗口大小，以控制发送流量。 方法 ConnectToIsmg 方法说明： 连接到远程短信网关ISMG上，只有连接到远程短信网关上，才可进行短信收发操作。 在本操作中，自动初始化本地Socket，以连接到指定IP服务器的指定端口上。 声明原型：int ConnectToIsmg(string ServerIP,int Port,string SP_ID,string Secret，string SN) 参数说明： ServerIP：远程短信网关服务器的IP地址，如1 Port：远程短信网关服务器的端口号，如7890 SP_ID：企业服务代码 Secret：连接认证码，由中国移动与源地址实体事先商定。 SN：本软件的使用许可序列号。无效的序列号仅可在2004年8月份前试用。如需继续使用需与本软件作者联系，E-mail：hurry_sg@。 返回值：整型，连接成功返回0，初始化端口失败返回－1，连接网关失败返回－2，序列号无效试用到期无法继续使用返回－3。 DisConnectWithIsmg 方法说明：断开与远程短信网关的连接。在此方法中同时释放与远程连接的Socket。 声明原型：int DisConnectWithIsmg() 返回值：成功返回0，失败返回负值。 SendMessage 方法说明：向指定手机发送短消息。 在此函数中，如发送的消息超过最大短信字符数（140Byte），则自动分条发送。同时支持群发，超过最大群发数时（100条），则自动分批次发送。 声明原型： int SendMessage(string Src_Id,string Service_Id,string Msg_src,string Dest_terminal_Id, string Msg_content) int SendMessage(string Src_Id,string Service_Id,string Msg_src,string Dest_terminal_Id, string Msg_content,byte Msg_Fmt) 参数说明： Src_Id：源号码，SP的服务代码或前缀为服务代码的长号码，该号码最终在用户手机上显示为短消息的主叫号码。 Service_Id：业务类型，是数字、字母和符号的组合。Msg_src：企业代码。 Dest_terminal_Id：接收短信的手机号码。群发时多个手机号码之间有逗号或分号隔开。 Msg_content：消息内容，长度大于最大短消息长度时，自动分条发送。 Msg_Fmt：消息编码格式。 0：ASCII串 3：短信写卡操作 4：二进制信息 8：UCS2编码 15：含GB汉字 声明原型1时，Msg_