近期重要更新

• 支持按群成员类型分页查询群成员列表。
• 支持添加特别关注群成员列表。
• 新增鸿蒙终端类型的解析。
• 支持按圈组频道向本地数据库插入圈组消息草稿，具体请参考插入本地圈组消息草稿。
• 圈组模块支持分页获取评论者列表，具体请参考圈组快捷评论。

---

[9.16.0] - 2024-04-16

新增特性

• 支持按群成员类型分页查询群成员列表。
• 支持添加、移除特别关注群成员列表。（高级群和超大群）
• 新增鸿蒙终端类型的解析。

优化改进

适配升级 OPPO 推送 SDK 至 3.4.0 版本。

API 新增

API	API 说明
TeamService.getTeamMemberList	按群成员类型分页查询群成员列表。（高级群）
TeamService.addTeamMembersFollow	添加特别关注群成员列表。（高级群）
TeamService.removeTeamMembersFollow	移除特别关注群成员列表。（高级群）
SuperTeamService.getTeamMemberList	按群成员类型分页查询群成员列表。（超大群）
SuperTeamService.addTeamMembersFollow	添加特别关注群成员列表。（超大群）
SuperTeamService.removeTeamMembersFollow	移除特别关注群成员列表。（超大群）

API 变更

方法/回调/类	说明
ClientType	新增 Harmony 成员参数，多端登陆支持鸿蒙客户端类型。

[9.15.2] - 2024-03-28

升级数据库加密套件（SQLCipher）至 4.5.4 版本。

[9.15.1] - 2024-03-22

圈组连接优化。

[9.15.0] - 2024-01-31

新增特性

圈组模块新增支持以下功能：

• 支持分页获取评论者列表，具体请参考圈组快捷评论。

• 为方便用户按需存储圈组消息草稿，支持按圈组频道向本地数据库插入圈组消息草稿，同时可以删除和查询该消息草稿。具体请参考插入本地圈组消息草稿。

• 支持发送失败的消息自动缓存到本地，并可以通过查询历史消息方法（getMessageHistory）获取发送失败的本地消息。具体请参考查询历史消息。

API 变更

方法/回调/类	说明
insertOrReplaceTextCache	新增接口，用于向本地数据库插入一条缓存数据，如果该频道下已经存在数据，则被新数据覆盖。
deleteTextCache	新增接口，用于删除指定缓存数据。
getTextCache	新增接口，用于获取指定缓存数据。
getCommentators	新增接口，用于分页获取指定消息的快捷评论者列表。
QChatGetMessageHistoryParam	新增 isIncludeLocalMessages() 成员函数，用于指定查询结果是否包含本地圈组消息。

[9.14.2] - 2024-01-15

优化

• 圈组多线程处理优化。
• 获取运营商信息缓存优化。
• 已读回执发送逻辑优化。

[9.14.1] - 2023-12-04

新增特性

支持查询指定时间段内的服务端 Thread 历史消息，具体请参考历史消息文档。

API 新增

API	API 说明
queryThreadTalkHistory	分页查询指定时间段内的云端 Thread 历史消息（单聊、群/超大群）。

优化

内部优化。

[9.14.0] - 2023-11-10

登录和消息发送逻辑优化。

[9.13.1] - 2023-10-25

内部优化。

[9.13.0] - 2023-08-29

新增特性

支持配置消息提醒（本地通知消息）的类型，具体请参考消息提醒类型。

修复

• 发送视频消息时，缩略图本地路径（thumbPath） 后缀名受视频文件后缀名影响而不规范。
• 用户被踢登出后，在子线程取消下载任务导致崩溃。

[9.12.2] - 2023-08-21

• 优化动态查询历史消息接口的参数类型。
• 修复 IPV6 URL 转换错误的问题。
• 修复重复收到自定义系统通知离线同步的问题。
• 修复 android 12 后台调用 startForegroundService 失败导致的崩溃问题。

[9.12.1] - 2023-08-01

SDKOptions 新增 reportIgnoredMessage 字段，支持配置是否上报被过滤的消息。

[9.12.0] - 2023-07-07

新增特性

圈组订阅机制支持自动订阅。开启自动订阅后，当用户登录到圈组服务器，无需手动订阅服务器或频道，进入服务器或频道时即可收到消息、事件和系统通知，退出时则自动取消订阅。具体请参考圈组订阅机制。

优化

• 优化第三方回调登录内部逻辑，具体请参见通过第三方回调登录 IM。
• 优化高级群和超大群的同步逻辑，并新增关闭同步高级群和超大群成员信息的配置项。

修复

本次版本修复以下问题：

• 当批量将会话消息未读数清零(标记已读)时，会话数量过大导致报错。
• 下载附件后重新进入 app，文件下载状态未更新。
• 切换 appkey 后 deviceId 未缓存导致自动登录被踢出。

API 变更

API	说明
SDKOptions#auto_subscribe	新增圈组自动订阅开启/关闭参数。
SDKOptions#syncConfig	新增同步配置参数，可设置是否在初始化时同步高级群/超大群的成员信息，默认为 true（同步）。

[9.11.2] - 2023-06-20

优化内部逻辑。

[9.11.1] - 2023-06-02

修复开启数据库加密异常的问题。

[9.11.0] - 2023-05-30

新增特性

• 支持接入第三方机器人，在一对一（P2P）和群组（高级群，Team）场景中与机器人进行互动，具体请参考接入第三方机器人。
• 新增第三方回调动态登录模式，具体请参考登录 IM。
• 新增数据准备成功的回调，具体请参考监听数据准备完成回调。
• 支持用户在初始化之后，登录 SDK 之前获取推送 Token，具体请参考实现离线推送。

修复

• 修复断网重连后进入聊天室又退出的问题。
• 修复锁屏之后 observeOnlineStatus 回调过于频繁的问题。
• 修复其他已知问题。

第三方推送兼容版本

v9.11.0 兼容的第三方推送 SDK 版本信息如下：

第三方推送	版本
华为	6.9.0.300
小米	5.6.2
OPPO	3.1.0
VIVO	3.0.0.4_484
魅族	4.2.3
荣耀	7.0.41.301
FCM	firebase-bom:28.4.2，具体版本： firebase-messaging：23.0.0 firebase-analytics: 20.0.0

API 变更

API	说明
observeDataReady	新增数据准备成功回调接口，当消息数据库开启完成后，通知用户数据已准备完成，可以开始发送消息。
SDKOptions#loginExtProvider	新增获取 IM 动态登录扩展信息，用于实现通过第三方回调动态登录 IM。
chatroomAuthProvider	新增获取聊天室动态 Token，用于实现通过动态 Token 登录聊天室。
chatroomLoginExtProvider	新增获取聊天室动态登录扩展信息，用于实现通过第三方回调动态登录聊天室。
getQuickComments	获取圈组快捷评论接口返回的数据中新增快捷评论的创建时间，即 QChatQuickCommentDetail 中新增获取评论创建时间的接口（getCreateTime）。
getRobotInfo	IMMessage 消息体中新增获取机器人信息的方法，用于实现机器人消息功能。
setRobotInfo	IMMessage 消息体中新增设置机器人信息的方法，用于实现机器人消息功能。
getRealMsgObj	IMMessage 消息体中新增获取消息本身的方法，可通过获取到的消息对象判断是否为圈组消息。
FileAttachment#setUri	发送消息时，消息附件支持设置文件uri，仅支持 ContentResolver.SCHEME_FILE 类型和 ContentResolver.SCHEME_CONTENT 类型的 uri
registerPush	新增获取推送 Token 接口。在初始化之后，无论是否登录，可以调用该方法获取推送 Token（Token 通过 observeMixPushToken 回调得到）。

[9.10.1] - 2023-04-18

修复已知问题。

[9.10.0] - 2023-04-11

API 变更

初始化参数 SDKOptions 中新增 fixMsgStatusByBlackList 配置项，默认关闭。开启后，消息状态是否成功需要结合 isInBlockList（通过解析消息体得到该字段）进行判断：

• 同步接收到的消息，如果 isInBlockList==true，则消息状态修改为 failed。
• 查询云端历史消息，如果 isInBlockList==true，则消息状态修改为 failed。

优化

• 优化内部拉黑后的消息重发逻辑，具体请参考消息重发。
• 优化圈组订阅回调机制。（订阅圈组服务器/频道后，只有未读数变更时才触发回调。）

修复

• 修复锁屏之后 observeOnlineStatus 回调过于频繁的问题。
• 修复已登录情况下数据库打开异常的问题。
• 修复其他已知问题。

[9.9.3] - 2023-03-14

优化动态查询历史消息接口（getMessagesDynamically），主要修复当本地消息后没有云端消息时，本地消息无法被查询到的问题。

[9.9.2] - 2023-03-07

新增特性

• 新增 “圈组用户资料复用 IM 用户资料” 的能力。

  • 如果某用户未配置自己的服务器成员信息，该用户的初始服务器成员信息将直接复用对应的 IM 用户资料（目前仅支持复用昵称和头像）。

  • 如果某用户在未配置自己的服务器成员信息的情况下修改了自己的 IM 用户资料（昵称或头像），系统通知（通知类型MY_MEMBER_INFO_UPDATED）将触发，通知该用户需要在哪些服务器重新获取自己的资料。

• 在线消息通知栏的 “新消息"提醒，支持多语言配置。

数据结构变更

• 圈组的系统通知类型QChatSystemNotificationType中新增枚举MY_MEMBER_INFO_UPDATED，表示修改 IM 用户资料触发的圈组服务器成员信息的联动修改。该系统通知的具体触发条件、接收者和接收条件，请参见圈组系统通知概述中对USER_INFO_UPDATE(35)的说明。

• 圈组系统通知的投递对象类型QChatSystemMessageToType新增枚举值ACCIDS，表示发送给指定的用户。

修复

部分已知问题修复与优化。

[9.9.0] - 2023-02-09

新增特性

SDK 支持查询指定频道中@当前用户的未读消息，同时也支持批量查询消息是否@当前用户。具体请参见查询@我的消息。

API 新增

API	API 说明
getMentionedMeMessages	查询指定频道中@当前用户的未读消息
areMentionedMeMessages	批量查询消息是否@当前用户
queryMessageListByTypesV2	查询指定消息类型的历史消息 该接口相较于queryMessageListByTypes接口，优化了内部的查询逻辑，请优先使用queryMessageListByTypesV2

优化

优化登录超时后的重连机制。

修复

