跳到主要内容

更新日志

26.7.0​

发布日期：2026/07/31

新增功能

  • 新增 searchMessagesWithParams 接口，支持按关键字、时间范围、会话及消息条件组合搜索本地消息。详见搜索消息。
  • 新增 getConversationListByFilters 接口，支持按会话类型、频道及未读状态筛选本地会话列表。详见获取会话。
  • IQuietHoursOption 新增 timezone 字段，支持设置免打扰时区。详见全局免打扰。

26.6.0​

发布日期：2026/06/30

新增功能

  • 新增消息回应能力，支持添加回应、移除回应、批量查询回应摘要、分页查询回应列表、分页查询回应用户列表，并支持监听回应变更。详见消息回应。
  • Message 类新增 hasReactions 字段，用于标识消息是否存在回应。
  • 新增 MessageReactionListener、UpdateMessageReactionParam、MessageReactionSummaryQueryParam、GetMessageReactionsParams、GetMessageReactionUsersParams、MessageReactionInfo、MessageReaction、MessageReactionUser、MessageReactionEvent 等类型。

26.5.0​

发布日期：2026/06/18

新增功能

  • 新增流式消息能力，支持接收服务端下发的 RC:StreamMsg 消息，并通过 requestStreamMessage 拉取流式内容。详见流式消息。
  • 新增流式消息拉取事件监听接口 addStreamMessageRequestEventListener、removeStreamMessageRequestEventListener，以及 StreamMessageRequestEventListener、StreamMessageRequestParams、StreamMessageChunkInfo 等类型，用于监听拉取初始化、增量内容和完成事件。
  • 新增 StreamMessage 消息内容类，用于解析流式消息正文，并在拉取过程中累加已收到的完整文本内容。

26.4.0​

发布日期：2026/06/01

功能优化

  • 优化内部逻辑。
  • 2026 年 5 月 29 日起，新注册客户的除图片消息（RC:ImgMsg）、流式消息（RC:StreamMsg）、语音消息（RC:VcMsg）、视频消息（RC:SightMsg）、位置消息（RC:LBSMsg）、合并转发消息（RC:CombineV2Msg，RC:CombineMsg）、引用消息（RC:ReferenceMsg）外，其他消息的 content 消息体大小限制不超过 10 KB。

问题修复

  • 修复偶现的启动后崩溃的问题。

26.3.0​

发布日期：2026/05/18

新增功能

  • Message 类新增 quoteInfo 字段，用于在文本、图片、高清语音、文件、F自定义消息等实际消息结构上携带引用关系信息。原引用消息 RC:ReferenceMsg 仍可继续使用。
  • 新增 QuoteInfo 数据类型，用于描述被引用消息的 msgUid、userId、objectName。
  • 新增 getMessagesByUid 接口，用于基于会话标识和消息 UID 列表批量查询消息。

26.1.0​

发布日期：2026/02/03

新增功能

  • Conversation 类新增托管信息 DataManagementInfo，用于会话列表中快捷显示用户和群组托管信息。
  • 新增 getAppSettings 接口，用于查询当前应用的功能开关配置。

问题修复

  • 修复 getJoinedGroupsByRole 接口调用异常。
  • 修复 refreshReferenceMessageWithParams 接口偶现崩溃问题。

25.12.0​

发布日期：2025/12/26

新增功能

  • 新增用户信息托管功能，支持设置、获取、批量查询用户信息及设置用户信息访问权限。详见用户信息托管。相关接口：updateMyUserProfile、getMyUserProfile、getUserProfiles、updateMyUserProfileVisibility、getMyUserProfileVisibility。
  • 新增用户搜索功能，支持通过用户应用号精确搜索用户。详见用户信息托管。相关接口：searchUserProfileByUniqueId。
  • 新增订阅事件功能，支持订阅、取消订阅、查询用户在线状态和用户信息变更事件。详见订阅用户在线状态、用户信息托管。相关接口：subscribeEvent、unsubscribeEvent、querySubscribeEvent、querySubscribeEventByPage、getSubscribeUsersOnlineStatus、addSubscribeEventListener。
  • 新增好友管理功能，支持添加、删除、检查、获取好友，以及设置好友信息和备注。详见好友管理。相关接口：addFriend、deleteFriends、checkFriends、getFriends、getFriendsInfo、searchFriendsInfo、setFriendInfo。
  • 新增好友申请管理功能，支持获取、接受、拒绝好友申请，以及设置加好友权限。详见好友管理。相关接口：getFriendApplications、acceptFriendApplication、refuseFriendApplication、setFriendAddPermission、getFriendAddPermission。
  • Conversation 新增 Message 字段。

