即时通讯框架MobileIMSDK的鸿蒙NEXT端详细介绍

一、基本介绍

MobileIMSDK-鸿蒙端是一套基于鸿蒙Next（纯血鸿蒙）系统的IM即时通讯客户端库：

• 1）超轻量级（编译后库文件仅50KB）、无任何第3方库依赖（开箱即用）；
• 2）纯ArkTS编写、无Native代码、高度提炼、简单易用；
• 3）基于鸿蒙Next标准WebSocket  API，简洁优雅；
• 4）可运行于任何支持鸿蒙Next的平台；
• 5）能与 MobileIMSDK的各种客户端完美互通；
• 6）可应用于鸿蒙Next中的消息推送、客服聊天、企业OA、IM等场景。
  

二、与MobileIMSDK的关系

MobileIMSDK-鸿蒙端是基于鸿蒙Next标准WebSocket  API的 MobileIMSDK配套客户端库。

以下是MobileIMSDK的最新通信架构图：


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

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

PS：MobileIMSDK一直在持续开发和升级中，本鸿蒙客户端是MobileIMSDK工程的最新成果。

三、支持作者

付费捐助的存在，是作者目前为数不多的物质支撑，如果您希望 MobileIMSDK 系列能够持续发展下去，并使得您的项目能够得到它持久的回馈，您的任何一笔捐助都意义非凡。Jack Jiang依托即时通讯网长期提供即时通讯技术的分享和传播，这里的技术资源和技术支持毫无疑问是您能找到的最低成本且是最优质的，您的支持是我们继续下去的动力！

MobileIMSDK-鸿蒙端SDK工程目前没有开源版（Demo工程源码点此查看），但您可通过捐助作者的方式获取精编注释版，非常抱歉给您带来不便。

捐助作者得 MobileIMSDK的鸿蒙端精篇源码和资料：

资源名称	包含内容	捐助金额	捐助方式	发货方式	专享技术支持
<精篇源码>	• 1、SDK精编注释源码 • 2、简明Demo源码	599 元	淘宝链接	付款后发货	1、VIP技术群 2、论坛讨论区 3、一对一交流、永久免费升级
<手册教程>	• 3、详尽开发者指南（共21页）

https://item.taobao.com/item.htm?id=864963120396

四、源码和手册获取

MobileIMSDK-鸿蒙端SDK工程目前没有开源版（Demo工程源码点此查看），您可通过捐助作者的方式获取精编注释版（同时您也将立即获得作者的专享技术支持），详见文首“支持作者”部分，感谢您的理解与支持。

或者直接点击链接：SDK精编注释源码 + 简明Demo源码 + 详尽开发者手册（共21页）（付款后将发货到您的关联邮箱）。

五、设计目标

直接使用鸿蒙Next的WebSocket API开撸，有以下问题和劣势：

• 1）功能有限：没有心跳保活、断线重连、消息送达保证（重传和去重）等即时通讯关键算法和逻辑；
• 2）API 简陋：在如此有限的API接口下，能逻辑清晰且健壮地实现并组合心跳保活、断线重连、消息送达保证等算法，需要相当高的技术掌控力；
• 3）逻辑耦合：经验欠缺的开发人员，会将WebSocket通信逻辑与前端ArkUI界面代码混在一起，使得UI界面的编写、维护、改版都非常困难。
  

针对以上问题，而MobileIMSDK-鸿蒙端库将让开发者专注于UI应用层的开发，网络通信层的专业代码交由SDK开发人员，从而解偶UI前端和通信层的逻辑耦合性，大大降低技术复杂度和应用门槛。

MobileIMSDK-鸿蒙端库的设计目标是为您的开发带来以下便利：

• 1）界面与通信解偶：UI界面与网络通信层代码解耦，UI界面的重构、维护、改版都非常容易和优雅；
• 2）轻量级和兼容性：受益于坚持使用鸿蒙Next的标准WebSocket API，简洁轻量，无需任何额外库依赖；
• 3）核心内聚和收敛：得益于长期的提炼和经验积累，SDK核心层高度封装，开发者无需理解复杂算法即可简单上手。
• 4）纯 ArkTS 实现：纯ArkTS编写，无重量级框架和库依赖（更无Native代码），可干净利落地对接各种既有系统；
• 5）跨平台运行能力：受益于鸿蒙系统的跨端特性，理论上本SDK可运行于任何支持鸿蒙Next的平台上。
  

六、技术亮点