• 修复会话状态更新错误问题。
• 修复同一用户在多个群中群昵称不同而被覆盖的问题。
• 修复下载附件完成后主线程操作数据库可能 ANR（Application Not Responding）的问题。
• 修复 NOS 下载过程中取消下载后无法再次下载的问题。
• 修复其他已知问题。

[9.8.0] - 2022-12-27

该版本的圈组模块新增了游客功能，离线推送模块新增支持荣耀的离线推送。

新增特性

序号	新增特性	特性描述	相关文档
1	游客功能	以游客身份进入服务器，可查询部分信息和接收消息，也可接收部分系统通知	游客功能
2	频道对游客的可见性	创建和修改频道时可设置频道是否对游客可见	频道管理
3	频道分组对游客的可见性	如果频道对游客可见，则包含该频道的频道分组也对游客可见，且频道分组的查看模式变更可能导致频道对游客的可见性变更	频道分组
4	频道可见性变更系统通知	新增系统通知类型CHANNEL_VISIBILITY_TO_VISITOR_UPDATE，表示频道对游客的可见性发生变更	游客可接收的系统通知
5	荣耀推送	支持荣耀的推送服务	荣耀推送

API 变更

新增 API

API	API 说明
QChatServerService#enterAsVisitor	以游客身份进入服务器
QChatServerService#leaveAsVisitor	以游客身份离开服务器
QChatChannelService#subscribeAsVisitor	以游客身份订阅频道
QChatServerService#subscribeAsVisitor	以游客身份订阅服务器

变更 API

API	API 说明	变更说明
createChannel	创建频道	新增参数visitorMode，用于设置频道是否对游客可见
updateChannel	修改频道信息	新增参数visitorMode，用于设置频道是否对游客可见

优化

IM SDK 适配 Android v13.0.0。

修复

修复部分已知问题。

[9.7.0] - 2022-12-2

新增特性

IM 新增动态查询连续完整的历史消息功能，具体请参见动态查询历史消息。

相较于频繁从云端获取，该查询方法在保证历史消息完整的同时，减少了耗时和耗能。

API 新增

API	API 说明
getMessagesDynamically	动态查询连续完整的历史消息

[9.6.3] - 2022-10-27

新增特性

v9.6.3 的聊天室模块，新增根据标签（Tags）查询聊天室历史消息的功能，具体请参见根据标签查询历史消息。

API 新增

API	API 说明
getMessagesByTags	通过聊天室标签（可多个）来检索聊天室历史消息
observeTagsUpdate	监听聊天室标签变更事件，回调包含变更标签的聊天室 ID 和变更后的标签信息

优化

• 优化同步消息过程中的去重逻辑，减少同步时间。
  • 原逻辑：按每条消息进行数据库查重，数据库查询次数过多。
  • 现逻辑：通过批量查询消息进行数据库查重，减少数据库查询次数，减少耗时。
• 修复其他已知问题。

第三方推送 SDK 兼容版本

V9.6.3 兼容的第三方推送 SDK 版本信息如下：

第三方推送	版本
华为	6.5.0.300
小米	5.1.0
OPPO	3.1.0
VIVO	3.0.0.4_484
魅族	4.1.0
FCM	firebase-bom:28.4.2，具体版本： firebase-messaging：23.0.0 firebase-analytics: 20.0.0

[9.6.2] - 2022-10-14

修复已知问题。

[9.6.1] - 2022-10-12

修复同步过程中去重失效，导致数据库可能存在多个相同消息的问题。

[9.6.0] - 2022-9-26

v 9.6.1 修复了 v9.6.0 可能导致数据库存在相同消息的问题。如果您的应用目前使用的是 v9.6.0，强烈建议您升级至 v9.6.1。

新增特性

序号	新增特性	特性描述	相关文档
1	@身份组	支持在圈组发送消息时@指定身份组	圈组消息收发
2	身份组自定义权限	支持通过服务端 API 为身份组添加自定义权限项，帮助开发者快速实现符合自身业务需求的权限管控能力	自定义权限

API 变更

API	API 说明	变更说明
sendMessage	在圈组的频道中发送消息	参数结构QChatSendMessageParam新增setMentionedRoleidList接口，用于发送圈组消息时@指定的身份组。@身份组需要拥有“@身份组”权限（MENTIONED_ROLE） 返回的消息体QChatMessage新增getMentionedRoleIdList接口，用于获取消息需要@的身份组
updateServerRole	修改服务器身份组	可配置的权限项新增“@身份组”（MENTIONED_ROLE）。拥有该权限的成员可在圈组发送消息时@指定身份组（最多10个） 定义身份组权限项的QChatRoleResource中新增自定义权限项（如果已通过服务端 API 创建） ，value 大于或等于 10000 的权限项即为自定义权限项
updateChannelRole	修改频道身份组	可配置的权限项新增“@身份组”（MENTIONED_ROLE）。拥有该权限的成员可在圈组发送消息时@指定身份组（最多10个） 定义身份组权限项的QChatRoleResource中新增自定义权限项（如果已通过服务端 API 创建） ，value 大于或等于 10000 的权限项即为自定义权限项
updateChannelCategoryRole	修改频道分组身份组	可配置的权限项新增“@身份组”（MENTIONED_ROLE）。拥有该权限的成员可在圈组发送消息时@指定身份组（最多10个） 定义身份组权限项的QChatRoleResource中新增自定义权限项（如果已通过服务端 API 创建） ，value 大于或等于 10000 的权限项即为自定义权限项
updateChannelCategoryMemberRole	修改频道分组的用户定制权限	可配置的权限项新增“@身份组”（MENTIONED_ROLE）。拥有该权限的成员可在圈组发送消息时@指定身份组（最多10个） 定义身份组权限项的QChatRoleResource中新增自定义权限项（如果已通过服务端 API 创建） ，value 大于或等于 10000 的权限项即为自定义权限项
updateMemberRole	修改（频道维度）的用户定制权限	可配置的权限项新增“@身份组”（MENTIONED_ROLE）。拥有该权限的成员可在圈组发送消息时@指定身份组（最多10个） 定义身份组权限项的QChatRoleResource中新增自定义权限项（如果已通过服务端 API 创建） ，value 大于或等于 10000 的权限项即为自定义权限项
checkPermission	查询自己是否拥有某个权限	支持查询自定义权限（如果已通过服务端 API 创建自定义权限）。QChatRoleResource中新增自定义权限项（如果已通过服务端 API 创建） ，value 大于或等于 10000 的权限项即为自定义权限项
checkPermissions	查询自己是否拥有某些权限	支持查询自定义权限（如果已通过服务端 API 创建自定义权限）。QChatRoleResource中新增自定义权限项（如果已通过服务端 API 创建） ，value 大于或等于 10000 的权限项即为自定义权限项
SDKOptions	SDK 的初始化配置	初始化配置参数中新增 recentContactContentSource，用于设置最近会话的消息内容来源。

优化

• 华为推送获取到的云信消息体 pushPayload 中新增 data 字段。
• 解决隐私合规问题。

[9.5.2] - 2022-9-7

修复断网场景下进行数据上报引起的崩溃问题。

[9.5.0] - 2022-8-29

升级必看

消息发送完成回调与状态实现顺序变更，即将sendMessage消息发送接口的回调触发，调整到了observeMessageStatus消息状态变化观察者回调触发之后。该变更优化了消息发送完成通知和消息发送状态修改的时序逻辑，具体为：

• 原逻辑：先通知消息发送完成，再修改消息发送状态。
• 新逻辑：先修改消息发送状态，再通知消息发送完成。

如果您的应用与该逻辑存在相关依赖，请进行相应调整。

新增特性

V9.5.0 的圈组模块新增搜索频道成员功能，具体请参见搜索服务器和频道。

优化

优化 LBS 策略。

新增 API

V9.5.0 的圈组模块引入了如下 API。

API	API 说明
searchChannelMembers	搜索频道成员

[9.4.0] - 2022-8-8

新增特性

V9.4.0 的圈组模块新增如下特性：

序号	新增特性	特性描述	相关文档
1	批量查询权限	支持查询自己是否拥有某些权限	查询自己是否拥有某些权限
2	以圈组服务器维度处理未读消息数	支持订阅服务器所有频道的消息，且支持清空服务器未读数	服务器未读数
3	搜索消息	支持分页搜索对用户可见的消息。您可通过subType参数进行相应的上层业务开发，实现消息可见性逻辑。支持配置该参数的 API，请参见下文的 API 变更说明	搜索消息

API 变更

V9.4.0 的圈组模块引入了如下新增 API 和 变更 API。

• 新增 API

API	API 说明
checkPermissions	查询自己是否圈组内的某些（圈组）权限
searchMsgByPage	分页搜索圈组消息
subscribeAllChannel	一次性订阅圈组服务器下最多 200 个频道。单次调用可传入的服务器 ID 数量上限为 10 个。即使多次调用，单个服务器下最多仅能订阅 200 个 频道
markRead	清空圈组服务器的未读数

• 变更 API

API	变更说明
sendMessage	QChatSendMessageParam新增subType入参，表示消息子类型。该参数可以用来做特殊渲染、可见性判断、动画效果展示等。例如，您可通过该参数开发相应的上层业务逻辑，实现发送消息时设置消息对其他用户的可见性
updateMessage	QChatUpdateMessageParam新增subType入参
observeReceiveMessage	返回的消息体QChatMessage新增subType参数
getMessageHistory	返回的消息体QChatMessage新增subType参数
observeMessageUpdate	返回的消息体QChatMessage新增subType参数
getMessageHistoryByIds	返回的消息体QChatMessage新增subType参数
getThreadMessages	返回的消息体QChatMessage新增subType参数
getLastMessageOfChannels	返回的消息体QChatMessage新增subType参数

第三方推送 SDK 兼容版本

V9.4.0 兼容的第三方推送 SDK 版本信息如下：

第三方推送	版本
华为	6.5.0.300
小米	4.5.0
OPPO	3.0.0
VIVO	3.0.0.4_484
魅族	4.1.0
FCM	firebase-bom:28.4.2，具体版本： firebase-messaging：23.0.0 firebase-analytics:20.0.0

[9.3.0] - 2022-7-25

新增特性

