一、基本介绍

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 的最新通信架构图：

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 各种客户端完全兼容的协议模型。

五、Demo 运行截图

六、详细介绍

① MobileIMSDK - 微信小程序端的详细介绍：点此查看 👈

② MobileIMSDK - 微信小程序端的开发手册：点此查看 👈

③ MobileIMSDK 开源框架的详细介绍：https://gitee.com/jackjiang/MobileIMSDK  👈

为了更好地分类阅读52im.net 总计1000多篇精编文章，我将在每周三推送新的一期技术文集，本次是第10 期。

[-1-] 简述传输层协议TCP和UDP的区别

[链接] http://www.52im.net/thread-580-1-1.html

[摘要] 本文将从应用层的角度，简要的对比TCP和UDP协议的区别，或许能给你些许启发。

[-2-] 为什么QQ用的是UDP协议而不是TCP协议？

[链接] http://www.52im.net/thread-279-1-1.html

[摘要] QQ既有UDP也有TCP！不管UDP还是TCP，最终登陆成功之后，QQ都会有一个TCP连接来保持在线状态。这个TCP连接的远程端口一般是80，采用UDP方式登陆的时候，端口是8000。

[-3-]移动端即时通讯协议选择：UDP还是TCP？

[链接] http://www.52im.net/thread-33-1-1.html

[摘要]对于有选择困难证的人来说，基于以上因素，加上UDP和TCP协议的本质差异，这样的选择确实很纠结。本文将从作者的实践总结，给出自已的观点，如有异议还请理性回复，不为找喷，仅供参考。

[-4-]快速理解TCP和UDP的差异

[链接] http://www.52im.net/thread-1160-1-1.html

[摘要] 本文延续《网络编程懒人入门》系列文章的风格，通过快速对比分析 TCP 和 UDP 的区别，来帮助即时通讯初学者快速了解这些基础的知识点，从而在IM、消息推送等网络通信应用场景中能准确地选择合适的传输层协议。

[-5-] 快速理解为什么说UDP有时比TCP更有优势

[链接] http://www.52im.net/thread-1277-1-1.html

[摘要] 随着网络技术飞速发展，网速已不再是传输的瓶颈，UDP协议以其简单、传输快的优势，在越来越多场景下取代了TCP，如网页浏览、流媒体、实时游戏、物联网。本文作为《网络编程懒人入门》系列文章的第5篇，将为您快速梳理UDP协议在某些场景下对比TCP协议所具有的优势。

[-6-] UDP的连接性和负载均衡

[链接] http://www.52im.net/thread-1018-1-1.html

[摘要]本文将从实践出发，讨论UDP在实际应用中的连接性和负载均衡问题。

[-7-] 深入地理解UDP协议并用好它

[链接] http://www.52im.net/thread-1024-1-1.html

[摘要] 本文接系列文章的上篇《不为人知的网络编程(五)：UDP的连接性和负载均衡》，将从实践出发，讨论如何深入地理解UDP协议并在实践中用好它。

[-8-] 如何让不可靠的UDP变的可靠？

[链接] http://www.52im.net/thread-1293-1-1.html

[摘要] 涉及到实时传输我们都会先考虑 RUDP，RUDP 应用在我们APP核心传输体系的各个方面，但不同的系统场景我们设计了不同的 RUDP 方式，所以基于那些激烈的讨论和我们使用的经验，我决定扒一扒 RUDP，来给大家分享如何让UDP变的可靠的实践经验。

[-9-] 从底层入手，深度分析TCP连接耗时的秘密

[链接] http://www.52im.net/thread-3265-1-1.html

[摘要] 经过日常工作的思考之后，我更想弄明白的是，TCP的开销到底有多大，能否进行量化。一条TCP连接的建立需要耗时延迟多少，是多少毫秒，还是多少微秒？能不能有一个哪怕是粗略的量化估计？当然影响TCP耗时的因素有很多，比如网络丢包等等。我今天只分享我在工作实践中遇到的比较高发的各种情况。

[-10-]彻底搞懂TCP协议层的KeepAlive保活机制

[链接] http://www.52im.net/thread-3506-1-1.html

[摘要] 限于篇幅，该篇并没有深入探讨TCP协议本身的KeepAlive机制，所以这次借本文想把TCP协议的KeepAlive保活机制给详细的整理出来，以便大家能深入其中一窥究竟。

[-11-] 拔掉网线再插上，TCP连接还在吗？一文即懂

[链接] http://www.52im.net/thread-3846-1-1.html

[摘要] 本篇文章，我们就从系统层面深入地探讨一个有趣的TCP技术问题：拔掉网线后，再插上，原本的这条TCP连接还在吗？或者说它还“好”吗？

[-12-] 单台服务器并发TCP连接数到底可以有多少

[链接] http://www.52im.net/thread-561-1-1.html

