From 6f7c5c2247f5e528e9049860f5cfc41946077383 Mon Sep 17 00:00:00 2001 From: haoxiuwen Date: Wed, 20 Aug 2025 11:28:31 +0800 Subject: [PATCH] Modify Old Moderation and Push FCM Certificate Doc --- docs/document/android/push/push_fcm.md | 15 +++++++++++---- docs/product/moderation/keyword_review.md | 9 +++++---- .../moderation/moderation_record_callback.md | 2 ++ 3 files changed, 18 insertions(+), 8 deletions(-) diff --git a/docs/document/android/push/push_fcm.md b/docs/document/android/push/push_fcm.md index e8441bb85..69de86318 100644 --- a/docs/document/android/push/push_fcm.md +++ b/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 或旧版证书。
- **V1**：推荐使用。你需要点击 **上传证书** 上传FCM V1 版本证书文件，并且设置 **证书名称**。
-**旧版**：已弃用，不推荐使用。你需要配置 **证书名称** 和 **推送密钥**。 | +| 上传文件 | 文件 | 是 | 点击 **上传证书** 上传获取的 FCM V1 版本证书文件（.json 文件）。此项仅对 V1 证书有效。 | +| 证书名称 | String | 是 | FCM 的发送者 ID。
- v1 证书：在 [Firebase 控制台](https://console.firebase.google.com/?hl=zh-cn) 的 **项目设置** > **云消息传递** 页面的 **Firebase Cloud Messaging API（V1）** 区域中获取发送者 ID，如下图所示。
- 旧版证书：在 [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)。
该参数仅对离线推送有效。| +| 推送消息类型 | | 否 | 通过 FCM 发送给客户端的消息类型：
- **数据**：数据消息，由客户端应用程序处理。
- **通知**：通知消息，由 FCM SDK 自动处理。**数据+通知**：通知消息和数据消息都可以通过 FCM 客户端发送。
请参见 FCM 的 [消息类型介绍](https://firebase.google.com/docs/cloud-messaging/concept-options#notifications_and_data_messages)。
该参数仅对离线推送有效。| +| APNs跨平台推送支持 | String | 否 | 是否开启 APNs 跨平台推送支持。非跨平台应用建议不要启用。该参数仅对离线推送有效。| + #### **旧版证书无缝切换至 V1 证书** 若你仍使用旧版证书，即 **证书类型** 选择 **旧版**，你需要将 **证书名称** 设置为 FCM 的发送者 ID，**推送密钥** 设置为 FCM 的服务器密钥。你需在 [Firebase 控制台](https://console.firebase.google.com/?hl=zh-cn)的 **项目设置 > 云消息传递** 页面中，在 **Cloud Messaging API（旧版）** 区域中获取发送者 ID 和服务器密钥，如下图所示。配置完毕，设置 **铃声**、**推送优先级设置** 和 **推送消息类型** 参数。 diff --git a/docs/product/moderation/keyword_review.md b/docs/product/moderation/keyword_review.md index 17de73bf7..e4ef2490c 100644 --- a/docs/product/moderation/keyword_review.md +++ b/docs/product/moderation/keyword_review.md @@ -58,10 +58,11 @@ | 字段 | 描述 | | :------------------- | :----------------------------------------------------------- | -| **名单名称** | 关键词名单的名称，不能超过 32 个字符。 | -| **审核建议** | 对关键词的审核结果，包括：
• **忽略**：表示关键词合法。
• **疑似**：表示关键词可能非法。
• **拒绝**：表示关键词非法。 | -| **生效范围** | 关键词审核规则的应用范围，包括：
• **全部**：所有会话，包含单聊、群聊和聊天室。
• **单聊**
• **群聊**
• **聊天室** | -| **关键词** | 该规则中的关键词。每个关键词的长度不能超过 128 个字符；一次最多可添加 200 个词条，每行一个词条。 | +| 名单名称 | 关键词名单的名称，不能超过 32 个字符。 | +| 命中处置 | 对命中关键词的消息的处理：
- **通过**：下发消息。
- `替换为***`：将消息内容中命中的关键词替换为 `***` 后再下发消息。
- **拦截**：不下发消息。 | +| 生效范围 | 关键词审核规则的应用范围，包括：
- **全部**：所有会话，包含单聊、群聊和聊天室会话。
- **单聊**
- **群聊**
- **聊天室**
- 群组/聊天室标签。详见 [标签管理](moderation_user_tag.html)。| +| 匹配方式 |
- **包含匹配**：模糊匹配，即消息内容中包含关键词内容即为命中。例如，关键词为“加我微信”，若消息内容中包含“加我微信88888**88” 即命中关键词。
- **相等匹配**：精确匹配。| +| 关键词 | 该规则中的关键词。每个关键词的长度不能超过 128 个字符，一次最多可添加 200 个词条，每行一个词条。 | 3. 点击**确定**保存配置。 diff --git a/docs/product/moderation/moderation_record_callback.md b/docs/product/moderation/moderation_record_callback.md index 78558776f..10c2e3595 100644 --- a/docs/product/moderation/moderation_record_callback.md +++ b/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 | 会话类型。
- `chat`：单聊；
- `groupchat`：群聊；
- `chatroom`：聊天室。 | | appkey | String | 你的 App Key。 | +| riskType | String | 风险类型，例如，`无风险`、`涉政`、`仇恨言论`、`色情`、`成人内容`、`暴恐`、`违禁`、`广告`、`二维码` 和 `未知`。 | | eventType | String | 事件类型，审核服务为 `moderation`。| | from | String | 消息发送方。 | | to | String | 消息接收方：
- 单聊为对端用户 ID；
- 群聊时为群组 ID；
- 聊天室聊天为聊天室 ID。 |