IM 即时通讯
Android
产品介绍
简介
产品优势
主要功能
功能介绍
帐号集成与登录
群组功能
聊天室功能
聊天室标签功能
圈组功能
多端登录与互踢策略
质量数据监控台
海外数据中心
IM平滑迁移方案
接口及业务限制
更新日志
IM UIKit 更新日志
NIM SDK 开发版更新日志
NIM SDK 稳定版更新日志
体验 Demo
下载 SDK 与 Demo 源码
快速开始
跑通 IM Demo 源码
实现单聊消息收发(不含 UI)
跑通圈组 Demo 源码
实现圈组消息收发(不含 UI)
含 UI 集成
什么是 IM UIKit
IM UIKit 功能概览
快速集成 IM UIKit
组件导入
初始化
界面跳转
自定义用户信息
全局配置
会话列表相关
集成会话列表界面
会话列表事件监听
自定义会话列表界面 UI
会话列表 API 概览
会话消息相关
集成会话界面
会话界面事件监听
实现音视频通话
实现地理位置消息功能(含 UI)
实现自定义消息发送(含 UI)
自定义会话界面 UI
会话消息 API 概览
通讯录相关
集成通讯录界面
自定义通讯录界面 UI
通讯录界面事件监听
通讯录 API 概览
IM UIKit 常见问题排查
IM UIKit API 概览
不含 UI 集成
集成 SDK
初始化
登录相关
登录 IM
多端登录与互踢
登出 IM
消息相关
消息概述
消息收发
自定义消息收发
消息配置选项
NOS 存储场景
广播消息收发
消息已读回执
消息撤回
消息重发与转发
消息更新
消息过滤
语音消息处理
插入本地消息
历史消息
最近会话
服务端会话服务
用户资料
用户关系
在线状态订阅
系统通知
系统通知概述
内置系统通知管理
内置系统通知未读数
自定义系统通知收发
离线推送与消息提醒
群组功能
群组概述
群组管理
群成员管理
群消息管理
超大群功能
聊天室
圈组功能
圈组概述
登录管理
服务器相关
服务器概述
服务器管理
服务器成员管理
游客功能
服务器未读数管理
频道相关
频道概述
频道管理
频道黑白名单
实时互动频道
频道分组
频道分组黑白名单
频道未读数管理
搜索服务器和频道
身份组相关
身份组概述
身份组应用场景
服务器身份组
频道身份组
用户定制权限
频道分组身份组
自定义权限项
成员权限查询与判定
身份组相关查询
圈组订阅机制
圈组消息相关
图解圈组消息流转
圈组消息收发
圈组消息撤回
圈组消息更新
圈组消息删除
消息正在输入
会话消息回复(Thread)
圈组快捷评论
获取频道最后一条消息
查询历史消息
查询@我的消息
圈组消息缓存
圈组消息搜索
圈组系统通知相关
圈组系统通知概述
圈组系统通知收发
圈组系统通知更新
圈组离线推送
圈组内容审核
圈组相关抄送
圈组第三方回调
圈组各端接口命名差异
反垃圾
聊天扩展
其他
最佳实践
IM 登录最佳实践
IM 应用隐私合规
聊天室重要消息投递
API 参考
Android SDK API
Android SDK 状态码
IM 控制台指南
创建应用
注册 IM 账号
升级服务
开通聊天室功能
配置应用客户端标识
常见问题
FAQ
错题集
Android 离线推送
实现离线推送
配置消息的推送属性
设置群消息强制推送
设置推送全局免打扰
设置多端推送策略
集成小米推送
集成华为推送
集成荣耀推送
集成 OPPO 推送
集成 vivo 推送
集成魅族推送
集成谷歌推送(FCM)
消息提醒
实现消息提醒
配置消息提醒功能
设置群消息强制提醒
设置消息提醒文案
定制通知栏显示信息
Android 端推送问题排查
第三方推送厂商的限制说明
服务协议

IM UIKit 更新日志

更新时间: 2023/03/17 18:08:17

[9.4.1] - 2023-03-17

修复IMKitClient中分步初始化接口config()initSDK的调用异常问题。

[9.4.0] - 2023-02-28

新增

  • 会话模块支持音视频通话功能。实现音视频通话的具体说明,请参见实现音视频通话
  • 圈组中支持表情和语音消息。

变更

  • 升级 NIM SDK 版本到 v9.8.0。

  • 离线消息支持 NIM SDK 的动态查询历史消息能力,避免出现历史消息拉取不完整的问题。更多详情请参见动态查询历史消息

问题修复

修复部分已知问题。

[9.3.0] - 2022-12-22

新增

  • 新增地理位置消息功能,具体实现方法参见实现地理位置消息功能

  • 新增文件消息功能(升级后可直接使用)。

    文件消息图.png

变更

