Skip to main content

Release Notes

5.30.1

Release Date: 2025/11/14

New Features

  1. Added support for passing through extra information in the exit chatroom interface.

5.30.0

Release Date: 2025/10/31

Optimizations

  1. Optimized the response data of the Web refreshReferenceMessageWithParams interface by completing the reference message content.referMsgStatus status data.
  2. Optimized the response of the getUserProfiles interface during network disconnection to support returning locally cached data.
  3. Optimized the getConversationsFromTagByPage interface to support retrieving up to 1000 conversations, addressing potential pagination issues on the Web.
  4. Optimized the Web event compensation logic by completing event notifications during reconnection, including features like read receipts for individual messages (V5).

Bug Fixes

  1. Fixed occasional internal SDK errors during Web account switching.
  2. Fixed issues with APIDoc and some .d.ts declaration files not being exported correctly.
  3. Fixed the Web's inability to receive sensitive word blocking notifications (affected versions: 5.26.1 - 5.28.1).
  4. Fixed occasional missing time data updates in Web Events.CONVERSATION notifications (affected versions: 5.20.0 - 5.28.1).
  5. Fixed occasional unread count errors when receiving ultra group messages on Web (affected versions: 5.20.0 - 5.28.1).

5.28.1

Release Date: 2025/10/10

New Features

  1. Added support for the isModifyMessage property of messages on the Electron platform.

Bug Fixes

  1. Fixed abnormal sorting and data issues in the Web history message retrieval interface (affected version: 5.28.0).

5.28.0

Release Date: 2025/09/26

Breaking Changes

  1. The original synchronous getUnreadMentionedMessages interface caused performance issues on Electron and has been deprecated. A new asynchronous interface electronExtension.getUnreadMentionedMessages has been added as a replacement.

New Features

  1. Added support for ultra group conversation types on Electron.
  2. Optimized chatroom functionality with full feature support on Electron and internal logic improvements on other platforms, along with various bug fixes.
  3. Added Electron support for the getBlockedConversationList interface.
  4. Added the Events.DATABASE_OPENED event on Electron to monitor local database opening or reconstruction after corruption.
  5. Added the getUnreadMentionMeConversationList interface to retrieve conversations with unread @mentions.
  6. Added the getSubscribeUsersOnlineStatus interface to query the online status of subscribed users.

Optimizations

  1. Improved write efficiency for message extensions on Electron, enhancing performance in related scenarios.
  2. Added getConversationListByTimestamp and getAllConversationList interfaces to replace getConversationList, addressing result inconsistencies across platforms and parameters.

Bug Fixes

  1. Fixed local cache not updating after updateMyUserProfile on Web (affected versions ≥ 5.24.0).
  2. Fixed abnormal targetId assignment in the latestMessage property of Web conversations (affected versions ≥ 5.20.0).
  3. Fixed incorrect list order in Electron's getRemoteHistoryMessages to match other platforms.
  4. Fixed occasional response delays in Electron's requestSpeechToTextForMessage interface (affected versions ≥ 5.22.0).

5.26.2

Release Date: 2025/09/11

New Features

  1. Added support for synchronizing server-side conversation lists on Electron.
  2. Enhanced the removeConversation interface to support deleting server-side conversations on Electron.

Bug Fixes

  1. Fixed occasional memory leaks in Electron's logging module (affected versions: 5.26.0 and 5.26.1).

5.26.1

Release Date: 2025/09/05

New Features

  1. Added support for editing successfully sent messages in one-to-one and group chats.
  2. Enhanced Web conversation list retrieval by including latestMessage data in:
    • Pinned conversations: getTopConversationList
    • Blocked conversations: getBlockedConversationList
    • Unread conversations: getUnreadConversationList
    • Tag-filtered conversations: getConversationsFromTagByPage
    • Specific conversation: getConversation
  3. Added the batch conversation deletion interface batchDeleteConversations.
  4. Deprecated Electron's multi-process mode in favor of single-process operation with optimized message handling performance.

Bug Fixes

  1. Fixed potential discarding of RTC business messages and sensitive word blocking notifications on Web.
  2. Fixed business exceptions caused by receiving abnormal messages (content as "null") on Web.
  3. Fixed connection recovery issues when apps return to foreground on Douyin Mini Program.
  4. Improved crash prevention for invalid parameters on Electron.

5.24.2

Release Date: 2025/08/14

New Features

  1. Added support for Kuaishou Mini Program platform.

Bug Fixes

  1. Fixed occasional conversation cache read failures causing business exceptions on Web (affected versions: 5.24.0 and 5.24.1).
  2. Fixed excessive redundant data fetching due to message gaps on Electron.
  3. Fixed abnormal translateStrategy values in Electron's conversation retrieval interfaces.
  4. Fixed occasional loss of friend extension data on Electron.

5.24.1

Release Date: 2025/08/04

Bug Fixes

  1. Fixed occasional failure to receive translation result notifications when translation is enabled.
  2. Fixed local cache cleanup issues after receiving chatroom destruction notifications on Web.
  3. Fixed incorrect translateStrategy data in Electron's getConversation interface.

5.24.0

Release Date: 2025/07/25

