v1.4.0

v1.4.0 was released on XXXX, 2026.

New Features

• Supported sending and receiving GIF image messages. The GIF image message is a subtype of the image message and will not be compressed.
• Supported setting, updating, and retrieving group avatars.
• Enabled users to receive the following information upon joining a chat room:
  • Current chat room member count: Retrieved via the ChatRoom#getMemberCount method. This count updates when users join or leave the chat room.
  • Chat room-wide mute status: Retrieved via the ChatRoom#isAllMemberMuted method. This status updates upon receiving mute/unmute status change events.
  • Chat room creation timestamp: Retrieved via the newly added ChatRoom#getCreateTimestamp method.
  • Whether the current user is on the chat room allowlist: Retrieved via the newly added ChatRoom#isInWhitelist method to check if the user is on the chat room allowlist.
  • Mute expiration timestamp of the current user: Retrieved via the ChatRoom#getMuteExpireTimestamp method.
• Added the new chat room mute event AgoraChatroomManagerDelegate#chatroomMuteListDidUpdate:addedMutedMembers: to provide the mute expiration timestamps via the (NSDictionary<NSString *,NSNumber*> *)aMutes parameter, deprecating the old event AgoraChatroomManagerDelegate#chatroomMuteListDidUpdate:addedMutedMembers:muteExpire:.
• Supported retrieving roaming messages sent by specific group members.
• Supported retrieving messages sent by specific members within a local group conversation.
• Supported searching for messages across all local conversations by keyword, returning the list of conversation IDs and their matching message IDs.
• Supported retrieving one or more local messages by message ID.
• Supported batch notifications via group member join/leave events. Previously, the SDK triggered a separate event for each individual member. The new events AgoraChatGroupManagerDelegate#onMembersJoined and AgoraChatGroupManagerDelegate#onMembersExited are introduced to replace the deprecated AgoraChatGroupManagerDelegate#onMemberJoined and AgoraChatGroupManagerDelegate#onMemberExited events.

Improvements

• Changed the unique app identifier from the app key to app ID.
• Supported modifying various message types via the message modification API AgoraChatManager#modifyMessage:
  • Text and custom messages: Modifying both the message body and extensions (ext).
  • File, video, voice, image, location, and combined messages: Modifying extensions (ext) only.
  • Command messages: Not supported.
• Allowed group owners, chat room owners, and administrators to recall messages sent by other users.
• Adjusted the trigger threshold for the AgoraChatClientDelegate#onTokenWillExpire event; the notification is now triggered when 80% of the token's validity period has elapsed (previously 50%).
• Supported retrieving a group member list that includes each member's role and join time.
• Changed AgoraChatCursorResult#cursor from undefined to an empty string ("") when ChatManager#fetchMessagesFromServerBy:conversationType:cursor:pageSize:option:completion: reaches the final page of roaming messages.
• Removed APIs that were deprecated prior to Android SDK version 1.1.0.
• Optimized specific database operations.
• Optimized the reconnection logic to automatically switch reconnection addresses by default.
• Improved the logic for calling applicationWillEnterForeground by sending a ping message to trigger reconnection.
• Disable the default constructors of AgoraChatMessage, AgoraChatConversation, and AgoraChatMessageBody to prevent crashes caused by null pointers.
• Added the device timezone offset to log files to facilitate troubleshooting.
• Upgraded BoringSSL and SQLCipher dependencies to their latest versions to mitigate potential security risks.
• Improved the loading performance of the local conversation list when the latest message is an attachment by eliminating redundant file length checks.

Issues Fixed

• Messages in memory were not deleted when their corresponding local conversation was removed.
• The TYPE field was empty in the AgoraChatThreadManagerDelegate#onUserKickOutOfChatThread event.
• A crash occurred on certain device models when retrieving the start and end times of conversation Do-Not-Disturb (DND) settings.
• AgoraChatManagerDelegate#onMessageContentChanged failed to return modification details when editing messages other than text and custom messages.
• After a group or chat room was disbanded, the SDK would still fetch group or chat room details from the server after members received the disbandment event.
• The database was mistakenly rebuilt upon encountering a SQLITE_BUSY error.
• The latest message in a conversation retrieved from the server via AgoraChatManager#getConversationsFromServerWithCursor did not contain translations or message Reactions.
• The completion callbacks of some API requests were not being executed on the main thread, including the following APIs:
  • All APIs under AgoraChatUserInfoManager and AgoraChatPresenceManager.
  • The fetchMessagesFromServer, fetchSupportedLanguages, translateMessage, and getMessageCountWithCompletion APIs under AgoraChatChatManager.
• A crash caused by extreme network conditions.

Important Notice

A compilation error may occur when using Agora Chat SDK 1.3.2 with Signaling SDK 2.2.0+ or Video SDK 4.3.0+. See Integration Issues for the fix.