集成会话界面(chatkit-ui)之前不再需要调用ChatKitClient.init方法对该模块进行初始化,相关文档参见集成会话界面

问题修复

修复部分已知问题。

[9.2.11] - 2022-11-23

变更

升级NIM SDK版本到 v9.6.4

问题修复

修复圈组、群设置中拍照功能异常。

[9.2.10] - 2022-11-04

新增

  • 新增IChatInputMenu类支持对会话界面(即聊天界面)输入框下方的按钮进行个性化配置,可通过ChatUIConfig进行配置。相关自定义示例请参见在界面底部菜单栏增加按钮
  • 新增IChatPopMenu类支持对会话界面的消息长按菜单进行个性化配置,可通过ChatUIConfig进行配置。相关自定义示例请参见不展示消息长按菜单
  • ChatKitClient中新增addCustomAttachaddCustomViewHolder方法,分别用于添加自定义消息附件和自定义消息的 ViewHolder。相关说明请分别参见自定义消息处理实现自定义消息的UI展示
  • MessageProperties中新增对界面标题的个性化定制能力。相关自定义示例请参见修改界面标题栏右侧图标
  • ContactUIConfig中新增IContactViewLayout支持对通讯录页面视图的个性化定制。相关自定义示例请参见在头部模块增加提示消息
  • 新增IConversationViewLayout支持个性化配置会话列表页面视图,可在ConversationUIConfig中配置。相关自定义示例请参见在会话列表顶部增加提示条
  • 新增SettingRepo类,提供通用配置方法,如通过setDeleteWithAlias方法可设置删除好友时删除昵称、通过setShowReadStatus方法设置是否展示已读未读状态等。

优化改进

  • 长按 loading 和发送失败消息,展示回复转发等功能。
  • 发送某些视频消息对端接收失败时,增加提示:云信IM视频下载失败。
  • 发送 1s 语音消息撤回时,撤回通知消息换行展示。
  • UI 和文案展示优化。

[9.2.9] - 2022-09-01

新增 API

  • 新增MessageProperties类,可通过该类下的selfMessageRes设置当前用户发送消息的背景资源 ID。
  • 新增MessageProperties类,可通过该类下的receiveMessageRes设置当前用户接收消息的背景资源 ID。

变更

  • 未实现功能去除,包括:
    • 去除文件发送入口
    • 去除多选选项
    • 去除标记列表
    • 去除“我的”界面的收藏选项和收藏的入口
  • 资源拆分:将依赖资源迁移到 UIKit 库中,不再依赖底层 Common 库的统一资源。

问题修复

  • 多语言英文文案更新。
  • 修复人员选择器选中的人员头像颜色不一致的问题。
  • 修复通知消息界面头像颜色不一致的问题。
  • 修复转发消息昵称过长且展示未对齐的问题。

[9.2.7] - 2022-08-18

新增 API

  • 新增CommonRepo类,该类中包含用户数据获取方法getUserInfo方法和用户信息更新方法updateUserInfo
  • ChatKit-ui模块中,支持传入会话 ID 进入会话界面(包括群聊界面和单聊界面),传入参数的 KEY 值为RouterConstant.CHAT_ID_KRY
  • 增加国际化英文文案,跟随系统切换。

问题修复

  • 修复黑名单中昵称展示问题。
  • 修复@功能名称展示问题。
  • 修复发送视频失败的提示文案。
  • 修复权限申请逻辑问题。

[9.2.6] - 2022-08-11

新增 API

  • IMKitClient类中增加setUserInfoDelegate(IUserInfoDelegate delegate,boolean cache)方法,支持UserInfo信息由业务实现。
  • IMKitClient类中增加removeUserInfoDelegate方法,移除设置的UserInfo代理类。
  • ChatKitClient类中增加init(Context context)方法。ChatKit模块初始化接口,需要在 Application 中进行初始化,完成自定义消息解析器CustomAttachParser的初始化。
  • CustomAttachment类中中增加getContent方法,获取自定义消息的摘要信息,用于展示会话列表中最新消息展示。

问题修复

  • 修复用户昵称或者群名称过长造成的 UI 展示问题。
  • 修复用户信息获取,保证用户信息优先同步获取,如获取失败则采用异步获取。

[9.2.2] - 2022-06-30

修复自动登录接口中,登录信息同步异常的问题。

[9.2.0] - 2022-06-23

新增特性

序号
新增特性
特性描述
1 UI 层支持个性化配置能力
  1. ChatKit-ui中:
    • 新增ChatUIConfig,支持自定义聊天界面 UI
    • 新增ChatKitClient,提供设置全局参数的接口
  2. ConversationKit-ui中:
    • 新增ConversationUIConfig,支持设置会话列表界面的 UI 自定义
    • 新增ConversationKitClient提供设置全局参数的接口
  3. ContactKit-ui中:
    • 新增ContactUIConfig支持自定义通讯录界面 UI
    • 新增ContactKitClient提供设置全局参数的接口