New Features

  1. Added intelligent text translation for messages and arbitrary text.
  2. Added conversation status sync completion notification Events.CONVERSATIONS_SETTINGS_SYNCE.
  3. Added user settings sync completion notification Events.USER_SETTINGS_SYNCED.
  4. Added user settings change notification Events.USER_SETTINGS_CHANGE.
  5. Added isConversationListIncludeUltraGroup to AppSettings to check ultra group support in conversation lists.
  6. Added electronExtension.getUntaggedConversationListByPage to retrieve untagged conversations.

Bug Fixes

  1. Fixed occasional operationTime=0 in Web's getConversationsFromTagByPage (affected versions ≥ 5.20.0).
  2. Fixed unparsed message expansion data in Web's online messages (affected versions ≥ 5.20.0).
  3. Fixed connection recovery after device sleep/wake on Electron (error code 32061).
  4. Improved V2-Adapter compatibility with legacy upload plugins.
  5. Fixed clearHistoryMessages failure when missing channelId on Electron (affected versions ≥ 5.20.0).
  6. Fixed local cache update issues after Web's setConversationTypeNotificationLevel.

5.22.0

Release Date: 2025/06/27

New Features

  1. Added voice-to-text conversion, configurable via developer console.
  2. Added global message search via Electron's searchMessageWithParams.
  3. Added getAppSettings to query feature toggles (currently voice-to-text only).

Optimizations

  1. Relaxed needReceipt validation during message sending, automatically setting to false when invalid.
  2. Added cross-conversation read receipt count interface getMessageReadReceiptInfoV5ByIdentifiers.

Bug Fixes

  1. Fixed incorrect targetId in Web's multi-device sync (affected versions ≥ 5.20.0).
  2. Fixed incorrect totalCount in Web's getMessagesReadReceiptUsersByPageV5 (affected versions ≥ 5.20.0).
  3. Fixed totalCount errors in Electron's MESSAGE_RECEIPT_RESPONSE_V5 (affected versions ≥ 5.20.0).
  4. Fixed incorrect operationTime in Web's getGroupApplications (affected versions ≥ 5.12.0).
  5. Fixed sorting issues in Web's getConversationList without ultra group support (affected versions ≥ 5.20.0).
  6. Fixed rare message reception failures during weak network on Web.
  7. Fixed lost pin/DND/tag states when recreating deleted conversations (affected versions ≥ 5.20.0).
  8. Fixed empty search results when messageTypes/conversationTypes are null on Electron (affected versions ≥ 5.20.0).
  9. Miscellaneous parameter validation fixes.

5.20.2

Release Date: 2025/06/12

Bug Fixes

  1. Fixed Web conversation cache read/write errors (affected versions ≥ 5.20.0).
  2. Fixed inconsistent search behavior between Electron and legacy versions (affected versions ≥ 5.20.0).
  3. Fixed incorrect needReceipt values in sendMessage responses (affected versions ≥ 5.20.0).

5.20.1

Release Date: 2025/06/03

New Features

  1. Added WeChat Mini Program platform support for the requestStreamMessageContent interface.

Bug Fixes

  1. Fixed occasional errors when retrieving chatroom messages after joining (affected versions ≥ 5.18.0)

5.20.0

Release Date: 2025/05/31

New Features

  1. Added "Ultra Group Support in Conversation List" feature (requires ticket submission to enable). When enabled:
    • Web clients will maintain a full one-to-one and group chat conversation list in memory, triggering the Events.CONVERSATIONS_SYNCED event to notify when synchronization completes;
    • The getConversationList interface will include default ultra group channel conversations;
    • Unread counts from default ultra group channels will be included in getTotalUnreadCount results;
    • The clearAllMessagesUnreadStatus interface can clear unread counts for default ultra group channels;
    • The getTopConversationList interface will include pinned ultra group default channel conversations;
    • The getUnreadConversationList interface will include unread ultra group default channel conversations;
  2. The removeConversation interface now supports deleting remote ultra group conversations;
  3. The setConversationToTop interface adds isCreateConversation and isUpdateTime parameters, with support for ultra group default channels;
  4. Added Electron platform support for clearAllMessagesUnreadStatus;
  5. New setConversationTypeNotificationLevel and getConversationTypeNotificationLevel interfaces for defining default Do Not Disturb levels by conversation type;
  6. Added per-message read receipts (Read Receipts v5), supporting read status marking for one-to-one and group chat messages;
  7. The getConversation interface now supports retrieving ultra group conversations;
  8. The disconnect interface supports a disablePush parameter to disable offline notifications;
  9. IMLib-v2-Adapter callback functions now support async declarations;
  10. Web clients now cache first unread message information for one-to-one and group chats locally;
  11. electronExtension.searchConversationByContent now supports searching by specified conversation types.

Breaking Changes

  1. The Events.ULTRA_GROUP_ENABLE event no longer provides callback data - clients should call interfaces directly to retrieve ultra group conversation lists;
  2. The getBlockedConversationList and getUnreadConversationList interfaces now return IAReceivedConversation[] lists with additional locally cached conversation information (drafts, unread counts, etc.);
  3. Local operations (setting conversation pinning/DND) no longer trigger duplicate Events.CONVERSATION callbacks;
  4. The messageType parameter in electronExtension.setMessageContent is now required to support post-modification message content searches.

