一、根本介绍
MobileIMSDK – 微信小程序端是一套基于微信原生 WebSocket 的即时通讯库:
1)超轻量级、无任何第 3 方库依赖(开箱即用);
2)纯 JS 编写、ES6 语法、高度提炼,简略易用;
3)基于微信原生 WebSocket API,简洁优雅;
4)反对运行于任何反对微信小程序的手机端;
5)能与 MobileIMSDK 的各种客户端完满互通;
6)可利用于微信小程序中的音讯推送、客服聊天、企业 OA、IM 等场景。
二、与 MobileIMSDK 的关系
MobileIMSDK – 微信小程序端是基于微信原生 WebSocket 协定的 MobileIMSDK 配套客户端库。
MobileIMSDK 是一套专为挪动端开发的开源原创 IM 通信层框架:
历经 8 年、久经考验;超轻量级、高度提炼,lib 包 50KB 以内;
精心封装,一套 API 同时反对 UDP、TCP、WebSocket 三种协定(可能是全网惟一开源的);
客户端反对 iOS、Android、规范 Java、H5、小程序、Uniapp(开发中..);
服务端基于 Netty,性能卓越、易于扩大;
👈可与姊妹工程 MobileIMSDK-Web 无缝互通实现网页端聊天或推送等;
👈可利用于跨设施、跨网络的聊天 APP、企业 OA、音讯推送等各种场景。
以下是 MobileIMSDK 的最新通信架构图:
PS:MobileIMSDK 的客户端库始终在继续开发和降级中,目前 基于 Uniapp 的 MobileIMSDK 客户端正在开发中。
三、设计指标
间接应用原生的微信小程序 WebSocket 有以下问题和劣势:
1)性能无限:没有心跳保活、断线重连、音讯送达保障(重传和去重)等即时通讯要害算法和逻辑;
2)API 简陋:在如此无限的原生 API 下,能逻辑清晰地实现并组合心跳保活、断线重连、音讯送达保障等算法,须要相当高的技术掌控力;
3)逻辑耦合:教训欠缺的开发人员,会将 WebSocket 通信与前端 UI 界面代码混在一起,使得 UI 界面的重构、保护、改版都十分艰难。
针对以上问题,而 MobileIMSDK – 微信小程序端库将让开发者专一于 UI 应用层的开发,网络通信层的业余代码交由 SDK 开发人员,从而解偶 UI 前端和通信层的逻辑耦合性,大大降低技术复杂性。
MobileIMSDK – 微信小程序端库的设计指标是为您的开发带来以下便当:
1)界面与通信解偶:UI 界面与网络通信代码解耦,UI 界面的重构、保护、改版都非常容易和优雅;
2)轻量级和兼容性:受害于保持原生微信小程序 WebSocket API,简洁轻量,无需任何额定依赖;
3)外围内聚和收敛:得益于长期的提炼和教训积攒,SDK 核心层高度封装,开发者无需了解简单算法即可简略上手。
4)纯 JS 轻量级实现:SDK 为纯 JS 编写、ES6 语法,无重量级框架和库依赖,可干净利落地对接各种既有零碎。
四、技术亮点
轻量易使用:超轻量级 —— 纯 JS 编写且无任何第 3 方库依赖,高度提炼 —— 简略易用;
代码现代感:尽可能优先应用 ES6 语法,摒弃新式 JS 语法的年代感;
兼容性很好:基于微信原生 WebSocket API,可很好地运行于反对微信小程序的手机端;
断网恢复能力:领有网络情况自动检测、断网主动治愈的能力;
送达保障机制:欠缺的 QoS 音讯送达保障机制(多重保障),不漏过每一条音讯;
通信协议封装:实现了一个对下层通明的即时通讯通信协议模型;
身份认证机制:实现了简略正当的身份认证机制;
欠缺的 log 信息:在开发调试阶段,确保每一个算法关键步骤都有日志输入,让您的运行调试更为便当;
界面代码解耦:实现了 UI 界面代码与 SDK 网络通信代码解偶,避免界面代码跟 IM 外围代码混在一起,不利于继续降级、重用和保护;
聊天协定兼容:实现了与 MobileIMSDK 各种客户端齐全兼容的协定模型。
五、文件组成
SDK 代码文件概览:
SDK 代码文件用处阐明:
六、技术交换
学习和材料:点击进入、bug 和倡议:点击进入
七、Demo 运行截图
1)Demo 的真机运行成果和性能阐明图:
2)Demo 在模拟器下的运行成果:
3)Demo 真机运行实拍图:
八、详尽开发者手册
① 开发者手册(网页版):MobileIMSDK 的微信小程序端开发疾速入门 ◀
② 开发者手册(PDF 精编版):
九、援用材料
[1] 微信小程序开发者手册
[2] MobileIMSDK 开源框架的 API 文档
[3] MobileIMSDK 开源 IM 框架源码(Github 地址点此)
[4] 开源轻量级 IM 框架 MobileIMSDK 的微信小程序端已公布
[5] 开源即时通讯框架 MobileIMSDK 的微信小程序端开发者手册