一、基本介绍

MobileIMSDK是一套全平台原创开源IM通信层框架:
- 超轻量级、高度提炼,lib包50KB以内;
- 精心封装,一套API同时支持UDP、TCP、WebSocket三种协议(可能是全网唯一开源的);
- 客户端支持iOS、Android、标准Java、H5、微信小程序、Uniap、鸿蒙Next(Demo完整源码);
- 服务端基于Netty,性能卓越、易于扩展 new;
- 可与姊妹工程 MobileIMSDK-Web 无缝互通实现网页端聊天或推送等;
- 可应用于跨设备、跨网络的聊天APP、企业OA、消息推送等各种场景。
二、源码仓库同步更新
- 代码托管: https://github.com/JackJiang2011/MobileIMSDK
- 技术社区: 点击查看更多资料
码云gitee:
- 代码托管: http://git.oschina.net/jackjiang/MobileIMSDK
- 技术社区: 点击查看更多资料
三、设计目标
让开发者专注于应用逻辑的开发,底层复杂的即时通讯算法交由SDK开发人员,从而解偶即时通讯应用开发的复杂性。
四、框架组成
整套MobileIMSDK框架由以下7部分组成:
- Android客户端SDK: 用于开发Android版即时通讯客户端,支持Android 4.0及以上版本,查看API文档;
- iOS客户端SDK: 用于开发iOS版即时通讯客户端,支持iOS 12.0及以上版本,查看API文档;
- Java客户端SDK: 用于开发跨平台的PC端即时通讯客户端,支持标准Java 1.6及以上版本,查看API文档;
- H5客户端SDK: 查看精编注释版;
- 微信小程序端SDK: 查看精编注释版;
- Uniapp端SDK: 查看精编注释版;
- 鸿蒙Next端SDK: SDK暂无开源版(查看精编注释版),Demo完整工程源码;
- 服务端SDK: 用于开发即时通讯服务端,支持Java 1.7及以上版本,查看API文档;
整套MobileIMSDK框架的架构组成:

MobileIMSDK一直在持续开发和升级中,鸿蒙Next客户端是MobileIMSDK工程的最新成果。
五、技术特征
- **久经考验:**历经10年,从Andriod 2.3、iOS 5.0 时代持续升级至今(绝不烂尾);
- **超轻量级:**高度提炼,lib包50KB以内;
- **多种协议:**可能是全网唯一开源可同时支持UDP、TCP、WebSocket三种协议的同类框架;
- **多种网络:**精心优化的TCP、UDP、WebSocket协议实现,可应用于卫星网、移动网、嵌入式物联网等场景;
- 多端覆盖: 客户端支持iOS、Android、标准Java、H5、微信小程序、Uniapp、鸿蒙Next;
- **高效费比:**独有的UDP协议实现,无连接特性,同等条件下可实现更高的网络负载和吞吐能力;
- **消息走向:**支持即时通讯技术中消息的所有可能走向,共3种(即C2C、C2S、S2C);
- **粘包半包:**优雅解决各端的TCP经典粘包和半包问题,底层封装,应用层完全无感知;
- **QoS机制:**完善的消息送达保证机制(自动重传、消息去重、状态反馈等),不漏过每一条消息;
- **健壮可靠:**实践表明,非常适于在高延迟、跨洲际、不同网络制式环境中稳定、可靠地运行;
- **断网恢复:**拥有网络状况自动检测、断网自动治愈的能力;
- **原创算法:**核心算法和实现均为原创,保证了持续改进和提升的空间;
- **多种模式:**预设多种实时灵敏度模式,可根据不同场景控制即时性、流量和客户端电量消耗;
- **数据压缩:**自有协议实现,未来可自主定制数据压缩,灵活控制客户端的流量、服务端网络吞吐;
- **高度封装:**高度封装的API接口,保证了调用的简易性,也使得可应用于更多的应用场景;
- Web支持: 可与姊妹工程 MobileIMSDK-Web 无缝互通实现网页端聊天或推送等;
- **扩展性好:**服务端基于Netty,继承了Netty的优秀高可扩展性;
- **性能优异:**服务端继承了Netty高性能、高吞吐特性,适用于高性能服务端场景。
六、演示程序
- Android客户端 Demo: 点此安装和使用;
- iOS客户端 Demo: 点此安装和使用;
- Java客户端 Demo: 点此安装和使用;
- H5客户端 Demo: 点此查看介绍;
- 微信小程序端 Demo: 点此查看介绍;
- Uniapp端 Demo: 点此查看介绍;
- 鸿蒙Next端 Demo: 点此查看介绍 new;
- 服务端 Demo: 点此安装和使用。
七、应用案例
RainbowChat是一款基于MobileIMSDK的产品级聊天APP,更多详情:点击下载体验 或 查看运行截图。
① 基于MobileIMSDK的产品级聊天APP:
② MobileIMSDK在高网络延迟下的案例:
▶ 某款基于MobileIMSDK的商业商品,曾运营于跨洲际的复杂网络环境下,端到端通信延迟在洲际网络繁忙时可高达600ms以上(与服务端的单向延迟约为300ms左右,而通常大家访问国内主流门户的延迟约为20~50ms),某段时期的非敏感运营数据 点此查看。
八、打包下载(all in one)
- ① 最新发布版(国外地址):Github打包下载
- ② 最新发布版(国内地址):码云gitee打包下载(访问速度快!)
**说明:**最新发布版打包内容中,已包含完整的demo源码、sdk源码、api文档、编译后的分发包等。
九、典型应用场景
场景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要简单的多。
十、开发指南
- Android客户端开发指南: 点此查看;
- iOS客户端开发指南: 点此查看;
- Java客户端开发指南: 点此查看;
- H5客户端开发指南: 点此查看;
- 微信小程序端开发指南: 点此查看;
- Uniapp端开发指南: 点此查看;
- 鸿蒙Next端开发指南: 点此查看;
- Server端开发指南: 点此查看。
附录1:Demo截图
1、在鸿蒙Next端运行效果:
>> 编译和运行:查看鸿蒙Next端Demo完整源码。

2、Android端、iOS端运行效果
>> 安装和使用:进入Android版Demo帮助页、进入iOS版Demo帮助页。


3、H5端运行效果

4、微信小程序端运行效果

5、Uniapp端运行效果

6、Windows 运行效果
>> 安装和使用:进入Java版Demo帮助页。

7、Mac OS X 运行效果
>> 安装和使用:进入Java版Demo帮助页。

8、MobileIMSDK-Web版客户端Demo运行效果:
8.1)MobileIMSDK-Web在手机端浏览器运行效果:(如何获取MobileIMSDK-Web版:点此进入)

8.2)MobileIMSDK-Web在PC端浏览器运行效果:(如何获取MobileIMSDK-Web版:点此进入)

附录2:基于MobileIMSDK的全功能IM【案例】
>>关于RainbowChat的更多资料请见: RainbowChat前端APP功能截图网页 (* 推荐 - 真机实拍视频:Andriod端、iOS端)。




附录3:基于MobileIMSDK-Web的网页端IM系统【案例】
下图为RainbowChat-Web的主界面 (更多截图点此进入、更多演示视频点此进入):

下图为RainbowChat-Web的主界面[聊天窗全屏时] (更多截图点此进入、更多演示视频点此进入):

下图为RainbowChat-Web的主界面[独立UI效果] (更多截图点此进入、更多演示视频点此进入):
