Merge pull request #1423 from haoxiuwen/doc-v2

Modify Old Moderation and Push FCM Certificate Doc

Author: haoxiuwen

docs/document/android/push/push_fcm.md

@@ -49,13 +49,20 @@
 ![image](/images/android/push/fcm_certificate_v1.png)
 
 1. 点击 **添加推送证书**。在默认打开的 **谷歌** 页签中，配置 FCM 推送：
-- **证书类型** 选择 **V1**。
-- 点击 **上传证书** 上传获取的 FCM V1 版本证书文件（.json 文件）。
-- **证书名称** 设置为 FCM 的发送者 ID。你需要在[Firebase 控制台](https://console.firebase.google.com/?hl=zh-cn)的 **项目设置** > **云消息传递** 页面中，在 **Firebase Cloud Messaging API（V1）** 区域中获取发送者 ID，如下图所示。
-- 设置 **铃声**、**推送优先级设置** 和 **推送消息类型** 参数。
 
 ![image](/images/android/push/fcm_v1.png)
 
+| 参数             | 类型 | 是否必需 | 描述               |
+| :-------------- | :----- | :------- | :---------------------------- |
+| 证书类型     |  文件    | 是    | 选择使用 V1 或旧版证书。<br/> - **V1**：推荐使用。你需要点击 **上传证书** 上传FCM V1 版本证书文件，并且设置 **证书名称**。<br/> -**旧版**：已弃用，不推荐使用。你需要配置 **证书名称** 和 **推送密钥**。 |
+| 上传文件        | 文件 | 是   | 点击 **上传证书** 上传获取的 FCM V1 版本证书文件（.json 文件）。此项仅对 V1 证书有效。 |
+| 证书名称       | String | 是   | FCM 的发送者 ID。<br/> - v1 证书：在 [Firebase 控制台](https://console.firebase.google.com/?hl=zh-cn) 的 **项目设置** > **云消息传递** 页面的 **Firebase Cloud Messaging API（V1）** 区域中获取发送者 ID，如下图所示。<br/> - 旧版证书：在 [Firebase 控制台](https://console.firebase.google.com/?hl=zh-cn)的 **项目设置 > 云消息传递** 页面的 **Cloud Messaging API（旧版）** 区域中获取发送者 ID。 |
+| 推送密钥     | String | 是   | FCM 服务器密钥。你需在 [Firebase 控制台](https://console.firebase.google.com/) 的 **项目设置** > **云消息传递**页面的 **云消息传递 API（旧版）** 区域中获取服务器密钥。此参数仅对旧版证书有效。|
+| 通道 ID         | String | 否     | FCM 通道 ID。该参数仅对离线推送有效。       |
+| 推送优先级设置  |      | 否    | 消息传递优先级。请参见 [设置消息优先级](https://firebase.google.cn/docs/cloud-messaging/concept-options#setting-the-priority-of-a-message)。<br/> 该参数仅对离线推送有效。|
+| 推送消息类型 |      | 否    | 通过 FCM 发送给客户端的消息类型：<br/> - **数据**：数据消息，由客户端应用程序处理。<br/> - **通知**：通知消息，由 FCM SDK 自动处理。**数据+通知**：通知消息和数据消息都可以通过 FCM 客户端发送。 <br/>请参见 FCM 的 [消息类型介绍](https://firebase.google.com/docs/cloud-messaging/concept-options#notifications_and_data_messages)。<br/> 该参数仅对离线推送有效。|
+| APNs跨平台推送支持 | String | 否 | 是否开启 APNs 跨平台推送支持。非跨平台应用建议不要启用。该参数仅对离线推送有效。|
+
 #### **旧版证书无缝切换至 V1 证书**
 
 若你仍使用旧版证书，即 **证书类型** 选择 **旧版**，你需要将 **证书名称** 设置为 FCM 的发送者 ID，**推送密钥** 设置为 FCM 的服务器密钥。你需在 [Firebase 控制台](https://console.firebase.google.com/?hl=zh-cn)的 **项目设置 > 云消息传递** 页面中，在 **Cloud Messaging API（旧版）** 区域中获取发送者 ID 和服务器密钥，如下图所示。配置完毕，设置 **铃声**、**推送优先级设置** 和 **推送消息类型** 参数。

docs/product/moderation/keyword_review.md

@@ -58,10 +58,11 @@
 
 | 字段                 | 描述                                                         |
 | :------------------- | :----------------------------------------------------------- |
-| **名单名称**  | 关键词名单的名称，不能超过 32 个字符。             |
-| **审核建议** | 对关键词的审核结果，包括：<br/> • **忽略**：表示关键词合法。<br/> • **疑似**：表示关键词可能非法。<br/> • **拒绝**：表示关键词非法。 |
-| **生效范围**  | 关键词审核规则的应用范围，包括：<br/> • **全部**：所有会话，包含单聊、群聊和聊天室。<br/> • **单聊**<br/> • **群聊**<br/> • **聊天室** |
-| **关键词**  | 该规则中的关键词。每个关键词的长度不能超过 128 个字符；一次最多可添加 200 个词条，每行一个词条。             |
+| 名单名称  | 关键词名单的名称，不能超过 32 个字符。             |
+| 命中处置 | 对命中关键词的消息的处理：<br/> - **通过**：下发消息。<br/> - `替换为***`：将消息内容中命中的关键词替换为 `***` 后再下发消息。<br/>- **拦截**：不下发消息。 |
+| 生效范围  | 关键词审核规则的应用范围，包括：<br/> - **全部**：所有会话，包含单聊、群聊和聊天室会话。<br/> - **单聊**<br/> - **群聊**<br/> - **聊天室** <br/> - 群组/聊天室标签。详见 [标签管理](moderation_user_tag.html)。|
+| 匹配方式  | <br/> - **包含匹配**：模糊匹配，即消息内容中包含关键词内容即为命中。例如，关键词为“加我微信”，若消息内容中包含“加我微信88888**88” 即命中关键词。  <br/> - **相等匹配**：精确匹配。|
+| 关键词  | 该规则中的关键词。每个关键词的长度不能超过 128 个字符，一次最多可添加 200 个词条，每行一个词条。 |
 
 3. 点击**确定**保存配置。
 

docs/product/moderation/moderation_record_callback.md

@@ -36,6 +36,7 @@
     "source": {
 
     },
+    "riskType": "广告",
     "eventType": "moderation", 
     "from": "qa2",
     "to": "qa1",
@@ -55,6 +56,7 @@
 | messageId       | String  | 消息 ID。   |
 | targetType       | String | 会话类型。<br/> - `chat`：单聊；<br/> - `groupchat`：群聊；<br/> - `chatroom`：聊天室。  |
 | appkey       | String | 你的 App Key。   |
+| riskType       | String |  风险类型，例如，`无风险`、`涉政`、`仇恨言论`、`色情`、`成人内容`、`暴恐`、`违禁`、`广告`、`二维码` 和 `未知`。   |
 | eventType       | String | 事件类型，审核服务为 `moderation`。|
 | from      | String | 消息发送方。   |
 | to      | String | 消息接收方：<br/> - 单聊为对端用户 ID；<br/> - 群聊时为群组 ID；<br/> - 聊天室聊天为聊天室 ID。  |