From 0a676ac11dcf02a7a06abecb1b6a7a90b12253db Mon Sep 17 00:00:00 2001 From: haoxiuwen Date: Wed, 29 Nov 2023 16:00:02 +0800 Subject: [PATCH] modify --- docs/document/android/group_manage.md | 4 ++++ docs/document/android/group_overview.md | 2 +- docs/document/android/message_receipt.md | 11 +++++++---- docs/document/flutter/message_receipt.md | 10 ++++++---- docs/document/ios/group_manage.md | 3 ++- docs/document/ios/message_receipt.md | 10 +++++++--- docs/document/react-native/group_manage.md | 4 ++++ docs/document/react-native/message_receipt.md | 10 +++++++--- docs/document/server-side/callback.md | 2 +- docs/document/unity/group_manage.md | 4 ++++ docs/document/unity/message_receipt.md | 10 +++++++--- docs/document/unity/room_members.md | 2 +- docs/document/web/group_manage.md | 4 ++++ docs/document/web/message_receipt.md | 10 +++++++--- docs/document/web/room_members.md | 2 +- docs/document/windows/group_manage.md | 4 ++++ docs/document/windows/group_members.md | 2 +- docs/document/windows/message_receipt.md | 10 +++++++--- docs/document/windows/room_members.md | 2 +- 19 files changed, 76 insertions(+), 30 deletions(-) diff --git a/docs/document/android/group_manage.md b/docs/document/android/group_manage.md index c262f70ab..a06871b3f 100644 --- a/docs/document/android/group_manage.md +++ b/docs/document/android/group_manage.md @@ -109,6 +109,10 @@ EMClient.getInstance().groupManager().destroyGroup(groupId); 群成员也可以调用 `getGroupFromServer(String groupId, boolean fetchMembers)` 方法从服务器获取群组详情。返回的结果包括群组 ID、群组名称、群组描述、群组基本属性、群主、群组管理员列表、是否已屏蔽群组消息以及群组是否禁用等信息。另外，若将该方法的 `fetchMembers` 参数设置为 `true`，可获取群成员列表，默认最多包括 200 个成员。 +:::tip +对于公有群，用户即使不加入群也能获取群组详情，而对于私有群，用户只有加入了群组才能获取群详情。 +::: + 示例代码如下： ```java diff --git a/docs/document/android/group_overview.md b/docs/document/android/group_overview.md index fcc492794..12ea0f218 100644 --- a/docs/document/android/group_overview.md +++ b/docs/document/android/group_overview.md @@ -41,7 +41,7 @@ - 群组按照是否对用户公开，可以分为公开群和私有群。 | 群组分类 | 加群方式 | 获取群组信息 | -| :------- | :---------- | :---------- | :---------- | +| :------- | :---------- | :---------- | | 公开群 | 任何用户可以搜索到该群，可申请加入群或者被管理员和群主邀请入群。任何用户均可申请入群，是否需要群主和群管理员审批，取决于群组的设置，例如 Android 为 `EMGroupStyle` 参数。 | - 对于群组详情和公开群列表，用户即使不加入群也能获取。
- 对于群公告和群共享文件列表，用户只有加入群时才能获取。 | | 私有群 | 群外用户不能搜索到此类群组，需要被邀请才能入群。除了群主和群管理员，群成员是否也能邀请其他用户进群取决于群组的设置，例如 Android 为 `EMGroupStyle` 参数。 | 用户只有加入群后才能获取群详情、群公告、群共享文件列表、和群成员列表等群组信息。 | diff --git a/docs/document/android/message_receipt.md b/docs/document/android/message_receipt.md index 56038fd77..69bc87cbf 100644 --- a/docs/document/android/message_receipt.md +++ b/docs/document/android/message_receipt.md @@ -4,7 +4,7 @@ 单聊会话支持消息送达回执、会话已读回执和消息已读回执，发送方发送消息后可及时了解接收方是否及时收到并阅读了信息，也可以了解整个会话是否已读。 -群聊会话只支持消息已读回执。群主和群管理员在发送消息时，可以设置该消息是否需要已读回执。仅旗舰版及以上版本支持群消息已读回执功能。若要使用该功能，需在[环信即时通讯云控制台](https://console.easemob.com/user/login)开通。 +群聊会话只支持消息已读回执。群主和群管理员在发送消息时，可以设置该消息是否需要已读回执。仅专业版及以上版本支持群消息已读回执功能。若要使用该功能，需在[环信即时通讯云控制台](https://console.easemob.com/user/login)开通。 本文介绍如何使用环信即时通讯 IM Android SDK 实现单聊和群聊的消息回执功能。 @@ -41,7 +41,7 @@ - 完成 SDK 初始化，并连接到服务器，详见 [快速开始](quickstart.html)。 - 了解环信即时通讯 IM 的使用限制，详见 [使用限制](/product/limitation.html)。 -- 群消息已读回执功能仅在环信 IM 旗舰版及以上版本支持该功能。若要使用该功能，需在[环信即时通讯云控制台](https://console.easemob.com/user/login)开通。 +- 群消息已读回执功能仅在环信 IM 专业版及以上版本支持该功能。若要使用该功能，需在[环信即时通讯云控制台](https://console.easemob.com/user/login)开通。 ## 实现方法 @@ -90,7 +90,6 @@ EMClient.getInstance().chatManager().removeMessageListener(msgListener); Options.setRequireAck = true; ``` - ##### 会话已读回执 参考以下步骤在单聊中实现会话已读回执。 @@ -125,6 +124,8 @@ EMClient.getInstance().chatManager().addConversationListener(new EMConversationL ##### 消息已读回执 +单聊消息的已读回执有效期与消息在服务端的存储时间一致，即在服务器存储消息期间均可发送已读回执。关于消息在服务端的存储时间与你订阅的套餐包有关，详见[产品价格](/product/pricing.html#套餐包功能详情)。 + 参考如下步骤在单聊中实现消息已读回执。 1. 接收方发送已读回执消息。 @@ -200,7 +201,9 @@ EMClient.getInstance().chatManager().addMessageListener(new EMMessageListener() 对于群聊，群主和群管理员发送消息时，可以设置该消息是否需要已读回执。若需要，每个群成员在阅读消息后，SDK 均会发送已读回执，即阅读该消息的群成员数量即为已读回执的数量。 -仅旗舰版及以上版本支持群消息已读回执功能。若要使用该功能，需在[环信即时通讯云控制台](https://console.easemob.com/user/login)开通。 +群聊已读回执的有效期为 3 天，即群组中的消息发送时间超过 3 天，服务器不记录阅读该条消息的群组成员，也不会发送已读回执。 + +仅专业版及以上版本支持群消息已读回执功能。若要使用该功能，需在[环信即时通讯云控制台](https://console.easemob.com/user/login)开通。 1. 群主或群管理员发送消息时若需已读回执，需设置 `EMMessage` 的方法 `setIsNeedGroupAck()` 为 `YES`。 diff --git a/docs/document/flutter/message_receipt.md b/docs/document/flutter/message_receipt.md index 6752bc22f..9c64a17bb 100644 --- a/docs/document/flutter/message_receipt.md +++ b/docs/document/flutter/message_receipt.md @@ -4,7 +4,7 @@ 单聊会话支持消息送达回执、会话已读回执和消息已读回执，发送方发送消息后可及时了解接收方是否及时收到并阅读了信息，也可以了解整个会话是否已读。 -群聊会话只支持消息已读回执。群主和群管理员在发送消息时，可以设置该消息是否需要已读回执。仅旗舰版及以上版本支持群消息已读回执功能。若要使用该功能，需在[环信即时通讯云控制台](https://console.easemob.com/user/login)开通。 +群聊会话只支持消息已读回执。群主和群管理员在发送消息时，可以设置该消息是否需要已读回执。仅专业版及以上版本支持群消息已读回执功能。若要使用该功能，需在[环信即时通讯云控制台](https://console.easemob.com/user/login)开通。 本文介绍如何使用环信即时通讯 IM Flutter SDK 实现单聊和群聊的消息回执功能。 @@ -37,7 +37,7 @@ - 完成 SDK 初始化，并连接到服务器，详见 [快速开始](quickstart.html)。 - 了解环信即时通讯 IM 的使用限制，详见 [使用限制](/product/limitation.html)。 -- 群消息已读回执功能仅在环信 IM 旗舰版及以上版本支持该功能。若要使用该功能，需在[环信即时通讯云控制台](https://console.easemob.com/user/login)开通。 +- 群消息已读回执功能仅在环信 IM 专业版及以上版本支持该功能。若要使用该功能，需在[环信即时通讯云控制台](https://console.easemob.com/user/login)开通。 ## 实现方法 @@ -120,6 +120,8 @@ EMClient.getInstance.chatManager.addEventHandler( ##### 消息已读回执 +单聊消息的已读回执有效期与消息在服务端的存储时间一致，即在服务器存储消息期间均可发送已读回执。关于消息在服务端的存储时间与你订阅的套餐包有关，详见[产品价格](/product/pricing.html#套餐包功能详情)。 + 参考如下步骤在单聊中实现消息已读回执。 1. 开启全局的消息已读回执开关。如果全局设置不开启，消息和会话的相应设置也无法生效。 @@ -155,9 +157,9 @@ try { ### 群聊 -对于群聊，群主和群管理员发送消息时，可以设置该消息是否需要已读回执。若需要，每个群成员在阅读消息后，SDK 均会发送已读回执，即阅读该消息的群成员数量即为已读回执的数量。 +对于群聊，群主和群管理员发送消息时，可以设置该消息是否需要已读回执。若需要，每个群成员在阅读消息后，SDK 均会发送已读回执，即阅读该消息的群成员数量即为已读回执的数量。群聊已读回执的有效期为 3 天，即群组中的消息发送时间超过 3 天，服务器不记录阅读该条消息的群组成员，也不会发送已读回执。 -仅旗舰版及以上版本支持群消息已读回执功能。若要使用该功能，需在[环信即时通讯云控制台](https://console.easemob.com/user/login)开通。 +仅专业版及以上版本支持群消息已读回执功能。若要使用该功能，需在[环信即时通讯云控制台](https://console.easemob.com/user/login)开通。 1. 消息发送方需要知道群组消息是否已读，需要监听 `onGroupMessageRead` 事件。 diff --git a/docs/document/ios/group_manage.md b/docs/document/ios/group_manage.md index 1338bb047..00b471e07 100644 --- a/docs/document/ios/group_manage.md +++ b/docs/document/ios/group_manage.md @@ -115,7 +115,8 @@ NSArray *members = @{@"member1",@"member2"}; ### 获取群组详情 :::notice -从 3.7.4 版本开始支持是否获取群组成员参数 `fetchMembers` 。 +从 3.7.4 版本开始支持是否获取群组成员参数 `fetchMembers`。 +对于公有群，用户即使不加入群也能获取群组详情，而对于私有群，用户只有加入了群组才能获取群详情。 ::: 群成员也可以调用 `getGroupSpecificationFromServerWithId` 方法从服务器获取群组详情。返回的结果包括群组 ID、群组名称、群组描述、群组基本属性、群主、群组管理员列表、是否已屏蔽群组消息以及群组是否禁用。另外，若将该方法的 `fetchMembers` 参数设置为 `true`，可获取群成员列表，默认最多包括 200 个成员。 diff --git a/docs/document/ios/message_receipt.md b/docs/document/ios/message_receipt.md index eedb4826e..683c45093 100644 --- a/docs/document/ios/message_receipt.md +++ b/docs/document/ios/message_receipt.md @@ -4,7 +4,7 @@ 单聊会话支持消息送达回执、会话已读回执和消息已读回执，发送方发送消息后可及时了解接收方是否及时收到并阅读了信息，也可以了解整个会话是否已读。 -群聊会话只支持消息已读回执。群主和群管理员在发送消息时，可以设置该消息是否需要已读回执。仅旗舰版及以上版本支持群消息已读回执功能。若要使用该功能，需在[环信即时通讯云控制台](https://console.easemob.com/user/login)开通。 +群聊会话只支持消息已读回执。群主和群管理员在发送消息时，可以设置该消息是否需要已读回执。仅专业版及以上版本支持群消息已读回执功能。若要使用该功能，需在[环信即时通讯云控制台](https://console.easemob.com/user/login)开通。 本文介绍如何使用环信即时通讯 IM iOS SDK 实现单聊和群聊的消息回执功能。 @@ -41,7 +41,7 @@ - 完成 SDK 初始化，并连接到服务器，详见 [快速开始](quickstart.html)。 - 了解环信即时通讯 IM 的使用限制，详见 [使用限制](/product/limitation.html)。 -- 群消息已读回执功能仅在环信 IM 旗舰版及以上版本支持该功能。若要使用该功能，需在[环信即时通讯云控制台](https://console.easemob.com/user/login)开通。 +- 群消息已读回执功能仅在环信 IM 专业版及以上版本支持该功能。若要使用该功能，需在[环信即时通讯云控制台](https://console.easemob.com/user/login)开通。 ## 实现方法 @@ -122,6 +122,8 @@ EMChatManagerDelegate ##### 消息已读回执 +单聊消息的已读回执有效期与消息在服务端的存储时间一致，即在服务器存储消息期间均可发送已读回执。关于消息在服务端的存储时间与你订阅的套餐包有关，详见[产品价格](/product/pricing.html#套餐包功能详情)。 + 参考如下步骤在单聊中实现消息已读回执。 1. 接收方发送已读回执消息。 @@ -189,7 +191,9 @@ EMChatManagerDelegate 对于群聊，群主和群管理员发送消息时，可以设置该消息是否需要已读回执。若需要，每个群成员在阅读消息后，SDK 均会发送已读回执，即阅读该消息的群成员数量即为已读回执的数量。 -仅旗舰版及以上版本支持群消息已读回执功能。若要使用该功能，需在[环信即时通讯云控制台](https://console.easemob.com/user/login)开通。 +群聊已读回执的有效期为 3 天，即群组中的消息发送时间超过 3 天，服务器不记录阅读该条消息的群组成员，也不会发送已读回执。 + +仅专业版及以上版本支持群消息已读回执功能。若要使用该功能，需在[环信即时通讯云控制台](https://console.easemob.com/user/login)开通。 1. 群主或群管理员设置 `EMChatMessage` 的属性 `isNeedGroupAck` 为 `YES`。 diff --git a/docs/document/react-native/group_manage.md b/docs/document/react-native/group_manage.md index d72c6622f..59a7ac0a6 100644 --- a/docs/document/react-native/group_manage.md +++ b/docs/document/react-native/group_manage.md @@ -136,6 +136,10 @@ ChatClient.getInstance() - `getGroupWithId`：从内存获取群组详情。返回的结果包括群组 ID、群组名称、群组描述、群主、公告信息、群成员列表数量、消息屏蔽、是否全体禁言、权限类型等，默认不包含群成员。 - `fetchGroupInfoFromServer`：从服务器获取群组详情。返回的结果包括群组 ID、群组名称、群组描述、群组基本属性、群主、群组管理员列表、是否已屏蔽群组消息和群组是否禁用等信息。若将该方法的 `fetchMembers` 参数设置为 `true`，可获取群成员列表，默认最多包括 200 个成员。 +:::tip +对于公有群，用户即使不加入群也能获取群组详情，而对于私有群，用户只有加入了群组才能获取群详情。 +::: + ```typescript // 从本地获取群组详情。 ChatClient.getInstance() diff --git a/docs/document/react-native/message_receipt.md b/docs/document/react-native/message_receipt.md index 851431c2d..41d34a1f3 100644 --- a/docs/document/react-native/message_receipt.md +++ b/docs/document/react-native/message_receipt.md @@ -3,7 +3,7 @@ 单聊会话支持消息送达回执、会话已读回执和消息已读回执，发送方发送消息后可及时了解接收方是否及时收到并阅读了信息，也可以了解整个会话是否已读。 -群聊会话只支持消息已读回执。群主和群管理员在发送消息时，可以设置该消息是否需要已读回执。仅旗舰版及以上版本支持群消息已读回执功能。若要使用该功能，需在[环信即时通讯云控制台](https://console.easemob.com/user/login)开通。 +群聊会话只支持消息已读回执。群主和群管理员在发送消息时，可以设置该消息是否需要已读回执。仅专业版及以上版本支持群消息已读回执功能。若要使用该功能，需在[环信即时通讯云控制台](https://console.easemob.com/user/login)开通。 本文介绍如何使用环信即时通讯 IM React Native SDK 实现单聊和群聊的消息回执功能。 @@ -37,7 +37,7 @@ - 完成 SDK 初始化，并连接到服务器，详见 [快速开始](quickstart.html) 及 [SDK 集成概述](overview.html)。 - 了解环信即时通讯 IM 的使用限制，详见 [使用限制](/product/limitation.html)。 -- 群消息已读回执功能仅在环信 IM 旗舰版及以上版本支持该功能。若要使用该功能，需在[环信即时通讯云控制台](https://console.easemob.com/user/login)开通。 +- 群消息已读回执功能仅在环信 IM 专业版及以上版本支持该功能。若要使用该功能，需在[环信即时通讯云控制台](https://console.easemob.com/user/login)开通。 ## 实现方法 @@ -151,6 +151,8 @@ ChatClient.getInstance().chatManager.addMessageListener(listener); ##### 消息已读回执 +单聊消息的已读回执有效期与消息在服务端的存储时间一致，即在服务器存储消息期间均可发送已读回执。关于消息在服务端的存储时间与你订阅的套餐包有关，详见[产品价格](/product/pricing.html#套餐包功能详情)。 + 参考如下步骤在单聊中实现消息已读回执。 1. 开启全局的消息已读回执开关。如果全局设置不开启，消息和会话的相应设置也无法生效。 @@ -230,7 +232,9 @@ ChatClient.getInstance() 对于群聊，群主和群管理员发送消息时，可以设置该消息是否需要已读回执。若需要，每个群成员在阅读消息后，SDK 均会发送已读回执，即阅读该消息的群成员数量即为已读回执的数量。 -仅旗舰版及以上版本支持群消息已读回执功能。若要使用该功能，需在[环信即时通讯云控制台](https://console.easemob.com/user/login)开通。 +群聊已读回执的有效期为 3 天，即群组中的消息发送时间超过 3 天，服务器不记录阅读该条消息的群组成员，也不会发送已读回执。 + +仅专业版及以上版本支持群消息已读回执功能。若要使用该功能，需在[环信即时通讯云控制台](https://console.easemob.com/user/login)开通。 1. 消息发送方需要知道群组消息是否已读，需要监听 `onGroupMessageRead` 事件。 diff --git a/docs/document/server-side/callback.md b/docs/document/server-side/callback.md index 0cb6d1d86..8450ae84f 100644 --- a/docs/document/server-side/callback.md +++ b/docs/document/server-side/callback.md @@ -4,7 +4,7 @@ 回调功能，即环信 IM 服务器会在事件发生之前或之后，向你的应用服务器发送请求，你可以根据业务需求来干预事件的后续处理流程（发送前回调），或据此进行必要的数据同步（发送后回调）。 -一般发送前回调是对用户发送的消息内容的处理，发送后回调还包括送达回执和已读回执、群组或聊天室操作、好友关系操作和用户状态变化等事件，具体见 [用户在线状态回调](user_status_callback.html) 和发送后回调过滤规则设置。 +一般发送前回调是对用户发送的消息内容的处理，发送后回调还包括送达回执和已读回执、群组或聊天室操作、好友关系操作和用户状态变化等事件，详见发送后回调过滤规则设置。 设置消息内容回调的规则可以在环信即时通讯云控制台实现，如需单独设置特定类型不回调，请联系环信商务经理。 diff --git a/docs/document/unity/group_manage.md b/docs/document/unity/group_manage.md index e1fd8e8de..0b38a6554 100644 --- a/docs/document/unity/group_manage.md +++ b/docs/document/unity/group_manage.md @@ -150,6 +150,10 @@ SDKClient.Instance.GroupManager.LeaveGroup(groupId, new CallBack( 群成员也可以调用 `GetGroupSpecificationFromServer` 方法从服务器获取群组详情。返回结果包括：群组 ID、群组名称、群组描述、群主、群组管理员列表、是否已屏蔽群组消息以及群组是否禁用等信息，不包括群成员列表。 +:::tip +对于公有群，用户即使不加入群也能获取群组详情，而对于私有群，用户只有加入了群组才能获取群详情。 +::: + 示例代码如下： ```csharp diff --git a/docs/document/unity/message_receipt.md b/docs/document/unity/message_receipt.md index 15b4c3d41..c0d62fb58 100644 --- a/docs/document/unity/message_receipt.md +++ b/docs/document/unity/message_receipt.md @@ -4,7 +4,7 @@ 单聊会话支持消息送达回执、会话已读回执和消息已读回执，发送方发送消息后可及时了解接收方是否及时收到并阅读了信息，也可以了解整个会话是否已读。 -群聊会话只支持消息已读回执。群主和群管理员在发送消息时，可以设置该消息是否需要已读回执。仅旗舰版及以上版本支持群消息已读回执功能。若要使用该功能，需在[环信即时通讯云控制台](https://console.easemob.com/user/login)开通。 +群聊会话只支持消息已读回执。群主和群管理员在发送消息时，可以设置该消息是否需要已读回执。仅专业版及以上版本支持群消息已读回执功能。若要使用该功能，需在[环信即时通讯云控制台](https://console.easemob.com/user/login)开通。 本文介绍如何使用环信即时通讯 IM Unity SDK 实现单聊和群聊的消息回执功能。 @@ -41,7 +41,7 @@ - 完成 SDK 初始化，并连接到服务器，详见 [快速开始](quickstart.html)； - 了解环信即时通讯 IM 的使用限制，详见 [使用限制](/product/limitation.html)； -- 群消息已读回执功能仅在环信 IM 旗舰版及以上版本支持该功能。若要使用该功能，需在[环信即时通讯云控制台](https://console.easemob.com/user/login)开通。 +- 群消息已读回执功能仅在环信 IM 专业版及以上版本支持该功能。若要使用该功能，需在[环信即时通讯云控制台](https://console.easemob.com/user/login)开通。 ## 实现方法 @@ -134,6 +134,8 @@ SDKClient.Instance.ChatManager.RemoveChatManagerDelegate(adelegate); ##### 消息已读回执 +单聊消息的已读回执有效期与消息在服务端的存储时间一致，即在服务器存储消息期间均可发送已读回执。关于消息在服务端的存储时间与你订阅的套餐包有关，详见[产品价格](/product/pricing.html#套餐包功能详情)。 + 参考如下步骤在单聊中实现消息已读回执。 1. 接收方发送已读回执消息。 @@ -223,7 +225,9 @@ SDKClient.Instance.ChatManager.RemoveChatManagerDelegate(adelegate); 对于群聊，群主和群管理员发送消息时，可以设置该消息是否需要已读回执。若需要，每个群成员在阅读消息后，SDK 均会发送已读回执，即阅读该消息的群成员数量即为已读回执的数量。 -仅旗舰版及以上版本支持群消息已读回执功能。若要使用该功能，需在[环信即时通讯云控制台](https://console.easemob.com/user/login)开通。 +群聊已读回执的有效期为 3 天，即群组中的消息发送时间超过 3 天，服务器不记录阅读该条消息的群组成员，也不会发送已读回执。 + +仅专业版及以上版本支持群消息已读回执功能。若要使用该功能，需在[环信即时通讯云控制台](https://console.easemob.com/user/login)开通。 1. 群主或群管理员发送消息时若需已读回执，需设置 `Message` 的 `IsNeedGroupAck` 为 `true`。 diff --git a/docs/document/unity/room_members.md b/docs/document/unity/room_members.md index 9f3812dc7..f306f8055 100644 --- a/docs/document/unity/room_members.md +++ b/docs/document/unity/room_members.md @@ -46,7 +46,7 @@ SDKClient.Instance.RoomManager.FetchRoomMembers(roomId, cursor, pageSize, callba ### 将成员移出聊天室 -仅聊天室所有者和管理员可调用 `DeleteRoomMembers` 方法将指定成员移出聊天室。 +仅聊天室所有者和管理员可调用 `DeleteRoomMembers` 方法将单个或多个成员移出聊天室。 被移出后，该成员收到 `OnRemovedFromRoom` 回调，其他成员收到 `OnMemberExitedFromRoom` 回调。 diff --git a/docs/document/web/group_manage.md b/docs/document/web/group_manage.md index f3d31a374..298aa2cbf 100644 --- a/docs/document/web/group_manage.md +++ b/docs/document/web/group_manage.md @@ -116,6 +116,10 @@ conn.destroyGroup(option).then((res) => console.log(res)); 所有群成员均可调用 `getGroupInfo` 方法根据群组 ID 获取单个或多个群组的详情，包括群组 ID、群组名称、群组描述、群组基本属性、群成员列表、是否已屏蔽群组消息以及群组是否禁用。 +:::tip +对于公有群，用户即使不加入群也能获取群组详情，而对于私有群，用户只有加入了群组才能获取群详情。 +::: + 示例代码如下： ```javascript diff --git a/docs/document/web/message_receipt.md b/docs/document/web/message_receipt.md index c0c913fc1..29901cb01 100644 --- a/docs/document/web/message_receipt.md +++ b/docs/document/web/message_receipt.md @@ -4,7 +4,7 @@ 单聊会话支持消息送达回执、会话已读回执和消息已读回执，发送方发送消息后可及时了解接收方是否及时收到并阅读了信息，也可以了解整个会话是否已读。 -群聊会话只支持消息已读回执。群主和群管理员在发送消息时，可以设置该消息是否需要已读回执。仅旗舰版及以上版本支持群消息已读回执功能。若要使用该功能，需在[环信即时通讯云控制台](https://console.easemob.com/user/login)开通。 +群聊会话只支持消息已读回执。群主和群管理员在发送消息时，可以设置该消息是否需要已读回执。仅专业版及以上版本支持群消息已读回执功能。若要使用该功能，需在[环信即时通讯云控制台](https://console.easemob.com/user/login)开通。 本文介绍如何使用环信即时通讯 IM Web SDK 实现单聊和群聊的消息回执功能。 @@ -37,7 +37,7 @@ - 已经集成和初始化环信 IM SDK，并实现了注册账号和登录功能。详情请参见 [快速开始](quickstart.html)。 - 了解 [使用限制](/product/limitation.html) 中的 API 调用频率限制。 -- 群消息已读回执功能仅在环信 IM 旗舰版及以上版本支持该功能。若要使用该功能，需在[环信即时通讯云控制台](https://console.easemob.com/user/login)开通。 +- 群消息已读回执功能仅在环信 IM 专业版及以上版本支持该功能。若要使用该功能，需在[环信即时通讯云控制台](https://console.easemob.com/user/login)开通。 ## 实现方法 @@ -104,6 +104,8 @@ conn.addEventHandler("customEvent", { ##### 消息已读回执 +单聊消息的已读回执有效期与消息在服务端的存储时间一致，即在服务器存储消息期间均可发送已读回执。关于消息在服务端的存储时间与你订阅的套餐包有关，详见[产品价格](/product/pricing.html#套餐包功能详情)。 + 参考如下步骤在单聊中实现消息已读回执。 1. 接收方发送消息已读回执。 @@ -147,7 +149,9 @@ conn.addEventHandler("customEvent", { 对于群聊，群主和群管理员发送消息时，可以设置该消息是否需要已读回执。若需要，每个群成员在阅读消息后，SDK 均会发送已读回执，即阅读该消息的群成员数量即为已读回执的数量。 -仅旗舰版及以上版本支持群消息已读回执功能。若要使用该功能，需在[环信即时通讯云控制台](https://console.easemob.com/user/login)开通。 +群聊已读回执的有效期为 3 天，即群组中的消息发送时间超过 3 天，服务器不记录阅读该条消息的群组成员，也不会发送已读回执。 + +仅专业版及以上版本支持群消息已读回执功能。若要使用该功能，需在[环信即时通讯云控制台](https://console.easemob.com/user/login)开通。 1. 群主或群管理员发送消息时若需已读回执，需设置 `allowGroupAck` 为 `true`： diff --git a/docs/document/web/room_members.md b/docs/document/web/room_members.md index 000473249..017d4bdfe 100644 --- a/docs/document/web/room_members.md +++ b/docs/document/web/room_members.md @@ -57,7 +57,7 @@ conn.leaveChatRoom(option).then(res => console.log(res)) #### 成员被移出聊天室 -仅聊天室所有者和聊天室管理员可以调用 `removeChatRoomMember` 方法将指定成员移出聊天室。被踢出聊天室后，被踢成员会收到 `removeMember` 事件，其他成员会收到 `memberAbsence` 事件。被移出聊天室后，该用户还可以再次加入聊天室。 +仅聊天室所有者和聊天室管理员可以调用 `removeChatRoomMember` 方法将指定的单个成员移出聊天室。被踢出聊天室后，被踢成员会收到 `removeMember` 事件，其他成员会收到 `memberAbsence` 事件。被移出聊天室后，该用户还可以再次加入聊天室。 示例代码如下： diff --git a/docs/document/windows/group_manage.md b/docs/document/windows/group_manage.md index e1fd8e8de..0b38a6554 100644 --- a/docs/document/windows/group_manage.md +++ b/docs/document/windows/group_manage.md @@ -150,6 +150,10 @@ SDKClient.Instance.GroupManager.LeaveGroup(groupId, new CallBack( 群成员也可以调用 `GetGroupSpecificationFromServer` 方法从服务器获取群组详情。返回结果包括：群组 ID、群组名称、群组描述、群主、群组管理员列表、是否已屏蔽群组消息以及群组是否禁用等信息，不包括群成员列表。 +:::tip +对于公有群，用户即使不加入群也能获取群组详情，而对于私有群，用户只有加入了群组才能获取群详情。 +::: + 示例代码如下： ```csharp diff --git a/docs/document/windows/group_members.md b/docs/document/windows/group_members.md index f8ccad8b0..eba15d902 100644 --- a/docs/document/windows/group_members.md +++ b/docs/document/windows/group_members.md @@ -48,7 +48,7 @@ SDKClient.Instance.GroupManager.AddGroupMembers(groupId, members, new CallBack( ### 群组踢人 -仅群主和群管理员可以调用 `DeleteGroupMembers` 方法将指定成员移出群组。被移出后，该成员收到 `IGroupManagerDelegate#OnUserRemovedFromGroup` 回调，其他群成员收到 `IGroupManagerDelegate#OnMemberExitedFromGroup` 回调。被移出群组后，该用户还可以再次加入群组。 +仅群主和群管理员可以调用 `DeleteGroupMembers` 方法将单个或多个成员移出群组。被移出后，该成员收到 `IGroupManagerDelegate#OnUserRemovedFromGroup` 回调，其他群成员收到 `IGroupManagerDelegate#OnMemberExitedFromGroup` 回调。被移出群组后，该用户还可以再次加入群组。 示例代码如下： diff --git a/docs/document/windows/message_receipt.md b/docs/document/windows/message_receipt.md index d44bd99ac..8c98b5ec7 100644 --- a/docs/document/windows/message_receipt.md +++ b/docs/document/windows/message_receipt.md @@ -4,7 +4,7 @@ 单聊会话支持消息送达回执、会话已读回执和消息已读回执，发送方发送消息后可及时了解接收方是否及时收到并阅读了信息，也可以了解整个会话是否已读。 -群聊会话只支持消息已读回执。群主和群管理员在发送消息时，可以设置该消息是否需要已读回执。仅旗舰版及以上版本支持群消息已读回执功能。若要使用该功能，需在[环信即时通讯云控制台](https://console.easemob.com/user/login)开通。 +群聊会话只支持消息已读回执。群主和群管理员在发送消息时，可以设置该消息是否需要已读回执。仅专业版及以上版本支持群消息已读回执功能。若要使用该功能，需在[环信即时通讯云控制台](https://console.easemob.com/user/login)开通。 本文介绍如何使用环信即时通讯 IM Windows SDK 实现单聊和群聊的消息回执功能。 @@ -41,7 +41,7 @@ - 完成 SDK 初始化，并连接到服务器，详见 [快速开始](quickstart.html)； - 了解环信即时通讯 IM 的使用限制，详见 [使用限制](/product/limitation.html)； -- 群消息已读回执功能仅在环信 IM 旗舰版及以上版本支持该功能。若要使用该功能，需在[环信即时通讯云控制台](https://console.easemob.com/user/login)开通。 +- 群消息已读回执功能仅在环信 IM 专业版及以上版本支持该功能。若要使用该功能，需在[环信即时通讯云控制台](https://console.easemob.com/user/login)开通。 ## 实现方法 @@ -134,6 +134,8 @@ SDKClient.Instance.ChatManager.RemoveChatManagerDelegate(adelegate); ##### 消息已读回执 +单聊消息的已读回执有效期与消息在服务端的存储时间一致，即在服务器存储消息期间均可发送已读回执。关于消息在服务端的存储时间与你订阅的套餐包有关，详见[产品价格](/product/pricing.html#套餐包功能详情)。 + 参考如下步骤在单聊中实现消息已读回执。 1. 接收方发送已读回执消息。 @@ -223,7 +225,9 @@ SDKClient.Instance.ChatManager.RemoveChatManagerDelegate(adelegate); 对于群聊，群主和群管理员发送消息时，可以设置该消息是否需要已读回执。若需要，每个群成员在阅读消息后，SDK 均会发送已读回执，即阅读该消息的群成员数量即为已读回执的数量。 -仅旗舰版及以上版本支持群消息已读回执功能。若要使用该功能，需在[环信即时通讯云控制台](https://console.easemob.com/user/login)开通。 +群聊已读回执的有效期为 3 天，即群组中的消息发送时间超过 3 天，服务器不记录阅读该条消息的群组成员，也不会发送已读回执。 + +仅专业版及以上版本支持群消息已读回执功能。若要使用该功能，需在[环信即时通讯云控制台](https://console.easemob.com/user/login)开通。 1. 群主或群管理员发送消息时若需已读回执，需设置 `Message` 的 `IsNeedGroupAck` 为 `true`。 diff --git a/docs/document/windows/room_members.md b/docs/document/windows/room_members.md index 1f283c661..407d37855 100644 --- a/docs/document/windows/room_members.md +++ b/docs/document/windows/room_members.md @@ -46,7 +46,7 @@ SDKClient.Instance.RoomManager.FetchRoomMembers(roomId, cursor, pageSize, callba ### 将成员移出聊天室 -仅聊天室所有者和管理员可调用 `DeleteRoomMembers` 方法将指定成员移出聊天室。 +仅聊天室所有者和管理员可调用 `DeleteRoomMembers` 方法将单个或多个成员移出聊天室。 被移出后，该成员收到 `OnRemovedFromRoom` 回调，其他成员收到 `OnMemberExitedFromRoom` 回调。