序号	新增特性	特性描述	相关文档
1	实时互动频道	圈组新增实时互动频道，用户可在实时互动频道进行音视频通话等音视频相关操作	实时互动频道
2	获取服务器未读数	获取服务器下所有频道的累加消息未读数	获取服务器未读数
3	圈组搜索结果自定义排序	搜索圈组服务器和频道的匹配结果，可按自定义排序	圈组搜索功能
4	下载消息附件	正常情况收到消息后附件会自动下载。如果下载失败，可调用 API 重新下载	下载附件
5	查询邀请/申请记录	查询服务器的邀请和申请记录，以及用户个人被邀请加入服务器和申请加入服务器的记录	查询申请/邀请的历史记录
6	生成邀请码	拥有“邀请他人加入服务器的权限”的用户可生成邀请码，其他用户可通过邀请码加入服务器	生成邀请码
7	通过邀请码加入服务器	获取到邀请码的用户，可通过邀请码加入服务器	通过邀请码加入服务器

优化

新增自动取消订阅逻辑：新增 频道对当前用户可见性变更 和 当前用户进入/退出服务器 内置系统通知类型。当收到前者时，如存在相应频道的订阅信息，则自动取消订阅该频道的请求。当收到后者（且为退出服务器）时，如存在相应服务器的订阅信息，则自动取消订阅该服务器以及该服务器下所有已订阅频道的请求。圈组订阅机制相关说明，请参见圈组订阅机制。

第三方推送兼容版本

华为推送兼容版本号更新为 6.5.0.300。

当前版本各第三方推送 SDK 的兼容版本信息如下：

第三方推送	版本
华为	6.5.0.300
小米	4.5.0
OPPO	3.0.0
VIVO	3.0.0.4_484
魅族	4.1.0
FCM	firebase-bom:28.4.2，具体版本： firebase-messaging：23.0.0 firebase-analytics:20.0.0

API 变更

新增 API

API	API 说明
generateInviteCode	生成邀请码
joinByInviteCode	通过邀请码加入服务器
getInviteApplyRecordOfServer	查询服务器下的申请记录和邀请记录
getInviteApplyRecordOfSelf	用户查询自己的申请记录和邀请记录
initialize	初始化实时互动频道模块
isInitialized	查询初始化状态
connect	连接实时互动频道
disConnect	取消连接实时互动频道
isConnected	查询当前连接状态
addRTCChannelListener	添加实时互动频道事件监听
removeRTCChannelListener	移除实时互动频道监听
unMuteAudio	打开成员音频
muteAudio	关闭成员音频
startScreenShare	开启本端屏幕共享
stopScreenShare	关闭本端屏幕共享
onMemberScreenShareStateChanged	成员屏幕共享状态回调
onMemberAudioMuteChanged	成员音频状态回调
onMemberVideoMuteChanged	成员视频状态回调
downloadAttachment	正常情况收到消息后附件会自动下载。如果下载失败，可调用该方法重新下载
observeServerUnreadInfoChanged	注册/注销服务器未读通知接收观察者

变更 API

API	变更说明
inviteServerMembers	入参新增ttl（可选），表示加入服务器邀请的有效时长。回参新增requestId和expireTime，分别表示邀请的标识和邀请的到期时间戳
applyServerJoin	入参新增ttl（可选），表示加入服务器申请的有效时长。回参新增requestId和expireTime，分别表示申请的标识和申请的到期时间戳
acceptServerApply	新增requestId入参（必传），表示加入服务器申请的标识
rejectServerApply	新增requestId入参（必传），表示加入服务器申请的标识
acceptServerInvite	新增requestId入参（必传），表示加入服务器邀请的标识
rejectServerInvite	新增requestId入参（必传），表示加入服务器邀请的标识
createChannel	可创建的频道类型枚举QChatChannelType增加枚举值RTCChannel，表示实时互动频道。
updateServerRole	可修改的服务器身份组权限QChatRoleResource新增实时互动相关权限、邀请申请管理权限和邀请申请历史记录查看权限
updateChannelRole	可修改的频道身份组权限新增实时互动频道相关权限
updateChannelRole	可修改的频道身份组权限新增实时互动频道相关权限
updateMemberRole	可修改的个人定制权限新增实时互动频道相关权限
updateChannelCategoryRole	可修改的个人定制权限新增实时互动频道相关权限
updateChannelCategoryMemberRole	可修改的频道分组维度的个人定制权限新增实时互动频道相关权限
searchServerByPage	新增入参sort，表示频道的排序条件
searchChannelByPage	新增入参sort，表示频道的排序条件

[9.2.8] - 2022-7-1

优化自动重连机制，实现国内外节点平滑迁移。

[9.2.5] - 2022-6-13

该版本在圈组模块增加了圈组系统通知的类型。

相关模块	新增特性	相关文档
圈组系统通知	1. 新增以下 5 种圈组系统通知类型： 加入服务器身份组成员 移除服务器身份组成员 更新服务器身份组权限 更新频道身份组权限 更新频道个人定制权限 具体可查看 QChatSystemNotificationType 2. 对应新增 5 种圈组系统通知附件结构类型，具体可查看QChatSystemNotificationAttachment	系统通知

[9.2.1] - 2022-5-26

解决NIMClient.config方法极低概率下会获取设备当前进程的问题。

[9.2.0] - 2022-5-24

该版本在圈组模块增加了频道分组、消息正在输入状态显示和搜索功能等更新。

NIM SDK v9.2.1 版本修复了 v9.2.0 版本中NIMClient.config方法有概率获取设备当前进程的问题。如您当前使用的是 v9.2.0 版本，强烈建议您升级至 v9.2.1。

新增特性

序号	新增特性	特性描述	相关文档
1	频道分组	支持对频道进行分组管理	频道分组
2	频道分组黑白名单	支持为频道分组设置黑白名单成员/身份组，与频道类型（私密/公开）共同判定频道分组是否对用户可见	频道分组黑白名单
3	频道分组身份组	支持在频道分组维度设置身份组和定制权限，增加用户权限控制的层级	频道分组身份组
4	消息正在输入	支持显示频道消息正在输入	消息正在输入
5	圈组搜索功能	支持通过关键字对服务器、频道和服务器成员进行搜索	圈组搜索功能
6	频道分组推送配置	支持在频道分组层级配置推送	推送管理

API 变更

新增 API

API	API 说明
createChannelCategory	创建频道分组
deleteChannelCategory	删除频道分组
updateChannelCategory	修改频道分组信息
getChannelCategories	查询频道分组
getChannelCategoriesByPage	分页查询服务器下的频道分组列表
getChannelsInCategoryByPage	分页查询频道分组下频道列表
addChannelCategoryRole	创建频道分组身份组
removeChannelCategoryRole	删除频道分组身份组
updateChannelCategoryRole	更新频道分组身份组。设置频道分组身份组的权限，需调用该方法
getChannelCategoryRoles	查询频道分组身份组信息
addChannelCategoryMemberRole	创建频道分组某人的定制权限
removeChannelCategoryMemberRole	删除频道分组某人的定制权限
updateChannelCategoryMemberRole	修改频道分组某人的定制权限。
getChannelCategoryMemberRoles	查询频道分组某人的定制权限
updateChannelCategoryBlackWhiteRoles	更新频道分组黑白名单身份组
getChannelCategoryBlackWhiteRolesByPage	分页查询频道分组黑白名单身份组列表
updateChannelCategoryBlackWhiteMembers	更新频道分组黑白名单成员
getChannelCategoryBlackWhiteMembersByPage	分页查询频道分组黑白名单成员列表
getExistingChannelCategoryBlackWhiteRoles	批量查询频道分组黑白名单身份组列表
getExistingChannelCategoryBlackWhiteMembers	批量查询频道分组黑白名单成员列表
observeReceiveTypingEvent	监听正在输入事件
sendTypingEvent	发送正在输入事件
searchServerByPage	分页搜索服务器
searchServerMemberByPage	分页搜索服务器成员
searchChannelByPage	分页搜索频道
updateUserChannelCategoryPushConfig	更新用户频道分组推送配置
getUserChannelCategoryPushConfigs	获取用户频道分组推送配置列表

变更 API

API	变更说明
createChannel	新增categoryId和syncMode参数，调用时传入categoryId可将频道加入某个频道分组；通过设置syncMode，可实现频道数据与频道分组数据的同步。具体同步的数据包括查看模式（私密或公开）、黑白名单和身份组权限。
updateChannel	同上

[9.1.1] - 2022-4-14

修复了 Gradle 集成时提示 R 文件重复导致的不能打包的问题。

[9.1.0] - 2022-4-11

如您当前使用 9.1.0 版本的 SDK，强烈建议您将其升级至 9.1.1 版本。 9.1.1 版本修复了 9.1.0 版本中存在的打包报错问题。

新增特性

• 圈组相关更新：
  • 当用户在服务器维度没有“管理角色”权限，但在频道维度有该权限时，可在 getServerRoles方法的 QChatGetServerRolesParam 中传入 channelId 参数查询整个服务器的身份组列表，以便对频道进行权限添加。相关详情请参见查询某服务器下身份组列表。
  • 新增封禁用户功能。
    • 创建或更新身份组时可配置 BAN_SERVER_MEMBER() 参数为身份组成员授予封禁其他成员的权限。相关详情请参见创建服务器身份组。
    • 拥有封禁其他成员权限的服务器成员可封禁或解封其他成员。相关方法调用详情请参见封禁服务器成员、解禁服务器成员和分页查询服务器封禁成员列表。
  • 新增 Thread 聊天和快捷评论功能。相关方法调用详情请参见消息扩展。
  • 新增圈组反垃圾功能。
    • 支持通过 getAntiSpamOption() 获取消息反垃圾选项，通过getAntiSpamOption() 获取消息反垃圾结果（仅对文本和图片有效）。相关调用详情请参见消息管理。
    • 支持为服务器、频道和身份组的创建和更新操作配置反垃圾QChatAntiSpamConfig。
  • 更新圈组推送逻辑。新的推送逻辑详情请参见圈组推送。相关的方法调用请参见更新服务器推送配置 、更新频道推送配置和推送管理。
  • 支持在 IM SDK 初始化时配置消息缓存。相关详情请参见初始化配置参数的 enabledQChatMessageCache 参数说明。
• 各厂家推送兼容更新：
  • 兼容 Vivo push SDK v3.0.0.4_484 且兼容 Android v12.0.0。
  • 兼容 OPPO PUSH SDK v3.0.0。
  • 兼容华为推送 SDK v6.3.0.302。
• 其他更新：
  • 新增未读相关操作按会话类型分类的能力。 可通过 sessiontype 获取指定会话类型的总未读数、清除未读数。

