Release Notes
5.30.1
Release Date: 2025/11/14
New Features
- Added support for passing through
extrainformation in the exit chatroom interface.
5.30.0
Release Date: 2025/10/31
Optimizations
- Optimized the response data of the Web
refreshReferenceMessageWithParamsinterface by completing the reference messagecontent.referMsgStatusstatus data. - Optimized the response of the
getUserProfilesinterface during network disconnection to support returning locally cached data. - Optimized the
getConversationsFromTagByPageinterface to support retrieving up to 1000 conversations, addressing potential pagination issues on the Web. - Optimized the Web event compensation logic by completing event notifications during reconnection, including features like read receipts for individual messages (V5).
Bug Fixes
- Fixed occasional internal SDK errors during Web account switching.
- Fixed issues with APIDoc and some
.d.tsdeclaration files not being exported correctly. - Fixed the Web's inability to receive sensitive word blocking notifications (affected versions: 5.26.1 - 5.28.1).
- Fixed occasional missing
timedata updates in WebEvents.CONVERSATIONnotifications (affected versions: 5.20.0 - 5.28.1). - 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
- Added support for the
isModifyMessageproperty of messages on the Electron platform.
Bug Fixes
- 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
- The original synchronous
getUnreadMentionedMessagesinterface caused performance issues on Electron and has been deprecated. A new asynchronous interfaceelectronExtension.getUnreadMentionedMessageshas been added as a replacement.
New Features
- Added support for ultra group conversation types on Electron.
- Optimized chatroom functionality with full feature support on Electron and internal logic improvements on other platforms, along with various bug fixes.
- Added Electron support for the
getBlockedConversationListinterface. - Added the
Events.DATABASE_OPENEDevent on Electron to monitor local database opening or reconstruction after corruption. - Added the
getUnreadMentionMeConversationListinterface to retrieve conversations with unread @mentions. - Added the
getSubscribeUsersOnlineStatusinterface to query the online status of subscribed users.
Optimizations
- Improved write efficiency for message extensions on Electron, enhancing performance in related scenarios.
- Added
getConversationListByTimestampandgetAllConversationListinterfaces to replacegetConversationList, addressing result inconsistencies across platforms and parameters.
Bug Fixes
- Fixed local cache not updating after
updateMyUserProfileon Web (affected versions ≥ 5.24.0). - Fixed abnormal
targetIdassignment in thelatestMessageproperty of Web conversations (affected versions ≥ 5.20.0). - Fixed incorrect list order in Electron's
getRemoteHistoryMessagesto match other platforms. - Fixed occasional response delays in Electron's
requestSpeechToTextForMessageinterface (affected versions ≥ 5.22.0).
5.26.2
Release Date: 2025/09/11
New Features
- Added support for synchronizing server-side conversation lists on Electron.
- Enhanced the
removeConversationinterface to support deleting server-side conversations on Electron.
Bug Fixes
- 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
- Added support for editing successfully sent messages in one-to-one and group chats.
- Enhanced Web conversation list retrieval by including
latestMessagedata in:- Pinned conversations:
getTopConversationList - Blocked conversations:
getBlockedConversationList - Unread conversations:
getUnreadConversationList - Tag-filtered conversations:
getConversationsFromTagByPage - Specific conversation:
getConversation
- Pinned conversations:
- Added the batch conversation deletion interface
batchDeleteConversations. - Deprecated Electron's multi-process mode in favor of single-process operation with optimized message handling performance.
Bug Fixes
- Fixed potential discarding of RTC business messages and sensitive word blocking notifications on Web.
- Fixed business exceptions caused by receiving abnormal messages (content as "null") on Web.
- Fixed connection recovery issues when apps return to foreground on Douyin Mini Program.
- Improved crash prevention for invalid parameters on Electron.
5.24.2
Release Date: 2025/08/14
New Features
- Added support for Kuaishou Mini Program platform.
Bug Fixes
- Fixed occasional conversation cache read failures causing business exceptions on Web (affected versions: 5.24.0 and 5.24.1).
- Fixed excessive redundant data fetching due to message gaps on Electron.
- Fixed abnormal
translateStrategyvalues in Electron's conversation retrieval interfaces. - Fixed occasional loss of friend extension data on Electron.
5.24.1
Release Date: 2025/08/04
Bug Fixes
- Fixed occasional failure to receive translation result notifications when translation is enabled.
- Fixed local cache cleanup issues after receiving chatroom destruction notifications on Web.
- Fixed incorrect
translateStrategydata in Electron'sgetConversationinterface.
5.24.0
Release Date: 2025/07/25
New Features
- Added intelligent text translation for messages and arbitrary text.
- Added conversation status sync completion notification
Events.CONVERSATIONS_SETTINGS_SYNCE. - Added user settings sync completion notification
Events.USER_SETTINGS_SYNCED. - Added user settings change notification
Events.USER_SETTINGS_CHANGE. - Added
isConversationListIncludeUltraGrouptoAppSettingsto check ultra group support in conversation lists. - Added
electronExtension.getUntaggedConversationListByPageto retrieve untagged conversations.
Bug Fixes
- Fixed occasional
operationTime=0 in Web'sgetConversationsFromTagByPage(affected versions ≥ 5.20.0). - Fixed unparsed message expansion data in Web's online messages (affected versions ≥ 5.20.0).
- Fixed connection recovery after device sleep/wake on Electron (error code 32061).
- Improved V2-Adapter compatibility with legacy upload plugins.
- Fixed
clearHistoryMessagesfailure when missingchannelIdon Electron (affected versions ≥ 5.20.0). - Fixed local cache update issues after Web's
setConversationTypeNotificationLevel.
5.22.0
Release Date: 2025/06/27
New Features
- Added voice-to-text conversion, configurable via developer console.
- Added global message search via Electron's
searchMessageWithParams. - Added
getAppSettingsto query feature toggles (currently voice-to-text only).
Optimizations
- Relaxed
needReceiptvalidation during message sending, automatically setting tofalsewhen invalid. - Added cross-conversation read receipt count interface
getMessageReadReceiptInfoV5ByIdentifiers.
Bug Fixes
- Fixed incorrect
targetIdin Web's multi-device sync (affected versions ≥ 5.20.0). - Fixed incorrect
totalCountin Web'sgetMessagesReadReceiptUsersByPageV5(affected versions ≥ 5.20.0). - Fixed
totalCounterrors in Electron'sMESSAGE_RECEIPT_RESPONSE_V5(affected versions ≥ 5.20.0). - Fixed incorrect
operationTimein Web'sgetGroupApplications(affected versions ≥ 5.12.0). - Fixed sorting issues in Web's
getConversationListwithout ultra group support (affected versions ≥ 5.20.0). - Fixed rare message reception failures during weak network on Web.
- Fixed lost pin/DND/tag states when recreating deleted conversations (affected versions ≥ 5.20.0).
- Fixed empty search results when
messageTypes/conversationTypesare null on Electron (affected versions ≥ 5.20.0). - Miscellaneous parameter validation fixes.
5.20.2
Release Date: 2025/06/12
Bug Fixes
- Fixed Web conversation cache read/write errors (affected versions ≥ 5.20.0).
- Fixed inconsistent search behavior between Electron and legacy versions (affected versions ≥ 5.20.0).
- Fixed incorrect
needReceiptvalues insendMessageresponses (affected versions ≥ 5.20.0).
5.20.1
Release Date: 2025/06/03
New Features
- Added WeChat Mini Program platform support for the
requestStreamMessageContentinterface.
Bug Fixes
- Fixed occasional errors when retrieving chatroom messages after joining (affected versions ≥ 5.18.0)
5.20.0
Release Date: 2025/05/31
New Features
- 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_SYNCEDevent to notify when synchronization completes; - The
getConversationListinterface will include default ultra group channel conversations; - Unread counts from default ultra group channels will be included in
getTotalUnreadCountresults; - The
clearAllMessagesUnreadStatusinterface can clear unread counts for default ultra group channels; - The
getTopConversationListinterface will include pinned ultra group default channel conversations; - The
getUnreadConversationListinterface will include unread ultra group default channel conversations;
- Web clients will maintain a full one-to-one and group chat conversation list in memory, triggering the
- The
removeConversationinterface now supports deleting remote ultra group conversations; - The
setConversationToTopinterface addsisCreateConversationandisUpdateTimeparameters, with support for ultra group default channels; - Added Electron platform support for
clearAllMessagesUnreadStatus; - New
setConversationTypeNotificationLevelandgetConversationTypeNotificationLevelinterfaces for defining default Do Not Disturb levels by conversation type; - Added per-message read receipts (Read Receipts v5), supporting read status marking for one-to-one and group chat messages;
- The
getConversationinterface now supports retrieving ultra group conversations; - The
disconnectinterface supports adisablePushparameter to disable offline notifications; - IMLib-v2-Adapter callback functions now support
asyncdeclarations; - Web clients now cache first unread message information for one-to-one and group chats locally;
electronExtension.searchConversationByContentnow supports searching by specified conversation types.
Breaking Changes
- The
Events.ULTRA_GROUP_ENABLEevent no longer provides callback data - clients should call interfaces directly to retrieve ultra group conversation lists; - The
getBlockedConversationListandgetUnreadConversationListinterfaces now returnIAReceivedConversation[]lists with additional locally cached conversation information (drafts, unread counts, etc.); - Local operations (setting conversation pinning/DND) no longer trigger duplicate
Events.CONVERSATIONcallbacks; - The
messageTypeparameter inelectronExtension.setMessageContentis now required to support post-modification message content searches.
Bug Fixes
- Fixed abnormal callback data in group hosting feature's group application notifications;
- Fixed occasional connection issues on Electron platform (affected versions ≥ 5.16);
- Fixed ultra group message sending not updating local conversation cache;
- Fixed Web clients not triggering
Events.CONVERSATIONafter receiving recalled messages (affected versions ≥ 5.18.0); - Fixed RTCLib compatibility issues (affected versions ≥ 5.14.0).
5.18.0
Release Date: 2025/05/08
Important Changes
- IMLib-v4-Adapter is officially deprecated, with final version maintained at 5.16.x.
New Features
- Image messages now support optional
thumWidthandthumHeightvalues in content to specify thumbnail dimensions.
Bug Fixes
- Fixed occasional errors caused by abnormal downstream data (no business impact);
- Fixed multi-device synchronization issues for pinned/DND conversation data;
- Fixed parameter validation errors when sending @mentions;
- Fixed Electron platform
setMessageStatusToReaderrors whenchannelIdcontains non-string data; - Fixed incorrect userId lists in Electron platform friend deletion notifications;
- Fixed Electron platform not clearing local unread counts when syncing multi-device unread status (affected versions: ≥5.16.0);
- Fixed duplicate callbacks when setting chatroom KV attributes via Server API on Electron platform.
5.16.1
Release Date: 2025/04/10
Bug Fixes
- 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
- Added
"RC:StreamMsg"streaming message support with newrequestStreamMessageContentmethod (Mini Programs excluded); - IM connections now support IPv6-only protocols;
- User profile hosting adds content moderation, returning failed field lists when updates are rejected;
- Message recall adds
isAdminparameter for IMKit display requirements; - Added
electronExtension.getLocalMessageinterface (deprecating originalgetMessage).
Bug Fixes
- Fixed inconsistency between ultra group and regular message recall results;
- Fixed Electron
getMessagereturningErrorCode.SUCCESSfor failed local message queries (now returnsErrorCode.RC_DB_DATA_NOT_FOUND); - Fixed missing changed fields in group/user info change notifications when setting values to
""or0; - Fixed Electron log writing errors causing data loss (affected versions: ≥5.12.2);
- Fixed occasional log reporting omissions/duplications on Electron;
- Fixed Web
onSendBeforecallback not executing during network outages.
5.14.1
Release Date: 2025/03/06
Bug Fixes
- Fixed missing exports in
@rongcloud/enginecausing RTC/Call/CallPlus SDK issues (affected version: 5.14.0); - Fixed occasional KV data retrieval failures when rapidly joining/leaving chatrooms.
5.14.0
Release Date: 2025/02/28
New Features:
- Web conversation lists now support
operationTimefield for tracking operation timestamps; Events.GROUP_INFO_CHANGEDcallbacks now includefullGroupInfowith complete group data;- Added global Do Not Disturb configuration management.
Bug Fixes
- Fixed missing tag change notifications on Electron;
- Fixed configuration issues preventing friend invitation push notifications;
- Fixed missing
onBeforecallbacks when sending messages in Electron single-process mode; - Fixed inconsistent response codes between Electron and Web for
getChatroomEntry.
Important Changes
- All interface error codes now use
numbertype.
5.12.4
Release Date: 2025/02/06
Bug Fixes:
- 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:
- Fixed Electron platform conversation pinning incorrectly modifying DND levels;
- Fixed
searchGroupMembersresult format - added missingpageTokenfield.
v5.12.2
Release Date: 2024/12/26
New Features:
- Added toggle for updating last message in conversation list for one-to-one/group chats.
Optimizations:
- Fixed banned users rejoining chatrooms after network reconnection;
- Fixed custom message registration loss after child process restart;
- Fixed reconnection failures after child process crashes;
- Fixed incorrect data structure in Electron
callInfocallbacks; - Improved Electron log reporting format;
- Enhanced multi-device read status sync with targeted message type filtering.
v5.12.1
Release Date: 2024/10/28
Optimizations:
- Fixed token/navi expiration preventing reconnection after child process crashes;
- Changed error code from 34328 to 34232 for invalid
countparameters ingetFriends/getFriendApplications; - Fixed default value assignment for extension fields in
updateGroupInfoduring child process startup.
v5.12.0
Release Date: 2024/10/18
New Features:
- Added group/member management capabilities to profile hosting;
- Added friend relationship management to profile hosting.
Optimizations:
- Fixed user profile retrieval errors when only profile hosting (without status subscription) is enabled;
- Fixed empty message content after insertion.
v5.10.4
Release Date: 2024/08/29
Optimizations:
- Added uniapp Vue3 framework compatibility for APP builds;
- Added database upgrade callback events for Electron.
v5.10.3
Release Date: 2024/07/30
New Features:
- Added join timestamps to chatroom entry responses;
- Added HarmonyOS push attribute support for sent messages;
- Added HarmonyOS platform support for online status subscriptions.
Bug Fixes:
- Fixed black borders in image message thumbnails.
v5.10.2
Release Date: 2024/07/02
Optimizations:
- Changed default pinned empty conversation sync setting to false.
v5.10.1
Release Date: 2024/06/28
New Features:
- Added user profile hosting functionality;
- Added Electron platform support for disabling pinned empty conversation sync.
Bug Fixes:
- Fixed potential
undefinedcount returns fromsearchMessages; - Fixed incorrect
mentionedInfoin non-group conversations; - Fixed incorrect
lastMessageSendTimeinRC:SRSMsgcontent.
v5.9.9
Release Date: 2024/06/05
New Features:
- Added
batch get conversation informationmethod for Electron platform.
Bug Fixes:
- Fixed real-time log request failures caused by special characters in URLs.
- Fixed inability to send RC:SRSMsg messages to system conversations.
- Fixed potential errors during log database upgrades.
- Fixed abnormal sending status when locally inserting RC:RcNtf messages in Electron.
- Fixed RTC signaling transmission and parsing failures in Electron platform.
- Fixed child process crashes caused by consecutive 30021 errors during connection.
- Fixed latestMessage update issues during batch message insertion.
- Fixed child process restart issues when application exits.
v5.9.8
Release Date: 2024/04/29
New Features:
- Added User Online Status Update Callback functionality.
- Added support for sending targeted notifications when recalling messages.
- Electron platform added
get local messages around specified timestampmethod. - Electron platform's
search local conversation historyinterface now supports message type filtering.
Bug Fixes:
- Fixed Web platform message processing exceptions that prevented further message retrieval.
- Fixed CombineV2Message export errors.
v5.9.7
Release Date: 2024/04/01
Bug Fixes:
- Fixed errors when downloading IMLib-next package via NPM.
v5.9.6
Release Date: 2024/03/29
New Features:
- Added target user list specification for targeted messages.
- Added unique identifier
referMsgUidfor referenced messages. - Added
electronExtension.getContinuousMessagesinterface for simultaneous local and remote history message queries.
Bug Fixes:
- Fixed reconnection issues when receiving 30021 errors.
- Fixed duplicate recall notifications in message listeners after active message recall.
Optimizations:
- Adapted Electron platform for context isolation scenarios.
v5.9.5
Release Date: 2024/01/31
Optimizations:
- Made
receivedStatusInfoin message data optional to resolve potential TS errors.
v5.9.4
Release Date: 2024/01/31
New Features:
- Ultra groups now support targeted messaging.
- Ultra groups support batch message deletion by Message UID.
- Pinned empty conversations now sync across multiple devices.
- Added sorting by pinned status parameter for conversation list retrieval.
- Electron platform added interface for retrieving all unread mention counts.
- Electron platform added status message sending functionality.
Bug Fixes:
- Fixed invalid thumbnail quality parameter in image messages.
- Fixed status message sending issues in Electron platform.
Optimizations:
- Improved group message read receipt functionality.
v5.9.3
Release Date: 2023/12/18
New Features:
- Electron platform added setMessageReceivedStatusInfo method.
Optimizations:
- Added sendUserId to one-to-one read receipt callbacks for sender identification.
- Improved offline message receipt triggering sequence during multi-device login.
Bug Fixes:
- Fixed parameter type definition error in removeChatRoomEntries interface.
- Fixed incorrect timestamps in conversation status change notifications.
v5.9.2
Release Date: 2023/12/13
Bug Fixes:
- Fixed high latency in Electron message sending interface on Windows.
- Fixed application freezes when pulling large offline messages in Electron/Windows.
- Added empty list restriction for
addConversationsToTaginterface.
v5.9.1
Release Date: 2023/11/28
Bug Fixes:
- Fixed dependency download issues for @rongcloud/electron in Node 14 and below.
v5.9.0
Release Date: 2023/11/23
New Features:
- Added conversation information to message expansion change notifications (Events.EXPANSION).
- Added current chatroom member count to join/exit notifications.
- Added
getAllUnreadMentionedCountinterface for cross-conversation unread mentions. - Added draft field to conversation list retrieval.
- Added
getFirstUnreadMessageInfointerface. - Added Honor push configuration support.
Bug Fixes:
- Removed dynamic navigation address requests for mini-programs.
- Fixed potential missed sensitive word blocking notifications.
- Fixed incorrect @ fields in conversations.
- Fixed 26002 errors during frequent tag/conversation status API calls.
- Fixed duplicate message modifications after recall in Electron.
- Fixed Electron/Windows exit hangs.
- Optimized performance during high message volumes on Windows.
v5.8.5
Release Date: 2023/10/27
Optimizations:
- Improved SDK log upload mechanism.
Bug Fixes:
- Fixed incorrect @ fields in conversations.
v5.8.4
Release Date: 2023/09/25
New Features:
- Electron platform supports Do Not Disturb levels.
- Added operationTime field to conversation lists (Electron only).
Bug Fixes:
- Fixed automatic rejoin issues after page refresh in chatrooms.
- Fixed incorrect read status for locally inserted recalled messages (Electron).
- Fixed concurrent voice message upload errors.
v5.8.3
Release Date: 2023/08/31
New Features:
- Multi-device unread count sync now supports system conversations.
- File messages now support @ mentions.
- Chatroom join interface returns room and user status information.
- Electron platform inserts RC:RcNtf messages for recalls even when original message is missing.
v5.8.2
Release Date: 2023/07/28
New Features:
- Electron platform supports win32 X64 architecture.
- Electron platform handles multi-device sync messages (RC:ReadNtf).
- Electron platform adapted upload functionality.
Bug Fixes:
- Fixed connection issues after server restarts.
- Fixed Alipay mini-program connection errors.
v5.8.1
Release Date: 2023/07/14
New Features:
- 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:
- Added message type property to ultra group unread @ mentions.
Bug Fixes:
- Fixed occasional heartbeat issues during reconnection.
Other:
- Mini-program security domain adjustments.
v5.7.10
Release Date: 2023/06/15
New Features:
- Added
getUltraGroupUnreadInfoListfor batch ultra group unread info retrieval. - Electron platform added
searchMessagesByUserfor sender-based message search.
Bug Fixes:
- Fixed ultra group @ mention recall count issues.
- Fixed potential infinite loops when pulling ultra group messages.
v5.7.9
Release Date: 2023/05/29
New Features:
- Added chatroom status notifications (bans, mutes, join/exit sync).
- Electron platform auto-reconnects on 30019/30021 errors.
- Added region code setting during initialization.
- Added unread @ mention counts to ultra group channel lists.
Bug Fixes:
- Fixed unread count issues when recalling ultra group messages.
- Fixed duplicate socket connections in Alipay mini-programs.
v5.7.8
Release Date: 2023/05/11
New Features:
- Electron IMLib added draft operations.
Bug Fixes:
- Fixed uniapp app connection issues.
- Disabled log storage for IE due to missing indexDB.getAllKeys.
v5.7.7
Release Date: 2023/04/21
Bug Fixes:
- Fixed undefined notificationLevel in Do Not Disturb list retrieval.
- Fixed system conversation retrieval issues in Electron.
Other:
- Added RC:ReadNtf message handling.
- Added vivo push category configuration options.
v5.7.5
Release Date: 2023/04/12
Bug Fixes:
- Optimized error handling for disabled resource pb in versions prior to 5.4.7.
v5.7.4
Release Date: 2023/03/30
Bug Fixes:
- Fixed the issue where unread counts couldn't be retrieved for conversations without Do Not Disturb levels or status.
- Fixed the issue where web platforms would receive notifications for KV changes they set themselves in chatrooms.
- Fixed the occasional error "Cannot read property 'kvStorage' of null".
- Fixed the occasional issue where self-sent messages would appear in message listeners after reconnecting from network disconnection.
Other:
- Modified the count parameter range for the history message retrieval API to 0-100 (exceeding values will now return errors).
- Added
firstUnreadMessageandchannelTypefields to the return value of thegetConversationsAPI for ultra group conversations.
v5.7.3
Release Date: 2023/03/02
New Features:
- Added ultra group user group notification monitoring
- Push notification attribute configuration IPushConfig.androidConfig now supports Huawei push parameters:
- categoryHW: Huawei push message classification
- importanceHW: Huawei push message priority level
- imageUrlHW: Notification image URL for Huawei notification-type pushes
- Push notification attribute configuration IPushConfig.androidConfig now supports message push parameters:
- miLargeIconUrl: Xiaomi Large icon URL
Bug Fixes:
- Fixed the issue where the levels parameter didn't take effect in the unread count retrieval API by conversation Do Not Disturb level
- Fixed the conversation change notification issue where senders received their own @mentions
- Fixed incorrect notificationlevel field values in the Do Not Disturb conversation list retrieval
- Fixed the issue where conversation status persisted from previous users after switching accounts
- Fixed the CMP connection failure reconnection issue in Electron platform
- 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:
- Added
batchInsertMessageAPI for Electron platform to support batch message insertion to local storage - Added
getMessageCountAPI for Electron platform to retrieve total message count for specific conversations
Bug Fixes:
- Fixed incorrect status type returned by getConnectionStatus API
- 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:
- Optimized web platform local conversation status cache limit to support up to 1000 conversation states
- Optimized Electron platform navigation caching by replacing database storage with local file storage
v5.7.1
Release Date: 2023/01/10
New Features:
- Added
setCheckDuplicateMessageAPI for Electron platform to disable message deduplication when receiving messages - Added closeDB parameter to Electron platform's disconnect API
Bug Fixes:
- Fixed indexDB compatibility issues in Firefox browser
- Fixed the disconnection failure issue when calling disconnect during network reconnection
- Fixed the KV data update type (ChatroomEntryType) showing as
UPDATEfor others after callingremoveChatRoomEntry. Now correctly shows asDELETE. - Fixed inconsistency between message extension fields (
canIncludeExpansion,expansion) set during message insertion and returned data in Electron platform - Fixed HTTP request errors in Electron platform
Optimizations:
- Completed location message type registrations
- Added
aliasfield toIUserInfo
v5.7.0
Release Date: 2022/12/01
New Features:
- Added unread conversation list retrieval
getUnreadConversationList, supporting one-to-one chat, group chat, and system conversations.
Bug Fixes:
- Fixed ultra group unread count calculation including self-sent messages
- Fixed incorrect hasMentioned field in conversation list retrieval for Electron platform
- Fixed incorrect isMentioned field in message retrieval for Electron platform
Optimizations:
- When reconnecting after network disconnection, SDK will no longer attempt to rejoin banned chatrooms
- During reconnection, the number of historical messages pulled when rejoining chatrooms internally matches the join parameter value (default: 10)
Breaking Changes:
-
Connection status callback parameter types changed:
- Events.DISCONNECT callback parameter type changed from [ConnectionStatus] to [ErrorCode]
- Events.SUSPEND callback parameter type changed from
ConnectionStatus | ErrorCodetoErrorCode
-
Interface return type changes:
Method Name Previous Return Type New Return Type [getUltraGroupMessageListByMessageUId] [IReceivedMessage] [IAReceivedMessage] [getConversationsFromTagByPage] [IReceivedConversationByTag] [IAReceivedConversationByTag] -
Event callback type changes:
Event Name Previous Return Type New Return Type Description 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:
- On Electron platform, SDK now updates recalled messages as gray bar messages
RC:RcNtf - RongIMLib.electronExtension.insertMessage API now supports
BaseMessagetype parameters - Added list field to getHistoryMessagesByMessageTypes return object (messages field marked as deprecated)
Other:
- Added support for JD Mini Program platform
v5.6.0
Release Date: 2022/11/04
New Features:
- Added new API: Get Pinned Conversation List
Bug Fixes:
- Fixed an issue where the application layer would not receive status notifications when reconnecting with an expired token
- Fixed an issue where the
offLineMessagefield was incorrectly set to true for messages received on Electron clients during multi-device login - Fixed an issue where Web clients would receive messages from chatrooms joined by other devices during multi-device login, even when not joined locally
- Fixed potential message duplication in Electron platform when inserting local messages (
insertMessage) due to specified server message ID (messageUId) - Fixed search functionality for quoted messages and image-text messages in Electron platform
- Fixed an issue where messages sent from Electron platform couldn't carry "@ mentions"
- Fixed console errors when receiving
RC:RLQuitandRC:RLJoinmessages for location sharing feature on Web platform
Breaking Changes:
- Electron platform now requires appkey parameter during main process initialization (
@rongcloud/electron), otherwise initialization will fail. See Main Process Initialization - Modified the download method for Electron platform extension .node packages. See: Install .node Files
- Web platform no longer supports Comet connection mode, only WebSocket connections are supported
v5.5.5
Release Date: 2022/10/21
Bug Fixes:
- 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:
- 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:
- Fixed missing
Event.SUSPENDnotifications during network exceptions - Fixed potential failure to receive ultra group initialization completion notification (
Event.ULTRA_GROUP_ENABLE) under poor network conditions - Corrected interface type declarations for callback parameters in
Event.MESSAGESandEvent.CONVERSATIONevents
v5.5.2
Release Date: 2022/09/09
New Features:
- Added
getUltraGroupUnreadMentionedMessagesAPI to retrieve unread @ messages list for ultra groups - Added
getUltraGroupFirstUnreadMessageTimestampAPI to get the timestamp of the first unread message in ultra groups
Bug Fixes:
- Fixed database conversation list loss in Electron when upgrading to version 5.5.0
v5.5.1
Release Date: 2022/09/01
New Features:
- Added
getTotalUnreadCountByLevelsAPI to get total unread message count filtered by conversation Do Not Disturb levels - Added
getTotalUnreadMentionedCountByLevelsAPI to get total unread @ message count filtered by conversation Do Not Disturb levels - Enhanced
getUltraGroupUnreadCountByTargetIdto support filtering by conversation Do Not Disturb levels - Enhanced
getUltraGroupUnreadMentionedCountByTargetIdto support filtering by conversation Do Not Disturb levels - Added
messageIdfield to sent and received messages
Bug Fixes:
- Fixed an issue where frequent ultra group KV modifications and message sending could cause users to receive their own sent messages
- 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:
- Architectural improvements to reduce version dependencies between plugin-rtc upgrades and IMLib
v5.4.5
Release Date: 2022/08/18
New Features:
- Added sensitive word notifications for ultra group message modifications and message extensions
Bug Fixes:
- Fixed duplicate notifications when setting conversation status across multiple devices
- Fixed incorrect HTTP request header fields in mini program platform
- Fixed KV retrieval issues when joining multiple chatrooms where later-joined chatrooms had anomalies
Other:
- Added support for WeChat Mini Program plugin platform
- Added WebSocket connection support for Alipay Mini Program platform
v5.4.4
Release Date: 2022/08/16
Bug Fixes:
- Fixed duplicate notifications for ultra group message extension changes
- Fixed missing notifications when channelId was empty in ultra group message extension changes
v5.4.3
Release Date: 2022/08/04
Bug Fixes:
- Fixed missing
senderUserIdparameter ingetUltraGroupMessageListByMessageUIdAPI and ultra group message change notifications
v5.4.2
Release Date: 2022/07/21
New Features:
- Added ultra group private channel functionality
- Added channelType parameter to getUltraGroupList API
- Added ultra group channel type (private/public) change notification: RongIMLib.Events.ULTRA_GROUP_CHANNEL_TYPE_CHANGE
- Added private channel allowlist user removal notification: RongIMLib.Events.ULTRA_GROUP_CHANNEL_USER_KICKED
- Added channel deletion notification: RongIMLib.Events.ULTRA_GROUP_CHANNEL_DLELTE
Bug Fixes:
- Fixed internal logger reference errors
v5.4.1
Release Date: 2022/07/02
Bug Fixes:
- Fixed potential compilation errors after being referenced
v5.4.0
Release Date: 2022/07/01
New Features:
- Added
notificationLevelfield to conversation list retrieval - Added uploadDomain parameter to init method, supporting custom file upload servers (private cloud only, currently supports Qiniu addresses)
- New Electron platform APIs:
- electronExtension.getAllConversationList
- electronExtension.getConversationList
- electronExtension.searchConversationByContent
- electronExtension.searchMessage
- electronExtension.searchMessageInTimeRange
- electronExtension.getHistoryMessagesByMessageTypes
- electronExtension.setMessageStatusToRead
- electronExtension.setMessageReceivedStatus
- electronExtension.setMessageSentStatus
- electronExtension.deleteMessages
- electronExtension.clearMessages
- electronExtension.deleteMessagesByTimestamp
- electronExtension.insertMessage
- New blocklist-related APIs:
Release Date: 2022/05/20
Optimizations:
- Optimized the mechanism for retrieving messages and extended attributes in chatrooms.
v5.3.1
Release Date: 2022/05/19
New Features:
- Added the
isDeleteparameter to the message recall interface, allowing control over whether mobile recipients display the gray bar notification for recalled messages.
Bug Fixes:
- Optimized reconnection logic to fix potential reconnection failures during network exceptions.
- Fixed an error when pulling messages during comet connections.
- Corrected a spelling error in the
NotificationLevelenum value fromAT_GROUP_ALL_USER_NOFICATIONtoAT_GROUP_ALL_USER_NOTIFICATION. - Fixed an issue where the SDK would abnormally pull ultra group messages after reconnection when the App Key had ultra group services disabled.
Other:
- Optimized connection logic.
v5.3.0
Release Date: 2022/04/29
New Features:
- The message body for recalling messages can now include an extra field.
- Added the
contentDispositionparameter to the file upload message interface. - Added new interfaces:
setUltraGroupDefaultNotificationLevelfor setting default notification configurations for specified ultra groups.getUltraGroupDefaultNotificationLevelfor querying default notification configurations for specified ultra groups.getUnreadMentionedCountfor retrieving unread mention counts in specified conversations.getUltraGroupUnreadCountByTargetIdfor retrieving total unread counts across all channels in specified ultra groups.getUltraGroupUnreadMentionedCountByTargetIdfor retrieving total unread mention counts across all channels in specified ultra groups.getAllUltraGroupUnreadCountfor retrieving total unread counts across all ultra groups.getAllUltraGroupUnreadMentionedCountfor retrieving total unread mention counts across all ultra groups.setConversationNotificationLevelfor setting Do Not Disturb levels.getConversationNotificationLevelfor retrieving Do Not Disturb levels.
Bug Fixes:
- Fixed an issue where broadcast messages would be received again after disconnecting and reconnecting.
- Fixed an issue where the latest ultra group conversation list couldn't be retrieved after reconnecting.
- Fixed an error when calling the
disconnectmethod in IE 11.
Other:
- Increased the length limit for ultra group message extension field values to 4096.
v5.2.4
Release Date: 2022/04/15
Bug Fixes:
- Fixed a rare issue where messages of type
ConversationType.RTC_ROOMmight be lost.
v5.2.3
Release Date: 2022/04/15
Bug Fixes:
- Fixed an issue where logs couldn't be reported when using HTTPS protocol.
v5.2.2
Release Date: 2022/04/07
Bug Fixes:
- Fixed potential duplicate reception of broadcast messages.
- Fixed an error when retrieving empty conversation lists.
- Fixed incorrect message counting when receiving the first message in an ultra group conversation.
v5.2.1
Release Date: 2022/03/17
Bug Fixes:
- Fixed an error when immediately calling ultra group-related interfaces after receiving the
RongIMLib.Events.ULTRA_GROUP_ENABLEevent. - Fixed an issue where reconnection attempts would fail in mini-programs.
- Fixed an issue where the ultra group recall event
RongIMLib.Events.ULTRA_GROUP_MESSAGE_RECALLEDcouldn't be received. - Fixed inaccurate unread message counting in ultra groups.
New Features:
- Added the
bindRTCRoomForChatroominterface for binding chatrooms with RTC rooms. - Added the
isModifyMessagefield to ultra group history messages. - Added the
senderUserIdfield to theRongIMLib.Events.ULTRA_GROUP_MESSAGE_RECALLEDevent.
v5.2.0
Release Date: 2022/03/02
New Features:
- Introduced RC ultra group conversations, supporting group chats without member limits.
- 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:
- Fixed an issue where the SDK would fail when the console was unavailable in certain environments.
New Features:
- Added status codes to the callbacks of
DISCONNECTandSUSPENDevents. - Added the 'isStatusMessage' field when registering custom messages.
v5.1.1
Release Date: 2022/01/17
New Features:
- Added the
sendReadReceiptResponseMessageV2method for group read receipts (deprecatedsendReadReceiptResponseMessage). - Added the
getBlockedConversationListinterface for retrieving Do Not Disturb conversation lists.
v5.1.0
Release Date: 2022/01/07
Bug Fixes:
- Fixed an error when receiving @ messages in one-to-one chats.
New Features:
- IMLib now provides underlying support for RTC cross-room co-streaming functionality.
v5.0.2
Release Date: 2021/12/30
Bug Fixes:
- Fixed an error when
latestMessagewas null in conversation lists (typically occurring when the latest message was deleted locally in the web client). - Fixed an error in the chatroom history message retrieval interface.
- Fixed incorrect
messageUIdin group read receipt events. - Fixed missing
content.mentionedInfo.mentionedContentfields in @ messages (used for offline push notifications). - Fixed duplicate message reception when using Server API to send messages with sender receipt enabled.
- Fixed missing
SUSPENDevent triggers during reconnection failures.
New Features:
- Added an interface to clear all unread counts.
- Added the
MESSAGE_BLOCKEDevent for sensitive word filtering notifications (requires customer support activation). - Added public TypeScript interfaces:
ISendImageMessageOptions,ISendFileMessageOptions.
v5.0.1
Release Date: 2021/12/09
Bug Fixes:
- Fixed potential message delays during reconnection.
- Fixed connection delays caused by multiple ping waits before connection.
- Fixed memory data issues when switching users.
- Fixed inconsistencies in the
user.portraitUrifield across platforms (recommend using theportraitfield). - Fixed incorrect
messageUIdin one-to-one read receipt events.
New Features:
- Added interfaces for retrieving unread @ message counts.
- Added interfaces for retrieving total unread @ message counts.
v5.0.0
Release Date: 2021/11/16
- Redesigned interface implementation with flattened architecture for better usability.
- Added new media message interfaces combining upload and send processes (no separate upload plugin required).
- Optimized connection state notifications to distinguish between reconnectable and non-reconnectable interruptions.
- Support for multiple event listeners to accommodate different business scenarios.
- Added batch message notifications to optimize rendering performance for bulk data operations.