一、基本介紹

MobileIMSDK-Uniapp端是一套基于Uniapp跨端框架的即時(shí)通訊庫：

• 1）超輕量級(jí)、無任何第3方庫依賴（開箱即用）；
• 2）純JS編寫、ES6語法、高度提煉，簡(jiǎn)單易用；
• 3）基于Uniapp標(biāo)準(zhǔn)WebSocket API，簡(jiǎn)潔優(yōu)雅；
• 4）理論上可運(yùn)行于任何支持Uniapp跨端框架的平臺(tái)上；
• 5）能與 MobileIMSDK（Github托管鏈接） 的各種客戶端完美互通；
• 6）可應(yīng)用于基于Uniapp的跨平臺(tái)App或Web的消息推送、客服聊天、企業(yè)OA、IM等場(chǎng)景。

詳細(xì)開發(fā)資料：

• ① MobileIMSDK-Uniapp端詳細(xì)介紹 ??
• ② MobileIMSDK-Uniapp端開發(fā)手冊(cè) ??
• ③ MobileIMSDK-開源框架的詳細(xì)資料 （Github托管鏈接）??

二、與MobileIMSDK的關(guān)系

MobileIMSDK-Uniapp端 是基于Uniapp標(biāo)準(zhǔn) WebSocket API的 MobileIMSDK配套客戶端庫。

以下是MobileIMSDK的最新通信架構(gòu)圖：

MobileIMSDK是一套專為移動(dòng)端開發(fā)的原創(chuàng)開源IM通信層框架：

• 1）歷經(jīng)8年、久經(jīng)考驗(yàn)；
• 2）超輕量級(jí)、高度提煉，lib包50KB以內(nèi)；
• 3）精心封裝，一套API同時(shí)支持UDP、TCP、WebSocket三種協(xié)議（可能是全網(wǎng)唯一開源的）；
• 4）客戶端支持iOS、Android、標(biāo)準(zhǔn)Java、H5(暫未開源)、微信小程序(暫未開源)、Uniapp(暫未開源)；
• 5）服務(wù)端基于Netty，性能卓越、易于擴(kuò)展；
• 6）可與姊妹工程 MobileIMSDK-Web 無縫互通實(shí)現(xiàn)網(wǎng)頁端聊天或推送等；
• 7）可應(yīng)用于跨設(shè)備、跨網(wǎng)絡(luò)的聊天APP、企業(yè)OA、消息推送等各種場(chǎng)景。

PS： MobileIMSDK一直在持續(xù)開發(fā)和升級(jí)中，本Uniapp客戶端是MobileIMSDK工程的最新成果。

三、設(shè)計(jì)目標(biāo)

直接使用Uniapp的WebSocket API開擼，有以下問題和劣勢(shì)：

• 1）功能有限： 沒有心跳?；?、斷線重連、消息送達(dá)保證（重傳和去重）等即時(shí)通訊關(guān)鍵算法和邏輯；
• 2）API簡(jiǎn)陋： 在如此有限的API接口下，能邏輯清晰且健壯地實(shí)現(xiàn)并組合心跳保活、斷線重連、消息送達(dá)保證等算法，需要相當(dāng)高的技術(shù)掌控力；
• 3）邏輯耦合： 經(jīng)驗(yàn)欠缺的開發(fā)人員，會(huì)將WebSocket通信與前端UI界面代碼混在一起，使得UI界面的編寫、維護(hù)、改版都非常困難。

針對(duì)以上問題： MobileIMSDK-Uniapp端庫將讓開發(fā)者專注于UI應(yīng)用層的開發(fā)，網(wǎng)絡(luò)通信層的專業(yè)代碼交由SDK開發(fā)人員，從而解偶UI前端和通信層的邏輯耦合性，大大降低技術(shù)復(fù)雜度和應(yīng)用門檻。

MobileIMSDK-Uniapp端庫的設(shè)計(jì)目標(biāo)是為您的開發(fā)帶來以下便利：