• 1）超级轻量纯净：超轻量级——纯ArkTS编写且无任何第3方库依赖，编译后库文件仅50KB；
• 2）高内聚易使用：高度提炼——简单易用，所有核心类皆设计为单例——到手即用、高度容错；
• 3）跨端支持好：基于鸿蒙Next的标准WebSocket API（无Native代码依赖），理论上可很好地运行于任何支持最新鸿蒙的平台上；
• 4）断网恢复能力：拥有网络状况自动检测、断网自动治愈的能力；
• 5）送达保证机制：完善的QoS消息送达保证机制（自动重传、消息去重、状态反馈等），不漏过每一条消息；
• 6）通信协议封装：实现了一个对上层透明的即时通讯通信协议模型；
• 7）身份认证机制：实现了简单合理的身份认证机制；
• 8）完善的log信息：在开发调试阶段，确保每一个算法关键步骤都有日志输出，让您的运行调试更为便利；
• 9）界面代码解耦：实现了UI界面代码与SDK网络通信代码解偶，防止界面代码跟IM核心代码混在一起，不利于持续升级、重用和维护；
• 10）多端协议兼容：实现了与MobileIMSDK各种客户端完全兼容的协议模型。
  

七、文件组成

完整工程文件概览：


SDK代码文件用途说明：


精编注释级的源码：

八、授权方式

* 授权方法：
完成捐助后（详见本文“二、支持作者”），你即可永久自由地使用MobileIMSDK-鸿蒙端（包括后绪永久免费提供升级版），无需单独授权，如：用于研究、学习、甚至商业用途。MobileIMSDK为著作权作品，未经作者授权不可对MobileIMSDK任何部分原样进行二次出售（但基于此进行的后续演进和开发成果由您自行独享），请尊重知识产权。

* 版本升级：
精编注释版可永久免费获取最新版本，作者承诺在捐助者索取最新版本时，提供优先交付的保证。（另请参见《MobileIMSDK版本更新日志（该贴持续更新...）》）

* 获取授权书：
如您确实需要单独的正式授权书，请联系作者即可。授权书电子版(盖章有效)将发到您的指定邮箱，如还需寄送纸质授权书(盖章有效)则请补上邮费即可（快递收多少就是多少，无需多付）。

* 著作权证书：


* 补充说明：如需获得更多技术支持或技术合作请联系作者（详见下方“联系方式”）。

九、联系方式

• 讨论学习和资料区：点击进入；
• 即时通讯网VIP群：200090696  （更多QQ群点此进入）；
• bug和建议请发贴：点击进入；
• 技术支持、技术合作或咨询请联系作者QQ：413980957。
  

十、Demo功能说明

（点击可看大图 ▲）

十一、实际运行效果

1）Demo 的登陆界面运行截图（点击可看大图 ▼）：


2）Demo 的主界面运行截图（点击可看大图 ▼）：


3）Demo 运行的同时，可以查看详细的 log 输出（方便调试）：

十二、详尽开发者手册

① 开发者手册（网页版）：点此进入 ◀
② 开发者手册（PDF精编版）：点此进入 ◀（* 推荐）

十三、相关资料

[1] 鸿蒙Next官方开发资料
[2] MobileIMSDK开源框架的API文档
[3] MobileIMSDK开源IM框架源码（Github地址点此）
[4] MobileIMSDK-鸿蒙Next端发布公告
[5] MobileIMSDK-鸿蒙Next端开发手册（* 推荐）

INFO  - [11:47:58.450][IMCORE-ws]客户端{uid:null}/127.0.0.1:51497的会话已超时失效，很可能是对方非正常通出或网络故障，即将以会话异常的方式执行关闭流程 ... | (MBWebsocketClientInboundHandler^exceptionCaught:59)
DEBUG - [11:47:58.451][IMCORE-websocket]此客户端的Channel抛出了exceptionCaught，原因是：null，可以提前close掉了哦！ | (ServerCoreHandler^exceptionCaught:154)
io.netty.handler.timeout.ReadTimeoutException: null，请问怎么解决

INFO  - [11:47:58.450][IMCORE-ws]客户端{uid:null}/127.0.0.1:51497的会话已超时失效，很可能是对方非正常通出或网络故障，即将以会话异常的方式执行关闭流程 ... | (MBWebsocketClientInboundHandler^exceptionCaught:59)
DEBUG - [11:47:58.451][IMCORE-websocket]此客户端的Channel抛出了exceptionCaught，原因是：null，可以提前close掉了哦！ | (ServerCoreHandler^exceptionCaught:154)
io.netty.handler.timeout.ReadTimeoutException: null，用的是官方demo，能正常启动，访问时报这个错误

引用：小帅哥 发表于 2025-07-02 14:54
INFO  - [11:47:58.450]客户端{uid:null}/127.0.0.1:51497的会话已超时失效，很可能是对方非正常通出或网络 ...

你用的是什么客户端？

引用：JackJiang 发表于 2025-07-02 15:03
你用的是什么客户端？

您这边提供的鸿蒙demo

引用：小帅哥 发表于 2025-07-02 15:14
您这边提供的鸿蒙demo