Bug Fixes

  1. Fixed abnormal callback data in group hosting feature's group application notifications;
  2. Fixed occasional connection issues on Electron platform (affected versions ≥ 5.16);
  3. Fixed ultra group message sending not updating local conversation cache;
  4. Fixed Web clients not triggering Events.CONVERSATION after receiving recalled messages (affected versions ≥ 5.18.0);
  5. Fixed RTCLib compatibility issues (affected versions ≥ 5.14.0).

5.18.0

Release Date: 2025/05/08

Important Changes

  1. IMLib-v4-Adapter is officially deprecated, with final version maintained at 5.16.x.

New Features

  1. Image messages now support optional thumWidth and thumHeight values in content to specify thumbnail dimensions.

Bug Fixes

  1. Fixed occasional errors caused by abnormal downstream data (no business impact);
  2. Fixed multi-device synchronization issues for pinned/DND conversation data;
  3. Fixed parameter validation errors when sending @mentions;
  4. Fixed Electron platform setMessageStatusToRead errors when channelId contains non-string data;
  5. Fixed incorrect userId lists in Electron platform friend deletion notifications;
  6. Fixed Electron platform not clearing local unread counts when syncing multi-device unread status (affected versions: ≥5.16.0);
  7. Fixed duplicate callbacks when setting chatroom KV attributes via Server API on Electron platform.

5.16.1

Release Date: 2025/04/10

Bug Fixes

  1. Fixed Electron platform multi-device read status synchronization incorrectly clearing peer unread counts (affected version: 5.16.0).

5.16.0

Release Date: 2025/03/28

New Features

  1. Added "RC:StreamMsg" streaming message support with new requestStreamMessageContent method (Mini Programs excluded);
  2. IM connections now support IPv6-only protocols;
  3. User profile hosting adds content moderation, returning failed field lists when updates are rejected;
  4. Message recall adds isAdmin parameter for IMKit display requirements;
  5. Added electronExtension.getLocalMessage interface (deprecating original getMessage).

Bug Fixes

  1. Fixed inconsistency between ultra group and regular message recall results;
  2. Fixed Electron getMessage returning ErrorCode.SUCCESS for failed local message queries (now returns ErrorCode.RC_DB_DATA_NOT_FOUND);
  3. Fixed missing changed fields in group/user info change notifications when setting values to "" or 0;
  4. Fixed Electron log writing errors causing data loss (affected versions: ≥5.12.2);
  5. Fixed occasional log reporting omissions/duplications on Electron;
  6. Fixed Web onSendBefore callback not executing during network outages.

5.14.1

Release Date: 2025/03/06

Bug Fixes

  1. Fixed missing exports in @rongcloud/engine causing RTC/Call/CallPlus SDK issues (affected version: 5.14.0);
  2. Fixed occasional KV data retrieval failures when rapidly joining/leaving chatrooms.

5.14.0

Release Date: 2025/02/28

New Features:

  1. Web conversation lists now support operationTime field for tracking operation timestamps;
  2. Events.GROUP_INFO_CHANGED callbacks now include fullGroupInfo with complete group data;
  3. Added global Do Not Disturb configuration management.

Bug Fixes

  1. Fixed missing tag change notifications on Electron;
  2. Fixed configuration issues preventing friend invitation push notifications;
  3. Fixed missing onBefore callbacks when sending messages in Electron single-process mode;
  4. Fixed inconsistent response codes between Electron and Web for getChatroomEntry.

Important Changes

  1. All interface error codes now use number type.

5.12.4

Release Date: 2025/02/06

Bug Fixes:

  1. Fixed local unread count update failures and other cache issues (introduced in 5.12.3).

v5.12.3

Release Date: 2025/01/17

Bug Fixes:

  1. Fixed Electron platform conversation pinning incorrectly modifying DND levels;
  2. Fixed searchGroupMembers result format - added missing pageToken field.

v5.12.2

Release Date: 2024/12/26

New Features:

  1. Added toggle for updating last message in conversation list for one-to-one/group chats.

Optimizations:

  1. Fixed banned users rejoining chatrooms after network reconnection;
  2. Fixed custom message registration loss after child process restart;
  3. Fixed reconnection failures after child process crashes;
  4. Fixed incorrect data structure in Electron callInfo callbacks;
  5. Improved Electron log reporting format;
  6. Enhanced multi-device read status sync with targeted message type filtering.

v5.12.1

Release Date: 2024/10/28

Optimizations:

  1. Fixed token/navi expiration preventing reconnection after child process crashes;
  2. Changed error code from 34328 to 34232 for invalid count parameters in getFriends/getFriendApplications;
  3. Fixed default value assignment for extension fields in updateGroupInfo during child process startup.

v5.12.0

Release Date: 2024/10/18

New Features:

  1. Added group/member management capabilities to profile hosting;
  2. Added friend relationship management to profile hosting.

Optimizations:

  1. Fixed user profile retrieval errors when only profile hosting (without status subscription) is enabled;
  2. Fixed empty message content after insertion.

