爱迪生信息技术实验室-为您提供优秀的短信开发商接口系列、彩信开发商接口系列

当前位置：首页－＞开发商接口－＞爱特生短信彩信开发平台（服务器）使用说明书

一、爱特生短信彩信开发平台简介

　　为了简化软件开发流程，减少各应用系统相同模块的重复开发工作，提高系统稳定性和可靠性，缩短开发时间，降低研发成本，增加产品的附加价值，我们开发了本套“爱特生短信彩信开发平台”。

　　爱特生短信彩信开发平台，提供的是基于数据库方式的开发接口。不管你的应用系统是单机应用的还是网络应用的，也不管你的应用系统是BS的还是CS的，也不管你的应用系统是Windows平台的还是Unix平台的，都可以非常容易地和爱特生短信彩信开发平台相结合，方便地进行二次开发。

　　爱特生短信彩信开发平台，是个独立的EXE文件，可以方便地进行开发过程的调试工作；同时可通过数据库的某些字段值来控制该EXE文件的执行情况；爱特生短信彩信开发平台具备了常见的短信彩信收发、用户管理、自动回复、彩信制作、记录管理等功能，在开发项目未完成之前，完全可以作为一个独立的应用软件来使用。

　　爱特生短信彩信开发平台，具备短信发送和接收的开发接口，具备彩信发送和接收的开发接口，接口调用都是通过数据库交换数据来完成；除此之外，为了开发系统的厂商标识统一，开发者可以自行更改“爱特生短信彩信开发平台”的界面图片。

　　爱特生短信彩信开发平台，支持单口和多口彩信发送设备，发送规模可以根据需求进行方便调节。
爱特生短信彩信开发平台，可以采用的是点对点的短信/彩信发送方式，也可以采用集成网关方式来发送彩信，不管上面哪种方式都需要和我们提供的GPRS Modem配套使用。使用时，需要把GPRS Modem数据连线与电脑串口相连，GPRS Modem里面需放入能够收发短信/彩信的手机卡。

　　注：点对点的短信/彩信发送方式指的是，软件完全模拟手机的方式来收发信息，通信资费和普通手机发送信息相同；集成网关的短信/彩信发送方式指的是，软件自带彩信中心功能，彩信发送不通过移动彩信中心，发送彩信的资费与短信相同。彩信文件大小与发送速度无关，每设备每小时发送速度约600条左右，稳定可靠，具备准确的接收回执信息。

二、使用方法概述

　　操作爱特生短信彩信开发平台的数据库（安装目录或源文件目录下的MMS.mdb文件）来实现数据的交流和系统的控制：
彩信开发,彩信编程,彩信技术,彩信控件,彩信接收,彩信源码,彩信接口,彩信服务器,彩信网关,彩信二次开发平台

　通过向数据库“信息发送表”写入新记录的方式来提交要发送的短信和彩信；

　通过读取数据库“信息接收表”中新增记录的方式来接收短信和彩信；

　通过查询数据库“信息发送表”中记录的状态字段值，来判断提交的消息是否发送成功（以及对方是否已接收到）；

　通过查询或设置数据库“系统状态表”，可对爱特生短信彩信开发平台的运行状态进行监测和控制；

　通过查询或设置数据库“彩信设备表”，可对系统连接的彩信设备进行控制值设置，对彩信设备的运行状况进行监测；

　通过查询数据库“错误日志表”中的记录，来读取系统产生的错误信息。

　　注：为了开发上的方便，开发者可以自行在MMS.mdb文件上添加新表，也可以在已有表上添加新字段，但不能够对已有表名和已有字段信息（如字段名、字段类型、默认值、大小）进行修改。
在安装时，系统默认使用的是Access数据库（数据库文件为安装目录下的MMS.mdb文件）。
在软件安装好并经过初次运行以后，在软件安装目录下会产生一个名为“MMSDB.ini”的文件，这个文件就是起到指定数据库的作用，文件内容为数据库的连接字符。如果你要使用其它数据库，请参见本文第六章“如何修改系统默认数据库”。

三、数据库表说明

3.1 信息发送表SendMsgTable

字段名	类型	说明
MsgIndex	自动编号	主键，自动生成。
PhoneNumber	文本	发送手机号码（限一个）。
MsgTitle	文本	短信的内容（超长时，系统自动分割为多条发送），或彩信的标题。
MMSInfoFile	文本	彩信信息全路径文件名（文件类型及格式需符合附录1的要求），发短信时忽略此值。
TimeSend	文本	定时发送时，时间格式为：yyyy-mm-dd hh24:mi:ss；循环发送时，时间格式为： [每年]x月x日x时x分 [每月] x日x时x分 [每周]星期几x时x分 [每日] x时x分注：如果在软件界面上提交定时和循环的发送信息后，时间格式就可以在待发列表的定时任务和循环任务记录中看到。当格式错误时，系统忽略此值。
MsgStatus	数字	0新加入的信息（默认）， 1发送中的信息， 100发送成功的信息， -100发送失败的信息， 200已送达接收手机的消息， -200送达接收手机过程失败的消息。
MsgType	数字	1发送的信息类型为彩信（默认）， 0发送的信息类型为短信。
RunInfo	文本	用于记录执行过程中产生的信息（通常记录在发送失败时的失败原因）。