改进优化

• 修复了终端用户开启消息漫游后在不同手机登录时收到的消息发送结果不一致的问题（一台手机上显示消息发送成功，另一台上显示消息发送失败）。
• 其他问题修复及优化。

[9.0.1] - 2022-3-10

修复

修复因圈组 SDK bug 导致的成员管理界面的成员头像显示不全的问题。

优化

优化消息未读数更新逻辑：

• 如果 isHistoryEnable 或 isNeedBadge 为 false，消息未读数不更新。
• 删除未读消息时更新未读数，且同步更新 mentionedCount。
• 删除已读消息时不更新未读数。
• 自己的消息不更新未读数。

[9.0.0] - 2022-2-24

新增

1. 网易云信即时通讯服务全新能力“圈组”发布。相关功能介绍和开发集成请分别参见什么是圈组和圈组接入流程。

[8.11.1] - 2022-1-17

修复

1. 修复推送被异常关闭问题

[8.11.0] - 2022-1-10

如果您当前使用的是 8.11.0 版本的 SDK，强烈推荐您将 SDK 版本升级到 8.11.1 或以上版本。8.11.1 版本修复了 8.11.0 版本中存在的推送异常关闭问题。该问题具体为：融合存储关闭后，Android 系统推送开启与否都无法推送成功。

新增

1. 支持聊天室空间消息功能。进入聊天室和发送聊天室消息支持配置x, y, z坐标,支持坐标位置实时更新
2. 支持聊天室定向消息功能。发送聊天室消息支持消息接受者列表
3. 支持聊天室标签实时更新
4. 匿名聊天室和独立聊天室支持第三方token鉴权
5. 支持业务反垃圾。涉及进入聊天室、更新我的用户资料、创建群、更新群信息、更新超大群信息、更新聊天室信息和更新我的聊天室资料

修复

1. 修复注销异常导致导致上次的数据库没有关闭问题
2. 修改被踢出后又自动登录问题

[8.10.0] - 2021-12-23

新增

1. 支持aws s3存储

修复

1. 修复历史消息可能再次漫游下发问题
2. 修改部分异常场景下错误日志记录崩溃问题

变更

1. SDK最低支持android 5.0

[8.9.0] - 2021-12-03

新增

1. 支持自定义配置在线通知的通道
2. 获取到离线推送token的统一回调
3. 最大支持好友数至1万
4. 适配 Android 12 PendingIntent

变更

1. FCS推送升级，firebase:28.4.2 (firebase-messaging:23.0.0, firebase-analytics:20.0.0)

[8.8.0] - 2021-10-28

新增

1. 支持批量添加聊天室队列元素（由服务端发起）
2. 增加全文云端消息检索（按消息时间排序）接口

修复

1. 修复连续开启推送报错的问题

[8.7.2] - 2021-09-27

变更

1. Android9之后版本避免getRunningAppProcesses调用

[8.7.0] - 2021-08-25

新增

1. 支持聊天室撤回消息（撤回动作由服务端发起）
2. 聊天室加入或者更新队列元素时，支持配置队列元素所属账号
3. 支持分页获取最近会话列表
4. 消息体新增易盾反垃圾扩展字段yidunAntiSpamExt和结果字段yidunAntiSpamRes，具体参见消息重要参数。

变更

1. 小米推送版本升级至4.5.0
2. 魅族推送版本升级至4.1.0

修复

1. 修复MixPushService的enable接口异常情况下可能没有回调问题
2. 修复Https使用了不安全的HostNameVerifier导致在Google play无法上架问题、
3. 修复后台频繁获取正在运行应用信息问题

[8.6.2] - 2021-08-06

修复

1. 提高上传文件时SDK的稳定性
2. 修复删除不需要未读的消息时未读数也减少的问题

[8.6.1] - 2021-07-27

新增

1. 支持FCM推送配置自定义字段fcmField
2. 支持根据免打扰状态获取总未读数
3. 发消息支持设置第二段等待时间

变更

1. 支持通过token的获取情况选择推送渠道
2. 华为推送升级5.3.0.304
3. Vivo升级3.0.0

修复

1. 修复退出登录时会取消所有Job的问题，修复后只会取消云信SDK的Job
2. 修复频控场景下，频控包被转为心跳包的问题
3. 修复Android11上没有电话权限导致发送文件失败的问题
4. 修复批量删除消息不成功的问题
5. 修复未读情况下撤回他人消息时，未读数不变更的问题

[8.5.0] - 2021-06-22

新增

1. 支持云端历史消息全文检索
2. 本地检索功能就单会话检索和全局检索分别新增支持更多种配置项的接口
3. 查询指定群消息的已读回执，支持指定群成员列表

变更

1. 支持撤回自己给自己发送的消息

修复

1. 修复通过openLocalCache初始化数据库时，绕开了部分本地缓存初始化步骤的问题

[8.4.6] - 2021-06-02

变更

1. 提升高可用服务稳定性
2. 录音时不再强制检测存储权限
3. 打印日志时如果日志模块尚未初始化，不再直接抛出异常

[8.4.0] - 2021-04-29

新增

1. 创建会话支持配置是否通过消息数据库设置最后一条消息
2. 支持从本地数据库查询群已读回执内容
3. 聊天室设置标签标志加入聊天室及按标签发送消息、查询成员详情及总数、禁言能力
4. 支持通过设置过滤器来调控收到撤回通知时否弹出通知栏
5. 登录抄送新增SDK外部版本号

变更

1. 前面版本覆盖安装当前版本，可以正常自动登录
2. 批量删除本地消息和批量单向删除消息会更新未读数
3. 通知栏合并方式为按会话折叠或全部不折叠时收到已读ack，清理对应会话的通知栏

修复

1. 修复更新消息状态时，附件包含单引号就会失败的问题

2. 删除本地会话配置sendAck标记除了发送ack告诉其他端已读外，本端也设置消息已读

   注意：未读数变化后会触发observeRecentContact回调，并且不保证和删除回调之间的时序，8.5.0起不再触发observeRecentContact回调

[8.3.1] - 2021-03-22

变更

1. 提高SDK稳定性
2. 优化缺省lbs生成规则

修复

1. SDK初始化对httpdns访问过于频繁的问题

注意

1. 不使用IMEI作为deviceID，从8.0.1及以下升级到此版本及以后会产生deviceID的变更，导致第一次自动登录失败。8.4.0起不再受此限制，可以顺畅自动登录

[8.3.0] - 2021-03-03

变更

1. 清空未读数接口clearUnreadCount支持接收ack请求结果的回调
2. 支持通过配置LoginInfo进行动态登录

注意

1. 不使用IMEI作为deviceID，从8.0.1及以下升级到此版本及以后会产生deviceID的变更，导致第一次自动登录失败。8.4.0起不再受此限制，可以顺畅自动登录

[8.2.5] - 2021-02-04

变更

1. 完善域名高可用策略，提升服务稳定性
2. 点击通知栏支持回调字符串，修改NotificationExtraTypeEnum#notificationExtraType的默认值为MESSAGE。如果本来没有显式配置此参数，8.2.0及之后的版本升级到当前版本需要显式配置此参数为JSON_ARR_STR，来维持原有逻辑。**8.2.0之前（不含）**的版本不需要做额外工作来维持原有逻辑

注意

1. 不使用IMEI作为deviceID，从8.0.1及以下升级到此版本及以后会产生deviceID的变更，导致第一次自动登录失败。8.4.0起不再受此限制，可以顺畅自动登录

[8.2.2] - 2021-01-19

新增

1. 数据库新增恢复能力

变更

1. 优化前后台切换逻辑，减少卡顿
2. 根据手机品牌的不同优化前台进程被杀死的处理逻辑

注意

1. 不使用IMEI作为deviceID，从8.0.1及以下升级到此版本及以后会产生deviceID的变更，导致第一次自动登录失败。8.4.0起不再受此限制，可以顺畅自动登录

[8.2.0] - 2020-12-30

新增

1. 支持批量查询群组信息
2. OnePlus和RealMe手机支持通过OPPO推送下发消息推送
3. 删除会话支持配置删除范围
4. 撤回消息支持扩展字段
5. 点击通知栏支持回调字符串，维持原有逻辑，需要配置NotificationExtraTypeEnum#notificationExtraType为MESSAGE
6. 不使用IMEI作为deviceID，从8.0.1及以下升级到此版本及以后会产生deviceID的变更，导致第一次自动登录失败

注意

1. 不使用IMEI作为deviceID，从8.0.1及以下升级到此版本及以后会产生deviceID的变更，导致第一次自动登录失败。8.4.0起不再受此限制，可以顺畅自动登录

[8.1.3] - 2020-11-27

新增

1. 支持批量清除会话的未读数

变更

1. 小米推送升级3.8.5

注意

1. 不使用IMEI作为deviceID，从8.0.1及以下升级到此版本及以后会产生deviceID的变更，导致第一次自动登录失败。8.4.0起不再受此限制，可以顺畅自动登录

[8.1.0] - 2020-11-13

新增

1. NOS下载支持独立CDN域名配置
2. NOS下载域名加速支持多域名配置
3. 聊天室支持CDN消息机制

注意

1. 不使用IMEI作为deviceID，从8.0.1及以下升级到此版本及以后会产生deviceID的变更，导致第一次自动登录失败。8.4.0起不再受此限制，可以顺畅自动登录

[8.0.1] - 2020-10-23

变更

1. 华为推送兼容性配置中的action配置内容调整
2. 数据库加密库Sqlcipher升级3.5.9
3. 支持注册初始化状态监听

[8.0.0] - 2020-9-28

新增

1. 数据库支持加密，通过初始化配置参数中的databaseEncryptKey参数控制。StatusCode增加一个新状态值DATA_UPGRADE，表明当前数据库需要迁移到加密状态。
2. 单向删除消息支持删除单条、多条、和会话，同时支持多端同步
3. 撤回消息支持配置附言
4. 云端最近会话最后一条消息增加撤回通知类型
5. 拉取云端消息支持配置过滤规则
6. Oppo推送升级2.1.0
7. 魅族推送升级3.9.7

变更

1. 'SDK集成'时需要在AndroidManifest.xml中增加PreferenceContentProvider的声明。

[7.8.1] - 2020-7-29

新增

1. 获取聊天室成员列表支持按进入时间排序，MemberQueryType新增GUEST_DESC和GUEST_ASC，API

[7.8.0] -2020-7-21

新增

