百靈佳科技LOGO
加入收藏 | 設為首頁 | English   
ALIBABA MADE IN CHINA ALIBABA
深圳市百靈佳科技有限公司
地址:深圳市福田區上步南路國企大廈永富樓15A
電話:0755-25911778
傳真:0755-25911778-806
郵箱:[email protected]
您現在的位置: 深圳市百靈佳科技有限公司 > 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的電話號碼。
 
 
 *  主  題:
 *  聯系人:
 *  公司名:
 *  電  話:
  傳  真:
 *  郵  箱:
 地  址:
*您的需求:
    
  
公司簡介
企業文化
加入我們
  
行業新聞
公司新聞
  
最新產品
模塊系列
  
資質榮譽
合作加盟
  
公司地圖
聯系方式
江苏时时彩骗局