|
维泰彩信服务器(mm1)
二次开发说明
参考文档：
#1. <<彩信服务器(mm1)使用说明>>
#2. <<维泰彩信网关开发说明>>
1. 概述
本文讲述在单机工作状态下，如何使用维泰彩信服务器(mm1)进行彩信发送的二次开发。阅读本文之前应当阅读维泰彩信服务器和彩信网关的开发说明。
2. 数据结构
2.1 彩信发送任务表MMSend
|
字段名
|
数据类型
|
索引
|
备注
|
|
KeyId
|
Integer
|
PK
|
自动增长编号
|
|
UserName
|
Varchar(20)
|
|
用户账号
|
|
Mobile
|
Varchar(20)
|
|
目标手机号码
|
|
Title
|
Varchar(200)
|
|
彩信标题
|
|
Content
|
Varchar(2000)
|
|
彩信资源文件名
|
|
Context
|
Integer
|
|
上下文
|
|
SubmitTime
|
Varchar(20)
|
|
发送时间
|
|
MsgStatus
|
Integer
|
|
发送状态
|
|
MsgType
|
Integer
|
|
信息类型(保留为0)
|
|
Priority
|
Integer
|
|
优先级别(越大越优先发送)
|
|
Retrycount
|
Integer
|
|
失败次数
|
2.2 彩信发送日志表MMSendLog
表结构与MMSend相同，彩信发送成功之后，转入此表。
2.3 用户账号UserData
|
字段名
|
数据类型
|
索引
|
含义
|
备注
|
|
UserName
|
TEXT(20)
|
PK
|
用户名
|
|
|
UserPass
|
TEXT(20)
|
|
密码
|
|
|
UserGroup
|
TEXT(20)
|
|
用户组
|
|
|
AgentName
|
Text(20)
|
|
代理商帐号
|
|
|
SMSCount
|
INTEGER
|
|
购买量
|
|
|
SendCount
|
INTEGER
|
|
发送量
|
|
|
Priority
|
INTEGER
|
|
优先级
|
99：表示优先发送
|
|
Customer
|
TEXT(255)
|
|
客户名称
|
|
|
Province
|
TEXT(50)
|
|
省份
|
|
|
City
|
TEXT(255)
|
|
城市
|
|
|
Phone
|
TEXT(255)
|
|
联系电话
|
|
|
Contact
|
TEXT(255)
|
|
联系人
|
真实姓名
|
|
Mobile
|
TEXT(20)
|
Index
|
手机号码
|
查询是否重复
|
|
Email
|
TEXT(255)
|
Index
|
电子邮件
|
查询是否重复
|
|
Address
|
TEXT(255)
|
|
地址
|
|
|
PostCode
|
TEXT(10)
|
|
邮政编码
|
|
|
QQ
|
TEXT(20)
|
|
|
|
|
MSN
|
TEXT(255)
|
|
|
|
|
RegTime
|
TEXT(20)
|
|
登记日期
|
|
|
FromUrl
|
Text(100)
|
|
客户来源网址
|
2007.03.24
|
|
FromIp
|
Text(20)
|
|
客户来源IP
|
2007.03.24
|
3. 发送彩信
3.1 编译资源文件
编译资源文件是一个可选的发送步骤，但是当需要一条彩信包含多个资源文件时必须编译。如果一条彩信只包含一个资源文件，则不需要编译。
函数名称wtmmsBuild
库文件：smsapi.dll
参考文件: 彩信开发接口
wtmmsBuild需要一个会话参数hSession，需要调用wtsmsOpen来建立。
因为我们不需要调用wtmmsSend，所以我们在调用wtsmsOpen时，可以任意输入三个参数：ServerURL, UserName, UserPass。
调用wtmmsBuild之后，应当再调用wtsmsClose及时清理内存。
3.2 写入彩信发送任务表
写彩信发送任务表MMSend，生成发送任务。以下字段必须填写：
UserName 用户名；
Mobile 目标手机号码
Title 彩信标题
Content 资源文件名，请填写完整的路径信息。
SubmitTime 发送时间, 请填写当前时间，字符串类型，格式:2007-01-01 02:02:02
可选择字段：
Priority 优先级别；当有很多彩信要发送时，通过设定优先级别，可以允许一些重要的彩信及时发送出去。
Context 上下文信息。通过上下文信息，可以为查询彩信的发送状态提供方便。
彩信任务成功写入后，服务器会自动读取发送任务，按要求的顺序将彩信发送出去。 |
