@tencentcloud/sdk-mcp 1.4.7 → 1.6.0-beta.1

package/resource/knowledge/push/config/android/fcm.md

@@ -0,0 +1,133 @@
+本文将介绍如何完成 Google FCM 离线推送服务厂商配置。
+
+## 前提条件
+
+开始前，请确认您已具备以下条件：
+
+|**条件**|**说明**|
+|---------|---------|
+|Google 账号|用于登录 Firebase 控制台。|
+|Android App 包名|Firebase Android 应用包名必须与 Android 工程的 `applicationId` 保持一致。包名区分大小写，且 Firebase 应用注册后无法更改。Google FCM 推送服务不要求应用先上架应用市场。|
+|Android 运行环境|目标设备或模拟器需支持 Android 6.0（API 23）及以上，并安装 Google Play 服务。|
+|可访问 Google 服务的网络环境|用于访问 Firebase 控制台、下载配置文件、生成服务账号私钥，并在运行时连接 Google Play 服务和 FCM。|
+|腾讯云账号和即时通信 IM 应用权限|用于在腾讯云控制台添加 Google FCM 厂商证书。|
+|后续 Android 工程接入权限|用于在 `SDK 接入` 阶段集成 TIMPush 和 FCM 推送依赖。|
+
+## Firebase 控制台配置
+
+> **提示：**
+>
+
+> 本文配置流程可对照 Firebase 官方 [将 Firebase 添加到 Android 项目](https://firebase.google.cn/docs/android/setup) 操作。
+>
+
+### 进入 Firebase 控制台
+
+进入 [Firebase 控制台](https://console.firebase.google.com)，登录 Google 账号。
+
+### 创建项目并注册 Android 应用
+1. 单击**创建项目**，添加一个新的项目。
+
+   > **说明：**
+   >
+
+   > Firebase 会根据项目名称生成项目 ID。项目创建后，项目 ID 无法更改，请在创建前确认命名和用途。创建项目时，建议启用 Google Analytics，以便后续使用 FCM 消息传送报告能力。
+   >
+
+2. 进入 Android 应用注册入口。
+
+3. 输入应用信息，注册 Android 应用。
+
+   > **注意：**
+   >
+
+   > Android 软件包名称区分大小写，且 Firebase Android 应用注册后无法更改。请确保填写的包名与 Android 工程的 `applicationId` 完全一致。
+   >
+
+4. 下载 `google-services.json` 配置文件，完成注册。
+
+   > **注意：**
+   >
+
+   > 后续 SDK 接入时，需将 `google-services.json` 放置到 Android 工程的**模块（应用级）根目录**，例如 `app/google-services.json`，不要放到项目根目录。
+   >
+
+## 生成服务账号私钥
+1. 单击应用，进入应用管理。
+
+2. 在**项目设置**中单击**服务账号 > 生成新的密钥**，生成并下载服务账号私钥 JSON 文件。
+
+   > **注意：**
+   >
+
+   > 服务账号私钥用于服务端向 FCM 鉴权，请妥善保存。不要将私钥提交到代码仓库、客户端安装包或公开渠道。
+   >
+
+### 确认 FCM API V1 状态
+
+在 Firebase 控制台**项目设置 > Cloud Messaging **中，确认 **Firebase Cloud Messaging API (V1)**已启用。新接入场景请使用 HTTP v1 API 和服务账号私钥进行 FCM 鉴权。
+
+> **注意：**
+>
+
+> FCM 旧版 Server Key（HTTP/XMPP）已被弃用。TIMPush 的 Google FCM 通道应使用 HTTP v1 API 和服务账号私钥，请勿混用旧版 Server Key 凭据。
+>
+
+## 腾讯云控制台配置
+
+### 添加 Google FCM 厂商证书
+
+登录腾讯云 [即时通信 IM 控制台](https://console.qcloud.com/avc)，在**推送服务 Push** > **推送设置** > **厂商配置**中添加 Google FCM 厂商证书，并按控制台要求上传或填写服务账号私钥相关配置。
+| <strong>厂商推送平台</strong> | <strong>腾讯云即时通信 IM 控制台</strong> |
+| --- | --- |
+|  |  |
+
+### 选择 FCM 消息类型
+
+FCM 支持通知消息和数据消息。腾讯云控制台默认选择通知消息，可根据业务场景切换消息类型。
+
+|**消息类型**|**处理方式**|**适用建议**|
+|---------|---------|---------|
+|通知消息|应用在后台时，FCM SDK 可自动将通知显示到通知面板。|适用于只需要展示基础离线通知的场景，新接入建议优先使用。|
+|数据消息|由客户端应用代码自行处理，FCM 不会自动展示通知。|适用于需要自定义处理业务数据、路由或展示逻辑的场景，接入后需在目标设备上充分测试。|
+|通知消息 + 数据载荷|后台展示通知，同时携带业务参数。|适用于既要展示通知，又要在用户单击通知后传递业务参数的场景。|
+
+控制台可通过**消息类型**选项进行切换：
+
+> **注意：**
+>
+
+> FCM 数据消息能力仅支持 TIMPush 7.8 及以上版本的 Pixel 手机，其他厂商设备需自测支持情况。
+>
+
+## 配额和限频对推送效果的影响
+
+Google FCM 没有国内厂商的私信、公信、服务通讯等消息分类体系，但会对项目、单设备和可折叠消息进行配额和限频管理。若发送频率过高，可能出现限流、延迟、失败或被判定为滥用。
+
+|**限制维度**|**官方规则**|**配置建议**|
+|---------|---------|---------|
+|项目级下行配额|FCM HTTP v1 API 默认按项目、按分钟计量，下行消息默认配额为每项目每分钟 `60 万` 条。超限可能返回 `429 RESOURCE_EXHAUSTED / QUOTA_EXCEEDED`。|服务端发送链路需处理限流、退避和重试，避免短时间流量激增。|
+|单设备发送速率|Android 单设备限制为 `240` 条/分钟、`5000` 条/小时。|同一用户的多条业务提醒建议在业务侧合并或降频。|
+|可折叠消息|每台设备、每个应用可突发发送 `20` 条可折叠消息，之后每 `3` 分钟补充 `1` 条。|同步类、状态刷新类消息不要高频重复发送，避免被延迟。|
+|消息类型|通知消息适合基础离线通知；数据消息支持更灵活的自定义处理，但需要客户端完整实现处理逻辑。|新接入优先使用通知消息；需要自定义处理时再评估数据消息。|
+
+如果业务需要设置 FCM 通知渠道，后续发送离线推送时可在 SDK API 中设置 Android 8.0 及以上系统的通知渠道 ID。具体 API 使用方式请参见 Android SDK 接入文档中的 配置消息分类（可选）"。具体配额以 [Firebase 消息限频](https://firebase.google.com/docs/cloud-messaging/throttling-and-quotas) 为准。
+
+## 配置完成检查
+
+完成本篇配置后，请按顺序检查：
+
+|**检查项**|**预期结果**|
+|---------|---------|
+|包名一致性|Firebase Android 应用包名与 Android 工程 `applicationId` 完全一致，且大小写一致。|
+|Android 运行环境|目标设备或模拟器满足 Android 6.0（API 23）及以上，并可使用 Google Play 服务。|
+|Firebase 项目|项目 ID 已确认，项目创建后不再需要修改；如需消息传送报告，已启用 Google Analytics。|
+|配置文件|已下载最新 `google-services.json`，并准备在 SDK 接入阶段放置到模块（应用级）根目录，例如 `app/google-services.json`。|
+|服务账号私钥|已生成并妥善保存服务账号私钥 JSON 文件，未提交到代码仓库或公开渠道。|
+|FCM API V1|已在 Firebase 控制台确认 Firebase Cloud Messaging API (V1) 启用。|
+|腾讯云厂商证书|已在腾讯云控制台添加 Google FCM 证书，并填写或上传正确配置。|
+|消息类型|已根据业务需要选择通知消息或数据消息；使用数据消息时已了解版本和设备限制。|
+|配额和限频|已评估项目级下行配额、单设备发送速率和可折叠消息限制，并在服务端发送链路中处理限流和重试。|
+|旧凭据迁移|未使用已弃用的旧版 Server Key，已使用 HTTP v1 API 和服务账号私钥。|
+
+下一步请前往 Android SDK 接入，集成 TIMPush。

package/resource/knowledge/push/config/android/honor.md

@@ -0,0 +1,111 @@
+本文将介绍如何完成荣耀离线推送服务厂商配置。
+
+## 前提条件
+
+开始前，请确认您已具备以下条件：
+
+|**条件**|**说明**|
+|---------|---------|
+|荣耀开发者账号|用于登录荣耀开发者服务平台并申请开通推送服务。|
+|Android App 包名|荣耀应用包名必须与 Android 工程的 `applicationId` 保持一致，字符长度需为 `4-64`。荣耀推送服务不要求应用先上架应用市场。|
+|打包证书 SHA256 指纹|需要在荣耀平台配置，且必须与实际打包签名证书一致。如有多套打包证书，需要全部填写。|
+|腾讯云账号和即时通信 IM 应用权限|用于在腾讯云控制台添加荣耀厂商证书。|
+|后续 Android 工程接入权限|用于在 `SDK 接入` 阶段集成 TIMPush 和荣耀推送依赖。|
+
+## 荣耀开发者服务平台配置
+
+> **提示：**
+>
+
+> 本文配置流程可对照荣耀官方 [推送服务上架申请指南](https://developer.honor.com/cn/docs/11002/guides/app-registration) 操作。
+>
+
+### 注册荣耀开发者账号
+
+注册荣耀开发者账号，详情参见 [开发者注册](https://developer.honor.com/cn/doc/guides/100272)。
+
+### 创建或选择应用
+1. 进入**应用管理**，单击**新建应用**创建应用。
+
+2. 进入**应用详情**，绑定应用包名，并下载 `mcs-services.json` 文件。
+
+   > **说明：**
+   >
+>   - 必须添加打包的 [SHA256 证书指纹](https://developer.honor.com/cn/docs/11002/guides/android-generate-appsign)，SHA256 证书指纹需与实际打包证书一致。如有多套打包证书，需要全部填写。
+>   - `mcs-services.json` 用于后续 Android 工程接入阶段，请保存到 Android 项目中。
+>   - 修改项目、应用信息或开发服务设置后，需要重新下载并更新 `mcs-services.json`。
+
+### 开通推送服务
+1. 进入**管理中心 > 生态服务 > 应用服务 > 推送服务**，进入推送服务列表页面。
+
+2. 单击**申请推送服务**，进入应用申请页面。
+
+3. 选择应用类型为**移动应用**，填写或选择已创建的应用，填写应用包名和 SHA256 证书指纹，阅读并同意《荣耀推送服务使用协议》和《荣耀开发者服务数据处理附录》，然后单击**提交**。
+
+   > **警告：**
+   >
+
+   > 应用包名字符长度需为 `4-64`。SHA256 证书指纹必须与实际打包证书一致，如有多个证书指纹需要全部填写。包名或证书指纹不一致可能导致后续设备注册失败或离线推送无法触达。
+   >
+
+## 获取应用信息
+
+在**推送服务**列表中选择已开通推送服务的应用，查看并记录腾讯云控制台配置荣耀证书所需的应用信息。荣耀官方上架申请指南中明确可查看 `APPID`、`APP SECRET` 等信息；如腾讯云控制台要求填写其他字段，请以控制台表单和荣耀平台实际展示为准。
+
+## 腾讯云控制台配置
+
+### 添加荣耀厂商证书
+
+登录腾讯云 [即时通信 IM 控制台](https://console.qcloud.com/avc)，在**推送服务 Push** > **推送设置** > **厂商配置**中添加荣耀厂商证书，并按控制台要求填写厂商参数。其中"应用内指定界面"请使用控制台默认配置。
+| <strong>厂商推送平台</strong> | <strong>腾讯云即时通信 IM 控制台</strong> |
+| --- | --- |
+|  |  |
+
+### 配置回执和点击统计
+
+如需统计消息触达或点击数据，请在厂商配置阶段设置回执地址为：`https://api.im.qcloud.com/v3/offline_push_report/honor`。
+
+## 合规提示
+
+荣耀推送服务中，荣耀作为最终用户数据处理受委托方，应用方作为最终用户数据处理委托方。发送推送前，请根据业务所在地和用户协议要求获取用户同意，并向最终用户说明推送服务涉及的数据委托处理情况。具体要求请以荣耀官方隐私与数据处理说明为准。
+
+## 消息分类限制对推送效果的影响
+
+荣耀会将推送消息分为服务通讯类和资讯营销类。消息分类会影响推送数量、提醒方式和触达稳定性。IM 聊天、订单变化、账号安全等需要及时触达的消息，建议按荣耀规则申请自分类权益，并使用服务通讯类能力。
+
+|**消息类型**|**推送影响**|**适用建议**|
+|---------|---------|---------|
+|服务通讯类|适合及时触达；具体权益以荣耀平台审核结果和最新规则为准。|适用于聊天、交易、订单、账号变更等用户需要及时知道的消息。|
+|资讯营销类|可能受到每日推送数量、展示策略或夜间管控影响。|适用于活动、资讯、营销推广等非即时消息。|
+
+> **警告：**
+>
+
+> 如果消息分类与实际内容不符，可能导致消息被厂商降级、限频或影响通道权限。营销、广告类消息不建议配置为服务通讯类。
+>
+
+完成荣耀平台和腾讯云控制台配置后，后续发送离线推送时可在 SDK API 或腾讯云控制台默认配置中设置荣耀 `importance`。具体 API 使用方式请参见 Android SDK 接入文档中的 配置消息分类（可选）。
+
+> **说明：**
+>
+
+> 荣耀推送和系统版本有关。当前荣耀通道仅支持国内 Magic UI 4.0 及以上和境外 Magic UI 4.2 及以上荣耀设备使用，低于上述版本的荣耀设备可以按华为厂商接入推送。
+>
+
+## 配置完成检查
+
+完成本篇配置后，请按顺序检查：
+
+|**检查项**|**预期结果**|
+|---------|---------|
+|包名一致性|荣耀应用包名与 Android 工程 `applicationId` 完全一致，且字符长度为 `4-64`。|
+|SHA256 指纹|荣耀平台已添加与实际打包证书一致的 SHA256 证书指纹；如有多套证书，已全部填写。|
+|配置文件|已下载最新 `mcs-services.json`，并准备在 SDK 接入阶段加入 Android 工程。|
+|推送服务状态|荣耀推送服务已申请并开通。|
+|应用参数|已记录腾讯云控制台配置荣耀证书所需的应用信息，并按控制台表单填写。|
+|腾讯云厂商证书|已在腾讯云控制台添加荣耀证书，并填写正确参数。|
+|回执和点击统计|如需统计，已按消息触达统计配置完成回执相关配置。|
+|消息分类配置|如需 IM 消息及时触达，已申请并配置服务通讯类消息分类，并在 SDK API 或腾讯云控制台默认 `importance` 中完成配置。|
+|合规要求|已根据业务要求完成用户同意、隐私告知和数据委托处理说明。|
+
+下一步请前往 Android SDK 接入，集成 TIMPush。

package/resource/knowledge/push/config/android/huawei.md

@@ -0,0 +1,106 @@
+本文将介绍如何完成华为离线推送服务厂商配置。
+
+## 前提条件
+
+开始前，请确认您已具备以下条件：
+
+|**条件**|**说明**|
+|---------|---------|
+|华为开发者账号|用于登录华为开发者联盟和 AppGallery Connect。|
+|Android App 包名|华为推送服务不要求应用先上架应用市场，应用包名必须与 Android 工程的 `applicationId` 保持一致。|
+|打包证书及 SHA256 指纹|需提前准备实际打包签名证书，并获取对应 SHA256 指纹；后续将在华为 AppGallery Connect 中配置。|
+|腾讯云账号和即时通信 IM 应用权限|用于在腾讯云控制台添加华为厂商证书。|
+|后续 Android 工程接入权限|用于在 `SDK 接入` 阶段集成 TIMPush 和华为推送依赖。|
+
+## 华为 AppGallery Connect 配置
+
+> **提示：**
+>
+
+> 本文配置流程可对照华为官方 [推送服务](https://developer.huawei.com/consumer/cn/doc/HMSCore-Guides/service-introduction-0000001050040060) 操作。
+>
+
+### 注册华为开发者账号
+
+进入 [华为开发者联盟](https://developer.huawei.com/consumer/cn/)，注册华为开发者账号，详情请参见 [注册账号](https://developer.huawei.com/consumer/cn/doc/start/registration-and-verification-0000001053628148)。
+
+### 创建应用
+1. 在 [华为管理中心](https://developer.huawei.com/consumer/cn/console) 的**应用服务**中，单击 **AppGallery Connect**，进入应用管理中心。
+
+2. 单击**我的项目**，添加一个新的项目。
+
+3. 在**项目设置**栏单击**推送服务** > **立即开通**。
+
+4. 单击**项目设置 > API 管理**，开启推送服务的权限。
+
+### 添加应用
+
+单击**项目设置 > 常规**，添加应用。
+
+> **注意：**
+>
+
+> 应用包名与 Android 工程的 `applicationId` 需要保持一致。
+>
+
+## 获取应用信息
+
+单击**项目设置 > 常规**，获取应用信息。常规页面包含项目和应用的 Client ID 和 Client Secret，两者对应的参数不一致，请下拉至页面底部，获取应用的 Client ID 和 Client Secret。
+
+> **警告：**
+>
+
+> 必须添加打包的 [SHA256 证书指纹](https://developer.huawei.com/consumer/cn/doc/development/HMSCore-Guides/android-config-agc-0000001050170137#section193351110105114)，SHA256 证书指纹需与自己的打包证书一致，**否则可能导致无法正常接收离线推送消息**。
+>
+
+## 腾讯云控制台配置
+
+### 添加华为厂商证书
+
+登录腾讯云 [即时通信 IM 控制台](https://console.qcloud.com/avc)，在**推送服务 Push** > **推送设置** > **厂商配置**中添加华为厂商证书，并按控制台要求填写厂商参数。Client ID 对应 AppID，Client Secret 对应 AppSecret。"应用内指定界面"请使用控制台默认配置。
+| <strong>厂商推送平台</strong> | <strong>腾讯云即时通信 IM 控制台</strong> |
+| --- | --- |
+|  |  |
+
+### 配置回执和点击统计
+
+如需统计消息触达或点击数据，请配置回执，回调地址填写：`https://api.im.qcloud.com/v3/offline_push_report/huawei`。
+
+> **注意：**
+>
+
+> 华为推送证书 ID <= 11344 时，使用华为推送 v2 版本接口，不支持触达和点击回执，请重新生成更新证书 ID 。
+>
+
+## 消息分类限制对推送效果的影响
+
+华为会将通知消息分为服务与通讯类和资讯营销类。消息分类会影响单设备每日接收数量、夜间展示和推送策略，IM 聊天消息建议按华为规则申请并使用服务与通讯类能力。具体限制请以华为官方 [消息限制说明](https://developer.huawei.com/consumer/cn/doc/HMSCore-Guides/message-restriction-description-0000001361648361) 和 [消息分类说明](https://developer.huawei.com/consumer/cn/doc/development/HMSCore-Guides/message-classification-0000001149358835) 为准。
+
+|**消息类型**|**推送影响**|**适用建议**|
+|---------|---------|---------|
+|服务与通讯类|官方说明中该类消息不设数量限制，适合及时触达。|适用于聊天、交易、订单、账号变更等用户需要及时知道的消息。|
+|资讯营销类|按应用类型设每日推送上限；0:00 - 6:00 期间可能被缓存，待管控解除后再尝试下发。|适用于活动、资讯、推广等非即时消息。|
+
+> **警告：**
+>
+
+> 如果消息分类与实际内容不符，**可能导致消息被厂商降级、限频或影响通道权限**。营销、广告类消息不建议配置为服务与通讯类。
+>
+
+配置消息分类时，可在华为侧申请自分类权益。完成华为平台和腾讯云控制台配置后，后续发送离线推送时可在 SDK API 或腾讯云控制台默认配置中设置华为 `Category`。具体的 SDK API 使用方式请参见 Android SDK 接入文档中的 配置消息分类（可选）。
+
+## 配置完成检查
+
+完成本篇配置后，请按顺序检查：
+
+|**检查项**|**预期结果**|
+|---------|---------|
+|包名一致性|华为应用包名与 Android 工程 `applicationId` 完全一致。|
+|SHA256 指纹|华为平台已添加与实际打包证书一致的 SHA256 证书指纹。|
+|推送服务状态|华为推送服务已开通，推送服务 API 权限已开启。|
+|应用参数|已记录目标 Android 应用的 Client ID 和 Client Secret。|
+|腾讯云厂商证书|已在腾讯云控制台添加华为证书，并按映射填写 AppID 和 AppSecret。|
+|回执和点击统计|如需统计，已按消息触达统计配置完成回执相关配置。|
+|消息分类配置|如需 IM 消息及时触达，已申请并配置服务与通讯类消息分类，并在 API 或腾讯云控制台默认 `Category` 中完成配置。|
+
+下一步请前往 Android SDK 接入，集成 TIMPush。

package/resource/knowledge/push/config/android/meizu.md

@@ -0,0 +1,121 @@
+本文将介绍如何完成魅族离线推送服务厂商配置。
+
+## 前提条件
+
+开始前，请确认您已具备以下条件：
+
+|**条件**|**说明**|
+|---------|---------|
+|魅族开发者账号|用于登录魅族开放平台并创建应用。开发者资料提交后，通常会在 3 个工作日内完成审核。|
+|Android App 包名|魅族开放平台中的应用包名必须与 Android 工程的 `applicationId` 保持一致。魅族推送服务不要求应用先上架应用市场。|
+|腾讯云账号和即时通信 IM 应用权限|用于在腾讯云控制台添加魅族厂商证书。|
+|后续 Android 工程接入权限|用于在 `SDK 接入` 阶段集成 TIMPush 和魅族推送依赖。|
+
+## 魅族开放平台配置
+
+> **提示：**
+>
+
+> 本文配置流程可对照 [魅族开放平台](https://open.flyme.cn/docs) 操作。
+>
+
+### 注册魅族开发者账号
+
+进入 [魅族开放平台](https://open.flyme.cn/)，注册魅族开发者账号。
+
+### 创建应用
+1. 单击**控制台** > **Flyme 推送**。
+
+2. 按页面要求填写应用名称、应用包名和应用图标，然后创建应用。
+
+   > **警告：**
+   >
+
+   > 应用包名必须与 Android 工程的 `applicationId` 保持一致。包名不一致可能导致后续 SDK 注册失败或推送设备无法正确匹配。
+   >
+
+### 获取应用信息
+
+在应用列表中单击**打开应用**，进入**配置管理** > **应用配置**页面，查看并记录应用信息。
+
+|**参数**|**用途**|
+|---------|---------|
+|AppId|App 的唯一标识。|
+|AppKey|客户端身份标识，后续客户端 SDK 初始化时使用。|
+|AppSecret|服务端身份标识，腾讯云控制台配置魅族厂商证书时使用。|
+
+> **注意：**
+>
+
+> 魅族 AppSecret 支持重置。重置后，旧 AppSecret 的服务端身份识别会失效，请同步更新腾讯云控制台和服务端相关配置，避免推送中断。
+>
+
+## 腾讯云控制台配置
+
+### 添加魅族厂商证书
+
+登录腾讯云 [即时通信 IM 控制台](https://console.qcloud.com/avc)，在**推送服务 Push** > **推送设置** > **厂商配置**中添加魅族厂商证书，并将获取到的 AppId、AppKey、AppSecret 等参数填写到对应证书配置中。
+| <strong>厂商推送平台</strong> | <strong>IM 控制台配置</strong> |
+| --- | --- |
+|  | <strong>说明：</strong>"应用内指定界面"请使用控制台默认配置。 |
+
+### 配置回执和点击统计
+
+如需统计消息触达或点击数据，请在厂商开放平台开启回执：
+
+并设置回执地址为：`https://api.im.qcloud.com/v3/offline_push_report/meizu` ：
+
+同步完成回执配置，避免 SDK 接入后再返回控制台补配置。配置方法请参见 [消息触达统计配置 > 魅族](https://cloud.tencent.com/document/product/269/100626#daa658b0-1ac0-44a8-8a47-7ec8822ebe82)。
+
+> **注意：**
+>
+
+> 打开回执开关后，请务必确保回执地址正确配置。不配置或者配置地址错误，都会影响推送功能。
+>
+
+## 消息分类限制对推送效果的影响
+
+魅族会将推送消息分为私信消息和公信消息。默认通道为公信消息，公信消息会限制每日每设备推送数量；私信消息适用于用户有明确预期、需要及时知道的消息。
+
+|**消息类型**|**推送影响**|**适用建议**|
+|---------|---------|---------|
+|私信消息|适合及时触达；具体权益以魅族平台审核结果和最新规则为准。|适用于聊天消息、订单变化、交易提醒等用户有明确预期的消息。|
+|公信消息|可能受到每日每设备推送数量、频控或展示策略限制。|适用于活动、资讯、公告、营销推广等非即时消息。|
+
+> **警告：**
+>
+
+> 营销、广告、活动类消息不应配置为私信消息。分类不符或滥用可能导致消息被拦截、降级、限流或影响推送权限。
+>
+
+完成魅族平台和腾讯云控制台配置后，后续发送离线推送时可在 SDK API 或腾讯云控制台默认配置中设置魅族消息分类。具体 API 使用方式请参见 Android SDK 接入文档中的 配置消息分类（可选）。
+
+## 平台约束与配额
+
+魅族推送平台存在以下默认约束，业务侧发送频率或任务数量超过限制时，可能导致推送延迟、失败或展示效果不符合预期：
+
+|**约束项**|**默认限制**|**影响**|
+|---------|---------|---------|
+|推送速率限制|默认 `10000` 设备/10 秒|短时间集中推送超过限制时，需要联系平台调整或在业务侧降频。|
+|后台创建任务次数|默认 `1000` 次/天|通过 Push 推送后台创建任务或通过 API 推送全部用户、标签用户时受限。|
+|API 创建任务推送次数|默认 `10000` 次/天|通过 API 创建任务推送时受限。|
+|标签数量|单个业务订阅标签不超过 `100` 个|标签设计过细可能超过平台限制。|
+|消息折叠|单设备单业务推送消息 `≥4` 条会被折叠展示|连续发送多条消息时，用户可能只看到折叠后的通知。Flyme 10 以下版本会将多次不点击的消息收纳到右上角消息收纳盒。|
+|设备订阅有效期|单个设备 `30` 天不活跃将取消订阅|长期不活跃用户可能收不到后续推送，需要业务侧结合用户活跃度评估触达效果。|
+
+## 配置完成检查
+
+完成本篇配置后，请按顺序检查：
+
+|**检查项**|**预期结果**|
+|---------|---------|
+|开发者账号状态|魅族开发者账号已完成认证，企业开发者基本信息已核对无误。|
+|包名一致性|魅族开放平台应用包名与 Android 工程 `applicationId` 完全一致。|
+|应用参数|已记录腾讯云控制台配置魅族证书所需的 AppId、AppKey 和 AppSecret。|
+|腾讯云厂商证书|已在腾讯云控制台添加魅族证书，并填写正确参数。|
+|回执和点击统计|如需统计，已按消息触达统计配置完成回执相关配置。|
+|消息分类配置|如需 IM 消息及时触达，已确认私信消息分类规则，并在 SDK API 或腾讯云控制台默认配置中完成配置。|
+|平台约束|已评估推送速率、任务次数、消息折叠和 `30` 天不活跃取消订阅对触达效果的影响。|
+|点击后续动作|如使用**打开应用内指定界面**，已保留控制台默认值。|
+
+下一步请前往 Android SDK 接入，集成 TIMPush。

package/resource/knowledge/push/config/android/oppo.md

@@ -0,0 +1,108 @@
+本文将介绍如何完成 OPPO 离线推送服务厂商配置。
+
+## 前提条件
+
+开始前，请确认您已具备以下条件：
+
+|**条件**|**说明**|
+|---------|---------|
+|OPPO 企业开发者账号|用于登录 OPPO 开放平台并创建应用。申请消息推送时，建议使用管理员账号操作。|
+|已上架 OPPO 软件商店的 Android 应用|正式通知栏推送要求应用已在 OPPO 软件商店上架。国内政府类、企业内部 IM 类应用如无法上架，可先按 OPPO 官方 [应用不上架申请](https://open.oppomobile.com/documentation/page/info) 流程申请，通过后仍需继续提交 PUSH 服务申请。|
+|Android App 包名|OPPO 开放平台中的应用包名必须与 Android 工程的 `applicationId` 保持一致。|
+|腾讯云账号和即时通信 IM 应用权限|用于在腾讯云控制台添加 OPPO 厂商证书。|
+
+## OPPO 开放平台配置
+
+> **提示：**
+>
+
+> 本文配置流程可对照 OPPO 官方[申请推送服务](https://open.oppomobile.com/documentation/page/info)操作。
+>
+
+### 注册 OPPO 开发者账号
+
+进入 [OPPO 开放平台](https://open.oppomobile.com/)，注册 OPPO 企业开发者账号，详情参见 [OPPO 企业开发者账号注册](https://open.oppomobile.com/new/developmentDoc/info)。
+
+### 创建应用
+
+进入 OPPO 开放平台，单击**产品** > **应用分发** > **OPPO 软件商店** > **发布应用**，进入管理中心，创建应用。
+
+### 开通 PUSH 服务
+1. 进入 OPPO 开放平台，单击**产品** > **移动服务** > **推送服务**，进入推送主页，单击**申请接入**开通推送服务。
+
+2. 进入**管理中心** > **应用列表** > **申请推送服务**，为未开启服务的应用申请推送权限。
+
+   > **说明：**
+   >
+
+   > 已开启服务表示应用已申请 PUSH 权限并通过；未开启服务表示应用可申请 PUSH 权限。
+   >
+
+3. 在未开启服务的应用中选择目标应用，单击**申请开通**，按页面要求提交 PUSH 权限申请。
+
+### 确认推送权限类型
+
+提交申请后，请确认当前应用获得的是测试权限还是正式通知栏推送权限。测试权限每天仅可推送 1000 条消息，仅限测试使用；应用上架后，需要重新申请通知栏推送权限，以获得正式消息推送数量。PUSH 服务申请提交后，OPPO 平台通常会在 1 个工作日内返回审核结果。
+
+## 腾讯云控制台配置
+
+### 添加 OPPO 厂商证书
+
+登录腾讯云 [即时通信 IM 控制台](https://console.qcloud.com/avc)，在**推送服务 Push** > **推送设置** > **厂商配置**中添加 OPPO 厂商证书，并按控制台要求填写厂商参数。
+| <strong>厂商推送平台</strong> | <strong>IM 控制台配置</strong> |
+| --- | --- |
+|  | <strong>说明：</strong>"应用内指定界面"请使用控制台默认配置。 |
+
+## 消息分类限制对推送效果的影响
+
+OPPO [新消息分类](https://open.oppomobile.com/documentation/page/info) 会影响离线推送的提醒方式、推送量级和触达稳定性。对于 IM 聊天、音视频通话等需要及时触达的消息，建议按 OPPO 规则申请 [通讯与服务（原私信）不限量权益](https://open.oppomobile.com/documentation/page/info)，并在发送离线推送时配置正确的消息分类。
+
+|**场景**|**建议配置**|**对离线推送的影响**|
+|---------|---------|---------|
+|IM 聊天、音视频通话|申请通讯与服务不限量权益，并使用 `category=IM`。|适合即时触达。未申请或未配置时，消息可能走受限通道，影响大量离线消息触达。|
+|订单、账号、设备等个人强相关提醒|按 OPPO 规则选择通讯与服务类 `category`。|可获得更符合场景的提醒方式；分类不匹配可能影响审核或提醒效果。|
+|活动、广告、内容推荐等营销消息|使用内容与营销类分类。|不应走通讯与服务通道，否则可能被 OPPO 判定为违规，导致提醒降级或通道权限受限。|
+
+> **警告：**
+>
+
+> OPPO 通讯与服务通道非默认开启，需按 OPPO 官方流程申请。营销、广告、活动类消息不应走通讯与服务通道，否则可能被 OPPO 判定为违规，导致提醒降级或通道权限受限。
+>
+
+### notify_level 与强提醒
+
+OPPO `notify_level` 用于控制通知提醒等级：
+- `1` 表示仅通知栏，
+
+- `2` 表示通知栏、锁屏、铃声、振动，
+
+- `16` 表示通知栏、锁屏、铃声、振动、横幅。
+
+   配置 `notify_level` 时必须同时配置 `category`。
+
+   > **注意：**
+   >
+
+   > 内容与营销类消息的 `notify_level` 只能为 `1`。通讯与服务类消息默认 `2`，如需使用 `16`，需先向 OPPO 申请强提醒能力。未申请强提醒能力时，不要直接配置 `16`。
+   >
+
+### 后续 SDK/API 接入提示
+
+完成 OPPO 平台和腾讯云控制台配置后，后续发送离线推送时还需要按实际接入方式传入对应参数：新规则使用 `category`、私信模板参数和可选的 `notify_level`；旧规则仅适用于已开通 OPPO 私信通道权限的存量应用，需使用已创建并登记的私信通道 `ChannelID`。具体 API 使用方式请参见 Android SDK 接入文档中的 配置消息分类（可选）。
+
+## 配置完成检查
+
+完成本篇配置后，请按顺序检查：
+
+|**检查项**|**预期结果**|
+|---------|---------|
+|推送权限类型|正式推送使用的应用已在 OPPO 软件商店上架，或已完成 OPPO 不上架申请；测试权限仅用于测试场景，且每日仅可推送 1000 条。|
+|包名一致性|OPPO 开放平台应用包名与 Android 工程 `applicationId` 完全一致。|
+|PUSH 服务状态|目标应用已申请并开通 PUSH 服务，审核状态已通过。|
+|腾讯云厂商证书|已在腾讯云控制台添加 OPPO 证书，并填写正确参数。|
+|消息分类配置|IM 类消息已申请通讯与服务不限量权益，并在 API 或控制台默认配置中使用正确的 `category`，例如 `IM`。|
+|提醒等级配置|如需横幅等强提醒，已向 OPPO 申请强提醒能力，并确认 `notify_level` 配置符合 OPPO 规则。|
+|通道 ID 配置|如使用 OPPO 旧规则或存量私信通道方式，客户端 `channelID` 与 OPPO 推送运营后台登记的通道 ID 保持一致。|
+|合规使用|营销、广告、活动类消息未走通讯与服务通道，避免触发 OPPO 通道处罚。|
+
+下一步请前往 Android SDK 接入，集成 TIMPush。