NIM SDK iOS 稳定版更新日志

开发者中心

IM 即时通讯

了解产品

NIM SDK iOS 稳定版更新日志

更新时间： 2024/07/15 15:35:49

本文介绍网易云信即时通讯 IM SDK（简称 NIM SDK）稳定版 iOS 端 v9.x.x 及以下版本的更新日志。有关 v10.x.x 版本，请参考《IM 即时通讯 V10》iOS 更新日志。

单击展开了解什么是稳定版，以及与开发版的区别。

稳定版基于开发版，可满足常见 IM 应用业务场景，但更注重稳定性。开发版则主要是在可商用的基础上，提供新功能与特性。

稳定版与开发版的主要差异点如下：

稳定版相较开发版，在更长周期内获得了更多用户的验证，且修复了多个历史版本的已知问题，稳定性保障更佳。
最新稳定版基于开发版 V9.17.0，后续稳定版在该版本基础上迭代。

近期重要更新

从 v9.17.0 起，推出最新稳定版，整体性能和稳定性进一步提升。
从 v8.9.122 起，支持按会话类型批量清理未读数和查询未读数，具体请参考最近会话。
从 v8.9.111 起，第三方回调登录支持第三方服务器采用动态 token 鉴权的场景。
从 v8.9.109 起，支持聊天室定向消息功能，具体请参考发送聊天室定向消息。

9.17.0 (2024-07-04)

基于 IM 开发版 V9.17.0，推出最新稳定版，后续稳定版自 V9 系列开始迭代。

新增特性

新增圈组临时禁言功能，具体请参考圈组临时禁言。
新增圈组频道分组自定义排序能力，具体请参考搜索服务器和频道（频道分组）。
新增圈组查询未在频道分组下的频道信息能力，具体请参考频道管理。

性能优化

推出最新稳定版，整体性能和稳定性进一步提升。
跨平台支持增强，支持 XCFramework 打包。
圈组插件化，可根据需求灵活加载，提升应用的定制性和响应速度。

若需要使用圈组能力，除了需要引入 NIMSDK，还需要单独引入 NIMSDK/QChat，具体请参考集成 SDK。
存储上传稳定性提升，显著提高文件传输的稳定性和可靠性。
多项内部优化，进一步提升性能。

API 新增

方法/回调/类	说明
`NIMQChatServerManager.mute`	在指定圈组服务器中对指定成员进行临时禁言或解除临时禁言。
`NIMQChatServerManager.getMuteMemberByPage`	在指定圈组服务器中分页查询被临时禁言的成员列表。
`NIMQChatChannelManager.mute`	在指定频道中对指定成员进行临时禁言或解除临时禁言。
`NIMQChatChannelManager.getMuteMemberByPage`	在指定频道中分页查询被临时禁言的成员列表。
`getUncategorizedChannelsByPage`	分页查询当前服务器中不在频道分组下的频道列表。
`NIMQChatChannelCategory`	频道分组对象新增 `reorderWeight` 字段，表示自定义排序标识，在分页查询频道分组时可根据该字段进行自定义排序。
`getCategoriesInServerByPage`	查询频道分组列表接口的入参中新增 `sortType`（排序类型）和 `cursor` （分页）字段，可设置排序类型实现按自定义权重排序查询频道分组。

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