[摘要] 到底一台服务器能够支持多少TCP并发连接呢？这就是本文要讨论的问题。

👉52im社区本周新文：《得物从0到1自研客服IM系统的技术实践之路》，欢迎阅读！👈

我是Jack Jiang，我为自已带盐！https://github.com/JackJiang2011/MobileIMSDK/

1、项目简介

MobileIMSDK是一套专为移动端开发的原创IM通信层框架：

• 1）历经8年、久经考验；
• 2）超轻量级、高度提炼，lib包50KB以内；
• 3）精心封装，一套API同时支持UDP、TCP、WebSocket三种协议（可能是全网唯一开源的）；
• 4）客户端支持iOS、Android、标准Java、H5(暂未开源)、小程序(开发中..)、Uniap(开发中..)；
• 5）服务端基于Netty，性能卓越、易于扩展 new；
• 6）可与姊妹工程 MobileIMSDK-Web 无缝互通实现网页端聊天或推送等；
• 7）可应用于跨设备、跨网络的聊天APP、企业OA、消息推送等各种场景。

2、代码托管同步更新

GitHub.com：

• 代码托管：https://github.com/JackJiang2011/MobileIMSDK
• 技术社区： 点击查看更多资料

码云gitee：

• 代码托管： http://git.oschina.net/jackjiang/MobileIMSDK
• 技术社区： 点击查看更多资料

3、设计目标

让开发者专注于应用逻辑的开发，底层复杂的即时通讯算法交由SDK开发人员，从而解偶即时通讯应用开发的复杂性。

4、框架组成

整套MobileIMSDK框架由以下6部分组成：

• 1）Android客户端SDK：用于开发Android版即时通讯客户端，支持Android 2.3及以上版本，查看API文档；
• 2）iOS客户端SDK：用于开发iOS版即时通讯客户端，支持iOS 8.0及以上版本，查看API文档；
• 3）Java客户端SDK：用于开发跨平台的PC端即时通讯客户端，支持标准Java 1.6及以上版本，查看API文档；
• 4）H5客户端SDK：暂无开源版，查看精编注释版；
• 5）小程序端SDK：持续开发中，敬请关注；
• 6）服务端SDK：用于开发即时通讯服务端，支持Java 1.7及以上版本，查看API文档；

整套MobileIMSDK框架的架构组成：

5、技术特征

• 久经考验：历经8年，从Andriod 2.3、iOS 5.0 时代持续升级至今（绝不烂尾）；
• 超轻量级：高度提炼，lib包50KB以内；
• 多种协议：可能是全网唯一开源可同时支持UDP、TCP、WebSocket三种协议的同类框架；
• 多种网络：精心优化的TCP、UDP、WebSocket协议实现，可应用于卫星网、移动网、嵌入式物联网等场景；
• 高效费比：独有的UDP协议实现，无连接特性，同等条件下可实现更高的网络负载和吞吐能力；
• 消息走向：支持即时通讯技术中消息的所有可能走向，共3种（即C2C、C2S、S2C）；
• 粘包半包：优雅解决各端的TCP经典粘包和半包问题，底层封装，应用层完全无感知；
• QoS机制：完善的消息送达保证机制（多重保障），不漏过每一条消息；
• 健壮可靠：实践表明，非常适于在高延迟、跨洲际、不同网络制式环境中稳定、可靠地运行；
• 断网恢复：拥有网络状况自动检测、断网自动治愈的能力；
• 原创算法：核心算法和实现均为原创，保证了持续改进和提升的空间；
• 多种模式：预设多种实时灵敏度模式，可根据不同场景控制即时性、流量和客户端电量消耗；
• 数据压缩：自有协议实现，未来可自主定制数据压缩，灵活控制客户端的流量、服务端网络吞吐；
• 高度封装：高度封装的API接口，保证了调用的简易性，也使得可应用于更多的应用场景；
• Web支持：可与姊妹工程 MobileIMSDK-Web 无缝互通实现网页端聊天或推送等；
• 扩展性好：服务端基于Netty，继承了Netty的优秀高可扩展性；
• 性能优异：服务端继承了Netty高性能、高吞吐特性，适用于高性能服务端场景。

MobileIMSDK 所支持的全部3种即时通讯消息走向分别是：

(1) Client to Client (C2C)：即由某客户端主动发起，接收者是另一客端；

(2) Client to Server (C2S)：即由某客户端主动发起，接收者是服务端；

(3) Server to Client (S2C)：即由服务端主动发起，接收者是某客户端。

6、性能测试

压力测试表明，MobileIMSDK用于推送场景时，理论单机负载可接近千万级。用于聊天应用时，单机负载也可达数十万。

当然，每款应用都有各自的特点和差异，请视具体场景具体评估之，测试数据仅供参考。

性能测试报告：点此查看。

7、演示程序

