diff --git a/en-US/markdown/agora-chat/Develop/Chat Rooms/agora_chat_chatroom_android.md b/en-US/markdown/agora-chat/Develop/Chat Rooms/agora_chat_chatroom_android.md index 1c98c04ad22..4704e321024 100644 --- a/en-US/markdown/agora-chat/Develop/Chat Rooms/agora_chat_chatroom_android.md +++ b/en-US/markdown/agora-chat/Develop/Chat Rooms/agora_chat_chatroom_android.md @@ -196,7 +196,7 @@ public interface ChatRoomChangeListener { /** - * Occurs when the chat room announcements change. + * Occurs when the chat room announcement is changed. * @param chatRoomId The chat room ID * @param announcement The new chat room announcements */ diff --git a/en-US/markdown/agora-chat/Develop/Chat Rooms/agora_chat_chatroom_attributes_android.md b/en-US/markdown/agora-chat/Develop/Chat Rooms/agora_chat_chatroom_attributes_android.md index a5139933497..c7aa917f21e 100644 --- a/en-US/markdown/agora-chat/Develop/Chat Rooms/agora_chat_chatroom_attributes_android.md +++ b/en-US/markdown/agora-chat/Develop/Chat Rooms/agora_chat_chatroom_attributes_android.md @@ -28,7 +28,7 @@ This section introduces how to call the APIs provided by the Agora Chat SDK to i ### Manage basic chat room attributes #### Retrieve basic chat room attributes -All the chat room members can call `fetchChatRoomFromServer` to retrieve the detailed information of the current chat room, including the subject, announcements, description, member type, and admin list. +All the chat room members can call `fetchChatRoomFromServer` to retrieve the detailed information of the current chat room, including the subject, announcement, description, member type, and admin list. ```java // Fetches basic attributes including ID, name, description, maximum members, owners, roles, and whether all members are muted. @@ -46,16 +46,16 @@ ChatRoom chatRoom = ChatClient.getInstance().chatroomManager().changeChatRoomSub ChatRoom chatRoom = ChatClient.getInstance().chatroomManager().changeChatroomDescription(chatRoomId, newDescription); ``` -#### Retrieve or change chat room announcements -All the chat room members can retrieve the chat room announcements. +#### Retrieve or change the chat room announcement +All the chat room members can retrieve the chat room announcement. -Only the chat room owner and admin can set and update the announcements. Once the announcements are updated, all the chat room members receive the `onAnnouncementChanged` callback. +Only the chat room owner and admin can set and update the announcement. Once the announcement is updated, all the chat room members receive the `onAnnouncementChanged` callback. ```java -// Retrieves the chat room announcements. +// Retrieves the chat room announcement. String announcement = ChatClient.getInstance().chatroomManager().fetchChatRoomAnnouncement(chatRoomId); -// Sets or updates the chat room announcements. +// Sets or updates the chat room announcement. ChatClient.getInstance().chatroomManager().updateChatRoomAnnouncement(chatRoomId, announcement); ``` @@ -88,7 +88,7 @@ ChatClient.getInstance().chatroomManager().asyncFetchChatRoomAllAttributesFromSe #### Set a custom attribute -Chat room members can call `asyncSetChatroomAttributes` to set one single custom attribute. Use this method to add new custom attributes or update existing attributes that set by yourself. After you successfully call this method, other members in the chat room receive an `onAttributesUpdate` callback. +Chat room members can call `asyncSetChatroomAttributes` to set one single custom or update an existing attribute set by themselves. After you successfully call this method, other members in the chat room receive an `onAttributesUpdate` callback. ```java // Sets a custom attribute by specifying chat room ID, attribute key, and attribute value. @@ -118,7 +118,7 @@ ChatClient.getInstance().chatroomManager().asyncSetChatroomAttributesForced(chat #### Set multiple custom attributes -To set multiple custom attributes, call the `asyncSetChatroomAttributes` method with same name. Use this method to add new custom attributes or update existing attributes that set by yourself. After you successfully call this method, other members in the chat room receive an `onAttributesUpdate` callback. +Chat room members can call the `asyncSetChatroomAttributes` method add new custom attributes or update existing attributes set by themselves. After you successfully call this method, other members in the chat room receive an `onAttributesUpdate` callback. ```java // Sets multiple custom attribute by specifying chat room ID and the key-value maps of the attributes. @@ -148,7 +148,7 @@ ChatClient.getInstance().chatroomManager().asyncSetChatroomAttributesForced(chat #### Remove a custom attribute -Chat room members can call `asyncRemoveChatRoomAttributesFromServer` to remove one single custom attribute that is set by themselves. After you successfully call this method, other members in the chat room receive an `onAttributesRemoved` callback. +Chat room members can call `asyncRemoveChatRoomAttributeFromServer` to remove one single custom attribute that is set by themselves. After you successfully call this method, other members in the chat room receive an `onAttributesRemoved` callback. ```java // Removes a custom attribute by specifying chat room ID and attribute key. @@ -162,7 +162,7 @@ ChatClient.getInstance().chatroomManager().asyncRemoveChatRoomAttributeFromServe }); ``` -If you want to update custom attributes that set by other members, call `asyncRemoveChatRoomAttributesFromServerForced` instead. After you successfully call this method, other members in the chat room receive an `onAttributesRemoved` callback. +If you want to update a custom attribute set by another member, call `asyncRemoveChatRoomAttributeFromServerForced` instead. After you successfully call this method, other members in the chat room receive an `onAttributesRemoved` callback. ```java // Removes a custom attribute by specifying chat room ID and attribute key. diff --git a/en-US/markdown/agora-chat/Develop/Chat Rooms/agora_chat_chatroom_members_android.md b/en-US/markdown/agora-chat/Develop/Chat Rooms/agora_chat_chatroom_members_android.md index d3571ec55ae..afdf8ca8bfd 100644 --- a/en-US/markdown/agora-chat/Develop/Chat Rooms/agora_chat_chatroom_members_android.md +++ b/en-US/markdown/agora-chat/Develop/Chat Rooms/agora_chat_chatroom_members_android.md @@ -74,7 +74,7 @@ ChatClient.getInstance().chatroomManager().fetchChatRoomBlackList(chatRoomId, ne ### [Manage the chat room mute list](https://docs.agora.io/en/agora-chat/client-api/chat-room/manage-chatroom-members?platform=android#manage-the-chat-room-mute-list) -To manage the messages in the chat room, the chat room owner and admin can add the specified member to the chat room mute list and remove them from it. Once a chat room member is added to the mute list, this member can no longer send chat room message, not even after being added to the chat room allow list. +To manage the messages in the chat room, the chat room owner and admin can add the specified member to the chat room mute list and remove them from it. Once a chat room member is added to the mute list, this member can no longer send chat room messages, not even after being added to the chat room allow list. ``` // The chat room owner or admin call muteChatRoomMembers to add the specified user to the chat room block list. The muted member and all the other chat room admins or owner receive the onMuteListAdded callback. @@ -128,7 +128,7 @@ ChatClient.getInstance().chatroomManager().unmuteAllMembers(chatRoomId, new Valu The chat room owner and admins are added to the chat room allow list by default. -Members in the chat room allow list can send chat room messages even when the chat room owner or admin has muted all the chat room members using `muteAllMembers`. However, if a member is already in the chat room mute list, adding this member to the allow list does not take effect. +Members in the chat room allow list can send chat room messages even when the chat room owner or admin has muted all the chat room members using `muteAllMembers`. However, if a member is already in the chat room mute list, this member still cannot send messages in the chat room even after being added to the allow list of the chat room. Messages sent by members in the chat room allow list are of high priority and will be delivered first, but there is no guarantee that they will be delivered. When the load is high, the server discards low-priority messages first. If the load is still high even then, the server discards high-priority messages. diff --git a/en-US/markdown/agora-chat/Develop/Chat Rooms/agora_chat_classroom_ios.md b/en-US/markdown/agora-chat/Develop/Chat Rooms/agora_chat_classroom_ios.md index 97a6382bb02..30422f99782 100644 --- a/en-US/markdown/agora-chat/Develop/Chat Rooms/agora_chat_classroom_ios.md +++ b/en-US/markdown/agora-chat/Develop/Chat Rooms/agora_chat_classroom_ios.md @@ -178,7 +178,12 @@ To monitor the chat room events, you can listen for the callbacks in the `ChatRo oldOwner:(NSString *)aOldOwner { } - + +// Occurs when basic information of the chat room is changed. +- (void)chatroomSpecificationDidUpdate:(EMChatroom *)aChatroom { + + } + /** * When custom chat room attributes are set or changed, all room members receives this callback. * @param roomId The chat room ID.