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