开源即时通讯IM框架MobileIMSDK的微信小程序端技术概览

一、基本介绍

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的微信小程序端开发者手册