• 1）界面與通信解偶： UI界面與網(wǎng)絡(luò)通信代碼解耦，UI界面的重構(gòu)、維護(hù)、改版都非常容易和優(yōu)雅；
• 2）輕量級(jí)和兼容性： 受益于堅(jiān)持使用Uniapp的標(biāo)準(zhǔn)WebSocket API，簡(jiǎn)潔輕量，無需任何額外庫依賴；
• 3）核心內(nèi)聚和收斂： 得益于長(zhǎng)期的提煉和經(jīng)驗(yàn)積累，SDK核心層高度封裝，開發(fā)者無需理解復(fù)雜算法即可簡(jiǎn)單上手。
• 4）純JS輕量級(jí)實(shí)現(xiàn)： 純JS編寫、ES6語法，無重量級(jí)框架和庫依賴（更無Native代碼），可干凈利落地對(duì)接各種既有系統(tǒng)；
• 5）跨平臺(tái)運(yùn)行能力： 受益于Uniapp框架的跨端特性，理論上本SDK可運(yùn)行于任何支持Uniapp的平臺(tái)上。

四、技術(shù)亮點(diǎn)

• 1）輕量易使用： 超輕量級(jí)——純JS編寫且無任何第3方庫依賴，高度提煉——簡(jiǎn)單易用；
• 2）代碼現(xiàn)代感： 盡可能優(yōu)先使用ES6語法，摒棄舊式JS語法的年代感；
• 3）跨端支持好： 基于Uniapp的標(biāo)準(zhǔn)WebSocket API（無Native代碼依賴），理論上可很好地運(yùn)行于任何支持Uniapp的平臺(tái)上；
• 4）斷網(wǎng)恢復(fù)能力： 擁有網(wǎng)絡(luò)狀況自動(dòng)檢測(cè)、斷網(wǎng)自動(dòng)治愈的能力；
• 5）送達(dá)保證機(jī)制： 完善的QoS消息送達(dá)保證機(jī)制（自動(dòng)重傳、消息去重、狀態(tài)反饋等），不漏過每一條消息；
• 6）通信協(xié)議封裝： 實(shí)現(xiàn)了一個(gè)對(duì)上層透明的即時(shí)通訊通信協(xié)議模型；
• 7）身份認(rèn)證機(jī)制： 實(shí)現(xiàn)了簡(jiǎn)單合理的身份認(rèn)證機(jī)制；
• 8）完善的log信息： 在開發(fā)調(diào)試階段，確保每一個(gè)算法關(guān)鍵步驟都有日志輸出，讓您的運(yùn)行調(diào)試更為便利；
• 9）界面代碼解耦： 實(shí)現(xiàn)了UI界面代碼與SDK網(wǎng)絡(luò)通信代碼解偶，防止界面代碼跟IM核心代碼混在一起，不利于持續(xù)升級(jí)、重用和維護(hù)；
• 10）多端協(xié)議兼容： 實(shí)現(xiàn)了與MobileIMSDK各種客戶端完全兼容的協(xié)議模型。

五、文件組成

SDK代碼文件概覽：

SDK代碼文件用途說明：

六、Demo運(yùn)行效果和說明

七、跨平臺(tái)運(yùn)行效果演示

1）Demo在內(nèi)置瀏覽器中的運(yùn)行效果：

2）Demo在電腦瀏覽器中的運(yùn)行效果（以Chrome為例）：

3）Demo在Android真機(jī)上的運(yùn)行效果：

4）Demo在iOS模擬器上的運(yùn)行效果：

5）Demo在iOS真機(jī)上的運(yùn)行效果：

6）Demo在微信小程序上的運(yùn)行效果：

7）Demo在支付寶小程序上的運(yùn)行效果：

（其它更多平臺(tái)的運(yùn)行效果就不一一列舉了，因?yàn)槎家惭b各自的開發(fā)工具，硬盤空間吃緊 。。。）

八、詳細(xì)資料

① MobileIMSDK-Uniapp端的詳細(xì)介紹：點(diǎn)此查看 ??
② MobileIMSDK-Uniapp端的開發(fā)手冊(cè)（網(wǎng)頁版）：點(diǎn)此查看 ??
③ MobileIMSDK-Uniapp端的開發(fā)手冊(cè)（精編PDF版）：點(diǎn)此查看 ?? （* 推薦）
④ MobileIMSDK-開源框架的詳細(xì)介紹：https://gitee.com/jackjiang/MobileIMSDK （Github托管鏈接）??