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

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

@@ -0,0 +1,101 @@
+本文将介绍如何完成 vivo 离线推送服务厂商配置。
+
+## 前提条件
+
+开始前，请确认您已具备以下条件：
+
+|**条件**|**说明**|
+|---------|---------|
+|vivo 开发者账号|用于登录 vivo 开放平台并创建应用。|
+|已上架 vivo 应用商店的 Android 应用|正式通知推送要求应用已上架 vivo 应用商店。未上架应用的推送权限受限，只能在 API 后台向测试设备发送测试消息。|
+|Android App 包名|vivo 开放平台中的应用包名必须与 Android 工程的 `applicationId` 保持一致。|
+|腾讯云账号和即时通信 IM 应用权限|用于在腾讯云控制台添加 vivo 厂商证书。|
+
+> **注意：**
+>
+
+> 如果应用未上架 vivo 应用商店，不可在 vivo 官网 Web 界面和 API 后台发送正式消息，只能向设置的测试设备发送测试消息。
+>
+
+## vivo 开放平台配置
+
+> **提示：**
+>
+
+> 本文配置流程可对照 vivo 官方 [推送接入流程](https://dev.vivo.com.cn/documentCenter/doc/281) 操作。
+>
+
+### 注册 vivo 开发者账号
+
+进入 [vivo 开放平台](https://dev.vivo.com.cn/openAbility/pushNews)，注册 vivo 开发者账号，详情参见 [vivo 企业开发者账号注册](https://dev.vivo.com.cn/documentCenter/doc/2)。
+
+### 创建应用
+
+进入 vivo 开放平台，单击**分发** > **应用分发** > **应用商店** > **上传应用**，创建您的应用。
+
+> **警告：**
+>
+
+> vivo 开放平台中的应用包名必须与 Android 工程的 `applicationId` 保持一致。包名不一致可能导致后续 SDK 注册失败或推送设备无法正确匹配。
+>
+
+### 开通推送服务
+
+进入vivo 开放平台管理中心，单击**推送服务** > **推送申请**，为目标应用申请开通推送服务。
+
+### 获取应用信息
+
+进入 vivo 推送运营平台，单击**应用管理** > **应用信息**，查看并记录腾讯云控制台配置 vivo 证书所需的应用信息。
+
+## 腾讯云控制台配置
+
+### 添加 vivo 厂商证书
+
+登录腾讯云 [即时通信 IM 控制台](https://console.qcloud.com/avc)，在**推送服务 Push** > **推送设置** > **厂商配置**中添加 vivo 厂商证书，并按控制台要求填写厂商参数。
+| <strong>vivo 推送平台</strong> | <strong>腾讯云即时通信 IM 控制台</strong> |
+| --- | --- |
+|  |  |
+
+### 配置回执和点击统计
+
+如需统计消息触达或点击数据，请在 vivo 开放平台设置 App 回执地址为：`https://api.im.qcloud.com/v3/offline_push_report/vivo`，并在腾讯云控制台设置回执 ID。
+
+|**回调地址配置**|**腾讯云即时通信 IM 控制台**|
+|---------|---------|
+|||
+
+## 消息分类限制对推送效果的影响
+
+vivo 会将推送消息分为系统消息和运营消息。消息分类会影响日推总量、单设备每日接收数量和夜间发送策略。IM 聊天、订单变动、账号安全等需要及时触达的消息，建议按 vivo 规则申请并使用系统消息能力。
+
+|**消息类型**|**推送影响**|**适用建议**|
+|---------|---------|---------|
+|系统消息|适合及时触达；默认每日限额按通知开启有效用户数计算，可申请不限量权限。系统消息仍可能被 vivo 智能分类二次修正。|适用于聊天消息、订单变动、账号安全等用户有明确预期的消息。|
+|运营消息|新闻类和其他类按通知开启有效用户数计算日推总量；单设备每日接收数量有限；夜间发送会受限制。|适用于活动、内容推荐、营销推广等非即时消息。|
+
+> **警告：**
+>
+
+> vivo 会对系统消息进行智能分类二次修正。如果厂商识别出消息内容不属于系统消息，可能自动修正为运营消息。正式上线前，请确认消息内容和所申请的消息分类匹配。
+>
+
+运营消息存在发送时间限制。vivo 服务器通常仅允许在 `7:00 - 23:00` 之间下发运营消息，在 `23:00 - 次日 7:00` 发送的运营消息会被服务器直接丢弃，不会延迟补发。系统消息不受此限制。
+
+完成 vivo 平台和腾讯云控制台配置后，后续发送离线推送时可在 SDK API 或腾讯云控制台默认配置中设置 vivo `Category`。两者同时设置时，API 中的设置优先于控制台证书默认配置。具体 API 使用方式请参见 Android SDK 接入文档中的 配置消息分类（可选）。
+
+## 配置完成检查
+
+完成本篇配置后，请按顺序检查：
+
+|**检查项**|**预期结果**|
+|---------|---------|
+|应用上架状态|正式推送使用的应用已在 vivo 应用商店上架；未上架应用仅用于测试设备测试。|
+|包名一致性|vivo 开放平台应用包名与 Android 工程 `applicationId` 完全一致。|
+|PUSH 服务状态|目标应用已申请并开通 vivo 推送服务。|
+|应用参数|已记录腾讯云控制台配置 vivo 证书所需的应用信息。|
+|腾讯云厂商证书|已在腾讯云控制台添加 vivo 证书，并填写正确参数。|
+|回执和点击统计|如需统计，已按消息触达统计配置完成回执相关配置。|
+|消息分类配置|如需 IM 消息及时触达，已申请系统消息能力，并在 API 或腾讯云控制台默认 `Category` 中完成配置。|
+|运营消息限制|如果业务消息属于运营消息，已确认单设备接收数量限制和 `7:00 - 23:00` 下发时间限制，避免夜间发送后被直接丢弃。|
+
+下一步请前往 Android SDK 接入，集成 TIMPush。

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

@@ -0,0 +1,99 @@
+本文将介绍如何完成小米离线推送服务厂商配置。
+
+## 前提条件
+
+开始前，请确认您已具备以下条件：
+
+|**条件**|**说明**|
+|---------|---------|
+|小米开发者账号|已拥有或准备注册小米开发者账号；启用 PUSH 服务前需完成账号认证，认证可能需要 1-3 个工作日。|
+|已上架小米应用商店的应用|正式使用通知栏推送要求应用已在小米应用商店上架，并满足小米通知类别审核要求。|
+|Android App 包名|小米开放平台中的应用包名必须与 Android 工程的 `applicationId` 保持一致。|
+|腾讯云账号和即时通信 IM 应用权限|用于在腾讯云控制台添加小米厂商证书。|
+
+## 小米开放平台配置
+
+> **提示：**
+>
+
+> 本文配置流程可对照小米官方 [推送配置指南](https://dev.mi.com/xiaomihyperos/documentation/detail) 操作。
+>
+
+### 注册小米开发者账号
+1. 进入 [小米开放平台](https://dev.mi.com/xiaomihyperos)，注册小米开发者账号并启用推送服务。
+
+2. 使用小米开发者账号登录 [小米澎湃 OS 开发者平台](https://dev.mi.com/xiaomihyperos)，进入**管理中心**。
+
+3. 左侧导航栏选择 **PUSH 服务**，进入应用列表页。
+
+4. 进入**推送服务应用列表**。应用列表包括该开发者账号下的已有 App（包括 Android 手机/平板应用、Android TV 应用）。
+
+5. 单击**未启用**状态 App 的**启用推送**，可以进入消息推送启用页面。
+
+### 启用推送
+1. 启用推送前，您须先阅读《消息分类介绍及运营规范》、《推送消息违规处理办法》、《小米推送技术服务协议》、《小米推送技术服务数据保护附录》。勾选同意接受后，点击右上方按钮进入**下一步**。
+
+2. 为您的应用创建所需的通知类别：
+
+3. 点击**选择分类**，详细的**消息类型**说明请参考[《小米推送消息分类新规》](https://dev.mi.com/xiaomihyperos/documentation/detail)。
+
+4. 按新规要求完整填写相应信息。
+
+5. 提交审核。该环节您最多可同时创建 8 个不同分类的通知类别，小米开放平台会在 3-5 个工作日内完成审核。后续您可在**推送运营平台** > **消息分类管理**中维护应用的通知类别。
+
+### 创建应用
+1. 如果您想使用的应用不在应用列表内，点击**创建应用**，选择**创建手机/平板应用**或**创建电视应用**。
+
+2. 选择**操作系统**，填写**应用名称**和**应用包名**，选择应用分类，单击**创建**，创建一个新应用。
+
+3. 完成应用创建后，就可以启用该应用的推送服务了。
+
+4. 启用推送服务后，在左侧导航栏选择**应用管理** > **应用信息**，可查看该应用对应的 AppId、AppKey 和 AppSecret。
+
+   其中 AppId 和 AppKey 是客户端的身份标识，在客户端 SDK 初始化时使用；AppSecret 是服务器端的身份标识，在使用服务端 SDK 向客户端发送消息时使用。
+
+5. 应用列表包括该开发者账号下的已有 App（包括 Android 手机/平板应用、Android TV 应用）。
+
+### 查看获取应用信息
+
+进入推送运营平台的**应用信息**页面，查看**应用信息**。
+
+### 配置推送证书
+
+登录腾讯云 [即时通信 IM 控制台](https://console.qcloud.com/avc)，在**推送服务 Push** > **推送设置** > **厂商配置**中添加小米厂商证书，并按控制台要求填写厂商参数。其中"应用内指定界面"请使用控制台默认配置。
+| <strong>厂商推送平台</strong> | <strong>IM 控制台配置</strong> |
+| --- | --- |
+|  |  |
+
+## 消息分类限制对推送效果的影响
+
+小米通知消息主要分为私信消息和公信消息。**未接入分类的应用会走默认通道（按公信场景配置，但限额更严格）。**消息分类会影响推送数量和展示效果，IM 聊天、订单变化、交易提醒等需要及时触达的消息，建议按 [小米推送消息分类新规](https://dev.mi.com/xiaomihyperos/documentation/detail) 申请并使用私信消息能力。
+
+> **警告：**
+>
+
+> 未接入消息分类的应用走默认通道，**单设备单日仅可推送 1 条**，超出后消息不会下发，是用户反馈"收不到离线推送"的最常见原因。IM 类应用上线前必须完成私信消息接入。具体限额参见 [小米推送消息限制说明](https://dev.mi.com/xiaomihyperos/documentation/detail)。
+>
+
+| <strong>消息类型</strong> | <strong>推送影响</strong> | <strong>适用建议</strong> |
+| --- | --- | --- |
+| 私信消息 | 通常不限量。 | 适用于聊天消息、个人订单变化、快递通知、交易提醒、IoT 系统通知等用户有明确预期的消息。<br>注意：如果将营销、广告等非即时消息配置为私信消息，可能被厂商判定为违规，影响账号或通道权限。 |
+| 公信消息 | 按通知开启有效用户数 × 倍数计算单日总量（无许可证 2 倍、有许可证 3 倍）；单设备单日 5-8 条。 | 适用于热点新闻、新品推广、平台公告、社区话题、有奖活动等普适性内容。 |
+| 默认通道（未接入分类） | 单设备单日仅 1 条，超出后消息不会下发；性质上按公信场景配置，但限额远低于正式公信通道。 | IM 类消息<strong>必须</strong>接入私信消息，禁止长期使用默认通道。 |
+
+配置消息分类时，请在小米平台完成 [Channel 申请及接入](https://dev.mi.com/console/doc/detail)；后续可在**推送运营平台** > **消息分类管理**中维护 Channel。完成小米平台和腾讯云控制台配置后，后续发送离线推送时可在 SDK API 或腾讯云控制台默认配置中设置小米 `channelID`。具体 API 使用方式请参见 Android SDK 接入文档中的 配置消息分类（可选）。
+
+## 配置完成检查
+
+完成本篇配置后，请按顺序检查：
+
+|**检查项**|**预期结果**|
+|---------|---------|
+|应用上架状态|已确认目标应用的小米应用商店上架状态，并满足正式推送和通知类别审核要求。|
+|包名一致性|小米开放平台应用包名与 Android 工程 `applicationId` 完全一致。|
+|PUSH 服务状态|小米 PUSH 服务已启用，通知类别已创建，并已确认审核状态；正式使用前需审核通过。|
+|应用参数|已记录 AppID、AppKey 和 AppSecret。|
+|腾讯云厂商证书|已在腾讯云控制台添加小米证书，并填写正确参数。|
+|消息分类配置|IM 类消息已申请并接入私信消息 Channel，并已在 API 或腾讯云控制台默认 `channelID` 中完成配置。未接入时默认通道单设备单日仅 1 条，超出后消息不会下发，会导致大量推送丢失。|
+
+下一步请前往 Android SDK 接入，集成 TIMPush。