NIM SDK 稳定版更新日志

开发者中心

IM 即时通讯

了解产品

NIM SDK 稳定版更新日志

更新时间： 2024/04/11 17:28:20

近期重要更新

支持按会话类型批量清理未读数和查询未读数，具体请参考最近会话。
第三方回调登录支持第三方服务器采用动态 token 鉴权的场景。
支持聊天室定向消息功能，具体请参见发送聊天室定向消息。

什么是稳定版

稳定版基于开发版，可满足常见 IM 业务场景，更注重稳定性。

开发版在可商用的基础上，提供新功能与特性。

两者的主要差异点如下：

稳定版相较开发版，在更长周期内获得了更多用户的验证，且修复了多个历史版本的已知问题，稳定性保障更佳。
稳定版基于开发版 V8.9.0，包体积更小（具体见下文的 SDK 包体积大小对比）。

稳定版不支持海外节点存储、圈组功能以及其他最新功能。

具体功能差异如下：

功能	简介	稳定版	开发版
融合存储	将数据存储于海外节点如果您的应用涉及海外业务，请选择开发版。	✘	✔
圈组	用于打造全新社交模式类“Discord”场景	✘	✔
聊天室空间消息	用于在基于空间坐标的场景下给指定范围内的用户发送消息，如某游戏地图指定范围内的用户	✘	✔
聊天室标签实时更新	实时更新聊天室的用户标签	✘	✔

[8.9.128] - 2024-04-11

NIM iOS SDK 中新增 PrivacyInfo.xcprivac 隐私文件，兼容苹果公司的隐私更新。具体导入方式请参见苹果隐私策略说明。

[8.9.127] - 2024-03-28

修复已知问题。

[8.9.126] - 2024-03-20

优化信令模块（呼叫功能）。
其他内部优化。

[8.9.125] - 2024-03-07

修复已知问题。

[8.9.124] - 2024-02-02

新增特性

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

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

API 变更

方法/类/枚举	说明
`getMessagesDynamically`	动态查询连续完整的历史消息。

[8.9.123] - 2024-01-19

新增特性

支持按照群成员类型查询成员列表信息。（高级群和超大群）
支持按照关键字检索成员。（仅超大群）

API 新增

新增 NIMSuperTeamManager.searchTeamMember 方法按照关键字检索超大群成员。
```
- (void)searchTeamMembers:(NIMTeamMemberKeywordSearchOption *)option
            completion:(nullable NIMTeamMemberSearchResultHandler)completion;
```
NIMTeamMemberKeywordSearchOption 参数说明：
- teamId：高级群 ID
- keyword：查询使用的关键字
- offset：查询偏移，首次传 0，下一次调用传入上一次返回的 offset。
- order：NIMMessageSearchOrder，查询方向，即返回结果按照 joinTime（进群时间）升序或降序排序
- limit：本次查询最大数量，默认为 10
新增 NIMTeamManager.getTeamMemberList 和 NIMSuperTeamManager.getTeamMemberList 方法按照群成员类型查询高级群和超大群成员。
```
- (void)getTeamMemberList:(NSString *)teamId
                option:(NIMTeamMemberRoleTypeSearchOption *)option
            completion:(nullable NIMTeamMemberSearchResultHandler)completion;
```
NIMTeamMemberRoleTypeSearchOption 参数说明：
- teamId：群组 ID
- roleTypes：NIMTeamMemberType，群成员角色类型
- offset：查询偏移，首次传 0，下一次调用传入上一次返回的 offset
- order：NIMMessageSearchOrder，查询方向，即返回结果按照 joinTime（进群时间）升序或降序排序
- limit：本次查询最大数量，默认为 10

[8.9.122] - 2023-12-27

新增特性

支持按会话类型批量清理未读数和查询未读数，具体请参考最近会话。
优化蓝牙音频录制与播放功能。
优化短时间内发送群消息已读回执过多而导致报错的问题。

API 新增

API	描述
`markMessagesReadOfType::`	将会话类型批量清理未读数（标记已读）。
`messagesReadOfType:`	会话消息已读的回调。
`unreadCountOfType:`	按会话类型获取未读消息数。

[8.9.121] - 2023-12-08

新增 queryRecentSessionsWithLimit: 方法，用于查询指定数量的最近会话列表，主要适用于当前最近会话数量较多的场景。

[8.9.119] - 2023-10-19

优化第三方回调动态 Token 登录内部逻辑，具体请参见通过第三方回调登录 IM。

[8.9.118] - 2023-09-19

优化日志打印逻辑。
修复日志模块崩溃问题。

[8.9.116] - 2023-07-18

修复日志模块偶现的崩溃问题。

[8.9.115] - 2023-06-15

优化内部逻辑。

[8.9.114] - 2023-05-16

新增 TeamById2 接口，用于根据群组 ID 在本地缓存中查询具体的群组信息。该接口解决了历史接口（TeamById）频繁调用而引起的问题，因此建议使用新接口。
优化加载头像的日志打印占日志文件过多的问题。
调整 NOS 上传分片大小。
修复 SDK 打包上传时提示警告信息的问题。
修复 decodeMessageFromData 方法没有反序列化 remoteExt 属性的问题。

[8.9.113] - 2023-04-23

IM & 聊天室登录支持采用动态 Token 鉴权 & 动态 LoginExt 鉴权的场景。
修复获取本地历史记录传入 order 无效的问题。
修复清除过云端消息的会话无法收到漫游消息的问题。
修复由于数据库备份引起的多线程访问冲突问题。
修复其他已知问题。

[8.9.111] - 2023-03-31

引入 NIM SDK 时，支持去除 NIMFtsDB 这个 framework 包。

开发者引入时可自行选择是否去除 NIMFtsDB，如去除可缩减包体积大小。
第三方回调登录支持第三方服务器采用动态 token 鉴权的场景。

如果用户登录 IM 时 token 已过期，云信服务端会重新向第三方服务器发起登录回调请求，并获取新的 token。