v5.10.4

Release Date: 2024/08/29

Optimizations:

  1. Added uniapp Vue3 framework compatibility for APP builds;
  2. Added database upgrade callback events for Electron.

v5.10.3

Release Date: 2024/07/30

New Features:

  1. Added join timestamps to chatroom entry responses;
  2. Added HarmonyOS push attribute support for sent messages;
  3. Added HarmonyOS platform support for online status subscriptions.

Bug Fixes:

  1. Fixed black borders in image message thumbnails.

v5.10.2

Release Date: 2024/07/02

Optimizations:

  1. Changed default pinned empty conversation sync setting to false.

v5.10.1

Release Date: 2024/06/28

New Features:

  1. Added user profile hosting functionality;
  2. Added Electron platform support for disabling pinned empty conversation sync.

Bug Fixes:

  1. Fixed potential undefined count returns from searchMessages;
  2. Fixed incorrect mentionedInfo in non-group conversations;
  3. Fixed incorrect lastMessageSendTime in RC:SRSMsg content.

v5.9.9

Release Date: 2024/06/05

New Features:

  1. Added batch get conversation information method for Electron platform.

Bug Fixes:

  1. Fixed real-time log request failures caused by special characters in URLs.
  2. Fixed inability to send RC:SRSMsg messages to system conversations.
  3. Fixed potential errors during log database upgrades.
  4. Fixed abnormal sending status when locally inserting RC:RcNtf messages in Electron.
  5. Fixed RTC signaling transmission and parsing failures in Electron platform.
  6. Fixed child process crashes caused by consecutive 30021 errors during connection.
  7. Fixed latestMessage update issues during batch message insertion.
  8. Fixed child process restart issues when application exits.

v5.9.8

Release Date: 2024/04/29

New Features:

  1. Added User Online Status Update Callback functionality.
  2. Added support for sending targeted notifications when recalling messages.
  3. Electron platform added get local messages around specified timestamp method.
  4. Electron platform's search local conversation history interface now supports message type filtering.

Bug Fixes:

  1. Fixed Web platform message processing exceptions that prevented further message retrieval.
  2. Fixed CombineV2Message export errors.

v5.9.7

Release Date: 2024/04/01

Bug Fixes:

  1. Fixed errors when downloading IMLib-next package via NPM.

v5.9.6

Release Date: 2024/03/29

New Features:

  1. Added target user list specification for targeted messages.
  2. Added unique identifier referMsgUid for referenced messages.
  3. Added electronExtension.getContinuousMessages interface for simultaneous local and remote history message queries.

Bug Fixes:

  1. Fixed reconnection issues when receiving 30021 errors.
  2. Fixed duplicate recall notifications in message listeners after active message recall.

Optimizations:

  1. Adapted Electron platform for context isolation scenarios.

v5.9.5

Release Date: 2024/01/31

Optimizations:

  1. Made receivedStatusInfo in message data optional to resolve potential TS errors.

v5.9.4

Release Date: 2024/01/31

New Features:

  1. Ultra groups now support targeted messaging.
  2. Ultra groups support batch message deletion by Message UID.
  3. Pinned empty conversations now sync across multiple devices.
  4. Added sorting by pinned status parameter for conversation list retrieval.
  5. Electron platform added interface for retrieving all unread mention counts.
  6. Electron platform added status message sending functionality.

Bug Fixes:

  1. Fixed invalid thumbnail quality parameter in image messages.
  2. Fixed status message sending issues in Electron platform.

Optimizations:

  1. Improved group message read receipt functionality.

v5.9.3

Release Date: 2023/12/18

New Features:

  1. Electron platform added setMessageReceivedStatusInfo method.

Optimizations:

  1. Added sendUserId to one-to-one read receipt callbacks for sender identification.
  2. Improved offline message receipt triggering sequence during multi-device login.

Bug Fixes:

  1. Fixed parameter type definition error in removeChatRoomEntries interface.
  2. Fixed incorrect timestamps in conversation status change notifications.

v5.9.2

Release Date: 2023/12/13

Bug Fixes:

  1. Fixed high latency in Electron message sending interface on Windows.
  2. Fixed application freezes when pulling large offline messages in Electron/Windows.
  3. Added empty list restriction for addConversationsToTag interface.

v5.9.1

Release Date: 2023/11/28

Bug Fixes:

  1. Fixed dependency download issues for @rongcloud/electron in Node 14 and below.

v5.9.0

Release Date: 2023/11/23

New Features:

  1. Added conversation information to message expansion change notifications (Events.EXPANSION).
  2. Added current chatroom member count to join/exit notifications.
  3. Added getAllUnreadMentionedCount interface for cross-conversation unread mentions.
  4. Added draft field to conversation list retrieval.
  5. Added getFirstUnreadMessageInfo interface.
  6. Added Honor push configuration support.

Bug Fixes:

  1. Removed dynamic navigation address requests for mini-programs.
  2. Fixed potential missed sensitive word blocking notifications.
  3. Fixed incorrect @ fields in conversations.
  4. Fixed 26002 errors during frequent tag/conversation status API calls.
  5. Fixed duplicate message modifications after recall in Electron.
  6. Fixed Electron/Windows exit hangs.
  7. Optimized performance during high message volumes on Windows.