25.11.0​

发布日期：2025/11/28

重要说明

为更好的对 HarmonyOS SDK 进行版本管理，从此版本开始原版本号的第一位 1 改为年份 25，后面二、三位版本号规则保持不变。

更新后版本号第一位为年份、第二位为功能迭代版本号、第三位为补丁修复 hotfix 版本号。

新增功能

  • 新增 getAllRobots 接口，用于获取机器人列表。
  • 新增 getRobotById 接口，用于根据机器人 id 获取机器人信息。
  • 新增 addRobotEventListener 接口，用于添加机器人信息同步完成监听。
  • 新增 removeRobotEventListener 接口，用于移除机器人信息同步监听。
  • 新增 getConversationsIncludingRobots 接口，用于获取包含机器人的会话列表。
  • 新增 saveEditedMessageDraft 接口，用于保存会话编辑草稿。
  • 新增 getEditedMessageDraft 接口，用于获取会话编辑草稿。
  • 新增 clearEditedMessageDraft 接口，用于删除会话编辑草稿。
  • InitOption 新增 enableSyncEmptyTopConversation 字段，用于同步置顶会话时生成的空会话。

1.10.0​

发布日期：2025/10/31

新增功能

  • 新增消息修改功能：
    • 新增 addMessageModifiedListener 接口，用于添加消息修改监听。
    • 新增 removeMessageModifiedListener 接口，用于移除消息修改监听。
    • 新增 modifyMessageWithParams 接口，用于修改已发送的消息。
    • 新增 refreshReferenceMessageWithParams 接口，用于刷新引用消息。

1.9.0​

发布日期：2025/9/26

新增功能

  • 新增 getUnreadMentionMeConversationList 接口，用于获取 @ 我的未读会话列表。
important

该版本 IM 和 RTC SDK 同步改动，请同时升级 IM 和 RTC SDK 至 1.9.0 版本，避免出现兼容性问题。

1.8.1​

发布日期：2025/9/2

功能优化

  • 优化了内部逻辑。

1.8.0​

发布日期：2025/8/29

important

该版本 IM 和 RTC SDK 同步改动，请同时升级 IM 和 RTC SDK 至 1.8.0 版本，避免出现兼容性问题。

新增功能

  • 支持群组托管功能，新增了以下接口：
    • 群组管理：createGroup、updateGroupInfo、getGroupsInfo、getGroupMembersByRole、getGroupMembers、checkUserInGroup、kickGroupMembers、quitGroup、dismissGroup、transferGroupOwner、addGroupManagers、removeGroupManagers、setGroupMemberInfo、searchGroupMembers
    • 群组加入：joinGroup、inviteUsersToGroup、acceptGroupInvite、refuseGroupInvite、acceptGroupApplication、refuseGroupApplication、getGroupApplications
    • 群组查询：getJoinedGroupsByRole、searchJoinedGroups、getJoinedGroups
    • 群组备注：setGroupRemark
    • 群组关注：addGroupFollows、removeGroupFollows、getGroupFollows
    • 事件监听：addGroupEventListener、removeGroupEventListener

问题修复

  • 修复了通过 Server API 撤回消息设置的 extra 在本地数据库 RC:RcNtf 消息中丢失的问题。
  • 修复了插入已读的文本消息导致会话未读数增加的问题。

1.7.2​

发布日期：2025/8/8

问题修复

  • 修复了连接成功后，切换网络时向上层通知数据库状态的问题。

1.7.1​

发布日期：2025/7/25

新增功能

  • 在 UserInfo 中新增用户类型字段（userType）。

1.6.0​

发布日期：2025/6/27

新增功能

  • 新增消息已读 V5 批量查询消息已读回执状态接口。
  • 新增 CombineV2Message 内置消息类型。
  • 新增 ReadReceiptMessage 内置消息类型。
  • 新增 setReadTimestamp 接口，用于设置已读时间戳。
  • 新增 removeRemoteConversations 接口，用于删除远端会话。

1.5.0​

发布日期：2025/5/29