　　注1：本表记录的增加由应用系统来完成；爱特生短信彩信开发平台根据执行状况更新MsgStatus和RunInfo两个字段值。

　　注2：为了不影响系统查询数据的速度，建议应用系统及时清除已发送的信息。本表记录超过设定容量后，系统将根据条件判断自动清除部分过期已发记录。

　　注3： MMSInfoFile可填内容为4类文件（详细信息参考附录1）：
　　<a> 彩信资源文件：如“c:\MyMMS\1.jpg”。
　　<b> 彩信结构ini文件：如“c:\MyMMS\dog.ini”。
　　<c> 彩信结构smil文件：如“c:\MyMMS\Flower.smil”。
　　<d> 彩信打包emms文件：如“c:\MyMMS\节日快乐.emms”。

　　注4： MMSInfoFile字段内容只能填写一个文件名称，不能为多个文件名称，文件名称必须为全路径。支持除smil外的其他网络URL文件名，注意有些网站要求url中大小写要完全正确，使用网络URL文件名时必须要以“http：”打头，如“http://www.edi-son.com/edison.jpg”。

3.2 信息接收表RecvMsgTable

字段名	类型	说明
MsgIndex	自动编号	主键，自动生成。
PhoneNumber	文本	发送信息的手机号码。
MsgTilte	文本	短信的内容，或彩信的标题。
RecvMMSFileDir	文本	接收到的彩信资源文件保存目录（一般保存在C盘RecvMsg下面）。目录内包含了彩信信息文件有：彩信结构文件（RecvMMS.smil、RecvMMS.ini）和媒体内容文件（如jpg、txt、mid等）。（文件类型及格式参见附录）
MsgStatus	数字	0为新加入的信息，应用系统读取记录后可以自行修改此值，此字段通常作为阅读标记使用。
MsgType	数字	1为收到的信息是彩信， 0为收到的信息是短信。
RecvTime	时间日期	用于记录接收到信息的时间。
ResFile1	文本	接收到的彩信文件中的单个资源文件1
ResFile2	文本	接收到的彩信文件中的单个资源文件2
ResFile3	文本	接收到的彩信文件中的单个资源文件3
ResFile4	文本	接收到的彩信文件中的单个资源文件4
ResFile5	文本	接收到的彩信文件中的单个资源文件5

　　注1：本表记录的增加由爱特生短信彩信开发平台来完成；应用系统只需来查询有无新记录，有则读出处理。

　　注2：为了不影响系统查询数据的速度，建议应用系统及时清除已阅读的信息。本表记录超过设定容量后，系统将根据条件自动清除部分过期记录。

3.3 系统状态表SystemStatusTable

字段名	类型	说明
ShowWindow	数字	0为隐藏窗口，1为显示窗口。（输入控制）
PauseSend	数字	0为默认状态正常发送，1为暂停发送。（输入控制）
ExitMMSServer	数字	0为默认状态不退出，1为请求退出彩信接口软件。（输入控制）
SoftName	文本	设置的短信彩信平台软件的名字，软件重新启动后才生效。（输入控制，仅启动时检测）
RecvDir	文本	彩信接收存放目录。（输入控制，仅启动时检测）
SoftDogStatus	数字	1为已经找到软件加密狗，0为找到软件加密狗。（输出状态）

3.4 彩信设备表ModemSetTable

字段名	类型	说明
ModemIndex	自动编号	主键，自动生成。
ModemName	文本	系统默认产生，不允许应用程序做修改。
CommName	文本	连接COM口名称。（输入控制）
Remark	文本	备注信息。
IsPauseStatus	数字	是否处于暂停控制状态，值为：1暂停状态、0启用状态。（输入控制）
ConnectStatus	数字	Modem是否处于连接状态，-1为连接失败，0为连接中，1为已连接成功。（输出状态）
SMSFunStatus	数字	Modem发送短信是否正常，0为未知（此设备还未发送过短信），-1为不能正常发送短信，1为能正常发送短信。状态都是指通过上一次的发送情况来判断的。（输出状态）
MMSFunStatus	数字	Modem收发彩信是否正常，0为未知，-1为不能正常收发彩信，1为能正常。（输出状态）
SendCount	数字	累计发送信息条数。（输出状态）

3.5 错误日志表ErrorTable

字段名	类型	说明
ErrorIndex	自动编号	主键，自动生成。
ErrorTime	时间日期	错误产生的时间。
ErrorInfo	文本	错误信息描述。

第 1 2 3 页下一页