v5.8.5

Release Date: 2023/10/27

Optimizations:

  1. Improved SDK log upload mechanism.

Bug Fixes:

  1. Fixed incorrect @ fields in conversations.

v5.8.4

Release Date: 2023/09/25

New Features:

  1. Electron platform supports Do Not Disturb levels.
  2. Added operationTime field to conversation lists (Electron only).

Bug Fixes:

  1. Fixed automatic rejoin issues after page refresh in chatrooms.
  2. Fixed incorrect read status for locally inserted recalled messages (Electron).
  3. Fixed concurrent voice message upload errors.

v5.8.3

Release Date: 2023/08/31

New Features:

  1. Multi-device unread count sync now supports system conversations.
  2. File messages now support @ mentions.
  3. Chatroom join interface returns room and user status information.
  4. Electron platform inserts RC:RcNtf messages for recalls even when original message is missing.

v5.8.2

Release Date: 2023/07/28

New Features:

  1. Electron platform supports win32 X64 architecture.
  2. Electron platform handles multi-device sync messages (RC:ReadNtf).
  3. Electron platform adapted upload functionality.

Bug Fixes:

  1. Fixed connection issues after server restarts.
  2. Fixed Alipay mini-program connection errors.

v5.8.1

Release Date: 2023/07/14

New Features:

  1. Added support for gray bar messages (RC:InfoNtf), command messages (RC:CmdMsg), and group notification messages (RC:GrpNtf).

v5.8.0

Release Date: 2023/07/3

New Features:

  1. Added message type property to ultra group unread @ mentions.

Bug Fixes:

  1. Fixed occasional heartbeat issues during reconnection.

Other:

  1. Mini-program security domain adjustments.

v5.7.10

Release Date: 2023/06/15

New Features:

  1. Added getUltraGroupUnreadInfoList for batch ultra group unread info retrieval.
  2. Electron platform added searchMessagesByUser for sender-based message search.

Bug Fixes:

  1. Fixed ultra group @ mention recall count issues.
  2. Fixed potential infinite loops when pulling ultra group messages.

v5.7.9

Release Date: 2023/05/29

New Features:

  1. Added chatroom status notifications (bans, mutes, join/exit sync).
  2. Electron platform auto-reconnects on 30019/30021 errors.
  3. Added region code setting during initialization.
  4. Added unread @ mention counts to ultra group channel lists.

Bug Fixes:

  1. Fixed unread count issues when recalling ultra group messages.
  2. Fixed duplicate socket connections in Alipay mini-programs.

v5.7.8

Release Date: 2023/05/11

New Features:

  1. Electron IMLib added draft operations.

Bug Fixes:

  1. Fixed uniapp app connection issues.
  2. Disabled log storage for IE due to missing indexDB.getAllKeys.

v5.7.7

Release Date: 2023/04/21

Bug Fixes:

  1. Fixed undefined notificationLevel in Do Not Disturb list retrieval.
  2. Fixed system conversation retrieval issues in Electron.

Other:

  1. Added RC:ReadNtf message handling.
  2. Added vivo push category configuration options.

v5.7.5

Release Date: 2023/04/12

Bug Fixes:

  1. Optimized error handling for disabled resource pb in versions prior to 5.4.7.

v5.7.4

Release Date: 2023/03/30

Bug Fixes:

  1. Fixed the issue where unread counts couldn't be retrieved for conversations without Do Not Disturb levels or status.
  2. Fixed the issue where web platforms would receive notifications for KV changes they set themselves in chatrooms.
  3. Fixed the occasional error "Cannot read property 'kvStorage' of null".
  4. Fixed the occasional issue where self-sent messages would appear in message listeners after reconnecting from network disconnection.

Other:

  1. Modified the count parameter range for the history message retrieval API to 0-100 (exceeding values will now return errors).
  2. Added firstUnreadMessage and channelType fields to the return value of the getConversations API for ultra group conversations.

v5.7.3

Release Date: 2023/03/02

New Features:

  1. Added ultra group user group notification monitoring
  2. Push notification attribute configuration IPushConfig.androidConfig now supports Huawei push parameters:
    1. categoryHW: Huawei push message classification
    2. importanceHW: Huawei push message priority level
    3. imageUrlHW: Notification image URL for Huawei notification-type pushes
  3. Push notification attribute configuration IPushConfig.androidConfig now supports message push parameters:
    1. miLargeIconUrl: Xiaomi Large icon URL

Bug Fixes:

  1. Fixed the issue where the levels parameter didn't take effect in the unread count retrieval API by conversation Do Not Disturb level
  2. Fixed the conversation change notification issue where senders received their own @mentions
  3. Fixed incorrect notificationlevel field values in the Do Not Disturb conversation list retrieval
  4. Fixed the issue where conversation status persisted from previous users after switching accounts
  5. Fixed the CMP connection failure reconnection issue in Electron platform
  6. Fixed the issue where individual iOSConfig or androidConfig settings in push configurations didn't take effect

v5.7.2

Release Date: 2023/02/07

