以下的敘述著重說明MDP插件的使用方法、流程和注意事項(xiàng),適用于所有使用企信通P插件進(jìn)行開發(fā)的技術(shù)人員,不涉及開發(fā)環(huán)境。
使用流程概述 :
使用流程詳解:
1、創(chuàng)建接口句柄
目的:創(chuàng)建一個(gè)接口對象,成功后返回該對象句柄,以后的操作函數(shù)都需要一個(gè)參數(shù)指定需要操作的對象的句柄.
方法:調(diào)用SkOpen 或者SkProxyOpen
注意:
- 每個(gè)句柄可以形成一個(gè)與服務(wù)器的連接,與服務(wù)器的交互(如發(fā)送短信、接收短信等) 都要基于幾個(gè)連接.每個(gè)連接內(nèi)部是阻塞的,即完成一個(gè)操作后才能繼續(xù)下一個(gè)命令.如果您開發(fā)的應(yīng)用程序中使用多個(gè)線程可能需要注意,因?yàn)槎鄠€(gè)線程最終使用一個(gè)連接與服務(wù)器交互顯然并不可行. 可以嘗試創(chuàng)建多個(gè)連接解決這個(gè)問題.
- SkOpen 用于非代理方式連接到企信通服務(wù)器. SkProxyOpen 用于代理方式連接到企信通服務(wù)器.
目的:驗(yàn)證身份.與服務(wù)器建立連接后,需要向服務(wù)器提交帶有賬號(hào)和密碼的信息申請服務(wù)器的驗(yàn)證,只有通過驗(yàn)證后才可以有效的進(jìn)行以發(fā)送短信等操作.
方法:調(diào)用SkLogin
注意:
- 一次驗(yàn)證后此連接將保持登錄狀態(tài),隨后的發(fā)送短信等命令不需要提供身份驗(yàn)證,直至到退出登錄
- 重新連接后需要重新登錄
- 目的:在通過驗(yàn)證后就可以進(jìn)行功能性的操作比如發(fā)送、接收等。
- 方法:調(diào)用具體的功能函數(shù)
- 目的:驗(yàn)證身份.與服務(wù)器建立連接后,需要向服務(wù)器提交帶有賬號(hào)和密碼的信息申請服務(wù)器的驗(yàn)證,只有通過驗(yàn)證后才可以有效的進(jìn)行發(fā)送短信等操作.
- 方法:調(diào)用SkLogout、然后SkClose
- 保持連接。根據(jù)現(xiàn)在企信通服務(wù)器的規(guī)則,為了節(jié)約網(wǎng)絡(luò)資源,企信通服務(wù)器會(huì)主動(dòng)斷開長時(shí)間與服務(wù)器沒有命令的客戶端連接。所以客戶端有被服務(wù)器主動(dòng)斷開連接的可能.客戶端需要定期的使用保持連接命令或者發(fā)現(xiàn)與服務(wù)器斷開后能夠重新連接、登錄到服務(wù)器并完成當(dāng)前的操作。
- 各個(gè)操作接口的詳細(xì)使用情況請參考詳細(xì)的幫助文件或者示例程序。部分接口可能存在需要特別注意的問題。
- 示例程序只是我們?yōu)殚_發(fā)者提供的示例。示例在界面、使用流程等方面可能存在不足,內(nèi)部代碼也可能存在潛在問題。