1. 登录可配置自定义客户端类型，用于自定义互踢功能
2. 支持为消息配置子类型
3. 华为推送升级4.0.4.301
4. 删除单条消息支持配置是否记录操作

变更

1. 调整断网重连的退避策略，加快重连节奏
2. 私有化环境更新时更新nos缓存

[7.7.2] -2020-6-12

新增

1. IM和聊天室消息体新增易盾反垃圾字段
2. Android 8.0 起，SDK调用startForeground均会有通知栏提示

[7.7.0] -2020-5-27

新增

1. IMMessage新增getCallbackExtension()函数，获取第三方回调自定义扩展字段
2. StatusCode新增描述字段，服务端踢人如果附加描述，可以通过此字段获取

[7.6.0] -2020-5-13

新增

1. 消息回复
2. 快捷评论
3. 收藏
4. 消息PIN
5. 会话置顶
6. 主动上传日志消息
7. 自定义通知回调按到达顺序

变更

1. 未接通的音视频通话话单通知存离线，漫游和云端历史

[7.4.0] -2020-3-9

新增

1. 消息单向删除
2. 撤回消息支持配置撤回通知是否算未读
3. 清空本地会话消息支持配置是否记录此次清除操作
4. 拉取云端消息支持配置是否忽略清除记录

变更

1. 提升强推的优先级，免打扰对强推无效
2. 对于离线情况下被推送过的消息，在线时不会触发消息提醒通知栏

修复

1. 修复按会话合并通知栏时，只有第一栏有点击事件的问题

[7.2.0] -2020-1-13

新增

1. 超大群增加功能
2. 通过关键字搜索云端消息
3. 本地反查群ID、用户账号
4. 单向撤回
5. 按类型获取云端历史消息支持入库
6. 推送版本升级
7. 通知栏支持按会话合并

变更

1. 用户拉取云端消息时，被本地删除或者清除的消息会被过滤掉

修复

1. 修复阿拉伯语下，未读数更新异常的问题
2. 修复observeMemberRemove回调多次的问题

[7.0.3] -2019-12-4

新增

1. 新增nos token过期自动更新逻辑
2. 优化通知栏昵称显示

[7.0.0] -2019-11-13

新增

1. 不显示推送详情时，可自定义离线推送的文案
2. 暴露消息的服务端id
3. 会话列表获取服务
4. 插入本地消息支持设置发送方
5. 本地历史消息自定义消息字段支持搜索

[6.9.1] -2019-9-24

新增

1. SDK适配Android Q

变更

1. 升级FCM推送版本

[6.9.0] -2019-9-17

新增

1. 改用AndroidX支持库。升级Target API到28，不再支持support库
2. 超大群优化
3. 握手协议升级替换
4. IM日志上报。在408，415，500时记录；
5. 批量获取音视频通话信息
6. 支持会话新增少量获取会话
7. NOS文件优化
8. 拉日志支持独立聊天室模式
9. 内置通知栏提醒响铃及振动
10. 聊天室支持独立配置

[6.7.0] -2019-8-1

新增

1. 未接通的音视频通话消息统一计入未读数

2. 超大群Demo和UIKit适配

3. 新增接口，获取每个会话的最近一条非过滤消息

4. 高级群与超大群入群通知消息中，支持获取用户资料

5. 客户端反垃圾词库配置，特殊支持识别检测

6. oppo推送接入

[6.6.6] -2019-7-10

新增

1. 根据时间范围批量删除本地历史消息

[6.5.5] -2019-6-12

新增

1. 新增超大群功能

[6.5.0] -2019-5-24

新增

1. AOS设置免打扰时间段，支持配置消息推送是否显示通知栏

2. SDK提供方法查询群成员是由谁邀请入群 TeamService#getMemberInvitor

修复

1. 修复重复注册观察者

2. 魅族系统权限问题

[6.3.0] -2019-4-18

新增

1. vivo推送支持

2. 清空点对点历史消息 MsgService#clearServerHistory

3. 删除好友同时删除备注信息 FriendService#deleteFriend

4. UI唤醒添加开关

修复

1. 推送通知栏跳转报错，无法跳转到app

变更

1. Demo下线波特机器人

[6.2.0] -2019-3-14

新增

1. 音视频话单消息携带发起呼叫的扩展字段 AVChatAttachment#getExtendMessage

2. 增加群成员信息同步完成通知 AuthServiceObserver#observeLoginSyncTeamMembersCompleteResult

3. 音视频话单消息支持漫游及历史

修复

1. 音视频话单消息状态统一

2. 删除会话后，被移出群，或者群被解散 ，收到群组通知，重构该会话并通知

[6.1.1] -2019-1-29

修复

1. 小米手机App内推送有时不展示的问题

[6.1.0] -2019-1-22

新增

1. 支持本地消息牵移：MsgService#exportAllMessage 、MsgService#importAllMessage

2. 支持带文件附件类型消息取消发送：MsgService#cancelUploadAttachment

3. 撤回消息通知区分漫游与同步：RevokeMsgNotification#getNotificationType

4. 撤回消息读取服务端设置的msg 字段 ： RevokeMsgNotification#getCustomInfo

5. 拉人入群支持设置“邀请附言”和“自定义扩展字段” ：TeamService#addMembersEx

修复

1. App推送通知栏撤回消息bug

2. 更正 App推送免打扰通知channel的设置

3. 修复短时间内收到大量App内通知的bug

[5.9.0] -2018-11-28

新增

1. 创建群时指定人数上限：TeamFieldEnum#MaxMemberCount

2. 指定消息撤回时是否要App内的推送通知：NIMClient#toggleRevokeMessageNotification

3. 指定消息撤回时是否要三方推送 ： MsgService#revokeMessageEx

4. 音视频信令系统

变更

1. 音视频通话的话单通知时间放到通话结束时

[5.7.0] -2018-10-11

新增

1. 不发消息，创建一个会话项：MsgService#createEmptyRecentContact

2. 查询单个会话：MsgService#queryRecentContact

3. 文件上传默认支持秒传

4. 聊天室批量更新元素：ChatRoomService#batchUpdateQueue

5. 登录增加自定义字段：SDKOptions#loginCustomTag

6. 更新NosTokenSceneConfig配置 ：NIMClient#updateTokenSceneConfig()

修复

1. 在8.0 及以上的系统 ，StatusBarNotificationConfig ring/vibrate 不起作用

2. 不活跃聊天室重复登录收不到消息

[5.6.1] - 2018-9-13

变更

1. 修复群组成员数量不对的问题

2. 删除uikit中的avchat jar 包

3. 删除sdk清单文件中关于第三方推送的配置

4. 修复反垃圾词典校验时空指针的异常

5. 兼容IMMessage fromAccount为空的场景

6. 修复VideoAction序列化问题

[5.5.0] - 2018-8-7

新增

1. NOS场景配置

2. 发送消息时可以指定 NOS 场景

3. 上传文件时可以指定 NOS 场景

[5.3.0] - 2018-06-26

新增

1. 好友信息设置添加仅供服务器设置的扩展字段

[5.1.1] - 2018-05-21

变更

1. 解决在独立使用 basesdk.jar 不依赖 push.jar 时，登录返回 500 的问题。

[5.1.0] - 2018-05-17

新增

1. 华为推送升级到 2.6.0 版本，小米推送升级到 3.6.2 版本。

2. 端内推送支持撤回消息时未读数减一，配置接口：SDKOptions#shouldConsiderRevokedMessageUnreadCount

3. 发送消息时可以配置是否离线：配置接口：CustomMessageConfig#enablePersist

4. 从服务器拉取消息历史记录，可以指定查询的消息类型：MsgService#pullMessageHistoryExType

5. 第三方推送模块独立，输出 push.jar，开发者按需使用

[5.0.0] - 2018-03-29

新增

1. 添加群组已读功能，新增接口:

• TeamService#sendTeamMessageReceipt: (消息接收方)发送群消息已读回执
• TeamService#refreshTeamMessageReceipt: (消息发送方)刷新群消息已读未读数量
• TeamService#fetchTeamMessageReceiptDetail: (消息发送方)获取群消息已读未读账号列表
• MsgServiceObserve#observeTeamMessageReceipt: (消息发送方)监听群消息已读未读数量变更
• IMMessage#setMsgAck: (消息发送方)构造需要已读回执的消息

2. 群组整体禁言: TeamService#muteAllTeamMember。

3. 添加客户端反垃圾功能：MsgService#checkLocalAntiSpam。

4. 添加日志导出接口: MiscService#zipLogs。

5. 添加客户端删除缓存接口:

• MiscService#getSizeOfDirCache : 获取缓存大小
• MiscService#clearDirCache : 删除缓存

6. 添加聊天室高优先级消息判断接口：ChatRoomMessage#isHighPriorityMessage。

7. 添加在任意位置初始化 SDK 的接口:

• NIMClient#config, 在Application#onCreate()中配置SDK（仅仅是配置，不影响性能）
• NIMClient#initSDK, 在UI进程主线程上按需使用的初始化SDK

8. 匿名推送功能: MixPushService#setPushShowNoDetail。

[4.8.0] - 2018-02-08

新增

1. 对于已经接了易盾的应用，支持配置某条消息是否过易盾反垃圾。

2. 新增批量导入最近会话接口。

变更

1. 修复下载图片、视频等拼接 url 参数的问题。

2. 升级小米推送SDK至 3.6.0，升级华为推送SDK至 2.5.3.302。

3. 修复其他已知问题。

[4.6.0] - 2018-01-04

新增

1. 易盾反垃圾支持对单条消息配置对应的反垃圾业务规则。

2. 新增支持海外推送 FCM 以及魅族推送。

3. 支持配置聊天室队列管理权限。

4. 支持群管理员撤销其他人消息。

5. 支持视频消息获取远程缩略图 url。

6. 聊天室历史记录拉取可按类型筛选。

变更

1. 修复酷派偶现崩溃问题。

2. 接口变更：

javaList<NimRobotInfo> getRobotInfo(List<String> accounts);

改为

javaList<NimRobotInfo> getRobotInfoList(List<String> accounts);

3. MessageNotifierCustomization 新增消息撤回通知文案自定义接口:

java/**
 * 定制消息撤回提醒文案
 * @param revokeAccount 撤回操作者账号
 * @param item 被撤回的消息
 * @return
 */
String makeRevokeMsgTip(String revokeAccount, IMMessage item);

4. ChatRoomPartClearAttachment 附件内容变更