New Features:

  1. Added batchInsertMessage API for Electron platform to support batch message insertion to local storage
  2. Added getMessageCount API for Electron platform to retrieve total message count for specific conversations

Bug Fixes:

  1. Fixed incorrect status type returned by getConnectionStatus API
  2. Fixed the Do Not Disturb conversation list retrieval API (getBlockedConversationList) to properly return conversations with Do Not Disturb levels. Now returns all conversations with level > 0.

Optimizations:

  1. Optimized web platform local conversation status cache limit to support up to 1000 conversation states
  2. Optimized Electron platform navigation caching by replacing database storage with local file storage

v5.7.1

Release Date: 2023/01/10

New Features:

  1. Added setCheckDuplicateMessage API for Electron platform to disable message deduplication when receiving messages
  2. Added closeDB parameter to Electron platform's disconnect API

Bug Fixes:

  1. Fixed indexDB compatibility issues in Firefox browser
  2. Fixed the disconnection failure issue when calling disconnect during network reconnection
  3. Fixed the KV data update type (ChatroomEntryType) showing as UPDATE for others after calling removeChatRoomEntry. Now correctly shows as DELETE.
  4. Fixed inconsistency between message extension fields (canIncludeExpansion, expansion) set during message insertion and returned data in Electron platform
  5. Fixed HTTP request errors in Electron platform

Optimizations:

  1. Completed location message type registrations
  2. Added alias field to IUserInfo

v5.7.0

Release Date: 2022/12/01

New Features:

  1. Added unread conversation list retrieval getUnreadConversationList, supporting one-to-one chat, group chat, and system conversations.

Bug Fixes:

  1. Fixed ultra group unread count calculation including self-sent messages
  2. Fixed incorrect hasMentioned field in conversation list retrieval for Electron platform
  3. Fixed incorrect isMentioned field in message retrieval for Electron platform

Optimizations:

  1. When reconnecting after network disconnection, SDK will no longer attempt to rejoin banned chatrooms
  2. During reconnection, the number of historical messages pulled when rejoining chatrooms internally matches the join parameter value (default: 10)

Breaking Changes:

  1. Connection status callback parameter types changed:

    • Events.DISCONNECT callback parameter type changed from [ConnectionStatus] to [ErrorCode]
    • Events.SUSPEND callback parameter type changed from ConnectionStatus | ErrorCode to ErrorCode
  2. Interface return type changes:

    Method NamePrevious Return TypeNew Return Type
    [getUltraGroupMessageListByMessageUId][IReceivedMessage][IAReceivedMessage]
    [getConversationsFromTagByPage][IReceivedConversationByTag][IAReceivedConversationByTag]
  3. Event callback type changes:

    Event NamePrevious Return TypeNew Return TypeDescription
    ULTRA_GROUP_ENABLE[IReceivedConversation][IAReceivedConversation]Ultra group conversation list synchronization completed
    ULTRA_GROUP_MESSAGE_EXPANSION_UPDATED[IReceivedMessage][IAReceivedMessage]Ultra group message extension update notification
    ULTRA_GROUP_MESSAGE_MODIFIED[IReceivedMessage][IAReceivedMessage]Ultra group message modification notification
    ULTRA_GROUP_MESSAGE_RECALLED[IReceivedMessage][IAReceivedMessage]Ultra group message recall notification

v5.6.1

Release Date: 2022/11/18

Optimizations:

  1. On Electron platform, SDK now updates recalled messages as gray bar messages RC:RcNtf
  2. RongIMLib.electronExtension.insertMessage API now supports BaseMessage type parameters
  3. Added list field to getHistoryMessagesByMessageTypes return object (messages field marked as deprecated)

Other:

  1. Added support for JD Mini Program platform

v5.6.0

Release Date: 2022/11/04

New Features:

  1. Added new API: Get Pinned Conversation List

Bug Fixes:

  1. Fixed an issue where the application layer would not receive status notifications when reconnecting with an expired token
  2. Fixed an issue where the offLineMessage field was incorrectly set to true for messages received on Electron clients during multi-device login
  3. Fixed an issue where Web clients would receive messages from chatrooms joined by other devices during multi-device login, even when not joined locally
  4. Fixed potential message duplication in Electron platform when inserting local messages (insertMessage) due to specified server message ID (messageUId)
  5. Fixed search functionality for quoted messages and image-text messages in Electron platform
  6. Fixed an issue where messages sent from Electron platform couldn't carry "@ mentions"
  7. Fixed console errors when receiving RC:RLQuit and RC:RLJoin messages for location sharing feature on Web platform

Breaking Changes:

  1. Electron platform now requires appkey parameter during main process initialization (@rongcloud/electron), otherwise initialization will fail. See Main Process Initialization
  2. Modified the download method for Electron platform extension .node packages. See: Install .node Files
  3. Web platform no longer supports Comet connection mode, only WebSocket connections are supported

v5.5.5

Release Date: 2022/10/21

Bug Fixes:

  1. Fixed backward compatibility errors in navigation data change notifications that could prevent some RTCLib or CallLib users from using conversation tags properly.

v5.5.4

Release Date: 2022/09/23

Bug Fixes:

  1. Fixed incorrect decoding of int64 data in RTC signaling that could cause KV data anomalies in RTC rooms.

