Merge pull request #1436 from haoxiuwen/doc-v2

Add Function Activation Description on Console for SDK and REST Docs

Author: haoxiuwen

docs/document/android/conversation_list.md

@@ -31,7 +31,7 @@
 对于每个终端用户，服务器默认存储 100 条会话。超过该限制后，新会话会覆盖旧会话。若会话中的历史消息均过期，会话变成空会话。从服务端拉取会话列表时默认不包含这些空会话，若要包含，需在 SDK 初始化时将 `EMOptions#isLoadEmptyConversations` 设置为 `true`。这种情况下，空会话都会占用会话拉取名额，不管拉取时是否需要。如果拉取会话时不需要空会话且不希望其占用会话列表名额，需要联系商务开通。
 
 :::tip
-1. **若使用该功能，需在环信控制台开通，并将 SDK 升级至 4.0.3。而且，只有开通该功能，你才能使用置顶会话和会话标记功能。** 
+1. **若使用该功能，需 [在环信控制台开通](/product/console/basic_conversation_group_chatroom.html#服务端会话列表)，并将 SDK 升级至 4.0.3。而且，只有开通该功能，你才能使用置顶会话和会话标记功能。** 
 2. 建议你在首次下载、卸载后重装应用等本地数据库无数据情况下拉取服务端会话列表。其他情况下，调用 `asyncFilterConversationsFromDB`、`getAllConversationsBySort` 或 `getAllConversations` 方法获取本地所有会话即可。
 3. 通过 RESTful 接口发送的消息默认不创建或写入会话。若会话中的最新一条消息通过 RESTful 接口发送，获取会话列表时，该会话中的最新一条消息显示为通过非 RESTful 接口发送的最新消息。若要开通 RESTful 接口发送的消息写入会话列表的功能，需在[环信即时通讯控制台开通](/product/enable_and_configure_IM.html#设置通过-restful-api-发送的消息写入会话列表)。
 :::

docs/document/android/message_receipt.md

@@ -4,7 +4,7 @@
 
 **单聊会话支持消息送达回执和消息已读回执**，发送方发送消息后可及时了解接收方是否及时收到并阅读了消息。
 
-**群聊会话只支持消息已读回执，不支持送达回执**。群成员在发送消息时，可以设置该消息是否需要已读回执。要使用该功能，你需要 [在环信即时通讯云控制台上开通该功能](/product/enable_and_configure_IM.html#设置群消息已读回执)，具体费用详见 [计费策略](/product/pricing_policy.html#增值服务费用)。
+**群聊会话只支持消息已读回执，不支持送达回执**。群成员在发送消息时，可以设置该消息是否需要已读回执。要使用该功能，你需要 [在环信控制台上开通该功能](/product/console/basic_message.html#群聊消息已读回执)，具体费用详见 [计费策略](/product/pricing_policy.html#增值服务费用)。
 
 消息送达回执和已读回执的效果示例，如下图所示：
 
@@ -38,7 +38,7 @@
 
 - 完成 SDK 初始化，并连接到服务器，详见 [快速开始](quickstart.html)。
 - 了解环信即时通讯 IM 的使用限制，详见 [使用限制](/product/limitation.html)。
-- 要使用群消息已读回执功能，需在[环信即时通讯云控制台](https://console.easemob.com/user/login)开通，具体费用详见 [计费策略](/product/pricing_policy.html#增值服务费用)。
+- 要使用群消息已读回执功能，需在 [环信控制台](https://console.easemob.com/user/login) 开通，具体费用详见 [计费策略](/product/pricing_policy.html#增值服务费用)。
 
 ## 实现方法
 

docs/document/android/multi_device.md

@@ -2,7 +2,7 @@
 
 <Toc />
 
-即时通讯 IM 支持同一账号在多个设备上登录，使用该服务前，你需要在[环信即时通讯控制台](https://console.easemob.com/user/login)的 **即时通讯** > **功能配置** > **功能配置总览** > **基础功能** 页面上查找**多端多设备在线**，开启该功能。
+即时通讯 IM 支持同一账号在多个设备上登录。使用该功能前，你需要在 [环信控制台](https://console.easemob.com/user/login) 开通该服务。详见 [环信控制台文档](/product/console/basic_user.html#多端多设备)。
 
 多端多设备登录场景下，所有已登录的设备同步以下信息和操作：
 
@@ -11,7 +11,7 @@
 - 子区相关操作；
 - 会话相关操作。
 
-多端登录时，即时通讯 IM 每端默认最多支持 4 个设备同时在线。如需增加支持的设备数量，可以联系环信即时通讯 IM 的商务经理。你可以在环信控制台的**基础功能**页签下点击**多端多设备在线**操作栏中的**设置**，在弹出的对话框中设置各端设备的数量：
+多端登录时，即时通讯 IM 每端默认最多支持 4 个设备同时在线。如需增加支持的设备数量，可以联系环信即时通讯 IM 的商务经理。你可以在环信控制台的 **基础功能** 页签下点击**多端多设备在线**操作栏中的**设置**，在弹出的对话框中设置各端设备的数量：
 
 ![img](/images/common/multidevice_device_count.png)
 
@@ -53,9 +53,9 @@ Android SDK 初始化时会生成登录 ID 用于在多设备登录和消息推
 
 ## 前提条件
 
-开始前，确保将 SDK 初始化，连接到服务器。详见[快速开始](quickstart.html)。
-
-设置登录设备的自定义名称和平台需在 SDK 初始化时中完成。
+- 开始前，确保将 SDK 初始化，连接到服务器。详见[快速开始](quickstart.html)。
+- 已在 [环信控制台](https://console.easemob.com/user/login) 开通多端多设备功能。详见 [环信控制台文档](/product/console/basic_user.html#多端多设备)。
+- 设置登录设备的自定义名称和平台需在 SDK 初始化时中完成。
 
 ## 实现方法   
 

docs/document/android/presence.md

@@ -2,7 +2,7 @@
 
 <Toc />
 
-用户在线状态（即 Presence）包含用户的在线、离线以及自定义状态。
+用户在线状态（即 Presence）包含用户的在线、离线以及自定义状态。使用该功能前，你需要在 [环信控制台](https://console.easemob.com/user/login) 开通该服务。详见 [环信控制台文档](/product/console/basic_user.html#用户离在线状态实时同步)。
 
 本文介绍如何在即时通讯应用中发布、订阅和查询用户的在线状态。
 
@@ -36,9 +36,9 @@
 
 使用在线状态功能前，请确保满足以下条件：
 
-1. 完成 `3.9.1 或以上版本` SDK 初始化，详见 [快速开始](quickstart.html)。
+1. 完成 3.9.1 或以上版本 SDK 初始化，详见 [快速开始](quickstart.html)。
 2. 了解环信即时通讯 IM API 的 [使用限制](/product/limitation.html)。
-3. 已在[环信控制台](https://console.easemob.com/user/login)开通在线状态订阅功能。
+3. 已在[环信控制台](https://console.easemob.com/user/login)开通在线状态订阅功能。详见 [环信控制台文档](/product/console/basic_user.html#用户离在线状态实时同步)。
 
 ## 实现方法
 

docs/document/android/thread.md

@@ -2,11 +2,9 @@
 
 <Toc />
 
-子区是群组成员的子集，是支持多人沟通的即时通讯系统。本文介绍如何使用环信即时通讯 IM Android SDK 在实时互动 app 中创建和管理子区，并实现子区相关功能。
+子区是群组成员的子集，是支持多人沟通的即时通讯系统。使用子区功能前，你需要在 [环信控制台](https://console.easemob.com/user/login) 开通。详见 [环信控制台文档](/product/console/basic_conversation_group_chatroom.html#消息话题)。
 
-使用子区功能前，你需要在[环信即时通讯控制台](https://console.easemob.com/user/login)开通。
-
-如需查看消息相关内容，参见 [子区消息管理](thread_message.html)。
+本文介绍如何使用环信即时通讯 IM Android SDK 在实时互动 app 中创建和管理子区，并实现子区相关功能。如需查看消息相关内容，参见 [子区消息管理](thread_message.html)。
 
 ## 技术原理
 
@@ -28,7 +26,7 @@
 - 完成 3.9.3 或以上版本 SDK 初始化，详见 [快速开始](quickstart.html)。
 - 了解环信即时通讯 IM API 的 [使用限制](/product/limitation.html)。
 - 了解子区和子区成员数量限制，详见 [使用限制](/product/limitation.html)。
-- 已在[环信即时通讯控制台](https://console.easemob.com/user/login)开通子区功能。
+- 已在 [环信控制台](https://console.easemob.com/user/login) 开通子区功能。详见 [环信控制台文档](/product/console/basic_conversation_group_chatroom.html#消息话题)。
 
 ## 实现方法
 

docs/document/android/thread_message.md

@@ -2,9 +2,9 @@
 
 <Toc />
 
-子区消息消息类型属于群聊消息类型，与普通群组消息的区别是需要添加 `isChatThreadMessage` 标记。本文介绍环信即时通讯 IM Android SDK 如何发送、接收以及撤回子区消息。
+子区消息消息类型属于群聊消息类型，与普通群组消息的区别是需要添加 `isChatThreadMessage` 标记。使用子区消息功能前，你需要在 [环信控制台](https://console.easemob.com/user/login)开通。详见 [环信控制台文档](/product/console/basic_conversation_group_chatroom.html#消息话题)。
 
-使用子区功能前，你需要在[环信即时通讯控制台](https://console.easemob.com/user/login)开通。
+本文介绍环信即时通讯 IM Android SDK 如何发送、接收以及撤回子区消息。
 
 ## 技术原理
 
@@ -25,7 +25,7 @@
 - 已集成环信 IM 3.9.3 或以上版本的基本功能，账户登录成功。
 - 完成 SDK 初始化，详见 [快速开始](quickstart.html)。
 - 了解环信即时通讯 IM 的使用限制，详见 [使用限制](/product/limitation.html)。
-- 已在[环信即时通讯控制台](https://console.easemob.com/user/login)开通子区功能。
+- 已在[环信控制台](https://console.easemob.com/user/login)开通子区功能。详见 [环信控制台文档](/product/console/basic_conversation_group_chatroom.html#消息话题)。
 
 ## 实现方法
 

docs/document/android/user_relationship.md

@@ -5,9 +5,9 @@
 SDK 提供用户关系管理功能，包括好友列表管理和黑名单管理：
 
 - 好友列表管理：查询好友列表、请求添加好友、接受好友请求、拒绝好友请求、删除好友和设置好友备注等操作。
-- 黑名单管理：查询黑名单列表、添加用户至黑名单以及将用户移除黑名单等操作。
+- 黑名单管理：查询黑名单列表、添加用户至黑名单以及将用户移除黑名单等操作。使用该功能前，你需要在 [环信控制台](https://console.easemob.com/user/login) 开通该服务。详见 [环信控制台文档](/product/console/basic_user.html#用户黑名单)。
 
-此外，环信即时通讯 IM 默认支持陌生人之间发送单聊消息，即无需添加好友即可聊天。若仅允许好友之间发送单聊消息，你需要在[环信即时通讯云控制台](https://console.easemob.com/user/login)[开启好友关系检查](/product/enable_and_configure_IM.html#好友关系检查)。该功能开启后，SDK 会在用户发起单聊时检查好友关系，若用户向陌生人发送单聊消息，SDK 会提示错误码 221。
+此外，环信即时通讯 IM 默认支持陌生人之间发送单聊消息，即无需添加好友即可聊天。若仅允许好友之间发送单聊消息，你需要在[环信控制台](https://console.easemob.com/user/login)[开启好友关系检查](/product/enable_and_configure_IM.html#好友关系检查)。该功能开启后，SDK 会在用户发起单聊时检查好友关系，若用户向陌生人发送单聊消息，SDK 会提示错误码 221。
 
 ## 技术原理
 
@@ -26,6 +26,7 @@ SDK 提供用户关系管理功能，包括好友列表管理和黑名单管理
 
 - 完成 SDK 初始化，并连接到服务器，详见 [快速开始](quickstart.html)。
 - 了解环信即时通讯 IM 的使用限制，详见 [使用限制](/product/limitation.html)。
+- 已在 [环信控制台](https://console.easemob.com/user/login) 开通黑名单功能。详见 [环信控制台文档](/product/console/basic_user.html#用户黑名单)。
 
 ## 实现方法
 

docs/document/flutter/conversation_list.md

@@ -29,7 +29,7 @@
 对于每个终端用户，服务器默认存储 100 条会话。超过该限制后，新会话会覆盖旧会话。若会话中的历史消息均过期，会话变成空会话。从服务端拉取会话列表时默认不包含这些空会话，若要包含，需在 SDK 初始化时将 `EMOptions#enableEmptyConversation` 设置为 `true`。这种情况下，空会话都会占用会话拉取名额，不管拉取时是否需要。如果拉取会话时不需要空会话且不希望其占用会话列表名额，需要联系商务开通。
 
 :::tip
-1. **若使用该功能，需在环信控制台开通该功能，并将 SDK 升级至 V4.5.0 或以上版本。只有开通该功能，你才能使用置顶会话功能。** 
+1. **若使用该功能，需 [在环信控制台开通](/product/console/basic_conversation_group_chatroom.html#服务端会话列表) ，并将 SDK 升级至 V4.5.0 或以上版本。只有开通该功能，你才能使用置顶会话功能。** 
 2. 建议在 app 安装时或本地没有会话时调用该方法，否则调用 `loadAllConversations` 获取本地会话即可。
 3. 通过 RESTful 接口发送的消息默认不创建或写入会话。若会话中的最新一条消息通过 RESTful 接口发送，获取会话列表时，该会话中的最新一条消息显示为通过非 RESTful 接口发送的最新消息。若要开通 RESTful 接口发送的消息写入会话列表的功能，需在[环信即时通讯控制台开通](/product/enable_and_configure_IM.html#设置通过-restful-api-发送的消息写入会话列表)。
 :::

docs/document/flutter/message_receipt.md

@@ -4,7 +4,7 @@
 
 **单聊会话支持消息送达回执和消息已读回执**，发送方发送消息后可及时了解接收方是否及时收到并阅读了消息。
 
-**群聊会话只支持消息已读回执，不支持送达回执**。群成员在发送消息时，可以设置该消息是否需要已读回执。要使用该功能，你需要[在环信即时通讯云控制台上开通该功能](/product/enable_and_configure_IM.html#设置群消息已读回执)，具体费用详见 [计费策略](/product/pricing_policy.html#增值服务费用)。
+**群聊会话只支持消息已读回执，不支持送达回执**。群成员在发送消息时，可以设置该消息是否需要已读回执。要使用该功能，你需要 [在环信控制台上开通该功能](/product/console/basic_message.html#群聊消息已读回执)，具体费用详见 [计费策略](/product/pricing_policy.html#增值服务费用)。
 
 消息送达回执和已读回执的效果示例，如下图所示：
 
@@ -38,7 +38,7 @@
 
 - 完成 SDK 初始化，并连接到服务器，详见 [快速开始](quickstart.html)。
 - 了解环信即时通讯 IM 的使用限制，详见 [使用限制](/product/limitation.html)。
-- 要使用群消息已读回执功能，需在[环信即时通讯云控制台](https://console.easemob.com/user/login)开通，具体费用详见 [计费策略](/product/pricing_policy.html#增值服务费用)。
+- 要使用群消息已读回执功能，需在 [环信控制台](https://console.easemob.com/user/login) 开通，具体费用详见  [计费策略](/product/pricing_policy.html#增值服务费用)。
 
 ## 实现方法
 

docs/document/flutter/multi_device.md

@@ -2,7 +2,7 @@
 
 <Toc />
 
-即时通讯 IM 支持同一账号在多个设备上登录，使用该服务前，你需要在[环信即时通讯控制台](https://console.easemob.com/user/login)的 **即时通讯** > **功能配置** > **功能配置总览** > **基础功能** 页面上查找**多端多设备在线**，开启该功能。
+即时通讯 IM 支持同一账号在多个设备上登录。使用该功能前，你需要在 [环信控制台](https://console.easemob.com/user/login) 开通该服务。详见 [环信控制台文档](/product/console/basic_user.html#多端多设备)。
 
 多端多设备登录场景下，所有已登录的设备同步以下信息和操作：
 
@@ -51,9 +51,9 @@ Android SDK 初始化时会生成登录 ID 用于在多设备登录和消息推
 
 ## 前提条件
 
-开始前，确保将 SDK 初始化，连接到服务器。详见[快速开始](quickstart.html)。
-
-设置登录设备的自定义名称和平台需在 SDK 初始化时中完成。
+- 开始前，确保将 SDK 初始化，连接到服务器。详见[快速开始](quickstart.html)。
+- 已在 [环信控制台](https://console.easemob.com/user/login) 开通多端多设备功能。详见 [环信控制台文档](/product/console/basic_user.html#多端多设备)。
+- 设置登录设备的自定义名称和平台需在 SDK 初始化时中完成。
 
 ## 实现方法