彩信控件调用示例.doc

成都爱特生信息技术有限公司 短信彩信ocx控件调用示例爱特生短信彩信ocx控件调用示例一、典型调用方式2二、调用示例32.1初始化模块32.2连接设备32.3收发彩信短信42.4状态信息查询82.5断开设备连接9三、参考资料10一、典型调用方式程序启动时初始化模块，设置控件为事件驱动模式；连接设备；通过接口函数来发送短信彩信，利用控件事件来接收短信、彩信、发送报告、设备状态改变等；程序退出时，断开设备连接。注：如果本控件采用非事件驱动模式，通常需要建立一个新线程来管理控件操作，相对要困难些，建议本控件采用事件驱动模式。二、调用示例约定：假设容器程序中添加的彩信控件名称为m_ctrlMMSOcx。2.1初始化模块2.1.1初始化函数int nRes=m_ctrlMMSOcx.InitModel(C:RecvMMS,7,1,101,1);if(nRes0)MessageBox(初始化控件成功，已经找到加密狗。);else if(nRes=0)MessageBox(初始化失败！rn未找到软件加密狗。);else if(nRes=-4)MessageBox(初始化失败！rn不支持的加密狗类型参数。);说明：1、参数1指的是彩信工作路径，控件会在该创建彩信接收目录等。2、参数2指的是彩信使用模型，7表示要求控件支持彩信短信的收发功能（1+2+4=7）。3、参数3指的是彩信控件使用事件驱动模式工作。4、参数4指的是彩信控件使用加密狗类型，此值固定为101（设备连接串口固定为com1）。5、参数5指的是指收到彩信后要创建新的彩信接收文件目录，因为一个彩信里面通常包括了多个多媒体信息文件，所以建议创建一个新的目录来存储这些文件。6、函数返回值的说明参见上面的代码中的提示信息。2.2连接设备2.2.1连接设备函数int nRes=m_ctrlMMSOcx.ConnectModem(com1);if(nRes=1)MessageBox(正在启动连接设备过程。请稍候。);else if(nRes=-1)MessageBox(未成功初始化模块，请先进行控件初始化。);说明：1、参数1指的是彩信设备连接的com口名称。需要注意的是我们假设了彩信设备的连接波特率为115200，如果你的设备不是115200，请通过AT指令将你的彩信设备连接速率设为115200。注意：使用101类型加密狗时连接的com口名称固定为“com1”。2、回值的说明参见上面的代码中的提示信息。3、因为控件设为事件驱动方式工作，而彩信设备的检测和连接有个等待过程（约30秒钟），所以此函数的返回并没有说明设备是否连接成功，需要一个报告事件来告诉容器程序连接是否成功，此事件就是：ModemStatusChanged。2.2.1设备状态变化事件Void ModemStatusChanged (long ModemStatus)if(ModemStatus=1)MessageBox(连接设备成功！);else if(ModemStatus=-1)MessageBox(连接设备失败！);else if(ModemStatus=0)MessageBox(正在连接设备！);说明：只要设备的连接状态发生变化，控件都会发出此事件信息。需要了解一点的就是，收发短信和收发彩信的状态转换也会产生此事件，所以此事件不仅仅在连接设备时才产生。2.3收发彩信短信2.3.1发送文字短信int nRes=m_ctrlMMSOcx.SendSMS(“1398080xxxx”,”您好，爱特生控件文字短信测试消息。”,1);if(nRes=1)MessageBox(提交短信成功！短信已加入服务器的发送列表等待发送。);else if(nRes=-1)MessageBox(提交短信失败！尚未连接到短信彩信设备。);else if(nRes=-2)MessageBox(提交短信失败！当前使用模式不支持收发短信。);else if(nRes=-3)MessageBox(提交短信失败！未成功初始化模块，请先进行控件初始化。);说明：1、参数1指的是短信的接收号码（如果需要短信送达报告，则要在发送号码后加一个#号，例如“1398080xxxx#”）。2、参数2指的是要发送的短信内容。3、参数3指的是短信发送序号（用于事件返回时区分是那条消息）。4、文字短信的发送结果可以通过事件SendSMSStatus获知；如果是有状态报告请求的消息，可以通过事件SMSRecvReport获知。2.3.2发送彩信int nRes=m_ctrlMMSOcx.SendMMS(“1398080xxxx, 135989811xx”,”姚明精彩爆扣”,”c:姚明.jpg”,1);if(nRes=1)MessageBox(提交彩信成功！彩信已加入服务器的发送列表等待发送。);else if(nRes=-1)MessageBox(提交彩信失败！尚未连接到短信彩信设备。);else if(nRes=-2)MessageBox(提交彩信失败！当前使用模式不支持收发短信。);else if(nRes=-3)MessageBox(提交彩信失败！未成功初始化模块，请先进行控件初始化。);else if(nRes=-4)MessageBox(提交彩信失败！彩信信息文件不存在（或为空）。);else if(nRes=-5)MessageBox(提交彩信失败！彩信信息文件格式不正确。);说明：1、参数1指的是彩信的接收号码（允许一次填写10个以下号码，号码间以西文逗号分割，软件能够一次性批量提交所列号码的彩信）。2、参数2指的是要发送彩信的标题。3、参数3指的是彩信的资源文件。关于资源文件的类型和说明，请参见爱特生短信彩信控件开发说明书.doc文档，该文档有非常详细的关于这方面的描述。4、参数4指的是彩信发送序号（用于事件返回时区分是那条消息）。5、彩信的发送结果可以通过事件SendMMSStatus获知；送达对方手机后的通知，可以通过事件MMSRecvReport获知。2.3.3接收短信事件Void RecvSMS(LPCTSTR PhoneNumber, LPCTSTR SMSContent)CString strNoticeText;strNoticeText.Format(收到短信： %s,%s,PhoneNumber,SMSContent);MessageBox(strNoticeText);说明：1、参数1为发送者的手机号码。2、参数2为接收到的短信内容。2.3.4接收彩信事件Void RecvMMS (LPCTSTR PhoneNumber, LPCTSTR MMSTitle, LPCTSTR RecvMMSFileDir, LPCTSTR RecvFile1, LPCTSTR RecvFile2, LPCTSTR RecvFile3, LPCTSTR RecvFile4, LPCTSTR RecvFile5)CString strNoticeText;strNoticeText.Format(收到彩信！发送号码为：%s标题为：%s内容为： %s %s %s %s %s,PhoneNumber,MMSTitle,RecvFile1,RecvFile2,RecvFile3,RecvFile4,RecvFile5);MessageBox(strNoticeText);说明：1、参数1为发送者手机号码。2、参数2为彩信标题。3、参数3为接收到的彩信资源文件保存目录。4、参数4-9为彩信资源文件名（列出彩信中包含的前五个彩信资源文件，主要是方便容器程序调用）。2.3.5短信发送完毕事件void SendSMSStatus(long SMSIndex, long SMSStatus)CString strNoticeText;if(SMSStatus=1)strNoticeText.Format(发送消息号为%d的短信已经成功发送！,SMSIndex);elsestrNoticeText.Format(发送消息号为%d的短信发送失败！,SMSIndex);MessageBox(strNoticeText);说明：1、参数1为短信序号（在发送短信函数中设定的）。2、参数2为短信发送情况，1为成功送达运营商短信中心，其余值为发送失败。2.3.6彩信发送完毕事件void SendMMSStatus(long MMSIndex, long MMSStatus)CString strNoticeText;if(MMSStatus=1)strNoticeText.Format(发送消息号为%d的彩信已经成功发送！,MMSIndex);elsestrNoticeText.Format(发送消息号为%d的彩信发送失败！,MMSIndex);MessageBox(strNoticeText);说明：1、参数1为彩信序号（在发送彩信函数中设定的）。2、参数2为彩信发送情况，1为成功送达运营商彩信中心，其余值为发送失败。2.3.7短信已送达对方事件void SMSRecvReport(LPCTSTR PhoneNumber, long SMSStatus)if(SMSStatus =1)CString strNoticeText;strNoticeText.Format(短信送达报告！给%s手机发送的短信，手机已经收到该短信！, PhoneNumber);MessageBox(strNoticeText);说明：1、参数1为接收方手机号码。2、参数2为短信送达状态，1为成功送达，其余值为送达失败。注：由于受运营商系统影响的原因，此状态事件不稳定，部分时间收不到此事件。2.3.8彩信已送达对方事件void MMSRecvReport(long MMSIndex, long MMSStatus)CString strNoticeText;if(MMSStatus=1)strNoticeText.Format(彩信送达报告！rn发送编号为%d的彩信，手机已经收到！,MMSIndex);elsestrNoticeText.Format(彩信送达报告！rn发送编号为%d的彩信，被接收方拒收！,MMSIndex);MessageBox(strNoticeText);说明：1、参数1为接收方手机号码。2、参数2为彩信送达状态，1为成功送达，其余值为送达失败。注：由于受运营商系统影响的原因，此状态事件不稳定，部分时间收不到此事件。2.3.8设备振铃事件void FireRing(LPCTSTR PhoneNumber)CString strNoticeText;strNoticeText.Format(有人打电话到彩信猫内的卡上，源号码为%s！,PhoneNumber);MessageBox(strNoticeText);说明：1、参数1为拨打电话的源号码。2.4状态信息查询2.4.1查询设备的信号强弱int nSignal=m_ctrlMMSOcx. GetSignalStrength();说明：信号强度值的范围是0到100，值越大表示信号越强；如果返回值小于0，表示控件尚未连接到设备。2.4.2查询设备连接状态int nModemStatus=m_ctrlMMSOcx.GetModemStatus();if(nModemStatus=1)MessageBox (连接状态);else if(nModemStatus=-1)MessageBox (断开状态);elseMessageBox (连接中);说明：此函数用于查询当前设备的连接状态，0为查找中，1为已找到，-1为未找到。2.4.3查询设备运行信息CString strRunInfo=m_ctrlMMSOcx.GetRunInfo();MessageBox (strRunInfo );说明：设备连接过程、彩信收发过程和进度、状态消息等均可以从此函数中获得。此函数可用于显示当前设备的状态和做某项操作的进度信息。2.4.4查询控件中待发送彩信数目int nWaittoSendMMSCount=m_ctrlMMSOcx. GetSendMMSTaskCount ();2.4.5查询控件中待发送短信数目int nWaittoSendSMSCount=m_ctrlMMSOcx. G