• IMLib / IMKit >
 
• 升级说明

升级说明

关于停止维护 IMLib v2 旧版 SDK 的声明

IMLib 2.x 替换为 v2-adapter

NPM 包变更

原 @rongcloud/imlib-v2 包已停止维护，请使用 @rongcloud/imlib-v2-adapter 替代。

 
# 移除旧版本依赖
npm rm @rongcloud/imlib-v2 @rongcloud/engine
# 安装 RongIMLib-v2-Adapter
npm install @rongcloud/engine@latest @rongcloud/imlib-v2-adapter@latest -S
              

                
已复制
                复制代码
              
              
1
2
3
4

同时需要在集成代码中修改包引用。

 
// import * as RongIMLib from '@rongcloud/imlib-v2' 需修改为
import * as RongIMLib from '@rongcloud/imlib-v2-adapter'

// const RongIMLib = require('@rongcloud/imlib-v2') 需修改为
const RongIMLib = require('@rongcloud/imlib-v2-adapter')
              

                
已复制
                复制代码
              
              
1
2
3
4
5

CDN 链接引入

原 RongIMLib-2.x.x.prod.js SDK 已停止维护，请使用 RongIMLib-v2-Adapter 的最新版本替代。

关于 v2.5 及更早版本的升级说明

IMLib 2.5 及更早版本，需注意如下变更：

废弃功能

会话

废弃功能

因本地存储不准确，不再维护以下会话相关接口

兼容方法

getConversationUnreadCount 兼容示例代码

 
// 1、调用 getConversationList 方法获取所有会话
var targetTypes = [1,3]; //目标会话类型
var callback = {
    onSuccess: function(list) {
      // 2、根据返回的会话列表中 conversationType 方法字段筛选出目标会话
      var targetConvers = list.filter(function(conver) {
        return targetTypes.indexOf(conver.conversationType.toString()) > -1
      });
      // 3、根据筛选出的会话计算未读数
      var targetUnreadCount = 0
      targetConvers.forEach(function(conver) {
        targetUnreadCount += conver.unreadMessageCount
      });
      console.log('按会话类型获取会话未读数成功', targetUnreadCount);
    },
    onError: function(error) {
      console.log('获取会话列表失败', error);
  }
}
RongIMClient.getInstance().getConversationList(callback, null, 1000);
              

                
已复制
                复制代码
              
              
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20

clearConversations 兼容示例代码

 
// 1、调用 `getConversationList` 方法获取所有会话
var targetTypes = [1,3]; //目标会话类型
var callback = {
  onSuccess: function(list) {
    // 2、根据返回的会话列表中 `conversationType` 字段筛选出目标会话
    var targetConvers = list.filter(function(conver) {
      return targetTypes.indexOf(conver.conversationType) > -1
    });
    // 3、循环调用 removeConversation 方法删除会话
    var targetUnreadCount = 0
    targetConvers.forEach(function(conver) {
      RongIMClient.getInstance().removeConversation(conver.conversationType, conver.targetId, { onSuccess: function () { }, onError: function () { } });
    });
    console.log('按会话类型删除会话成功');
  },
  onError: function(error) {
    console.log('获取会话列表失败', error);
  }
}
RongIMClient.getInstance().getConversationList(callback, null, 1000);
              

                
已复制
                复制代码
              
              
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20

clearTotalUnreadCount 兼容示例代码

 
// 1、调用 `getConversationList` 方法获取所有会话
var targetTypes = [1,3]; //目标会话类型
var callback = {
  onSuccess: function(list) {
    // 2、循环调用 `clearUnreadCount` 方法清除未读数
    list.forEach(function(conver) {
      RongIMClient.getInstance().clearUnreadCount(conver.conversationType, conver.targetId, { onSuccess: function () { }, onError: function () { } });
    });
    console.log('按会话类型删除会话成功');
  },
  onError: function(error) {
    console.log('获取会话列表失败', error);
  }
}
RongIMClient.getInstance().getConversationList(callback, null, 1000);
              

                
已复制
                复制代码
              
              
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

讨论组

废弃功能

废弃讨论组相关接口