jackjiang2011 / mobileimsdk

一个原创多端IM通信层框架，轻量级、高度提炼，历经8年、久经考验。可能是市面上唯一同时支持UDP+TCP+WebSocket三种协议的同类开源框架，支持 iOS、Android、Java、H5、小程序、Uniapp，服务端基于Netty。

我是 Jack Jiang，即时通讯网站长，专注于即时通讯技术的分享和传播。佛系技术，默默坚守。

mobileimsdk's Issues

里面并没有打洞技术，服务器转发消息？

里面并没有打洞技术，是通过服务器转发消息的。并不是client与client直接通信

WebSocket客户端也没开源啊

使用WebSocket能够更好的支持web端，所以客户端也直接用WS，MobileIMSDK也没开源还是客户端就不支持WS

Socket连接失败

Socket连接服务器的地址是在哪里设置的

是否支持websocket，react native

请问有没有与Wi-Fi模块交互？

怎么给您捐钱？

如题，最讨厌这种不留名的人了。给个微信二维码或者支付宝收款码会怎样？？

能否增加Tcp模式

在吗 用着怎么样

请问下长消息支持吗？

如题.
传一个JSON，长度大概在5000，请问支持吗？
或者框架里有处理分包等吗

支持腾讯IM的接入吗

支持集成腾讯IM不带UI的SDK结合你这个UI框架吗

缺少IOS的源代码

发现只有Android、Java和Server的源代码，缺少了IOS，是不准备开源还是？

你好,我发现退出后台较长时间后,重新进入app,不会自动重连.

请问支持图片和视频的传输吗

如题，请问支持图片和视频的传输吗？对IM了解不多，请见谅

Android端切换账号问题

注销之前的账号，然后登录新的账号，发现无法回调登录成功，异步请求登录是成功的
另外， 不杀应用，直接去注销账号，然后登录，无法实现，AsyncTask不执行

`new AsyncTask<Object, Integer, Integer>() {
@OverRide
protected Integer doInBackground(Object... params) {
int code = -1;
Log.w(TAG, "loginout");
try {
code = LocalUDPDataSender.getInstance(context).sendLoginout();
} catch (Exception e) {
Log.w(TAG, e);
}

            //## BUG FIX: 20170713 START by JackJiang
            // 退出登陆时记得一定要调用此行，不然不退出APP的情况下再登陆时会报 code=203错误哦！
            IMClientManager.getInstance(context).resetInitFlag();
            //## BUG FIX: 20170713 END by JackJiang

            return code;
        }

        @Override
        protected void onPostExecute(Integer code) {
            if (code == 0) {//成功
                Log.d(TAG, "注销成功");
                doLoginIm(((Context) mView).getApplicationContext(), true);
            } else {//注销失败
                Log.d(TAG, "注销失败");
            }
        }
    }.execute();`

能在react-native中使用吗？有相关文档吗？

能在react-native中使用吗？有相关文档吗？

【特别提示】如果Github下载速度太慢，请往码云，代码完全同步！

码云地址是：https://gitee.com/jackjiang/MobileIMSDK

Android启动App进入首页就会ANR

Pixel2（Android 系统版本11），Pixel5（Android 系统版本13），还有一个Oppo（Android 系统版本13）的手机启动App进入首页就会ANR

Server端OnlineProcessor中putUser和removeUser存在的并发问题

putUser

源码里实现是先查询再判断，这里应该是有问题的，如果多个终端同时登录同一个账号，可能会存在丢失Channel导致资源泄露的问题。多个线程同时进到putUser，onlineSessions.get(user_id)结果都为空，就会执行到else里onlineSessions.put(user_id, newSession);这样就后一个就会把前一个Channel覆盖掉，导致Channel泄露，前一个Channel资源不能及时得到释放，也就不会kick掉。

