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 ChatRoomChangeListener#onMuteListAdded(java.lang.String, java.util.Map<java.lang.String,java.lang.Long>) to provide muted user IDs and their mute expiration timestamps via the Map<String,Long> muteInfo parameter, deprecating the old event ChatRoomChangeListener#onMuteListAdded(java.lang.String, java.util.List<java.lang.String>, long).
• 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 GroupChangeListener#onMembersJoined and GroupChangeListener#onMembersExited are introduced to replace the deprecated GroupChangeListener#onMemberJoined and GroupChangeListener#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 ChatManager#asyncModifyMessage:
  • 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 ConnectionListener#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 CursorResult#cursor from undefined to an empty string ("") when ChatManager#asyncFetchHistoryMessages reaches the final page of roaming messages.
• Removed APIs that were deprecated prior to Android SDK version 1.1.0.
• Optimized specific database operations.
• Added exception clearing mechanisms and null pointer protection to the JNI layer.
• Optimized the reconnection logic to automatically switch reconnection addresses by default.
• Added the device timezone offset to log files to facilitate troubleshooting.
• Removed the reflection-based approach for obtaining absolute file paths from FileProvider.
• 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 ChatThreadChangeListener#onChatThreadUserRemoved event.
• A crash occurred on certain device models when retrieving the start and end times of conversation Do-Not-Disturb (DND) settings.
• MessageListener#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 ChatManager#asyncFetchConversationsFromServer did not contain translations or message Reactions.
• An exception during logout caused by nesting SDK API calls within SDK events.
• 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.