新增功能

  • 新增逐条消息已读功能（消息已读 V5）。
  • 新增获取本地和远端历史消息功能。

1.4.3​

发布日期：2025/4/29

新增功能

  • 新增自定义媒体消息支持。
  • 新增 getDeltaTime 接口，用于获取本地时间与服务器时间的时间差。
  • 新增 setMessageExtra 接口，用于设置消息附加信息。
  • 新增 pauseDownloadMediaMessage 接口，用于暂停媒体消息下载。
  • 新增 downloadMediaFile 接口，支持根据远端文件地址下载媒体文件。
  • 新增 pauseDownloadMediaFile 接口，用于暂停媒体文件下载。
  • 新增 sendMediaMessageWithUploader 接口，支持使用自定义上传方式发送媒体消息。
  • 新增 downloadMediaMessageWithDownloader 接口，支持使用自定义方法下载媒体消息。
  • 新增自定义媒体消息上传和下载回调类 MediaMessageTransfer。
  • 图片消息的消息体新增缩略图宽高字段。
  • 多媒体消息下载后的文件名默认为消息中自带的文件名字段。

问题修复

  • 修复了获取设备版本信息不准确的问题。

1.3.2​

发布日期：2025/1/10

问题修复

  • 修复了在会话没有未读数情况下，再次拉取该会话历史消息时，该会话可能出现未读数异常的问题。
  • 修复了聊天室成员变化监听 setDatabaseStatusListener、addDatabaseStatusListener 不生效的问题。

1.3.1​

发布日期：2024/12/27

问题修复

  • 优化了 32061 错误码处理逻辑，调整为清空本地导航缓存并自动重连。
  • 修复了单聊 Message 的 senderId 字段错乱的问题。
  • 修复了连接方法回调之前，调用断开连接可能会发生死锁的问题。
  • 修复了同步单聊消息未读数时会清除会话对方未读数的问题。
  • 修复了偶现的进入聊天室后切换到后台一分钟以上，再切回前台后无法再接收聊天室消息的问题。
  • 修复了发消息过程中杀进程，再次打开后获取消息的发送状态依然是发送中的问题。
  • 修复了 connect 接口回调连接成功之前直接调用 disconnect 接口导致偶现崩溃的问题。

1.3.0​

发布日期：2024/12/12

新增功能

  • 消息功能
    • 新增发送定向消息方法 sendDirectionalMessage。
    • 新增发送定向媒体消息方法 sendDirectionalMediaMessage。
    • 新增下载媒体消息方法（含下载进度）downloadMediaMessageWithProgress。
    • 新增取消下载方法 cancelDownloadMediaMessage。
  • 用户配置功能
    • 新增显示推送详情接口 setPushContentShowStatus 和 getPushContentShowStatus。
    • 新增 Web 端在线时，手机端是否接收推送接口 setPushReceiveStatus 和 getPushReceiveStatus。
  • 搜索功能
    • 新增在指定的一批会话中搜索消息接口 searchMessagesByConversations。
    • 新增在本地指定会话中搜索多个成员指定的消息类型接口 searchMessagesByUsers。
  • 消息已读 V1 功能
    • Message 新增 ReadReceiptInfo 属性。
    • SentStatus 新增 Read 状态。
    • 新增 sendReadReceiptMessage 接口。
    • 新增 sendReadReceiptRequest 和 sendReadReceiptResponse 接口。
    • 新增 addMessageReadReceiptListener 和 removeMessageReadReceiptListener 接口。
    • 新增监听 MessageReadReceiptListener。

问题修复

  • 修复了加入聊天室接口和加入已存在聊天室接口的消息个数，保持与 iOS、Android 一致。

1.2.0​

发布日期：2024/11/01

新增功能

  • 新增完全支持 API12。详见 华为开发者公告。
  • 新增设置断线重连时是否踢出重连设备接口 setReconnectKickEnable。

消息功能

  • Message 扩展
    • 新增字段 canIncludeExpansion 和 expansion。
    • 新增消息扩展监听 MessageExpansionListener。
    • IMEngine 新增方法：
      • 设置扩展监听：setMessageExpansionListener
      • 更新扩展：updateMessageExpansion
      • 移除扩展：removeMessageExpansion
  • 新增插入单条消息方法 insertMessage。
  • 新增普通消息类型
    • 命令消息：CommandMessage
    • 命令提醒消息类（小灰条）：CommandNotificationMessage
    • 通知类消息（小灰条）：InformationNotificationMessage
    • 引用消息：ReferenceMessage
    • 图文消息：RichContentMessage
  • 新增媒体消息类型
    • GIF 消息：GIFMessage
    • 小视频消息：SightMessage
  • 撤回消息新增字段 originalMessageContent。

