百灵佳科技LOGO
加入收藏 | 设为首页 | English   
ALIBABA MADE IN CHINA ALIBABA
深圳市百灵佳科技有限公司
地址:深圳市福田区上步南路国企大厦永富楼15A
电话:0755-25911778
传真:0755-25911778-806
邮箱:guodong-ceo@bailing88.com
您现在的位置: 深圳市百灵佳科技有限公司 > 3G百灵短信彩信控件开发
 

百灵短信彩信开发控件内部运行原理图


四、百灵短信彩信开发控件接口说明

4.1控件使用特性

本控件适用标准工业GPRS Modem,GPRS Modem的串口波特率默认为115200。
本控件为Windows系统的标准OCX控件。使用简单,只有接口函数和接口事件,没有需要配置的属性。
控件文件名称:EtesnMMS.ocx。
控件接口名称:EtesnMMS。

4.2 控件接口函数

 接口函数一:
函数名
long InitModel(LPCTSTR WorkDir, long UseModel, long EventModel, long SoftDogType, long MakeRecvMMSDir);
函数描述
初始化系统
参数描述
WorkDir
设置彩信信息文件工作目录
UseModel
使用模型
1、发送彩信;
2、接收彩信;
4、收发短信。
注:功能数为数字相加,例:想具有所有功能,则为1+2+4=7。
EventModel
事件模型:
0、容器程序手动查询事件信息(对应4.3节描述);
1、系统向容器程序弹出事件提示(对应4.4节描述)。
SoftDogType
使用加密狗类型(此值目前固定为101)。
MakeRecvMMSDir
1为要创建新的接收文件目录,0为不创建。
返回值
>0 设置的使用模式值(此值为UseModel项与加密狗功能项的交集)
0  未找到加密狗,初始化失败。
-4 不支持的加密狗类型参数。
 
接口函数二:
函数名
long ConnectModem(LPCTSTR ComName)
函数描述
连接设备
参数描述
ComName
串口标识(如“com1”)。
返回值
-1未成功初始化模块,需先调用InitModel;
1 成功调用,模块正在连接设备。
 
接口函数三:
函数名
long DisConnectModem();
函数描述
断开与设备的连接。
参数描述
返回值
忽略
 