• 修改方案：直接先使用ConcurrentHashMap的put方法添加user_id和Channel的映射，put的结果会返回old值，因为ConcurrentHashMap是线程安全的，而且put始终会返回old值，再判断old值，如果old值不为空，直接走kick流程。

removeUser

这里完全没有必要上锁，直接加synchronized也太暴力了，把所有用户的remove都阻塞了。

• 修改方案：也是直接利用ConcurrentHashMap先remove，remove结果为true表示移除成功，false表示移除过了，通过remove返回结果来处理其他业务。

贴一段我这块的实现代码吧，可能也存在问题，一起来交流下

 // 绑定用户和Channel的关系
 public void bindSession(Session session, Channel newChannel) {
        final Channel oldChannel = userIdChannelMap.put(session.getUserId(), newChannel);
        // 如果oldChannel不为空，表明操作的是同一个userId，如果是同一个userId表示重复登录了
        // 重复登录有两种情况：
        // 1. 如果是同一个channel，表示用户没有重复建立连接，仅仅是重复发送了登录请求，这种情况忽略即可
        // 2. 如果不是同一个channel，表示用户重复建立连接了，可能是客户端bug，也可能是在另外一个终端登录，也就是被踢的场景，这种情况需要将原来的channel断开。
        if (oldChannel != null) {
            final boolean isTheSame = oldChannel.compareTo(newChannel) == 0;
            // 不是同一个连接，将原来的channel关闭断开或kick，防止资源泄露
            if (!isTheSame) {
                log.warn("duplicate login, close old connection, uid={}, oldId={}, newId={}", session.getUserId(),
                        oldChannel.id().asShortText(), newChannel.id().asShortText());
                oldChannel.attr(ATTRIBUTE_KEY_SESSION).set(null);
                oldChannel.close();
            }
        }
        // 如果oldChannel为空，表示用户第一次登录，则将在线数量加1
        else {
            onlineUserCount.incrementAndGet();
        }
        // 设置channel属性信息，这里不管是第一次登录还是重复登录，都更新一次attribute
        newChannel.attr(ATTRIBUTE_KEY_SESSION).set(session);
    }

 // 解绑用户和Channel的关系
 public void unBindSession(Channel channel) {
        // 检查是否登录过
        if (!hasLogin(channel)) {
            log.warn("unbind session, but not found session, {}", ClientUtils.getClientInfo(channel));
            return;
        }
        // 获取登录信息
        Session session = getSession(channel);
        // 使用ConcurrentHashMap的remove()来代替查询判断再移除的操作，来保证线程安全和原子性
        final boolean ret = userIdChannelMap.remove(session.getUserId(), channel);
        // 如果用户信息从map中移除成功，才进行在线数量的减1操作并移除Channel的attributes
        if (ret) {
            log.info("unbind session, {}", ClientUtils.getSimpleClientInfo(channel));
            onlineUserCount.decrementAndGet();
            channel.attr(ATTRIBUTE_KEY_SESSION).set(null);
        }
}

重连之后不是原来的id了

Android demo重连之后又被分配新的id，导致原来两个客户端无法继续通信，这好像不符合常理吧？

【开发动态】MobileIMSDK最新微信小程序端已发布！

一、基本介绍

MobileIMSDK-微信小程序端是一套基于微信原生WebSocket的即时通讯库：

• 1）超轻量级、无任何第3方库依赖（开箱即用）；
• 2）纯JS编写、ES6语法、高度提炼，简单易用；
• 3）基于微信原生WebSocket API，简洁优雅；
• 4）支持运行于任何支持微信小程序的手机端；
• 5）能与 MobileIMSDK 的各种客户端完美互通；
• 6）可应用于微信小程序中的消息推送、客服聊天、企业OA、IM等场景。

二、与MobileIMSDK的关系

MobileIMSDK-微信小程序端是基于微信原生WebSocket协议的 MobileIMSDK配套客户端库。

以下是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://github.com/JackJiang2011/MobileIMSDK/ 👈

