一、基本介绍
MobileIMSDK的H5端是一套纯JS编写的基于标准WebSocket的即时通讯库:- 1)超轻量级、极少依赖;
- 2)纯JS编写、高度提炼,简单易用;
- 3)基于标准WebSocket协议,客户端兼容性好;
- 4)支持运行于iOS、Android等移动端浏览器和各种PC端浏览器;
- 5)能与 MobileIMSDK(Github托管链接)的各种APP原生代码客户端完美互通;
- 6)可应用于手机端/PC端的网页聊天应用、企业OA、Web端等即时通讯场景。
二、与MobileIMSDK的关系
MobileIMSDK-H5端 是基于标准HTML5的WebSocket协议的 MobileIMSDK配套客户端库。
以下是MobileIMSDK的通信架构图:
MobileIMSDK是一套专为移动端开发的原创开源IM通信层框架:
- 1)历经8年、久经考验;
- 2)超轻量级、高度提炼,lib包50KB以内;
- 3)精心封装,一套API同时支持UDP、TCP、WebSocket三种协议(可能是全网唯一开源的);
- 4)客户端支持iOS、Android、标准Java、H5(暂未开源)、微信小程序(暂未开源)、Uniapp(暂未开源);
- 5)服务端基于Netty,性能卓越、易于扩展;
- 6)可与姊妹工程 MobileIMSDK-Web 无缝互通实现网页端聊天或推送等;
- 7)可应用于跨设备、跨网络的聊天APP、企业OA、消息推送等各种场景。
PS: MobileIMSDK一直在持续开发和升级中,新Uniapp端是MobileIMSDK工程的最新成果。
三、与MobileIMSDK-Web的关系
MobileIMSDK-Web也是一套纯JS编写的Web端即时通讯框架(含服务端)。MobileIMSDK-Web框架与MobileIMSDK-H5端的相同点:
- 1)都是Web端即时通讯框架;
- 2)都是纯JS编写;
- 3)都可以运行在手机、pc端的浏览器或web容器内。
- 1)MobileIMSDK-Web可以兼容不支持HTML5的旧版浏览器或容器,而MobileIMSDK-H5端必须运行在当前主流的HTML5浏览器或容器;
- 2)MobileIMSDK-Web需依赖于socket.io这种第3方通信层库,而MobileIMSDK-H5端无任何额外依赖。
- 选择一:如果您的应用必须兼容旧版浏览器(包括旧版IE等):
那唯一的选择就是MobileIMSDK-Web,因为它存在的主要价值就是为了兼容旧版浏览器; - 选择二:如果您的应用只需运行在现今主流的HTML5浏览器或容器:
那么建议您优先使用MobileIMSDK的H5端,必竟直接调用标准HTML5的WebSocket API,要简洁、轻量多了,也没有第3方依赖。
四、设计目标
直接使用原生的WebSocket有以下问题和劣势:- 1)功能有限:没有提供心跳保活、断线重连、送达保证(重传和去重)等即时通讯关键算法和逻辑;
- 2)API 简陋:在如此有限的标准API下,能逻辑清晰和健壮地实现并组合心跳保活、断线重连、送达保证等算法,需要相当高的技术掌控力;
- 3)逻辑耦合:经验欠缺的开发人员,会将WebSocket通信代码与前端UI界面代码混在一起,使得UI界面的编写、维护、改版都非常困难。
总结一下,MobileIMSDK-H5端库的设计目标是为您的Web端IM带来以下便利:
- 1)前端与通信解偶:前端UI与网络通信代码解耦,UI界面的重构、维护、改版都非常容易和优雅;
- 2)轻量级和兼容性:受益于标准WebSocket,可很好地运行于现今主流的H5浏览器上,且无需额外依赖;
- 3)核心内聚和收敛:得益于长期的提炼和经验积累,SDK核心层高度封装,开发者无需理解复杂算法即可简单上手。
- 4)纯JS轻量级实现:纯JS编写,无Angular、EmberJS、VUE等各种重量级前端框架依赖,方便对接各种既有系统;
五、技术亮点
- 1)轻量易使用:超轻量级——纯JS编写且极少依赖,高度提炼——简单易用;
- 2)兼容性很好:基于标准WebSocket,可很好地运行于现今主流的H5浏览器上,且无需额外依赖;
- 3)断网恢复能力:拥有网络状况自动检测、断网自动治愈的能力;
- 4)送达保证机制:完善的QoS消息送达保证机制(自动重传、消息去重、状态反馈等),不漏过每一条消息;
- 5)支持多种设备:支持运行于iOS、Android等移动端浏览器和各种PC端浏览器;
- 6)通信协议封装:实现了一个对上层透明的即时通讯通信协议模型;
- 7)身份认证机制:实现了简单合理的身份认证机制;
- 8)完善的log信息:在开发调试阶段,确保每一个算法关键步骤都有日志输出,让您的运行调试更为便利;
- 9)前端代码解耦:实现了UI前端代码与sdk网络通信代码解偶,防止前端代码跟IM核心代码混在一起,不利于持续升级、重用和维护;
- 10)多端协议兼容:实现了与MobileIMSDK各APP端完全兼容的协议模型;
六、文件组成
SDK代码文件概览:
SDK代码文件用途说明:
七、Demo功能预览和说明
八、Demo运行效果实拍图
1)Demo在手机端浏览器中的真机实拍图:
2)Demo在电脑端浏览器中的真机实拍图:
八、更多Demo运行效果截图
1)Demo在PC端浏览器运行效果:2)Demo在手机端浏览器运行效果(点击可看大图 ▼):
3)Demo在PC端主流浏览器的运行效果(点击可看大图 ▼):