2 分布初始化 新增config接口和initSDK接口,支持分布初始化
3 通过扩展参数设置群组信息 TeamRepo新增createNormalTeamcreateAdvanceTeam方法,支持传入扩展参数fieldsMap:Map<TeamFieldEnum, Serializable>设置群组信息

NIM SDK 版本兼容

IM UIKit 兼容的 NIM SDK 版本升级到 v9.2.5,圈组的系统通知增加新的通知类型,具体请参见 SDK 更新日志

优化改进

对 Repository 层的接口进行了调整和优化,涉及改动的模块包括ChatMessageRepoContactRepoConversationRepoTeamRepoSearchRepo

问题修复

修复部分机型首次安装通讯录界面无法即时刷新的问题。

[9.0.2] - 2022-06-07

新增 API

  • ChatMessageBean类中增加isSameMessage(ChatMessageBean bean)方法,判断消息体是否相同。
  • ChatMessageAdapter类中增加私有方法removeSameMessage(List message),去除重复消息。

变更 API

  • ChatMessageAdapter中的appendMessagesforwardMessages方法增加对removeSameMessage的调用,消息列表增加消息时进行去重。
  • MessageCommonBaseViewHolder从Common 库中移除,ChatKitUI中相关 UI 和逻辑移动到在 ChatKitUI 中ChatBaseMessageViewHolder
  • MessageCommonBaseViewHolder 从 Common 库中移除,QChatKitUI 中相关 UI 和逻辑移动到 QChatBaseMessageViewHolder

问题修复

  • 修复重复提示群组创建成功的问题。该问题具体为:创建讨论组和高级群之后,进入讨论组或高级群的会话界面(即聊天界面),部分机型出现重复展示创建成功的提示信息。
  • 修复图片库加载图片失败的问题。ContactAvatarView中增加图片库加载图片失败处理,图片加载失败按照纯生背景+昵称的头像模式展示。

[9.0.1] - 2022-05-19

我的模块中,个人信息页面增加账号复制功能。

[9.0.0] - 2022-05-09

网易云信全新一代 IM UIKit 发布。

IM UIKit 是基于 NIM SDK(网易云信 IM SDK)开发的一款即时通讯 UI 组件库,包括聊天、会话、圈组、搜索、群管理等组件。通过 IM UIKit,可快速集成包含 UI 界面的即时通讯应用。更多 IM UIKit 相关介绍请参见什么是 IM UIKit快速集成 IM UIKit

[8.5.0] - 2021-06-22

新增

  1. 支持撤回自己给自己发送的消息
  2. 成员信息页面增加回调监听,实时更新页面
  3. 群设置界面支持群禁言
  4. 高级群设置界面新增转让并退出群功能

[8.4.0] - 2021-04-29

新增

  1. 会话列表页面收到会话更新通知时,如果数据库中没有此会话,则不创建会话项
  2. 获取群消息的已读回执失败时,从本地加载

[8.2.0] - 2020-12-30

变更

  1. 对会话进行排序时,不再频繁从数据库读取置顶信息

[8.1.0] - 2020-11-13

变更

  1. 登录页新增独立模式进入聊天室入口

[7.8.0] -2020-7-21

变更

  1. 手动登录页面可配置设备自定义类型。此类型只在此次登录中生效。
  2. 会话置顶会多端同步和漫游

[7.4.0] -2020-3-9

变更

  1. 长按消息菜单栏中添加单向删除接口
  2. 长按消息菜单栏中的撤回,变更为通知计入未读数和通知不计入未读数的撤回
  3. 会话界面(即聊天界面)中菜单栏的云消息记录变更为被清除消息入库和不入库两栏
  4. 会话界面(即聊天界面)中菜单栏的清空本地消息记录变更为记录操作和不记录操作两栏

[7.2.0] -2020-1-13

变更

  1. 设置页增加配置会话合并类型的项
  2. 合并转发外观调整
  3. 会话服务展示

[7.0.0] -2019-11-13

变更

  1. 封装合并转发功能

[6.9.0] -2019-9-17

变更

  1. 修复收到推送通知,头像图片不显示的问题
  2. 修改GlobalSearchActivity和SearchMessageAcivity的screenOrientation参数为"behind"

[6.5.0] -2019-5-24

变更

1. 修复发送图片崩溃

[5.9.0] -2018-11-28

变更

1. 修复多处内存泄漏

[5.7.0] - 2018-10-11

新增

1. 设置页面新增通知的振动模式

2. 好友资料页新增置顶操作

[5.6.1] - 2018-9-13

新增

1. 播放音频时贴近耳朵,切换成听筒模式

2. 图片、音频、视频、文件消息在未下载成功前支持转发

变更

1. fix视频聊天切换画面崩溃

