IM 即时通讯
iOS
开发指南

NIM SDK 稳定版更新日志

更新时间: 2024/02/19 17:38:57

近期重要更新


什么是稳定版

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

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

两者的主要差异点如下:

  • 稳定版相较开发版,在更长周期内获得了更多用户的验证,且修复了多个历史版本的已知问题,稳定性保障更佳。

  • 稳定版基于开发版 V8.9.0,包体积更小(具体见下文的 SDK 包体积大小对比)。

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

    具体功能差异如下:

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

[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
    • orderNIMMessageSearchOrder,查询方向,即返回结果按照 joinTime(进群时间)升序或降序排序
    • limit:本次查询最大数量,默认为 10
  • 新增 NIMTeamManager.getTeamMemberListNIMSuperTeamManager.getTeamMemberList 方法按照群成员类型查询高级群和超大群成员。

    - (void)getTeamMemberList:(NSString *)teamId
                    option:(NIMTeamMemberRoleTypeSearchOption *)option
                completion:(nullable NIMTeamMemberSearchResultHandler)completion;
    

    NIMTeamMemberRoleTypeSearchOption 参数说明:

    • teamId:群组 ID
    • roleTypesNIMTeamMemberType,群成员角色类型
    • offset:查询偏移,首次传 0,下一次调用传入上一次返回的 offset
    • orderNIMMessageSearchOrder,查询方向,即返回结果按照 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。

[8.9.110] - 2023-02-13

修复部分已知问题。

[8.9.109] - 2022-12-15

SDK 包体积增量大小对比

架构 IPA 解压并安装后的增量大小
稳定版(v8.9.109) 开发版(v9.7.0)
arm64 6.7MB 10.5MB

新增特性

支持聊天室定向消息功能。发送聊天室消息支持消息接收者列表

问题修复

修复已知问题

[8.9.108] - 2022-11-08

SDK 包体积增量大小对比

架构 IPA 解压并安装后的增量大小
稳定版(v8.9.108) 开发版(v9.6.3)
arm64 9.4MB 11.4MB

新增特性

支持聊天室动态登录

问题修复

  • 修复 Thread 消息查询结果包含已撤回和删除消息的问题
  • 修复独立模式登录聊天室异常报错的问题
  • 修复自己发出消息的回调中发送者昵称信息为空的问题
  • 修复其他已知问题
此文档是否对你有帮助?
有帮助
去反馈
  • 近期重要更新
  • 什么是稳定版
  • [8.9.124] - 2024-02-02
  • 新增特性
  • API 变更
  • [8.9.123] - 2024-01-19
  • 新增特性
  • API 新增
  • [8.9.122] - 2023-12-27
  • 新增特性
  • API 新增
  • [8.9.121] - 2023-12-08
  • [8.9.119] - 2023-10-19
  • [8.9.118] - 2023-09-19
  • [8.9.116] - 2023-07-18
  • [8.9.115] - 2023-06-15
  • [8.9.114] - 2023-05-16
  • [8.9.113] - 2023-04-23
  • [8.9.111] - 2023-03-31
  • [8.9.110] - 2023-02-13
  • [8.9.109] - 2022-12-15
  • SDK 包体积增量大小对比
  • 新增特性
  • 问题修复
  • [8.9.108] - 2022-11-08
  • SDK 包体积增量大小对比
  • 新增特性
  • 问题修复