接口函数四:
函数名
long SendSMS(LPCTSTR PhoneNumber, LPCTSTR SMSContent, long SMSIndex);
函数描述
发送短消息
参数描述
PhoneNumber
短信接收号码(如果需要短信送达报告,则要在发送号码后加一个#号),本参数只允许包含一个发送号码。
SMSContent
短消息内容
SMSIndex
短信序号(自己填写,用于群发时返回结果的标识)
返回值
1 为提交短信成功,短信已加入服务器的发送列表,否则提交失败。
-1为尚未连接到彩信设备;
-2为当前使用模式不支持收发短信;
-3为设备未初始化。
 
 接口函数五:
函数名
long SendMMS(LPCTSTR PhoneNumber, LPCTSTR MsgTitle, LPCTSTR MMSInfoFile, long MMSIndex);
函数描述
发送彩信
参数描述
PhoneNumber
彩信接收号码(支持10个以下的批量提交群发,号码间以西文逗号间隔)。
MsgTitle
彩信标题
MMSInfoFile
彩信信息全路径文件名(文件类型和大小要求参见附录1和2)
MMSIndex
彩信序号(自己填写,用于群发时返回结果的标识)
返回值
1 为提交彩信成功,彩信已加入服务器的发送列表。否则提交失败。
-1为尚未连接到彩信设备;
-2为当前使用模式不支持收发彩信;
-3为设备未始化。
-4为彩信信息文件不存在(或为空)。
-5为彩信信息文件格式不正确。
 
接口函数六:
函数名
long GetModemStatus();
函数描述
获得彩信猫设备连接状态
参数描述
返回值
-1查找彩信猫设备失败;
0查找彩信猫设备中;
1已经找到彩信猫设备。
 
接口函数七:
函数名
long GetSendMMSTaskCount();
函数描述
取模块中的待发送彩信数目
参数描述
返回值
待发送彩信数目
 
接口函数八:
函数名
long GetRecvMMSTaskCount();
函数描述
取模块中的待接收彩信数目
参数描述
返回值
收到彩信数目
 
接口函数九:
函数名
long GetSendSMSTaskCount();
函数描述
取模块中的待发送短信数目
参数描述
返回值
待发送短信数目
 
接口函数十: 
函数名
long SendDataSMS(long SMSIndex, LPCTSTR SMSData);
函数描述
发送数据短信(一般不使用此函数,仅为特殊用户测试用)
参数描述
SMSIndex
短信序号
SMSData
短信数据内容
返回值
1 为提交短信成功,短信已加入服务器的发送列表,否则提交失败;
-1为尚未连接到设备;
-2为当前使用模式不支持收发短信;
-3为设备未始化。
 
接口函数十一: 
函数名
CString GetRunInfo();
函数描述
获取模块运行中的提示性信息。
参数描述
返回值
模块运行中的提示性信息。
 
接口函数十二: 
函数名
long GetSignalStrength();
函数描述
取得设备的信号强度(范围0-100,值越大信号越强)
参数描述
返回值
设备的信号强度。
 
接口函数十三: 
函数名
long SendWebPush(LPCTSTR PhoneNumber, LPCTSTR WebURL, LPCTSTR TitleText, long SMSIndex);
函数描述
向手机发送含URL地址的PUSH信息,手机收到后提示有服务信息(又称WAP Push信息),手机用户可以到该地址取相关文件。
参数描述
PhoneNumber
接收手机号码。
WebURL
文件Web地址。
TitleText
提示信息标题。
SMSIndex
信息序号(自己填写,用于群发时返回结果的标识)
返回值
1 为提交短信成功,短信已加入服务器的发送列表,否则提交失败。
-1为尚未连接到彩信设备;
-2为当前使用模式不支持收发短信;
-3为设备未初始化。
 
接口函数十四(普通用户不要使用本接口,本公司不提供本接口的技术支持): 
函数名
long SendMMSPush(LPCTSTR PhoneNumber, LPCTSTR MMSTitle, LPCTSTR MMSFileURL, long MMSFileLen, LPCTSTR MMSScr, long MMSIndex);
函数描述
向手机发送彩信PUSH消息(获取的彩信文件格式必须符合相关标准)。
参数描述
PhoneNumber
接收手机号码。
MMSTitle
彩信标题。
MMSFileURL
彩信文件的URL地址。
MMSFileLen
彩信文件大小。
MMSScr
彩信发送源号码。
SMSIndex
信息序号(自己填写,用于群发时返回结果的标识,0和999999之间)
返回值
1 为提交彩信PUSH成功,已加入服务器的发送列表。否则提交失败。
-1为尚未连接到彩信设备;
-2为当前使用模式不支持收发彩信PUSH;
-3为设备未始化。
-4为URL地址和源号码字符长度超过了允许范围45字节(计算长度时要包括http://)。
-5为MMSIndex值没有在0和999999之间。
 
接口函数十五: 
函数名
long SetMMSImageSize(long MaxWidth, long MaxHeight);
函数描述
设置彩信中图片的尺寸大小范围(本函数对gif图片无效)。
参数描述
MaxWidth
彩信图片的最大宽度值,大于此值时按比例压缩至此值。
MaxHeight
彩信图片的最大高度值,大于此值时按比例压缩至此值。
返回值
1为设置成功。
0为设置失败。
 

4.3手动调用事件接口函数

使用手动调用事件接口函数的目的是为了满足某些程序开发者的编程习惯,手动调用事件和弹出事件两种方式功能上没有任何差异。两种调用方式的选择由控件接口函数InitModel的第三个参数EventModel来决定。
本节与4.4节在内容上为并列关系,如果你习惯或擅长于windows基于事件的编程方式,那么你可以跳过本节阅读其后内容。
使用手动调用事件方式编程的优点是使程序流程比较清晰,方便于流程图绘制,特别在多线程多设备应用开发时优点尤为突出。
手动调用事件接口函数一:
函数名
long GetEventRecvSms(short * PhoneNumber, short * SMSContent);
函数描述
取模块中的短信接收事件
参数描述
PhoneNumber
短信发送号码
SMSContent
短信内容
返回值
1为取到接收短信;0为无新收到短信
 
手动调用事件接口函数二:
函数名
long GetEventRecvMMS(short * PhoneNumber, short * MMSTitle, short * RecvMMSFileDir, short * RecvFile1, short * RecvFile2, short * RecvFile3, short * RecvFile4, short * RecvFile5);
函数描述
取模块中的彩信接收事件
参数描述
PhoneNumber
彩信发送号码
MMSTitle
彩信标题
RecvMMSFileDir
接收到的彩信资源文件保存目录
RecvFile1
彩信资源文件名1
RecvFile2
彩信资源文件名2
RecvFile3
彩信资源文件名3
RecvFile4
彩信资源文件名4
RecvFile5
彩信资源文件名5
返回值
1为取到接收彩信;0为无新收到彩信
 
手动调用事件接口函数三:
函数名
long GetEventSendMMSStatus(long MMSIndex,short* MMSCID);
函数描述
取模块中的发送彩信状态事件
参数描述
MMSIndex
彩信序号
MMSCID
彩信中心对本条信息的编号
返回值
-100为序号不正确;
0为发送中;
1为发送成功;
-1为发送失败。
 
手动调用事件接口函数四:
函数名
long GetEventSendSMSStatus(long SMSIndex,short* SMSCID);
函数描述
取模块中的发送短信状态事件
参数描述
SMSIndex
短信序号
SMSCID
短信中心对本条信息的编号
返回值
-100为序号不正确;
0为发送中;
1为发送成功;
-1为发送失败。
 
手动调用事件接口函数五:
函数名
long GetEventMMSRecvReport(short* MMSStatus, short* MMSCID, short* PhoneNumber);
函数描述
取模块中的彩信接收报告事件
MMSStatus
彩信状态1,对方接收彩信成功;否则接收失败
MMSCID
该彩信提交时彩信中心的消息编号
PhoneNumber
该彩信的接收号码
返回值
1为取得消息接收报告;
0为无消息接收报告。
 
手动调用事件接口函数六:
函数名
CString GetEventSMSRecvReport(short* SMSStatus, short* SMSCID, short* PhoneNumber);
函数描述
取模块中的短信接收报告事件
参数描述
SMSStatus
短信状态1,对方接收短信成功;否则接收失败
SMSCID
该短信提交时短信中心的消息编号
PhoneNumber
该短信的接收号码
返回值
1为取得消息接收报告;
0为无消息接收报告。
 
手动调用事件接口函数七:
函数名
CString GetEventRing();
函数描述
取接收到的来电信息事件
参数描述
返回值
取来电的电话号码。
 

4.4 控件接口事件

接口事件一:
事件名
void ModemStatusChanged(long ModemStatus);
事件描述
Modem改变状态提示事件
参数描述
ModemStatus
Modem状态值:
0、查找中,
1、已经找到设备,
-1、查找设备失败。
 
接口事件二:
事件名
void SendSMSStatus(long SMSIndex, long SMSStatus, LPCTSTR SMSCID);
事件描述
发送短信状态提示事件
参数描述
SMSIndex
短信序号
SMSStatus
1 短信提交到运营商短信中心成功;
0短信提交到运营商短信中心失败。
SMSCID
短信中心对本条信息的编号
 
接口事件三:
事件名
void SendMMSStatus(long MMSIndex, long MMSStatus, LPCTSTR MMSCID);
事件描述
发送彩信状态提示事件
参数描述
MMSIndex
彩信序号
MMSStatus
1 彩信提交到运营商彩信中心成功;
0 彩信提交到运营商彩信中心失败。
MMSCID
彩信中心对本条信息的编号
 
接口事件四:
事件名
void RecvSMS(LPCTSTR PhoneNumber, LPCTSTR SMSContent);
事件描述
收到短消息提示事件
参数描述
PhoneNumber
发送者手机号码
SMSContent
短信内容
 
接口事件五:
事件名
void RecvMMS(LPCTSTR PhoneNumber, LPCTSTR MMSTitle, LPCTSTR RecvMMSFileDir, LPCTSTR RecvFile1, LPCTSTR RecvFile2, LPCTSTR RecvFile3, LPCTSTR RecvFile4, LPCTSTR RecvFile5);
事件描述
收到彩信提示事件
参数描述
PhoneNumber
发送者手机号码
MMSTitle
彩信标题
RecvMMSFileDir
接收到的彩信资源文件保存目录
RecvFile1
RecvFile5
彩信资源文件名1
彩信资源文件名5
 
接口事件六:
事件名
void MMSRecvReport(long MMSStatus, LPCTSTR PhoneNumber, LPCTSTR MMSCID);
事件描述
彩信接收报告提示事件
参数描述
MMSStatus
1  表示对方手机已接收彩信;
<1 表示对方手机没有成功接收彩信(如对方手机不支持彩信或欠费等)。
PhoneNumber
该彩信的接收号码
MMSCID
该彩信提交时彩信中心的消息编号
 
接口事件七:
事件名
void SMSRecvReport(long MsgStatus, LPCTSTR PhoneNumber, LPCTSTR SMSCID);
事件描述
短信接收报告提示事件
参数描述
SMSStatus
1表示对方手机已接收到短信;
0 表示对方手机接收短信失败。
PhoneNumber
该短信的接收号码
SMSCID
该短信提交时短信中心的消息编号
 
接口事件八:
事件名
void FireRing(LPCTSTR PhoneNumber);
事件描述
电话振铃提示事件(即来电提示)
参数描述
PhoneNumber
拨打彩信猫内SIM的电话号码。
 
 
 *  主  题:
 *  联系人:
 *  公司名:
 *  电  话:
  传  真:
 *  邮  箱:
 地  址:
*您的需求:
    
  
公司简介
企业文化
加入我们
  
行业新闻
公司新闻
  
最新产品
模块系列
安防报警器
  
资质荣誉
合作加盟
  
公司地图
联系方式