近期重要更新

• 新增服务端会话服务功能模块，具体请参考服务端会话服务。
• 新增动态查询历史消息接口，云信提供智能选择云端、本地历史消息。

---

[0.17.0] - 2023-12-26

优化未读数处理逻辑。

[0.16.0] - 2023-12-01

API 新增

API	说明
getServerTime	获取服务器时间戳（毫秒）。用于校准消息时间信息。

优化

• 优化信令回调数据
• 优化群未读计数
• 优化小程序低版本兼容性
• 优化断网恢复后，会话未读计数逻辑

[0.14.0] - 2023-05-30

优化

使 AWS S3 文件上传过程中触发相关回调，并统一以下回调的回参表现。

• onUploadProgress：上传进度回调
• onUploadStart：上传开始回调
• onUploadDone：上传完成的回调

修复

• 修复撤回已读消息以及删除未读消息后，未读数显示异常的问题。
• 修复当发送未传 pushInfo 的消息时，转发该消息会失败的问题。
• 修复调用 disconnect 接口后报错的问题。

API 变更

调用获取圈组快捷评论接口（getQuickComments）返回的数据中新增快捷评论的创建时间，即 QChatQuickCommentDetail 中新增评论创建时间字段（createTime）。

[0.13.0] - 2023-04-11

新增特性

• 新增服务端会话服务功能模块，与本地最近会话不同，其提供了新的会话列表获取服务，需要从云端拉取，不支持同步到本地最近会话列表，具体请参考服务端会话服务。
• 新增获取内存中的所有会话的能力，具体请参考最近会话。
• 新增 myTeamMembers 和 mySuperTeamMembers 事件，在初始化可获取个人在所有群组（高级群和超大群）中的成员信息。
• 新增 msgReceipts 事件，查看某消息是否已读。

API 新增

API	API 说明
getAllSessions	获取内存中的所有会话
queryCloudSessionList	查询服务端会话列表
queryCloudSession	查询指定服务端会话的详细信息
updateCloudSession	更新服务端会话的扩展信息
deleteCloudSessionList	删除服务端会话列表

API 变更

为优化推送接口，将对历史的推送相关参数进行调整。目前涉及推送的接口如下：

模块	API	推送相关参数说明
消息模块	消息发送接口 如sendTextMsg、sendTipMsg等	入参 pushInfo 调整后包含以下属性： 是否需要推送：needPush 是否需要计数：needPushBadge 是否需要昵称：needPushNick 推送文案：pushContent 第三方推送属性：pushPayload 是否需要强制推送：needForcePush 强制推送列表：forcePushIDsList 强制推送文案：forcePushContent
	消息撤回接口 recallMsg	入参 pushInfo 调整后包含以下属性： needPush、needPushBadge、needPushNick、pushContent、pushPayload
系统通知模块	发送自定义系统通知 sendCustomSysMsg	入参 pushInfo 调整后包含以下属性： needPush、needPushBadge、needPushNick、pushContent、pushPayload
信令模块	发送自定义信令 sendCustomCommand	入参 pushInfo 调整后包含以下属性： needPush、needPushBadge、needPushNick、pushContent、pushPayload

优化

• 优化 uniapp 推送功能，具体请参考 uniapp 推送相关。
• 优化内部拉黑后的消息重发逻辑。

问题修复

• 修复 uniapp 重复监听 socket 事件的问题。
• 修复调用 destroy 后，可能销毁失败的问题。
• 修复同步后收到漫游导致会话重复更新的问题。
• 修复其他已知问题。

[0.12.1] - 2023-02-16

新增特性

新增 signaling 信令模块。具体接口请参见SignalingServiceInterface。

问题修复

修复支付宝小程序的长连接的若干问题。

[0.12.0] - 2023-02-10

API 变更

API	API 说明
NIMEModuleParamCloudStorageConfig	新增 isNeedToGetUploadPolicyFromServer 参数，此参数用来控制是否通过服务器获取上传策略，默认为 true。只有当isNeedToGetUploadPolicyFromServer为 false 时，otherOptions的ServerConfig的 cdn 配置才生效。

问题修复

修复已知问题。

[0.11.0] - 2022-12-27

优化改进

被拉黑方向拉黑方发出的消息体的服务端 ID 逻辑优化。

问题修复

• 修复当会话数量超过 10 个时，调用resetAllSessionsUnreadCount方法异常报错的问题。

