1、深圳百利通科技 http:/ 全国服务热线：400-057-8590QQ：757013743 1213624832木鱼彩信（数据库接口版）用户手册版本：V3.0深圳百利通科技 http:/ 全国服务热线：400-057-8590深圳百利通科技 http:/ 咨询热线：400-057-8590 QQ 咨询：757013743 1.产品概述 42.概念说明 53.工作流程 64.产品安装配置 85.数据库表说明 95.1 信息发送表（MSG_Outbox） .95.2 信息发送成功表（MSG_Sentbox） 125.3 信息发送失败表（MSG_Failedbox ） .125.4 信息接收表（M
2、SG_Inbox） 136.发送功能实现 156.1 发送短信 156.2 发送 wap push 156.3 发送彩信 157、应用环境 .16深圳百利通科技 http:/ 全国服务热线：400-057-8590深圳百利通科技 http:/ 咨询热线：400-057-8590 QQ 咨询：757013743 1.产品概述本产品定位于为传统软件企业、无线增值业务服务公司和其他任何需要彩信/短信服务的实体提供二次开发接口服务。对于使用彩信/短信的公司而言，传统的方式是通过专线或 Internet 等有线接入方式实现，而彩信产品则可通过 gsm/gprs 等移动通信网络直接将彩信 /短信以无线的方
3、式传输，无需通过移动运营商的接入平台就可以开展无线业务应用。本系统提供基于数据库表的接口连接模式，这种方式可以跨越 windows 和 Unix 平台，同时可兼顾 B/S 和 C/S 应用，是一套全能的接口策略。本产品可实现： 多种形式彩信发送 彩信接收 普通短信发送、快闪短信（免提短信）发送 Wap push 信息发送 普通短信接收本产品提供给用户快速二次开发的能力，利用本产品普通的开发人员可以在几个小时之内快速开发、测试并启用彩信/短信服务。本产品支持的数据库包括：Access、SQL Server、Oracle、 MYSQL 和 Sybase本产品支持的彩信文件种类包括： 单一资源文件：
4、 文字：.txt .doc .ppt .pdf 和 .xls 文件 图片：.jpg .jpeg .gif .bmp 和.png 文件 声音：.mid .amr .wav 和.mp3 文件 影像：.3gp .mp4 .mpg4 .avi 和. asf 文件 其他：.jar .jad 和 .sis 文件 自定义的 ini 简单彩信格式：后面数据表说明处有详细介绍 Smil 标准彩信格式：具体需查阅相关彩信资料深圳百利通科技 http:/ 全国服务热线：400-057-8590深圳百利通科技 http:/ 咨询热线：400-057-8590 QQ 咨询：757013743 2.概念说明名称 描述快闪
5、短信 也叫免提短信，当此类短信到达手机后，不需要用户点击就可自行显示Wap push Wap 标准之一，将一个 wap 链接地址发送到手机上smil Synchronized Multimedia Integration Language即“同步多媒体集成语言” ，是 W3C 的标准之一彩信通知 类似于 wap push，用户接收彩信的时候，首先接收一条彩信通知( MMS Notifycation)，系统再根据彩信通知提供的地址去下载彩信彩信 Multimedia Messaging Service，多媒体消息服务，中国移动规定彩信内容一般不要大于 50k深圳百利通科技 http:/ 全国服务
6、热线：400-057-8590深圳百利通科技 http:/ 咨询热线：400-057-8590 QQ 咨询：757013743 3.工作流程本产品作为应用系统与彩信/短信服务的中介，利用数据库表来交换数据，系统支持Access、SQL Server、Oracle、MYSQL 和 Sybase 数据库，初次安装彩信系统，默认数据库为Access，数据库文件为安装目录下的 MMSServer.mdb，内有 4 张表，简单说明如下：表名 中文名 用途MSG_Outbox 信息发送表 用户要发送的彩信/短信存储于该表MSG_Sentbox 信息发送成功表 存储发送成功的信息MSG_Failedbox
7、信息发送失败表 存储发送失败的信息MSG_Inbox 信息接收表 存储接收到的彩信/短信下图为应用系统和彩信系统之间的连接图：数据库 彩信系统应用系统手机用户G P R S 网络应用系统和彩信系统只需要读写中间的数据库就可以收发彩信 / 短信 , 无需其他任何复杂的操作（ 彩信系统与应用系统连接示意图 ） 发送彩信/短信过程1. 应用系统向数据库中的 MSG_Outbox 表填写要发送的手机号码和彩信数据2. 彩信系统系统定时扫描 MSG_Outbox 表，一旦发现有符合条件的数据，则读出并控制 GPRS 彩信设备连接 GPRS 网络将信息发出深圳百利通科技 http:/ 全国服务热线：400
8、-057-8590深圳百利通科技 http:/ 咨询热线：400-057-8590 QQ 咨询：757013743 3. 彩信系统删除 MSG_Outbox 中的相应数据4. 如发送成功，彩信系统将数据保存到 MSG_Sentbox 表中5. 如发送失败，彩信系统将数据保存到 MSG_Failedbox 表中6. 应用系统可通过读取 MSG_Sentbox 和 MSG_Failedbox 表中的信息来判断彩信/ 短信发送是否成功 接收彩信过程1. 手机用户向 GPRS 彩信设备发送了一条彩信2. 彩信系统将收到的“彩信通知“保存到 MSG_Inbox 中，并控制 GPRS 彩信设备连接 GPR
9、S 网络，接收彩信3. 如成功接收彩信，彩信系统将接收的彩信以文件的形式保存到指定目录，并把文件名称更新到数据库中的 MSG_Inbox 表4. 如接收彩信失败，彩信系统将更新 MSG_Inbox 表中对应的下载状态字段，以后不再下载5. 应用系统可读取 MSG_Inbox 表中的内容来操作成功接收的彩信 接收短信过程1. 手机用户向 GPRS 彩信设备发送了一条短信2. 彩信系统将收到的短信保存到 MSG_Inbox 中3. 应用系统可读取 MSG_Inbox 表中的内容来操作成功接收的短信深圳百利通科技 http:/ 全国服务热线：400-057-8590深圳百利通科技 http:/ 咨询
10、热线：400-057-8590 QQ 咨询：757013743 4.产品安装配置木鱼彩信（数据库接口版）是一单一可执行文件提供的，用户拿到该软件后，可按照下面的顺序来操作。1. 安装硬件 GPRS 彩信发送设备，并确保插入了 SIM 卡，且该卡开通了彩信服务2. 运行本软件的安装程序，完成产品的安装3. 第一次运行本系统，配置通道连接、安装 USB 加密狗4. 配置数据库连接：a) 系统默认的数据库是 Access，用户如需使用其他数据库系统，则需使用本软件提供的 SQL 建表语句，利用相应数据库的管理程序，建立数据库和表。b) 对于 Access 数据库，在系统数据库配置界面直接选择就可以，
11、无需其他配置。c) 对于 SQL Server、MySQL 和 Sybase 数据库，需利用 windows 控制面板中的 ODBC管理程序建立相应的数据库连接的数据源，将 ODBC 数据源名称填写到本系统的配置数据库界面的“数据库连接串“项目，并测试连接是否正常d) 对于 Oracle 数据库，需安装 Oracle 的客户端程序，并将 Oracle 客户端设置的服务名填写到本系统配置数据库界面的在“数据库连接串“项目，并测试连接是否正常。5. 配置其他参数6. 启动服务、正式使用 MMS-Examples：彩信例子目录，包含 3 种彩信，可用于测试发送 MMS-IN：系统安装完成后，默认的彩
12、信接收保存目录深圳百利通科技 http:/ 全国服务热线：400-057-8590深圳百利通科技 http:/ 咨询热线：400-057-8590 QQ 咨询：757013743 5.数据库表说明5.1 信息发送表（ MSG_Outbox）序号 字段名 类型 长度 默认值允许空说明1 MsgID 数字 自动编号字段，可作为要发送信息的 ID 标识，用户程序无需处理2 ExpressLevel 数字 2 发送级别，系统分为 3 个级别: 0 为最高优先级 1 较高优先级 2 普通优先级可通过此字段控制发送信息的先后顺序3 Sender 文本 100 发送者名称，也可以是发送者的手机号码，为用户程
13、序保留的字段，用户可根据自己的需要来填写，也可不填写。4 Receiver 文本 200 接收者手机号码，此字段为必填字段。 发送短信，只能填写一个手机号码 发送彩信，可填写多个手机号，手机号之间用半角逗号分开，手机号的数量最多不超过 10 个，其数值与当地彩信网关有关，有的网关会过滤掉后面的手机号，这种情况只能填写一个手机号5 MsgType 数字 1 0= 普通短信1 = 彩信 （系统默认为 1，彩信）2 = wap push3 = 免提短信（快闪短信）6 MsgTitle 文本 500 该字段包含 3 个作用，其含义取决于MsgType 字段： 可作为普通短信的内容 可作为 wap pu
14、sh 中的提示语和 URL，提示语和 url 之间用 # 分隔例如：push 测试# 可作为彩信的标题7 MMSContentLocation 文本 500 彩信内容的全路径文件名，如发短信和 wap push，则本字段不用填写，彩信内容文件以下 3 种方式提供：深圳百利通科技 http:/ 全国服务热线：400-057-8590深圳百利通科技 http:/ 咨询热线：400-057-8590 QQ 咨询：757013743 单一资源文件 （比如一个图片文件或一个声音文件） ini 简单彩信描述文件 smil 标准彩信描述文件关于 ini 文件和 smil 的文件格式，下面有详细说明8 Sen
15、dTime 日期时间计划发送时间，必填字段，一般填写当前时间9 CommPort 数字 0 指定串口号当彩信系统有多个设备同时工作的时候，如需指定使用某串口上的设备发送信息，则填写串口号，如不需要指定则填写 0，这时系统根据各个设备的忙闲情况自动分配使用。注：MMSContentLocation 字段需要的彩信文件说明该字段填写的文件名称一定要使用全路径文件名:比如：c:测试彩信 .jpg，而不能只是：测试彩信.jpg 单一资源文件最简单的彩信，适用于只发送单个图片、声音或文字彩信的情况，系统支持如下格式： 文字： txt 文件 图片： jpg .gif .bmp 和.png 文件 声音： m
16、id .amr .wav 和.mp3 文件 Ini 简单彩信这种为我公司自行定义的彩信文件格式，文件扩展名为 ini ,利用该文件可实现多帧彩信，并且每帧可包含多个内容：Ini 文件以“ 新帧开始 “作为文件的开始，帧与帧之间都以”新帧开始“加换行回车作为分隔，每帧内各个彩信文件间用换行回车来分隔，每帧开始的时候可选择是否定义播放时间，用“播放时间=x”来定义，x 是播放时间，单位是秒，默认时间为 5 秒。下面是一个两帧彩信的例子：第一帧的播放时间为 10 秒，包含的三个文件分别是：“C:MMS三万英尺.mid”“C:MMS单机.jpg”“C:MMS单机介绍.txt”;第二帧没有设定播放时间，
17、按照默认值为 5 秒，包含的三个文件是：“C:MMS三万英尺.mid”“C:MMS机群.jpg”“C:MMS机群介绍.txt”深圳百利通科技 http:/ 全国服务热线：400-057-8590深圳百利通科技 http:/ 咨询热线：400-057-8590 QQ 咨询：757013743 Smil 格式彩信Smil 的全称为 Synchronized Multimedia Integration Language，即“同步多媒体集成语言”是 W3C 的标准之一，具体介绍可参见：http:/www.w3.org/AudioVideo/Smil 格式的彩信举例如下，同样是一个包含两帧的彩信：第一
18、帧的播放时间为 5 秒，包含“music.mid” 、 “single.jpg”和“single.txt ”三个资源文件；第二帧的播放时间为 10 秒，包含包含“music.mid” 、 “group.jpg”和“group.txt ”三个资源文件；需要说明的是，smil 文件中的资源文件名称必须用英文或数字，不能使用中文，另外，各个资源文件一定要与 smil 文件在同一个目录下。深圳百利通科技 http:/ 全国服务热线：400-057-8590深圳百利通科技 http:/ 咨询热线：400-057-8590 QQ 咨询：757013743 5.2 信息发送成功表（MSG_Sentbox）序
19、号 字段名 数据类型长度 默认值允许空说明1 ID 数字 自动编号字段，用户程序无需处理2 OriginMsgID 数字 对应 MSG_Outbox 表中的 MsgID 字段，目的是为了能与 MSG_Outbox 表建立关联3 ExpressLevel 数字 详见 MSG_Outbox 表对应字段说明4 Sender 文本 100 详见 MSG_Outbox 表对应字段说明5 Receiver 文本 200 详见 MSG_Outbox 表对应字段说明6 MsgType 数字 详见 MSG_Outbox 表对应字段说明7 MsgTitle 文本 500 详见 MSG_Outbox 表对应字段说明
20、8 MMSContentLocation 文本 500 详见 MSG_Outbox 表对应字段说明9 SendTime 日期时间详见 MSG_Outbox 表对应字段说明10 CommPort 数字 该信息发送使用的串口号11 ActualSendTime 日期时间信息实际发送完成时间12 ReceiveMMSTime 日期时间 对方接收到彩信的时间： 如此字段不为空，则表示对方肯定成功接收到了彩信。 如此字段为空，则有两种可能，一种是对方确实没有成功接收彩信，另一种可能是对方已成功接收了彩信。造成第二种情况的原因是运营商的系统返回状态有时候也不准确。13 MMSMessageID 文本 20
21、0 彩信编号，为发送彩信完成后彩信中心返回的一个编号，该编号作为系统内部使用，用户不用干预。5.3 信息发送失败表（MSG_Failedbox）序号 字段名 数据类型长度 默认值允许空说明1 ID 数字 自动编号字段，用户程序无需处理2 OriginMsgID 数字 对应 MSG_Outbox 表中的 MsgID 字段，目深圳百利通科技 http:/ 全国服务热线：400-057-8590深圳百利通科技 http:/ 咨询热线：400-057-8590 QQ 咨询：757013743 的是为了能与 MSG_Outbox 表建立关联3 ExpressLevel 数字 详见 MSG_Outbox
22、表对应字段说明4 Sender 文本 100 详见 MSG_Outbox 表对应字段说明5 Receiver 文本 200 详见 MSG_Outbox 表对应字段说明6 MsgType 数字 详见 MSG_Outbox 表对应字段说明7 MsgTitle 文本 500 详见 MSG_Outbox 表对应字段说明8 MMSContentLocation 文本 500 详见 MSG_Outbox 表对应字段说明9 SendTime 日期时间详见 MSG_Outbox 表对应字段说明10 CommPort 数字 该信息发送使用的串口号11 ActualSendTime 日期时间信息实际发送失败的时间
23、12 FailedReason 文本 500 发送信息失败的原因5.4 信息接收表（ MSG_Inbox）序号 字段名 数据类型长度 默认值允许空说明1 ID 数字 自动编号字段，用户程序无需处理2 Sender 文本 100 发送者手机号码或特服号码3 MsgType 数字 信息类别0 = 普通短信1 = 彩信4 MsgTitle 文本 500 该字段有 2 个作用，取决于 MsgType中的值： 如果接收的信息类别为普通短信，则本字段表示短信内容 如果接收的信息类别为彩信，则本字段表示彩信标题5 MMSUrl 文本 200 彩信下载地址，对于普通短信而言，此字段为空6 MMSContent
24、Location 文本 5000 接收到的彩信资源文件全路径文件名，如果彩信包含多个文件，则两个文件名之间用半角的逗号分隔，大部分彩信都会包含一个以 smi 结尾的文件，这个文件是描述彩信格式的，具体可参见彩信协议，其他文件都是具体的图片、铃声和文字等。深圳百利通科技 http:/ 全国服务热线：400-057-8590深圳百利通科技 http:/ 咨询热线：400-057-8590 QQ 咨询：757013743 7 MsgArrivedTime 日期时间信息到达的日期时间，是指普通短信或彩信通知的到达时间，也就是信息接收时间8 MMSDownloadedTime 日期时间 彩信实际下载完成
25、或下载失败时间，如还未开始下载彩信，则该字段为空9 MMSDownloadedState 数字 彩信是否已经成功下载:0 = 彩信还未开始下载1 = 已经开始下载彩信100 = 彩信下载成功-100 = 彩信下载失败10 CommPort 数字 接收信息使用的串口号深圳百利通科技 http:/ 全国服务热线：400-057-8590深圳百利通科技 http:/ 咨询热线：400-057-8590 QQ 咨询：757013743 6.发送功能实现所有发送功能的实现都是应用程序向 MSG-Outbox 表中填写数据，下面各个功能的实现中，我们都模拟了一条 SQL 语句，以便于应用开发人员将来能模仿
26、该语句建立自己的插入语句。6.1 发送短信 普通短信SQL 示例：INSERT INTO MSG_Outbox (Receiver,MsgType,MsgTitle,MMSContentLocation,SendTime) VALUES (13800008888,0,普通短信 ,2009-01-01 15:40:21) 快闪短信SQL 示例：INSERT INTO MSG_Outbox (Receiver,MsgType,MsgTitle,MMSContentLocation,SendTime) VALUES(13800008888,3,快闪短信 ,2009-01-01 15:41:40)6.
27、2 发送 wap pushSQL 示例：INSERT INTO MSG_Outbox (Receiver,MsgType,MsgTitle,MMSContentLocation,SendTime) VALUES(13800008888,2,wap push 测试#,2009-01-01 15:42:03)6.3 发送彩信 单个图片彩信SQL 示例：INSERT INTO MSG_Outbox (Receiver,MsgType,MsgTitle,MMSContentLocation,SendTime) VALUES (13800008888,1,单个图片彩信,C:MMS单一资源彩信美女头像.g
28、if,2009-01-01 15:42:41) 单个声音彩信SQL 示例：INSERT INTO MSG_Outbox (Receiver,MsgType,MsgTitle,MMSContentLocation,SendTime) VALUES (13800008888,1,单个铃声彩信 ,c:MMS单一资源彩信情非得意.mid,2009-01-01 15:43:43) 单个文字彩信SQL 示例：INSERT INTO MSG_Outbox (Receiver,MsgType,MsgTitle,MMSContentLocation,SendTime) VALUES(13800008888,1,
29、单个文本彩信,c:MMS单一资源彩信念奴娇赤壁怀古.txt,2009-01-01 深圳百利通科技 http:/ 全国服务热线：400-057-8590深圳百利通科技 http:/ 咨询热线：400-057-8590 QQ 咨询：757013743 15:44:27) 单个简单结构彩信SQL 示例：INSERT INTO MSG_Outbox (Receiver,MsgType,MsgTitle,MMSContentLocation,SendTime) VALUES (13800008888,1,简单结构彩信,c:MMSini 简单结构彩信测试彩信.ini,2009-01-01 15:45:07
30、) 单个 smil 结构彩信SQL 示例：INSERT INTO MSG_Outbox (Receiver,MsgType,MsgTitle,MMSContentLocation,SendTime) VALUES (13800008888,1,smil 标准结构彩信,c:MMSsmil 结构彩信测试彩信.smil,2009-01-01 15:46:18)7、应用环境 服务器：硬件配置：PC Server ，P4 以上，50M 以上空闲硬盘空间，内存 512M 以上运行环境：windows XP GPRS Modem：采用 Wavecom GRPS Modem，连接速率为 115200.【联系方式】：深圳百利通科技有限公司 http:/ 全国服务热线：【400-057-8590】业务联系：谢先生 手机号码：13510229725服务热线：0755-83745521 83745526 在线客服 QQ：757013743 516109523 公司地址：深圳市福田区华强北燕南路 96 号格林网苑大厦