• getContentMap() 返回由 Map<String,Object> 变为 Map<String, String>

• getChatRoomQueueChangeType() 返回 ChatRoomQueueChangeType.PARTCLEAR

[4.4.0] - 2017-11-16

新增

1. 添加聊天室用户异常掉线或主动退出的时候自动清除队列：ChatRoomService#updateQueueEx。影响类和接口：

• 添加通知类型：NotificationType#CHATROOM_QUEUE_BATCH_CHANGE，表示队列批量变更。
• 添加附件类型：ChatRoomPartClearAttachment，包含清除队列的内容。

2. NOS 资源下载添加 CDN 支持，添加两种可配置模板，见 SDKOptions#ServerAddress#nosAccess。

3. 适配 Android O 版本通知栏，增加云信即时消息通道、消息免打扰通道，解决 target 指向26 通知栏无法弹出的问题。

4. 适配 Android O 版本后台运行机制，开发者请务必在清单文件里面配置:

java    <service android:name="com.netease.nimlib.service.ResponseService" />

5. 适配 Android O+ 版本，解决 target 指向27 InvalidKeySpecException 导致的 SDK 无法登陆的问题。

6. 添加新的 IPC 数据共享机制，替换不安全的多进程读写 SharedPreference，开发者请务必在清单文件里配置:

java    <provider
        android:name="com.netease.nimlib.ipc.NIMContentProvider"
        android:authorities="{APP包名}.ipc.provider"
        android:exported="false"
        android:process=":core" />

7. 添加 SDKOptions#asyncInitSDK 支持异步 SDK 初始化，降低 Application#onCreate 中 SDK 初始化函数的同步响应时间。

8. 添加 SDKOptions#reducedIM 支持弱 IM 场景。如果您的APP 仅在部分场景按需使用 IM 能力(不需要在应用启动时就做自动登录)，并不需要保证消息通知、数据的实时性，那么这里可以填 true。弱 IM 场景下，push 进程采用懒启动策略(延迟到用户登录阶段)，启动后其生命周期将跟随 UI 进程，降低弱 IM 场景的APP的后台功耗开销。

9. 添加 SDKOptions.checkManifestConfig，自动检查 SDK 配置是否完全，如果不完全将抛出异常提示。强烈建议开发者在开发阶段开启检查，检查通过后，线上环境关闭。

10. API 调用框架增强：

• 支持带 Looper 的非UI线程发起的异步API调用，直接回调到调用者线程。老版本会默认回调到 UI 线程。
• 提供异步强制转成同步的接口：NIMClient#syncRequest,允许设置最大同步等待时间，支持非 UI 线程里需要同步调用云信 API的场景。
• 添加自动生成的 NIMSDK类，开发者可以直接采用 NIMSDK#getXXXService 方法获取服务接口，不再需要传递 XXXService.class，简化 API 调用方式。其他插件自动生成的调用入口类为：NIMChatRoomSDK、NIMLuceneSDK。例如采用 NIMSDK.getAuthService().login() 替换NIMClient.getService(AuthService.class).login()。

11. 添加 NIMClient#getSDKVersion 接口，运行时获取当前集成的 SDK 版本号。

变更

1. 类变更：com.netease.nimlib.sdk.uinfo.UserInfoProvider#UserInfo 包名变更为 com.netease.nimlib.sdk.uinfo.model.UserInfo，开发者升级到此版本时，请统一修改 UserInfo import 的包名。

2. 类成员函数变更：UserInfoProvider 移除 getDefaultIconResId、getAvatarForMessageNotifier、getTeamIcon 三个函数，统一替换为新增的函数，根据会话类型、会话ID返回消息提醒需要的头像位图：getAvatarForMessageNotifier(sessionType, sessionId)，请参考最新 Demo 源码中 NimUserInfoProvider 类中提供的替换方案。

3. 添加 NIMUitl#isMainProcess 接口，保证 SDK 初始化及 APP 初始化进程判断方式统一，请开发者替换 Application#onCreate 中主进程判断方法为此方法。

4. 移除 SDKOptions#enableSDKBackgroundReconnectStrategy 后台自动重连开关，请采用弱 IM 模式替换。

5. 修复 Push 进程自动登录被踢出后，部分机器进程被系统反复调度重启时依然发起连接的问题。

6. 针对 SDKOptions#sdkStorageRootPath 配置的外置存储缓存根目录，如果开发者配置在 Context#getExternalCacheDir 及 Context#getExternalFilesDir 等应用扩展存储缓存目录下（即/sdcard/Android/data/{package}），SDK 内部将不再检查写权限。值得注意的是，改缓存目录下的的文件会随着App卸载而被删除，也可以由用户手动在设置界面里面清除。

7. 优化唤醒策略，减少不必要的唤醒。优化 Push 进程无法唤醒 UI 时将采用的 “自杀机制”，先切断所有唤醒路径后再安全退出。

8. 修复匿名聊天室断网重连过程中如果出现回调 1001 的错误码时(SDK无法通过回调获取聊天室ip)时，SDK 无法继续重连的问题。

9. 修复聊天室调用 ChatRoomSerivce#updateMyRoomRole 后，在断网重连过程中，丢失角色信息更新的问题。

[4.3.0] - 2017-10-12

新增

1. 添加聊天室独立登录模式：EnterChatRoomData#setIndependentMode。

2. 添加批量清空所有会话未读数接口：MsgService#clearAllUnreadCount。

3. 添加支持多类型的本地消息历史搜索接口：MsgService#queryMessageListByTypes。

4. 添加大群清理逻辑。

5. 添加全员广播消息，通过注册观察者接口接收广播消息：MsgServiceObserve#observeBroadcastMessage。

6. 群消息支持 "只接收管理员消息提醒" 的免打扰选项。影响类和接口：

• 添加枚举类型：TeamMessageNotifyTypeEnum，用于表示群消息提醒类型，包含全部提醒、仅管理员提醒、全部不提醒。
• 变更接口：TeamService#muteTeam，参数类型从 boolean 更改为 TeamMessageNotifyTypeEnum。
• 添加方法：Team#getMessageNotifyType，此外 Team#mute 方法废弃。

7. 添加动图缩略图下载选项：SDKOptions#animatedImageThumbnailEnabled，支持下载原图或者第一帧图像(默认)。

8. 添加聊天室获取机器人列表接口：ChatRoomService#pullAllRobots。

9. 添加后台自动断网重连策略可选开关 SDKOptions#enableSDKBackgroundReconnectStrategy。

[4.2.0] - 2017-09-12

新增

1. 添加聊天室 bot 机器人功能，添加机器人上行消息构建接口：ChatRoomMessageBuilder#createRobotMessage。

2. 登录选项添加群通知消息是否计入未读数开关：SDKOptions#teamNotificationMessageMarkUnread。

变更

1. 对单个用户所在群的数量添加限制，影响到接口：

• TeamService#createTeam， 返回结果CreateTeamResult，包含邀请失败账号列表
• TeamService#addMembers， 返回结果 List，即邀请失败账号列表

如果邀请成员中有群数量超过限制，返回码仍然是成功，并且同时返回这部分超限的账号。

2. 解决登录偶现登录 417 问题。

3. 添加登录同步失败情况处理。

4. 添加 IPC ACK 机制，解决极端情况下群消息丢失的问题。

5. 解决 HttpDownload 安全警告问题。

[4.1.0] - 2017-08-08

新增

1. SDK 发送群自定义通知支持离线。

2. 多端登录客户端类型 ClientType 添加 Mac 端。

变更

1. SDK 后台运行机制调整，避免由于系统后台限制导致 push 进程消息队列无法消化引发的各种问题，减少不必要的系统资源开销。

2. 针对系统 Binder 状态异常导致 IPC 无法建立的问题，添加重置机制。

3. 华为推送添加通知栏清理回调接口 MixPushMessageHandler#cleanHuaWeiNotifications，开发者可自行决定通知栏的清除行为。

4. SDK 唤醒方式调整以适配即将发布的 Android O 版本，强烈建议开发者在清单配置文件中加上 项，具体配置信息请参考开发者文档。

5. NOS https 上传资源过程中如果发生证书认证失败，将切换成默认域名进行上传。

6. SDK 切换 LBS Link 地址时机调整，当从未登录成功时，采用前台策略。

[4.0.0] - 2017-07-06

新增

1. 接入华为推送服务。

2. 接入网易Bot(智能机器人)功能，增加 RobotService 、RobotServiceObserve 接口。

3. 新增聊天室发消息是否存历史记录的开关，发送聊天室消息时可以选择是否存入历史记录。

4. 聊天室连麦队列变更后数据同步。

变更

1. 被叫语音、视频通话未接听计入未读数。

2. 修复接收聊天室 tip 消息获取 content 为空的问题。

[3.9.0] - 2017-06-23

变更

1. 添加 NOS 请求频率控制。

2. 断网重连策略调整，修复 APP 长时间在后台网络受限，回到前台无法立即重连的问题。

[3.8.0] - 2017-06-06

新增

1. 聊天室针对固定成员，支持 nick, avatar 和 extension 字段的持久化。

变更

1. 针对 oppo 手机 IPC 异常问题添加容错处理。

2. 修复全文检索偶现的 InternalError 问题。

3. 针对解包出错的极端情况添加容错处理。

[3.6.0] - 2017-04-27

新增

1. 事件订阅服务：EventSubscribeService，提供如下接口：

• publishEvent 发布事件
• subscribeEvent 订阅指定账号、指定类型的事件
• unSubscribeEvent 取消指定账号、指定事件类型的订阅关系
• batchUnSubscribeEvent 取消指定事件类型的全部的订阅关系
• querySubscribeEvent 查询指定指定账号、指定类型的订阅关系

2. 事件订阅监听：EventSubscribeServiceObserver，提供如下接口：

• observeEventChanged 监听事件变化

3. IM Demo 实现在线状态展示。

4. 支持设置消息提醒通知栏 smallIcon 背景颜色，StatusBarNotificationConfig#notificationColor。

5. 本地消息清空后，别人再撤回消息，可收到消息撤回的通知

变更

1. 小米推送升级 V3.2.2 版本，解决部分小米手机升级到 Android 7.0 之后初始化推送崩溃、收不到推送的问题。

2. IM Demo 更换通知栏透明 smallIcon。

[3.5.0] - 2017-03-15

新增

1. 聊天室历史记录拉取接口: pullMessageHistoryEx，支持查询方向按时间点向前或者向后。