会话功能

  • 新增查询会话接口 searchConversationsWithResult。

功能废弃

  • 废弃接口 searchConversations，建议使用 searchConversationsWithResult 替代。

问题修复

  • 修复了删除本地消息接口崩溃的问题。
  • 修复了无法清空草稿的问题。

1.1.0​

发布日期：2024/08/29

重要变更

  • 枚举值 NaviRespLicenseExpired 更名为 ConnectLicenseExpired。
  • 枚举值 CmpRecvTimeOut 更名为 SocketRecvTimeout。
  • ChatroomStatusListener 从 abstract class 改为 interface。如果报错，删除 entry/build 目录重新编译即可。

新增功能

  • 数据库功能
    • 新增枚举值 DatabaseStatus。
    • 新增监听 setDatabaseStatusListener。
  • 消息功能
    • 新增位置消息 LocationMessage。
    • 新增方法 deleteRemoteMessages，用于删除远端消息。
  • 推送功能
    • 新增 IosConfig、AndroidConfig 和 HarmonyConfig 类。
  • 会话功能
    • 新增 getUnreadConversations 方法，用于获取未读会话。
  • 搜索功能
    • 新增 searchConversations、searchMessages、searchMessagesInTimeRange 和 searchMessagesByUser 方法。
    • 新增 ISearchMessageInTimeRangeOption 类。
  • 聊天室功能
    • 新增 setChatroomEntries、deleteChatroomEntries、getChatroomEntries、getAllChatroomEntries、setChatroomKVStatusListener 和 setChatroomMemberListener 方法。
    • 新增 ChatroomKVStatusListener、ChatroomMemberAction、ChatroomMemberActionListener、ChatroomNotifyEventListener、ChatroomSyncEvent、ChatroomMemberBlockEvent 和 ChatroomMemberBanEvent 类。
    • 新增枚举值 ChatroomMemberActionType。
  • 输入状态功能
    • 新增 setTypingStatusListener、sendTypingStatus 和 setTypingStatusInterval 方法。

问题修复

  • 修复了 IM 方法回调中再调用 IM 方法时，偶现的卡死情况。
  • 修复了 IM 连接偶现的 31002 错误。原因是偶现读取的系统版本号类似 OpenHarmony-5.0.0.36 这类包含 - 的特殊字符无法被 IM 服务识别。
  • 修复了 HTTPS 请求偶现的 OpenSSL 崩溃问题。
  • 修复了手机网络切换时偶现的崩溃问题。
  • 修复了发送失败的消息进行重发时，出现一条失败消息和一条成功消息的问题。
  • 修复了发送失败的消息，Message 对象为空的问题。
  • 修复了媒体消息发送失败，从数据库获取的发送状态为发送中（期望为发送失败）的问题。
  • 修复了 IGetRemoteMsgOption isCheckDup 的错误。
  • 修复了 UserInfo decode 时错误地将 userId 解析为 id 的错误。
  • 修复了置顶或免打扰之后，Conversation 的 lastSentTime 被错误更新为 lastOperateTime 的问题。

1.0.3​

发布日期：2024/08/06

新增功能

  • 基于 1.0.2 版本，新增支持字节码。应用需要修改配置，详情请参见 FAQ。

问题修复

  • 修复了置顶或免打扰之后，Conversation 的 lastSentTime 被错误更新为 lastOperateTime 的问题。

1.0.2​

发布日期：2024/07/11

新增功能

  • 新增用于创建并加入聊天室的 joinChatroom 接口。

功能优化

  • 为保持与其他平台统一，UserInfo 废弃了 portraitUrl，新增了 portraitUri。

问题修复

  • 修复了 TypeScript 层 Boolean 值被错误转化为 0、1，而非 Boolean 值的问题。

1.0.1​

发布日期：2024/07/02

新增功能

  • 新增 x86_64 架构支持，支持 Windows（64-bit）模拟器和 Mac（x86）模拟器。

1.0.0​

发布日期：2024/07/01

鸿蒙 SDK 初版