v5.5.3

Release Date: 2022/09/22

Bug Fixes:

  1. Fixed missing Event.SUSPEND notifications during network exceptions
  2. Fixed potential failure to receive ultra group initialization completion notification (Event.ULTRA_GROUP_ENABLE) under poor network conditions
  3. Corrected interface type declarations for callback parameters in Event.MESSAGES and Event.CONVERSATION events

v5.5.2

Release Date: 2022/09/09

New Features:

  1. Added getUltraGroupUnreadMentionedMessages API to retrieve unread @ messages list for ultra groups
  2. Added getUltraGroupFirstUnreadMessageTimestamp API to get the timestamp of the first unread message in ultra groups

Bug Fixes:

  1. Fixed database conversation list loss in Electron when upgrading to version 5.5.0

v5.5.1

Release Date: 2022/09/01

New Features:

  1. Added getTotalUnreadCountByLevels API to get total unread message count filtered by conversation Do Not Disturb levels
  2. Added getTotalUnreadMentionedCountByLevels API to get total unread @ message count filtered by conversation Do Not Disturb levels
  3. Enhanced getUltraGroupUnreadCountByTargetId to support filtering by conversation Do Not Disturb levels
  4. Enhanced getUltraGroupUnreadMentionedCountByTargetId to support filtering by conversation Do Not Disturb levels
  5. Added messageId field to sent and received messages

Bug Fixes:

  1. Fixed an issue where frequent ultra group KV modifications and message sending could cause users to receive their own sent messages
  2. Fixed potential crashes in Electron when sending custom messages containing numbers exceeding 32-bit limits in content

v5.5.0

Release Date: 2022/08/25

Optimizations:

  1. Architectural improvements to reduce version dependencies between plugin-rtc upgrades and IMLib

v5.4.5

Release Date: 2022/08/18

New Features:

  1. Added sensitive word notifications for ultra group message modifications and message extensions

Bug Fixes:

  1. Fixed duplicate notifications when setting conversation status across multiple devices
  2. Fixed incorrect HTTP request header fields in mini program platform
  3. Fixed KV retrieval issues when joining multiple chatrooms where later-joined chatrooms had anomalies

Other:

  1. Added support for WeChat Mini Program plugin platform
  2. Added WebSocket connection support for Alipay Mini Program platform

v5.4.4

Release Date: 2022/08/16

Bug Fixes:

  1. Fixed duplicate notifications for ultra group message extension changes
  2. Fixed missing notifications when channelId was empty in ultra group message extension changes

v5.4.3

Release Date: 2022/08/04

Bug Fixes:

  1. Fixed missing senderUserId parameter in getUltraGroupMessageListByMessageUId API and ultra group message change notifications

v5.4.2

Release Date: 2022/07/21

New Features:

  1. Added ultra group private channel functionality
  2. Added channelType parameter to getUltraGroupList API
  3. Added ultra group channel type (private/public) change notification: RongIMLib.Events.ULTRA_GROUP_CHANNEL_TYPE_CHANGE
  4. Added private channel allowlist user removal notification: RongIMLib.Events.ULTRA_GROUP_CHANNEL_USER_KICKED
  5. Added channel deletion notification: RongIMLib.Events.ULTRA_GROUP_CHANNEL_DLELTE

Bug Fixes:

  1. Fixed internal logger reference errors

v5.4.1

Release Date: 2022/07/02

Bug Fixes:

  1. Fixed potential compilation errors after being referenced

v5.4.0

Release Date: 2022/07/01

New Features:

  1. Added notificationLevel field to conversation list retrieval
  2. Added uploadDomain parameter to init method, supporting custom file upload servers (private cloud only, currently supports Qiniu addresses)
  3. New Electron platform APIs:
  4. New blocklist-related APIs:

Release Date: 2022/05/20

Optimizations:

  1. Optimized the mechanism for retrieving messages and extended attributes in chatrooms.

v5.3.1

Release Date: 2022/05/19

New Features:

  1. Added the isDelete parameter to the message recall interface, allowing control over whether mobile recipients display the gray bar notification for recalled messages.

Bug Fixes:

  1. Optimized reconnection logic to fix potential reconnection failures during network exceptions.
  2. Fixed an error when pulling messages during comet connections.
  3. Corrected a spelling error in the NotificationLevel enum value from AT_GROUP_ALL_USER_NOFICATION to AT_GROUP_ALL_USER_NOTIFICATION.
  4. Fixed an issue where the SDK would abnormally pull ultra group messages after reconnection when the App Key had ultra group services disabled.

Other:

  1. Optimized connection logic.

v5.3.0

Release Date: 2022/04/29