• 修复其他已知问题。

[0.9.2] - 2022-10-27

新增特性

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

新增事件

聊天室模块新增 tagsUpdate事件，回调包含变更后的标签信息。

API 新增

API	API 说明
getHistoryMsgsByTags	通过聊天室标签（可多个）来检索聊天室历史消息

[0.8.5] - 2022-8-29

• IM 会话中撤回消息后重置未读数更新: 若会话的未读数已经为 0，不需要触发协议，也不更新会话。
• 修正更新会话 lastmsg 的条件，补充处理一种情况：本地发送消息时，本地时间故意调的比远端服务器的大，导致收到消息回包后无法触发 session.lastMsg 的 status 从 sending 到 sent 状态的更新。
• 调用resetSessionUnreadCount时 本地的时间比服务器的小上几秒钟，导致本地时间不可信，所以修复为使用 lastMsg.time 或者 session.updateTime。
• 修复发送文件消息时磁盘删除对应选中资源后没有回调。
• 修复其他已知问题。

[0.7.1] - 2022-7-29

新增特性

新增最近会话置顶功能。

新增 API

API	API 说明
addStickTopSession	添加云端置顶的会话
deleteStickTopSession	取消云端置顶的会话
updateStickTopSession	更新云端置顶的会话

[0.6.4] - 2022-7-20

NIM Web SDK，聊天室 Web SDK 新增了setOptions方法，您可以调用此方法更新初始化传入的参数，在初始化完成后使用。

[0.6.1] - 2022-6-2

ESM 模块的 tree-shaking 优化。

[0.5.1] - 2022-04-22

修复 npm install 失败的问题 （ 由 package.json 里的 denpencies 存在无法安装的依赖而导致）。

[0.5.0] - 2022-04-22

如您安装了 0.5.0 版本的 SDK，强烈建议您将其升级至 0.5.1 版本。0.5.1 版本修复了 0.5.0 版本中存在的 npm install 失败的问题。

• 新增聊天室队列服务。聊天室队列指聊天室（房间）中由多个元素（key-value 键值对）构成的队列，主要应用于直播连麦场景。 功能详情请参见聊天室队列服务。
• SDK 增加对微信小程序和支付宝小程序设配。

0.4.2

• 优化: 优化了 TS 定义
• 修复: 修复了 nim 发送消息的 needPushNick 参数设置为 true，不能真的让移动端收到推送里的昵称的问题。

连接相关的优化或修复有：

• 优化: 缩短了 nim sdk 对于 lbs 请求的超时时间的默认值，降至 10 s。
• 优化: 优化了 nim，chatroom 三个 sdk 的重连表现。sdk 目前针对初始化的连接失败都会断开并且抛出异常，重连阶段尝试连接失败，只会记录日志而不会向上抛出异常。

0.4.0

• 功能优化: 优化建立连接的一些表现，如允许传入多个 lbsUrls，遍历找到一个可用值。

0.3.2

• fix: 修复调用 resetAllSessionsUnreadCount api 无响应的问题

0.3.1-beta1

feature: 增加对微信小程序、支付宝小程序等环境的适配

• chore: 变更 crypto-js 库的引入方式

0.3.0

• feature: 追加 deleteSelfMsgs 单向删除接口。
• feature: 推送插件以及适配代码，推送功能的使用参见文章：uniapp 推送相关
• chore: uniapp 平台适配优化，能够支持编译去支付宝小程序，微信小程序
• chore: 优化撤回消息逻辑，使撤回消息后 session 的 unread 数等参数能得到正确的更新。
• chore: 聊天室追加鉴权方式
• fix: 修复登出协议的一些问题

0.2.0

• feature: 追加 superTeam 超级群逻辑
• fix: 修复同步阶段错误的把 syncRelations 当作是同步回包的 bug
• fix: 修复同步包超时问题
• fix: 修复被拉黑的情况下消息漫游下来的状态显示成功
• chore: 优化，追加 esm/index 供开发者上层使用 esm 打包的模块，便于做 tree shaking 节省体积
• chore: 使用 lodash 替代内部一些函数，打包体积增大 30kb

0.1.1

• 初始化参数支持传入 lbsUrls 和 linkUrl 来指定默认的连接地址
• 修复 NIM 建立连接没有区别出自动重连的情况

0.1.0

初版上线，拥有好友，用户，群，消息，会话，透传协议，系统消息，聊天室能力。