2. 视频聊天结束释放资源

[5.1.1] - 2018-05-21

变更

1. 多人通话使用AVChatTextureViewRenderer替换AVChatSurfaceViewRenderer。

[5.0.0] - 2018-03-29

新增

1. 白板模块组件化RTSKit

2. 新增群组已读功能演示

[4.8.0] - 2018-02-09

变更

1. 红包功能更新。

[4.6.0] - 2018-01-04

新增

1. 抽取音视频组件 avchatkit。

2. 集成 fabric 崩溃收集工具。

3. 允许管理员撤回其他成员消息。

[4.4.0] - 2017-11-16

新增

1. 添加全面屏配置。

2. 规避 oppo r11 Toast 崩溃的问题。

变更

1. 更新UIkit图片库,升级 Glide 到 4.2.0。

2. 非透明的 png 资源转成 webp 格式,减小包体积。

3. 被拉黑发消息失败后的交互调整。

4. Demo 开发环境升级到 Android Studio 3.0, Gradle tool 3.0, compile 26, target 26, 适配 O 版本。

5. UIKit 组件重构。

[4.3.0] - 2017-10-12

新增

1. 添加聊天室独立模式Demo。

2. 添加批量清空所有未读数接口演示。

3. 添加搜索历史图片/视频浏览界面。

变更

1. 猜拳文本演示改成图片演示。

2. UIKit 去掉对 avcaht library 的依赖。

3. UIKit Glide 图片库升级到v4.0,解决 gif 动画加载延迟问题。

[4.2.0] - 2017-09-12

新增

1. 聊天室机器人Demo演示。

[4.1.0] - 2017-08-08

新增

1. 添加金融魔方组件,集成金融魔方红包示例。

2. UIKit 添加 APP Icon 未读数红点更新接口 Bader,适配国内主流厂商机型,demo 演示最近会话未读数与 APP icon 红点数同步。

3. 添加多人音视频与 WebRtc 通信开关。

变更

1. 音视频在锁屏被呼叫时自动亮屏并唤起呼叫界面。

2. UIKit @功能重构,修复输入框@遗留的问题。

3. 修复 targetSdkVersion 24及以上时,选择拍摄照片失败问题。

[4.0.0] - 2017-07-06

新增

1. 添加机器人同步、机器人收发消息。

2. 添加机器人UI 组件。

此文档是否对你有帮助?
有帮助
我要吐槽
  • [9.4.1] - 2023-03-17
  • [9.4.0] - 2023-02-28
  • 新增
  • 变更
  • 问题修复
  • [9.3.0] - 2022-12-22
  • 新增
  • 变更
  • 问题修复
  • [9.2.11] - 2022-11-23
  • 变更
  • 问题修复
  • [9.2.10] - 2022-11-04
  • 新增
  • 优化改进
  • [9.2.9] - 2022-09-01
  • 新增 API
  • 变更
  • 问题修复
  • [9.2.7] - 2022-08-18
  • 新增 API
  • 问题修复
  • [9.2.6] - 2022-08-11
  • 新增 API
  • 问题修复
  • [9.2.2] - 2022-06-30
  • [9.2.0] - 2022-06-23
  • 新增特性
  • NIM SDK 版本兼容
  • 优化改进
  • 问题修复
  • [9.0.2] - 2022-06-07
  • 新增 API
  • 变更 API
  • 问题修复
  • [9.0.1] - 2022-05-19
  • [9.0.0] - 2022-05-09
  • [8.5.0] - 2021-06-22
  • 新增
  • [8.4.0] - 2021-04-29
  • 新增
  • [8.2.0] - 2020-12-30
  • 变更
  • [8.1.0] - 2020-11-13
  • 变更
  • [7.8.0] -2020-7-21
  • 变更
  • [7.4.0] -2020-3-9
  • 变更
  • [7.2.0] -2020-1-13
  • 变更
  • [7.0.0] -2019-11-13
  • 变更
  • [6.9.0] -2019-9-17
  • 变更
  • [6.5.0] -2019-5-24
  • 变更
  • [5.9.0] -2018-11-28
  • 变更
  • [5.7.0] - 2018-10-11
  • 新增
  • [5.6.1] - 2018-9-13
  • 新增
  • 变更
  • [5.1.1] - 2018-05-21
  • 变更
  • [5.0.0] - 2018-03-29
  • 新增
  • [4.8.0] - 2018-02-09
  • 变更
  • [4.6.0] - 2018-01-04
  • 新增
  • [4.4.0] - 2017-11-16
  • 新增
  • 变更
  • [4.3.0] - 2017-10-12
  • 新增
  • 变更
  • [4.2.0] - 2017-09-12
  • 新增
  • [4.1.0] - 2017-08-08
  • 新增
  • 变更
  • [4.0.0] - 2017-07-06
  • 新增