• 1）Android客户端 Demo：点此安装和使用；
• 2）iOS客户端 Demo：点此安装和使用；
• 3）Java客户端 Demo：点此安装和使用；
• 4）H5客户端 Demo：点此查看介绍；
• 5）服务端 Demo：点此安装和使用 new。

8、应用案例

RainbowChat是一款基于MobileIMSDK的产品级聊天APP，更多详情：点击下载体验 或 查看运行截图。

① 基于MobileIMSDK的产品级聊天APP：

▶ 详细介绍、下载体验 或 查看运行截图。

② MobileIMSDK在高网络延迟下的案例：

▶ 某款基于MobileIMSDK的商业商品，曾运营于跨洲际的复杂网络环境下，端到端通信延迟在洲际网络繁忙时可高达600ms以上（与服务端的单向延迟约为300ms左右，而通常大家访问国内主流门户的延迟约为20~50ms），某段时期的非敏感运营数据 点此查看。

9、打包下载（all in one）

• ① 最新发布版（国外地址）：Github打包下载
• ② 最新发布版（国内地址）：码云gitee打包下载（访问速度快！）

说明：最新发布版打包内容中，已包含完整的demo源码、sdk源码、api文档、编译后的分发包等。

10、典型应用场景

场景1：聊天APP

• 应用说明：可用于开发类似于微信、QQ等聊天工具。
• 消息走向：需使用C2C、C2S、S2C全部类型。

特别说明：MobileIMSDK并未定义聊天应用的应用层逻辑和协议，开发者可自行定义并实现之。

场景2：消息推送

• 应用说明：可用于需要向客户端实时推送信息的各种类型APP。
• 消息走向：仅需使用S2C 1种消息走向，属MobileIMSDK的最简单应用场景。

场景3：企业OA

• 应用说明：可用于实现企业OA的指令、公文、申请等各种消息实时推送，极大提升用户体验，并可延伸至移动设备。
• 消息走向：仅需使用S2C 1种消息走向，属MobileIMSDK的最简单应用场景。

场景4：企业OA的增强型

• 应用说明：可用于实现企业OA中各种系统级、用户级消息的实时互动，充分利用即时通讯技术提升传统OA的价值。
• 消息走向：可使用C2C、C2S、S2C全部类型，这与聊天APP在很多方面已无差别，但企业OA有自已的用户关系管理模型和逻辑，较之全功能聊天APP要简单的多。

11、开发指南

• 1）Android客户端开发指南：点此查看；
• 2）iOS客户端开发指南：点此查看；
• 3）Java客户端开发指南：点此查看；
• 4）H5客户端开发指南：点此查看；
• 5）Server端开发指南：点此查看。

12、关注作者

博客地址：点击入进、Github主页：点击进入

附录1：Demo截图

1）Android和iOS运行效果

>> 安装和使用：进入Android版Demo帮助页、进入iOS版Demo帮助页。

2）Windows 运行效果

>> 安装和使用：进入Java版Demo帮助页。

3）Mac OS X 运行效果

>> 安装和使用：进入Java版Demo帮助页。

>> 关于RainbowChat的更多资料请见：RainbowChat前端APP功能截图网页 。

附录3：基于MobileIMSDK-Web的网页端IM系统【案例】

下图为RainbowChat-Web的主界面（更多截图点此进入、更多演示视频点此进入）：

关于MobileIMSDK

MobileIMSDK 是一套专门为移动端开发的开源IM即时通讯框架，超轻量级、高度提炼，一套API优雅支持UDP 、TCP 、WebSocket 三种协议，支持iOS、Android、H5、标准Java平台，服务端基于Netty编写。

工程开源地址是：

• 1）Gitee码云地址：https://gitee.com/jackjiang/MobileIMSDK
• 2）Github托管地址：https://github.com/JackJiang2011/MobileIMSDK

关于RainbowChat

► 详细产品介绍：http://www.52im.net/thread-19-1-1.html
► iOS端更新记录：http://www.52im.net/thread-2735-1-1.html
► 全部运行截图：iOS端全部运行截图 （另：Android端运行截图 点此查看）
► 在线体验下载：App Store安装地址 （另：Android端下载体验 点此查看）

RainbowChat是一套基于开源IM聊天框架 MobileIMSDK 的产品级移动端IM系统。RainbowChat源于真实运营的产品，解决了大量的屏幕适配、细节优化、机器兼容问题（可自行下载体验：专业版下载安装）。

* RainbowChat可能是市面上提供im即时通讯聊天源码的，唯一一款同时支持TCP、UDP两种通信协议的IM产品（通信层基于开源IM聊天框架 MobileIMSDK 实现）。

v6.2 版更新内容

此版更新内容（更多历史更新日志）：

• 1）[优化] 升级核心通信层库 MobileIMSDK 至 v6.3；
• 2）[优化] 提供了方便的配置用于开/关长连接的SSL/TLS加密传输。

此版主要功能运行截图（更多截图点此查看）：