New Features:

  1. The message body for recalling messages can now include an extra field.
  2. Added the contentDisposition parameter to the file upload message interface.
  3. Added new interfaces:
    • setUltraGroupDefaultNotificationLevel for setting default notification configurations for specified ultra groups.
    • getUltraGroupDefaultNotificationLevel for querying default notification configurations for specified ultra groups.
    • getUnreadMentionedCount for retrieving unread mention counts in specified conversations.
    • getUltraGroupUnreadCountByTargetId for retrieving total unread counts across all channels in specified ultra groups.
    • getUltraGroupUnreadMentionedCountByTargetId for retrieving total unread mention counts across all channels in specified ultra groups.
    • getAllUltraGroupUnreadCount for retrieving total unread counts across all ultra groups.
    • getAllUltraGroupUnreadMentionedCount for retrieving total unread mention counts across all ultra groups.
    • setConversationNotificationLevel for setting Do Not Disturb levels.
    • getConversationNotificationLevel for retrieving Do Not Disturb levels.

Bug Fixes:

  1. Fixed an issue where broadcast messages would be received again after disconnecting and reconnecting.
  2. Fixed an issue where the latest ultra group conversation list couldn't be retrieved after reconnecting.
  3. Fixed an error when calling the disconnect method in IE 11.

Other:

  1. Increased the length limit for ultra group message extension field values to 4096.

v5.2.4

Release Date: 2022/04/15

Bug Fixes:

  1. Fixed a rare issue where messages of type ConversationType.RTC_ROOM might be lost.

v5.2.3

Release Date: 2022/04/15

Bug Fixes:

  1. Fixed an issue where logs couldn't be reported when using HTTPS protocol.

v5.2.2

Release Date: 2022/04/07

Bug Fixes:

  1. Fixed potential duplicate reception of broadcast messages.
  2. Fixed an error when retrieving empty conversation lists.
  3. Fixed incorrect message counting when receiving the first message in an ultra group conversation.

v5.2.1

Release Date: 2022/03/17

Bug Fixes:

  1. Fixed an error when immediately calling ultra group-related interfaces after receiving the RongIMLib.Events.ULTRA_GROUP_ENABLE event.
  2. Fixed an issue where reconnection attempts would fail in mini-programs.
  3. Fixed an issue where the ultra group recall event RongIMLib.Events.ULTRA_GROUP_MESSAGE_RECALLED couldn't be received.
  4. Fixed inaccurate unread message counting in ultra groups.

New Features:

  1. Added the bindRTCRoomForChatroom interface for binding chatrooms with RTC rooms.
  2. Added the isModifyMessage field to ultra group history messages.
  3. Added the senderUserId field to the RongIMLib.Events.ULTRA_GROUP_MESSAGE_RECALLED event.

v5.2.0

Release Date: 2022/03/02

New Features:

  1. Introduced RC ultra group conversations, supporting group chats without member limits.
  2. Added ultra group channel functionality, allowing creation of multiple channels within ultra groups where messages are isolated between channels.

v5.1.2

Release Date: 2022/02/17

Bug Fixes:

  1. Fixed an issue where the SDK would fail when the console was unavailable in certain environments.

New Features:

  1. Added status codes to the callbacks of DISCONNECT and SUSPEND events.
  2. Added the 'isStatusMessage' field when registering custom messages.

v5.1.1

Release Date: 2022/01/17

New Features:

  1. Added the sendReadReceiptResponseMessageV2 method for group read receipts (deprecated sendReadReceiptResponseMessage).
  2. Added the getBlockedConversationList interface for retrieving Do Not Disturb conversation lists.

v5.1.0

Release Date: 2022/01/07

Bug Fixes:

  1. Fixed an error when receiving @ messages in one-to-one chats.

New Features:

  1. IMLib now provides underlying support for RTC cross-room co-streaming functionality.

v5.0.2

Release Date: 2021/12/30

Bug Fixes:

  1. Fixed an error when latestMessage was null in conversation lists (typically occurring when the latest message was deleted locally in the web client).
  2. Fixed an error in the chatroom history message retrieval interface.
  3. Fixed incorrect messageUId in group read receipt events.
  4. Fixed missing content.mentionedInfo.mentionedContent fields in @ messages (used for offline push notifications).
  5. Fixed duplicate message reception when using Server API to send messages with sender receipt enabled.
  6. Fixed missing SUSPEND event triggers during reconnection failures.

New Features:

  1. Added an interface to clear all unread counts.
  2. Added the MESSAGE_BLOCKED event for sensitive word filtering notifications (requires customer support activation).
  3. Added public TypeScript interfaces: ISendImageMessageOptions, ISendFileMessageOptions.

v5.0.1

Release Date: 2021/12/09

Bug Fixes:

  1. Fixed potential message delays during reconnection.
  2. Fixed connection delays caused by multiple ping waits before connection.
  3. Fixed memory data issues when switching users.
  4. Fixed inconsistencies in the user.portraitUri field across platforms (recommend using the portrait field).
  5. Fixed incorrect messageUId in one-to-one read receipt events.

New Features:

  1. Added interfaces for retrieving unread @ message counts.
  2. Added interfaces for retrieving total unread @ message counts.

v5.0.0

Release Date: 2021/11/16

  1. Redesigned interface implementation with flattened architecture for better usability.
  2. Added new media message interfaces combining upload and send processes (no separate upload plugin required).
  3. Optimized connection state notifications to distinguish between reconnectable and non-reconnectable interruptions.
  4. Support for multiple event listeners to accommodate different business scenarios.
  5. Added batch message notifications to optimize rendering performance for bulk data operations.