变更

1. AudioRecorder 高清语音录音组件异步化，使用子线程开始、结束录音，UIKit 同时修改适配。

2. 通知栏样式变更：

• 展开样式的通知栏点击跳转更改为进入对应联系人的聊天界面
• 折叠样式的通知栏在多联系人时将应用 icon 设置为通知栏大图

3. SDK 心跳机制优化，缩短弱网环境下连接失效时上层的感知时间。

4. LBS 机制优化，避免应用在后台受到网络限制时耗尽可用的 Link 地址。

[3.4.0] - 2017-01-20

变更

1. 文件断点续传优化。

2. 修复文件下载过程中调用 cancel 接口后无状态回调的问题。

3. 登录优化，解决特殊场景下出现的服务异常的情况。

4. SDKOptions 添加是否提高 SDK 进程优先级可选项，用户可根据例外机型或例外系统版本停用此进程保护方式。

5. SDK 内部 http 地址替换为 https 地址。

[3.3.0] - 2016-12-28

新增

1. UIKit 优化，降低接入复杂度。

2. UIKit 基于强推消息实现群组 @ 功能。

3. 进入聊天室接口支持可配置重试次数：ChatRoomService#enterChatRoomEx。

4. 添加消息通知栏展示样式配置（折叠或者展开）：StatusBarNotificationConfig#notificationFolded。默认是折叠，即云信消息端内消息提醒最多之占一栏；也可以设置为展开，达到端内、端外通知栏提醒一致的表现。

5. 聊天室通知消息中加入新的附件类型：ChatRoomTempMuteAddAttachment 可获取临时禁言时长， ChatRoomTempMuteRemoveAttachment 可获取解禁提前的时长，ChatRoomRoomMemberInAttachment 可获取进入聊天室的用户是否被禁言，是否被临时禁言以及临时禁言时长。

6. 添加文档转码：

• 文档分页查询, DocumentManager#queryDocumentDataList
• 单个文档查询, DocumentManager#querySingleDocumentData
• 单个文档删除, DocumentManager#delete

变更

1. SDK IPC 唤醒方式修改。

2. SDK HTTP 网络库更新。

3. NOS 资源传输支持 HTTPS。

4. NOS 上传优化，修复文件传输过程中出现断网，偶现重连后无法继续上传的问题。

5. 聊天室断网重连机制优化。

6. SDK 初始化异常问题优化。

7. SDK 网络层偶现的空指针问题修复。

8. SDK 多线程问题优化。

9. 手动登录返回 408,415 时进行网络检测并输出到日志。

10. SDK 收到新消息后不再发送 Action 为 ACTION_RECEIVE_MSG 的广播通知。若开发者依赖此广播实现接收消息，在升级 SDK 请改为使用 Observer 监听的方式接收消息。

[3.2.0] - 2016-11-30

新增

1. 添加第三方推送服务：NIMPushClient,MixPushService，目前已接入小米推送。

2. 添加会话未读数多端同步功能，开关为 SDKOptions#sessionReadAck，默认关闭。

3. 添加第三方推送免打扰设置：MixPushService#setPushNoDisturbConfig。

4. 添加本地消息拉取扩展接口：MsgService#queryMessageListExTime，支持时间和条数共同限定结果集。

变更

1. 最低支持版本变更为Android 4.0 (Ice Cream Sandwich)， 其中音视频通话最低支持版本为Android 4.4 (KitKat)。

2. 登录优化。

3. 消息撤回优化，针对离线时对方发送消息并撤回的场景，下次登录时会收到 MsgServiceObserve#observeRevokeMessage 通知，可以获得被撤回消息的时间，便于在 UI 上展现离线期间消息撤回的提示。

[3.1.0] - 2016-10-26

新增

1. 添加发送消息时的反垃圾配置 IMMessage#setNIMAntiSpamOption。

2. 添加查询被禁言群成员列表接口 TeamService#queryMutedTeamMembers。

3. 添加群全员禁言通知。

4. 添加聊天室全员禁言通知。

5. 文件传输添加动态分块策略。

变更

1. SDK 网络库精简及优化。

2. 修正部分手机 UI 进程被 Kill , push 进程无法感知导致下次 UI 重启时没有同步在线状态的问题。

3. 修正联想某型号手机退后台长时间后回到前台无法重连成功的问题。

4. 修正 MsgService#saveMessageToLocalEx 接口发送第一条消息，最近联系人列表收不到通知的问题。

5. MsgService#queryMessageListByUuidBlock 接口支持 sending 状态的返回。

6. 引入 JobScheduler, Android 5.0+ 能起到一定的保活效果；修改提高 push 进程优先级保活方案的适用版本。

[3.0.0] - 2016-10-20

变更

1. 修改多端登录获取登录时间为空的问题。

[2.9.0] - 2016-09-19

新增

1. 添加聊天室成员是否被临时禁言和临时禁言解除时长字段：ChatRoomMember#isTempMuted, ChatRoomMember#getTempMuteDuration。

变更

1. 聊天室断线重连时间优化。

2. 聊天室发包频控优化。

3. MsgService#saveMessageToLocal(IMMessage, boolean, long) 改名为 MsgService#saveMessageToLocalEx(IMMessage, boolean, long)。

[2.8.0] - 2016-08-30

新增

1. 添加消息撤回功能：MsgService#revokeMessage, MsgServiceObserve#observeRevokeMessage。

2. 添加删除指定会话的漫游消息接口：MsgService#deleteRoamingRecentContact。

3. 新增保存消息到本地接口：MsgService#saveMessageToLocal 可以设置消息存储的时间点。

4. 消息中添加获取消息发送方类型接口：IMMessage#getFromClientType。

变更

1. 精简全文检索插件包大小。

2. 清空会话本地消息记录 MsgService#clearChattingHistory 接口保留 RecentContact 中的 tag, extension, time 属性。

[2.7.0] - 2016-08-11

新增

1. 添加全文检索插件，目前支持消息全文检索及高亮，支持分页查询，接口为 LuceneService。 此外，MsgService 中也提供基于SQL Like方式的实现。

2. 添加 SDK 发包频控控制。

3. 添加聊天室队列服务（针对直播连麦场景使用）。

4. 添加指定成员强制推送功能（主要针对群）：IMMessage#memberPushOption。

5. 添加 PC/Web 端在线时可配置是否推送的开关 SettingService。

6. 添加获取群邀请和群踢人通知附件的扩展字段：MemberChangeAttachment#getExtension。

7. 添加更新聊天室信息接口 ChatRoomService#updateRoomInfo ，更新本人聊天室成员信息接口 ChatRoomService#updateMyRoomRole。

8. 添加登录时同步本人所在的所有群的本人群成员资料信息。

9. 优化 SDK 登录同步流程。

[2.5.0] - 2016-07-08

新增

1. 添加文本消息的全局搜索接口：MsgService#searchAllMessageHistory。

2. 添加消息转发功能：MessageBuilder#createForwardMessage，支持除通知消息和音视频消息以外的消息类型。

3. 添加聊天室临时禁言接口：ChatRoomService#markChatRoomTempMute，支持设置临时禁言时长。

变更

1. 将注册群通知消息过滤接口移动到 MsgService 中：MsgService#registerIMMessageFilter ，并支持单聊和群聊的通知类型消息过滤，不再限于群通知消息，同时支持音视频类型消息过滤。

2. 聊天室架构调整，聊天室业务仅在 UI 进程处理。

3. SDK 输出jar包按模块分离：nim-sdk.jar（必须）、nim-chatroom.jar（可选聊天室模块）、nim-rts.jar（可选实时会话白板模块）、nim-avchat.jar（可选实时音视频模块）、nrtc-sdk.jar（实时会话、实时音视频基础库），供开发者按需组合使用。

[2.4.0] - 2016-06-02

新增

1. 升级群组功能：添加群邀请模式、被邀请模式、群资料修改模式、群资料扩展字段修改模式、群头像、群成员是否被禁言、群成员扩展字段等属性。

2. 添加群禁言功能 TeamService#muteTeamMember，禁言后，群成员都会收到一条通知类消息，附件为 MuteMemberAttachment。

3. 添加修改自己的群成员扩展字段接口 TeamService#updateMyMemberExtension。

4. 添加发送消息配置项：消息是否支持路由（抄送） CustomMessageConfig#enableRoute。

5. 添加群通知消息过滤接口：MsgService#registerTeamNotificationFilter，支持由上层决定群通知消息是否需要持久化。

6. 添加漫游消息通知接收消息监听接口。

7. 通知栏提醒支持呼吸灯配置：StatusBarNotificationConfig#ledARGB、StatusBarNotificationConfig#ledOnMs、StatusBarNotificationConfig#ledOffMs。

8. 添加静音列表变更通知：FriendServiceObserve#observeMuteListChangedNotify。

变更

1. 优化网络心跳唤醒方式。

2. 提高云信服务进程系统优先级，降低被系统杀死的概率。

3. 适配 Android M+ 外部存储读写权限开启后，日志写入无法立即生效的问题。

4. UserService#fetchUserInfo 添加单次请求账号数量上限150，超过150需要上层做分批请求，否则抛出 IllegalArgumentException。

5. MsgService#searchMessageHistory 接口去掉文本消息类型限制，参照 content 字段进行关键字匹配。

6. 完善 AuthService#openLocalCache 接口逻辑。

[2.3.0] - 2016-05-18

变更

1. 修正日志超过 8M 未裁剪的问题。

2. 修正 SDK 初始化过程中部分机型偶现空指针的问题。

[2.2.0] - 2016-04-28

新增

1. LoginInfo 中添加可选属性 AppKey，支持在登录时设置 AppKey。

2. 消息中添加获取发送者昵称接口：IMMessage#getFromNick。

3. 进入聊天室前，如果 IM 未成功登录，将上报错误码1000。

4. 群组添加批量移除群成员接口：TeamService#removeMembers。

5. 扩展字段支持 Map、List、JsonObject、JsonArray 的嵌套。在解析扩展字段时，如果 JSON 解析成 Map 失败将原字符串返回（放入返回的 Map 中，key 为 ext）。

6. 添加获取 SDK 数据缓存目录接口：NimClient#getSdkStorageDirPath。

7. 聊天室断线重连机制优化。

8. 聊天室添加获取断线重连（自动登录）失败的错误码接口：ChatRoomService#getEnterErrorCode。

[2.1.2] - 2016-04-06

新增