截图或拍个操作视频，把你这个启动、运行、连接过程演示给我看看，我帮你分析分析

引用：JackJiang 发表于 2025-07-02 15:47
截图或拍个操作视频，把你这个启动、运行、连接过程演示给我看看，我帮你分析分析

找到原因是因为session中没有userId,但是出现了一个新的问题，当客户端调用其他接口时，会监听到离线，其实是在线的。这个是什么原因？

引用：小帅哥 发表于 2025-07-02 17:06
找到原因是因为session中没有userId,但是出现了一个新的问题，当客户端调用其他接口时，会监听到离线，其 ...

我有点没看明白。

你现在是在运行原版的MobileIMSDK鸿蒙NEXT客户端Demo+MobileIMSDK原版的服务端Demo出现了贴子里的情况，还是客户端有什么改动或者是有做什么修改？

引用：JackJiang 发表于 2025-07-02 17:12
我有点没看明白。

你现在是在运行原版的MobileIMSDK鸿蒙NEXT客户端Demo+MobileIMSDK原版的服务端Demo ...

在Java后端demo的消息发送接口外面，包了一层，然后就出现调用自己写的接口，监听立马反馈对方离线

引用：小帅哥 发表于 2025-07-02 17:18
在Java后端demo的消息发送接口外面，包了一层，然后就出现调用自己写的接口，监听立马反馈对方离线

说的更明白一点，就是客户端调用服务端非Im的接口，都会触发onUserLogout监听

引用：小帅哥 发表于 2025-07-02 17:18
在Java后端demo的消息发送接口外面，包了一层，然后就出现调用自己写的接口，监听立马反馈对方离线

具体你是怎么做的，你可以贴一贴具体的实现代码，我看看是否有什么问题

引用：小帅哥 发表于 2025-07-02 17:23
说的更明白一点，就是客户端调用服务端非Im的接口，都会触发onUserLogout监听

“非Im的接口”，具体指的是什么样的接口？你可以给点实际的代码或例子，让你理解你在干什么，不然我猜不出到底发生了啥，因为你说的，跟我理解，好像不在一个频道

引用：JackJiang 发表于 2025-07-02 17:28
“非Im的接口”，具体指的是什么样的接口？你可以给点实际的代码或例子，让你理解你在干什么，不然我猜不 ...

* **/
@RequestMapping(value = "/sendMessage",method = RequestMethod.POST)

public synchronized JSONObject sendMessage(@RequestParam("image") MultipartFile[] image,@RequestParam("files") MultipartFile[] files, HttpServletRequest request) throws Exception {
    //转换json对象
    ImModel imModel=  JSON.parseObject(request.getParameter("imModel"), ImModel.class);
    JSONObject jsonObject = new JSONObject();
    Channel fromChannel= (Channel) ServerEventListenerImpl.map.get(imModel.getFromUserId());
    Channel channel= null;这是我们自己写的业务处理接口，就会触发@Overridepublic void onUserLogout(String userId, Object obj, Channel session)
{
   map.put(userId,null);
   //保存客户信息到redis中
   logger.debug("【DEBUG_回调通知OnUserLogoutAction_CallBack】用户："+userId+" 离线了！");
}

引用：小帅哥 发表于 2025-07-02 17:40
* **/
@RequestMapping(value = "/sendMessage",method = RequestMethod.POST)

你的代码看起来我有点费解

你用MobileIMSDK的情况下，没有理由需要去直接操作Channel对象，你服务端如果需向某个人发送消息，直接调用LocalSendHelper即可

另一个，你一定要注意把长连接跟你的http短连接分开理解，长连接是有状态的，对它的消息推送一定是要借助sdk层提供的LocalSendHelper即可这样的公开接口才能实现

引用：JackJiang 发表于 2025-07-02 18:26
你的代码看起来我有点费解

你用MobileIMSDK的情况下，没有理由需要去直接操作Channel对象，你服务端如 ...

您提供的demo会监听到谁谁谁上线了，引入到自己的项目中这个上线日志就没触发监听？

引用：小帅哥 发表于 2025-07-03 09:07
您提供的demo会监听到谁谁谁上线了，引入到自己的项目中这个上线日志就没触发监听？

肯定能触发，我的意思其实是担心，你是不是对代码的调用理解不太对，导致了问题。因为通常搞web系统习惯了，一时比较难以理解长连接这种东西，它不是像http一样拉起就能用，它有一整套客户端的连接建立和维持才能通信。

所以，你最好尽量多贴代码，越多越好，至少能让我明白你是怎么干的，我才能理解你有没有搞对。

另外，你如果是在spring boot工程里集成，你可以参考这些帖子，对照一下是否用法没搞对，尤其是这篇：《SpringBoot集成开源IM框架MobileIMSDK，实现即时通讯IM聊天功能》