【开发动态】MobileIMSDK最新Uniapp端库已发布！

一、基本介绍

MobileIMSDK-Uniapp端是一套基于Uniapp跨端框架的即时通讯库：

• 1）超轻量级、无任何第3方库依赖（开箱即用）；
• 2）纯JS编写、ES6语法、高度提炼，简单易用；
• 3）基于Uniapp标准WebSocket API，简洁优雅；
• 4）理论上可运行于任何支持Uniapp跨端框架的平台上；
• 5）能与 MobileIMSDK 的各种客户端完美互通；
• 6）可应用于基于Uniapp的跨平台App或Web的消息推送、客服聊天、企业OA、IM等场景。

详细开发资料：

① MobileIMSDK-Uniapp端详细介绍 👈
② MobileIMSDK-Uniapp端开发手册 👈

二、与MobileIMSDK的关系

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

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

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

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

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

三、设计目标

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

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

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

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

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

四、技术亮点

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

七、文件组成

SDK代码文件概览：

SDK代码文件用途说明：

八、Demo运行效果和说明

九、跨平台运行效果演示

1）Demo在内置浏览器中的运行效果：

2）Demo在电脑浏览器中的运行效果（以Chrome为例）：

3）Demo在Android真机上的运行效果：

4）Demo在iOS模拟器上的运行效果：

5）Demo在iOS真机上的运行效果：

6）Demo在微信小程序上的运行效果：

7）Demo在支付宝小程序上的运行效果：

（其它更多平台的运行效果就不一一列举了，因为都要安装各自的开发工具，硬盘空间吃紧 。。。）

十、详细资料

① MobileIMSDK-Uniapp端的详细介绍：点此查看 👈
② MobileIMSDK-Uniapp端的开发手册：点此查看 👈
③ MobileIMSDK-开源框架的详细介绍：https://github.com/JackJiang2011/MobileIMSDK 👈

能不能问一下发送文件 图片的思路？

新人学习中，真心求教

服务端源码

有没有服务端源码

【重要提示】常见问题、技术疑问请前往开发者社区！

MobileIMSDK的专用开发者社区地址是： http://www.52im.net/forum-89-1.html

其它重要链接

1、产品案例

• RainbowChat体验版 👈
• RainbowChat体验版截图预览

2、Demo安装和使用

• 客户端Demo安装和使用帮助(Android)
• 客户端Demo安装和使用帮助(iOS)
• 客户端Demo安装和使用帮助(Java)
• 客户端Demo演示和说明(H5)
• 客户端Demo演示和说明(微信小程序)
• 服务端Demo安装和使用帮助 🆕

3、开发者指南

• 客户端开发指南(Android)
• 客户端开发指南(iOS)
• 客户端开发指南(Java)
• 客户端开发指南(H5)
• 客户端开发指南(微信小程序)
• 服务端开发指南

4、API文档

• 客户端SDK API文档(Android)：TCP版、UDP版
• 客户端SDK API文档(iOS)：TCP版、UDP版
• 客户端SDK API文档(Java)：TCP版、UDP版
• 客户端SDK API文档(H5)：点此进入
• 客户端SDK API文档(微信小程序)：点此进入
• 服务端SDK API文档

5、打包下载

• MobileIMSDK最新版打包下载 👈
• 国外地址：MobileIMSDK的Github地址
• 国内地址：MobileIMSDK的码云gitee地址（访问速度快！）

6、学习交流

• 技术交流社区：点此进入
• 常见问题讨论：点此进入 👈
• 技术交流Q群： 215477170 👈
• 技术支持/合作/咨询请联系作者QQ：413980957 （关于作者 👈）
• 关注我的公众号：:point_down: :point_down:

服务器连接不稳定时会出现这个异常

是否可以集成高性能并发库disruptor

转成Android Studio版的工程源码就好了

eclipse 都不好导入