1. 进入聊天室时支持设置通知的扩展字段 notifyExtension，设置后，在收到聊天室通知消息时，通过 ChatRoomNotificationAttachment 获取此扩展字段。

[2.1.1] - 2016-03-28

新增

1. 聊天室 ChatRoomMessageBuilder 支持更丰富的消息类型。

2. 进入不存在的聊天室返回错误码404。

[2.1.0] - 2016-03-24

新增

1. MsgService 添加已读回执功能。

2. 添加 RTSNotifyOption、AVChatNotifyOption，可自定义音视频、白板的 iOS 推送通知。

变更

1. 创建 Tip 消息接口变更：MessageBuilder#createTipMessage 去掉最后一个参数 Map<String, Object> content，早期版本请根据该接口返回的 IMMessage 对象来 setRemoteExtension。

2. RTSOptions 去掉 pushContent、 extra字段，新版本使用 RTSNotifyOption。

3.\ 优化 App 从后台切到前台时断网重连机制。

4.\ 修复部分系统偶现后台进程活着但UI进程收不到消息提醒的问题。

[2.0.1] - 2016-02-29

变更

1. RTSManager 去掉铃声配置接口，铃声交由上层自定义实现。

2. MsgService#updateRecent 接口改成同步接口。

[2.0.0] - 2016-02-22

新增

1. 添加聊天室功能 SDK：ChatRoomService。

2. 去掉 libs 下 netty-4.0.23-for-yx.final.jar。

[1.8.0] - 2016-01-18

新增

1. RecentContact 类添加扩展字段（本地使用）。

2. SDKOption 类添加消息提醒（通知栏提醒）内容定制接口： MessageNotifierCustomization。

3. 添加未登录时访问 SDK 本地数据接口：AuthService.openLocalCache。

4. IMMessage 和 CustomNotification 的扩展字段支持嵌套。

5. 添加更新本地扩展字段接口：MsgService.updateIMMessage。

6. 保存消息到本地接口：MsgService.saveMessageToLocal 支持设置是否计入最近联系人未读计数。

变更

1. 断网后立即上报状态（去掉延时上报机制），上层感知到的网络状态变更更加灵敏供开发者自由发挥。

[1.7.1] - 2015-12-05

变更

1. 修复断网时登录无响应的问题（影响版本1.6.0及1.7.0）。

2. 修复被拉进群后，收到第一条群消息时，通知栏无法显示昵称的问题。

3. UserService.getUserInfo(List accounts) 接口名称更改为UserService.getUserInfoList(List accounts)。

[1.7.0] - 2015-12-01

新增

1. IMMessage 类添加扩展字段（服务器扩展字段和本地扩展字段）。

2. IMMessage 类添加推送文案、自定义推送属性。

3. IMMessage 类添加消息配置选项，发送消息时可以指定该消息是否计入未读数。

4. IMMessage 类添加消息配置选项，发送消息时可以指定该消息是否需要推送（消息提醒）。

5. IMMessage 类添加消息配置选项，发送消息时可以指定该消息是否推送昵称（接收方针对iOS有效）。

6. CustomNotification 类添加通知配置选项，发送通知时可以指定该通知是否需要推送（消息提醒）。

7. CustomNotification 类添加通知配置选项，发送通知时可以指定该通知是否推送昵称（接收方针对iOS有效）。

8. CustomNotification 类添加通知配置选项，发送通知时可以指定该通知是否计入未读数。

9. CustomNotification 类添加自定义推送属性。

10. 添加通过消息ID批量获取IMMessage接口： MsgService.queryMessageListByUuidBlock 和 MsgService.queryMessageListByUuid。

11. 添加通过消息类型查询消息历史接口： MsgService.queryMessageListByType。

12. 添加更新好友备注名、好友关系扩展字段接口： FriendService.updateFriendFields。 Friend 类添加获取好友备注名、好友关系扩展字段方法。

13. 添加根据类型查询系统通知列表接口：SystemMessageService.querySystemMessageByType。

14. 添加查询指定类型的系统通知未读数总和接口：SystemMessageService.querySystemMessageUnreadCountByType。

15. 添加将指定类型的系统通知设为已读接口：SystemMessageService.resetSystemMessageUnreadCountByType。

16. 添加清空指定类型的系统通知接口：SystemMessageService.clearSystemMessagesByType。

17. AudioRecorder 类添加获取当前录音时最大振幅接口：AudioRecorder.getCurrentRecordMaxAmplitude。

18. UserInfoProvider 类添加自定义通知栏消息提醒发送者显示名称接口：UserInfoProvider.getDisplayNameForMessageNotifier。

19. 添加新的消息类型Tip：MessageBuilder.createTipMessage，主要用于会话内的通知提醒的场景。

20. TeamMember 类添加判断该成员是否有效（是否还在群中）的接口：TeamMember.isInTeam ，当群成员退出或被移除后， SDK 通知群成员变化时会将 isInTeam 置为 false。

变更

1. SystemMessageType 去掉 DeleteFriend ，由 SDK 内部处理好友删除，该系统通知不再上报。

2. 修复群成员退出或者被移除后 TeamServiceObserver.observeMemberRemove 监听没有回调的问题。

[1.6.0] - 2015-11-02

新增

1. 添加查询系统通知列表（同步版本）接口： SystemMessageService.querySystemMessagesBlock 。

2. 添加登录同步数据状态通知接口： AuthServiceObserver.observeLoginSyncDataStatus 。

3. 添加查询未读消息总数接口： MsgService.getTotalUnreadCount 。

4. 添加设置单条系统消息为已读接口： SystemMessageService.setSystemMessageRead 。

5. AudioPlayer 支持听筒/扬声器播放。

变更

1. 修改 FriendChangedNotify 类，在好友关系变更通知中批量返回增加、更新、被删除的的好友关系。

2. 修改 BlackListChangedNotify 类，在黑名单变更通知中批量返回被拉黑、移出黑名单的帐号列表。

[1.5.0] - 2015-09-29

新增

1. 用户资料托管。

2. 数据通道服务，基于数据通道服务实现白板功能。

3. UI组件新增：通讯录列表、联系人选择器、群名片。

[1.4.0] - 2015-09-02

新增

1. 好友系统托管。

2. 黑名单设置。

3. 消息提醒开关设置。

4. 开源UI组件，集成更方便。

5. SDK 调用接口回调增加 RequestCallbackWrapper 类，将 RequestCallback 的3个回调函数合并为1个，方便开发者调用。

6. MsgService 增加 saveMessageToLocal 接口，用于开发者保存一些tips类的本地消息，同时 IMMessage 放开更多设置接口。

7. MsgService 增加单独清空最近联系人未读数接口：clearUnreadCount。

8. 给部分不需要网络请求的接口增加了同步调用版本，这些同步调用接口以 *Block 结尾。

9. 增加 UserInfoProvider 接口，并在 SDKOptions 中增加设置，用于云信内建的状态栏通知显示用户头像和自定义名字。

变更

1. 因为架构调整，需要在AndroidManifest文件中增加组件申明：

xml<!-- 云信进程间通信receiver -->
<receiver android:name="com.netease.nimlib.service.ResponseReceiver"/>

2. SDK 架构调整，SDK 主要业务逻辑改为工作在 UI 进程，push 进程更轻量，占用资源更少，收到消息后就启动 UI 进程，用户打开 APP 更快速。

3. 收到新消息，新系统消息，新自定义通知后，UI 进程会被唤起，因此除了使用 Receiver 外，也可以直接使用 observer 接口监听。

4. 云信 appKey 除了在 AndroidManifest 中配置外，也可以在 SDKOptions 中进行设置，并优先采用 SDKOptions 中的设置。 ​

[1.3.0] - 2015-07-31

新增

1. 增加搜索本地消息历史纪录的接口： MsgService.searchMessageHistory。

2. 新增一个更方便使用，更灵活的批量获取本地消息历史纪录的接口: MsgService.queryMessageListEx。

3. 增加语音转文字的接口：MsgService.transVoiceToText。

4. 增加了一个后台保活的 jar 包，增强程序健壮性。

5. 自定义消息增加生命周期和推送参数的自主配置： CustomMessageConfig。

变更

1. 发送消息的回掉函数改为到最终发送完成时才回调了，如果发送失败，开发者可以清楚的知道错误码是什么。

2. 修改群组资料改为可以同时修改多个字段了。

3. 因为架构调整，需要在AndroidManifest文件中增加组件申明：

xml<!-- 运行后台辅助服务 -->
<service
     android:name="com.netease.nimlib.service.NimService$Aux"
     android:process=":core"/>

bug修复

1. 修改服务进程在后台时可能会被系统杀掉导致 UI 上自定义消息无法解析，新消息提醒设置失效的 bug。

[1.2.0] - 2015-06-23

新增

1. 群组增加消息提醒开关设置。

2. 有多端同时在线时，可以给其他端发送消息，可以踢其他端下线。

3. 增加设置消息推送内容的接口。

bug修复

1. 修正多个进程调用 SDK 接口时，回调可能混乱的问题。

[1.1.0] - 2015-05-25

新增

1. 支持的 android 系统版本由 2.2 升级到 2.3。

2. 消息数据库去掉加密选项，去掉对 sqlcipher 的依赖。

3. 整合透传指令和自定义系统通知，使接口更方便，概念更清晰。

4. 增加从服务器拉取消息记录功能。

5. 增加文件消息类型。

6. 新消息通知栏提醒的文案改为可自定义。

7. 增加语音消息播放 API (AudioPlayer)。

8. 增加多端登录状态接口。

9. 高级群增加两个扩展字段，可第三方应用自由定义和使用。

变更

1. CommandMessage 和 CustomSystemNotification 统一改为 CustomNotification，对应 MsgService 的 sendCommandMessage 接口改为 sendCustomNotification，AndroidManifest 文件中 Receiver 声明的 Action 对应改为 “.ACTION.RECEIVE_CUSTOM_NOTIFICATION”。

2. IMMessage 的接口精简，去掉大部分setter 接口，去掉了用于内部使用的 getter 接口。去掉的 getter 接口包括：getMessageId (可改用getUuid)，getServerId，getAttachStr。

3. MsgAttachment 不再需要实现 formJson 接口。

4. RecentContact 去掉 getSortTag 和 getSortTime 接口（以前没有实现），增加 getTag 和 setTag 接口。

5. MsgTypeEnum.picture -> MsgTypeEnum.image。

[1.0.0] - 2015-03-27

云信发布了！