跳到主要内容

更新日志

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

问题修复

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

新增功能

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

1.2.0​

发布日期：2024/11/01

  • 新增：完全支持 API12 https://developer.huawei.com/consumer/cn/notice/20241010/
  • 修复：修复删除本地消息接口崩溃问题
  • 新增：设置断线重连时是否踢出重连设备接口 setReconnectKickEnable
  • 废弃：废弃接口 searchConversations
  • 修复：无法清空草稿

消息​

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

会话​

  • 新增：查询会话接口 searchConversationsWithResult

1.1.0​

发布日期：2024/08/29

重要

  • 枚举值：NaviRespLicenseExpired 改为 ConnectLicenseExpired
  • 枚举值：CmpRecvTimeOut 改为 SocketRecvTimeout
  • ChatroomStatusListener 从 abstract class 改为 interface，如果报错，删除 entry/build 目录重新编译即可
  • 修复：IM 方法回调中再调用 IM 方法，偶现的卡死情况
  • 修复：IM 连接偶现的 31002。原因是偶现读取的系统版本号类似 OpenHarmony-5.0.0.36 这类包含 - 的特殊字符无法被 IM 服务识别
  • 修复：https 请求偶现的 openssl 崩溃
  • 修复：手机网络切换时偶现的崩溃

数据库​

新增功能

  • 新增了枚举值 DatabaseStatus。
  • 新增了监听 setDatabaseStatusListener。

消息​

新增功能

  • 新增了位置消息 LocationMessage。
  • 新增了方法 deleteRemoteMessages。

问题修复

  • 修复了发送失败的消息进行重发，出现一条失败消息一条成功消息的问题。
  • 修复了发送失败的消息，Message 对象为空的问题。
  • 修复了媒体消息发送失败，从数据库获取的发送状态为发送中，期望为发送失败的问题。
  • 修复了 IGetRemoteMsgOption isCheckDup 错误。
  • 修复了 UserInfo decode 时错误的将 userId 解析为 id 的错误。

推送​

新增功能

  • 新增了 IosConfig,AndroidConfig 和 HarmonyConfig 类。

会话​

新增功能

  • 新增了 getUnreadConversations 方法。

问题修复

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

搜索​

新增功能

  • 新增了 searchConversations, searchMessages， searchMessagesInTimeRange 和 searchMessagesByUser 方法。
  • 新增了 ISearchMessageInTimeRangeOption 类。

聊天室​

新增功能

  • 新增了 setChatroomEntries，deleteChatroomEntries，getChatroomEntries，getAllChatroomEntries，setChatroomKVStatusListener 和 setChatroomMemberListener方法。
  • 新增了 ChatroomKVStatusListener，ChatroomMemberAction，ChatroomMemberActionListener，ChatroomNotifyEventListener，ChatroomSyncEvent，ChatroomMemberBlockEvent 和ChatroomMemberBanEvent类。
  • 新增枚举值 ChatroomMemberActionType。

输入状态​

新增功能

  • 新增了 setTypingStatusListener，sendTypingStatus 和 setTypingStatusInterval方法。

1.0.3​

发布日期：2024/08/06

新增功能

  • 基于 1.0.2 版本，支持字节码，app 需要修改配置，详细见 FAQ

问题修复

  • 修复：置顶或者免打扰之后，Conversation lastSentTime 被错误的更新为 lastOperateTime

1.0.2​

发布日期：2024/07/11

新增功能

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

功能优化

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

问题修复

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

1.0.1​

发布日期：2024/07/02

新增功能

  • 增加 x86_64 架构，支持 Windows(64-bit)-模拟器 和 Mac(x86)-模拟器

1.0.0​

发布日期：2024/07/01

鸿蒙 SDK 初版