诺亚彩信开发接口，是Windows系统的标准OCX控件，支持标准工业GPRS Modem。无需接入互联网即可实现发送彩信、接收彩信、发送短信、接收短信、发送WAP Push消息、发送彩E等功能，支持发送彩信，实时返回信息接收报告，同时还包含彩信制作、接收彩信解析、彩信文件播放等功能。本彩信控件支持100K以下的彩信收发，彩信文件编辑可以采用ini文件、SMIL文件等。本彩信控件采用特殊技术，对超长短信分割发送，手机收到后能自动合并为一条短信。
诺亚彩信开发控件，使用特有的内嵌拨号技术，使在收发彩信时不需要在操作系统中建立拨号连接，从而避免了使用时与电脑上的其他网络软件发生冲突的可能性，因此大大提高了开发系统的环境独立性和可靠性。目前国内外同类软件因没有解决此问题，软件运行稳定性和可靠性均较差。
利用诺亚彩信控件开发短信彩信的应用软件，您无需了解复杂的GSM/GPRS/WAP等通信协议，只需简单调用接口函数和接口事件，即可让应用软件快速集成彩信短信收发功能。适用于主流开发语言（VB、VC、Delphi、C++Builder、c#等），提供了多种开发语言的示例源代码。
利用诺亚彩信控件升级应用系统的彩信功能，具有实施低成本的特点。只需要用一套GPRS Modem与电脑相连，就可以使用本控件来收发彩信短信，使用简单，维护较少。
利用诺亚彩信控件，您可以简单快捷地进行二次开发，可广泛应用在企业MIS系统、电台节目互动、调度通知系统、ERP应用、OA办公网络、客户服务中心等应用系统中，将彩信短信服务与不同行业度身定制的信息管理系统相结合，根据不同客户、不同需求，高效提供更多个性化的服务、产品和信息。
诺亚彩信二次开发包适用于发送彩信MODEM、彩信机、手机彩信报警器、彩信报警器、彩信工具、彩信发送MODEM、彩信MODEM池、彩信器等诺亚彩信应用产品。
注：在使用诺亚彩信开发控件之前，请先在您的电脑中安装诺亚GPRS彩信MODEM，具体安装方法，请参阅《诺亚彩信MODEM安装说明》。
功能说明
·提供一系列控制函数库，用户通过在自行开发的软件中调用这些函数，就可实现短信、彩信的收发功能。适用于主流开发平台（VB、VC、Delphi等），帮助您的应用系统快速集成短信、彩信功能。
·基于此平台可快速开发网络短信、彩信的应用，您无需了解复杂的GSM/GPRS通信控制协议，只需简单调用标准的 OCX控件，即可让系统快速集成短信及彩信功能。
·点对点方式发送短信彩信，无需上网即可发送彩信、接收彩信、发送短信、接收短信、发送联通彩e、发送wap push消息等。
·低成本实施，采用GSM/GPRS Modem接入普通电脑，配合本套软件即可建立起短信彩信平台。使用和维护简单方便，有效保障企业利益。
诺亚彩信开发接口内部运行原理图
诺亚彩信开发接口函数说明
一.控件使用特性
本控件适用标准工业GPRS Modem，GPRS Modem的串口波特率默认为115200。
本控件为Windows系统的标准OCX控件。使用简单，只有接口函数和接口事件，没有需要配置的属性。
控件文件名称：NoahMMS.ocx
控件接口名称：NoahMMS
二.控件使用特性
1．控件初始化
函数名称 |
long NoahInit(LPCTSTR szWorkDir, short nUseType, short nSoftKind) |
功能描述 |
初始化控件 |
参数说明 |
szWorkDir |
设置彩信信息文件工作目录 |
nUseType |
使用类型
- １、 发送彩信；
- ２、 接收彩信；
- ４、 收发短信。
注：功能数为数字相加，例：想具有所有功能，则为1+2+4=7。 |
nSoftKind |
彩信发送完毕处理方式：
0 彩信发送完毕，立即挂断
1 彩信发送完毕，不挂断 |
返回值 |
0 |
控件初始化成功 |
-1 |
空间初始化失败 |
2．释放控件
函数名称 |
void NoahRelease(void) |
功能描述 |
程序关闭之前释放控件，避免内存泄漏等问题 |
参数说明 |
无 |
返回值 |
无 |
3．发送彩信
函数名称 |
long SendMms(LPCTSTR szMobile, LPCTSTR szSubject, LPCTSTR szMsgInfo, long nMsgIndex) |
功能描述 |
发送彩信 |
参数说明 |
szMobile |
彩信接收号码（支持10个以下的批量提交发送，号码间以半角逗号间隔）。 |
szSubject |
彩信标题 |
szMsgInfo |
彩信信息全路径文件名 |
nMsgIndex |
彩信序号（自己填写，用于发送时返回结果的标识） |
返回值 |
0 |
为提交彩信成功，彩信已加入服务器的发送列表。否则提交失败 |
-1 |
超过发送任务列表限额，稍后再提交 |
-2 |
没有发现彩信设备 |
4．发送短信????
函数名称 |
long SendSms(LPCTSTR szMobile, LPCTSTR szSms, long nIndex) |
功能描述 |
发送短信 |
参数说明 |
szMobile |
短信接收号码 |
szSms |
短消息内容 |
nIndex |
短信序号（自己填写，用于发送时返回结果的标识） |
返回值 |
0 |
为提交短信成功，短信已加入服务器的发送列表。否则提交失败 |
-1 |
超过发送任务列表限额，稍后再提交 |
-2 |
没有发现短信终端 |
5．刷新设备
函数名称 |
long DeviceRefresh(void) |
功能描述 |
刷新连接的设备 |
参数说明 |
无 |
返回值 |
刷新后得到的设备个数 |
6．获取任务列表中待发彩信数目
函数名称 |
long GetCountOfSendMms(void) |
功能描述 |
获取任务列表中待发彩信的数量 |
参数说明 |
无 |
返回值 |
任务列表中待发彩信的数量 |
7．获取任务列表中待发短信数目
函数名称 |
long GetCountOfSendSms(void) |
功能描述 |
获取任务列表中待发短信的数量 |
参数说明 |
无 |
返回值 |
任务列表中待发短信的数量 |
8．获取待接收彩信的数目
函数名称 |
long GetCountOfRecvMms (void) |
功能描述 |
获取任务列表中待接收彩信的数量 |
参数说明 |
无 |
返回值 |
任务列表中待接收彩信的数量 |
9．获取设备的信号强度
函数名称 |
long GetSignalDegree (void) |
功能描述 |
取得设备的信号强度（范围0-32，值越大信号越强） |
参数说明 |
无 |
返回值 |
设备的信号强度 |
三.控件接口事件说明
1．设备初始化事件
事件函数 |
void DeviceInited(long nDevice, long nStatus) |
功能描述 |
设备初始化完成事件 |
参数说明 |
nDevice |
设备个数 |
nStatus |
设备状态 |
2．设备状态改变事件
事件函数 |
void DeviceStatusChanged(long nStatus) |
功能描述 |
设备状态改变事件 |
参数说明 |
nStatus |
设备当前状态值：
- 1．? 设备正在刷新
- 2．? 刷新完成，找到设备
- 3．? 刷新完成，没有找到任何设备
|
3．短信发送状态事件
事件函数 |
void SmsSendStatus(long nMsgIndex, long nStatus) |
功能描述 |
短信发送状态事件 |
参数说明 |
nMsgIndex |
短信编号 |
nStatus |
短信发送状态
0：短信发送成功
1：短信发送失败 |
4．彩信发送状态事件
事件函数 |
void MmsSendStatus(long nMsgIndex, long nStatus) |
功能描述 |
彩信发送状态事件 |
参数说明 |
nMsgIndex |
彩信编号 |
nStatus |
彩信发送状态
0：彩信发送成功
1：彩信发送失败 |
5．收到彩信事件
事件函数 |
void MmsReceived(LPCTSTR szMobile, LPCTSTR szSubject, LPCTSTR szRecvFolder, LPCTSTR szFileName) |
功能描述 |
收到彩信事件 |
参数说明 |
szMobile |
发送者手机号码 |
szSubject |
彩信标题 |
szRecvFolder |
彩信接收文件夹 |
szFileName |
彩信资源文件名 |
6．收到短信事件
事件函数 |
void RecvSms(LPCTSTR szMobile, LPCTSTR szContent) |
功能描述 |
收到短信事件 |
参数说明 |
szMobile |
发送者手机号码 |
szContent |
短信内容 |
7．电话振铃提示事件
事件函数 |
void Ring(LPCTSTR szPhoneNum) |
功能描述 |
来电提示 |
参数说明 |
szPhoneNum |
拨打的电话号码 |
8．控件系统事件
事件函数 |
void NoahSysEvent (long nEvent, LPCTSTR szDescript) |
功能描述 |
收到短信事件 |
参数说明 |
nEvent |
系统事件编号 |
szDescript |
事件描述 |
附录一彩信信息文件类型及格式
以上函数中提到的彩信信息文件可以为以下4种类型：
1、单一彩信资源文件
指的是如图片文件、声音文件、文本文件等信息资源文件。
这种适用于仅包含一种媒体类型的彩信，如单一图片（或单一铃声、单一视频）的彩信、纯文本的彩信等。操作特点是简单易用。
支持文件类型的后缀名为下列：txt、jpg、gif、bmp、png、amr、mp3、mid、mmf、aac、mfm、adp、3gp、jar、jad、sis。
支持文件大小在50K以内。
2、多媒体彩信结构文件（ini文件格式）（下载“测试INI”文件）
该格式为本控件自定义格式，内容为该彩信包含的各个彩信资源文件名称（绝对路径），扩展名为ini（与配置文件相同，类似于txt文件）。
文件结构定义，如下图所示：
一般来说按照该格式填写内容即可。另外总帧数不一定非要在第一行，各帧的播放时间、图片路径、音乐路径、文字路径的“=”后面的值可以为空和总帧数不一定非要在第一行外，其它的严格按照该格式填写，但是必须保证每一帧至少有一项内容（图片或音乐或文字）。
3、SMIL彩信结构（SMIL文件格式）
SMIL是同步多媒体集成语言（Synchronized Multimedia Integration Language）的缩写，念做smile。它是由3W(World Wide Web Consortium)组织规定的多媒体操作语言。关于SMIL语言的知识请参考相关专业书籍。
值得注意的是：如果你使用SMIL文件作为彩信结构格式文件来提交要发送的彩信，则务必要把该SMIL文件引用到的资源文件放在SMIL文件的同一目录下，否则会找不到引用资源文件。
4、MMS彩信打包文件（EMMS文件格式）
本格式为诺亚公司创建的专有格式，格式标准尚未公开。
如果你需要建立此文件，可以用诺亚公司的彩信制作控件来制作此类文件。
附录二彩信资源文件的格式和大小要求
彩信资源文件的后缀名必须在下列范围之类：txt、jpg、gif、bmp、png、amr、mp3、mid、mmf、aac、mfm、adp、3gp、jar、jad、sis。
彩信资源文件大小必须在50K以内。
附录三术语表
术语 |
描述 |
SMIL |
Synchronized Multimedia Integration Language
同步多媒体集成语言 |
SMS |
Short Messaging Service
短消息服务 |
WAP |
Wireless Application Protocol
无线应用协议 |
MMS |
Multimedia Messaging Service
多媒体消息服务 |
MMSC |
Multimedia Messaging Service Center
多媒体消息服务中心 |
MS |
Mobile Station, Terminal
移动终端，终端 |
彩信资源文件 |
指包含彩信内容信息的文件，如图片文件、声音文件、文本文件、视频文件、应用程序文件等。 |
彩信结构文件 |
指用于彩信内容组织、排版、布局的信息文件。彩信结构文件不包含具体的彩信内容信息。 |
彩信打包文件 |
指同时包含了彩信内容信息和彩信组织布局信息的文件，相当于彩信资源文件和彩信结构文件的合并文件。 |
|
