@tencentcloud/sdk-mcp 1.7.2 → 1.7.4

package/resource/knowledge/push/integration/android.md

@@ -11,7 +11,7 @@
 |`timpush-configs.json`|腾讯云控制台下载|放入 Android 应用模块的 `assets` 目录，TIMPush 注册时会读取该配置文件。|
 |Android 工程包名|Android 工程 `applicationId`|需要与厂商平台应用包名保持一致。|
 |目标厂商配置|对应厂商配置文档|确认厂商侧已开通推送服务，并已在腾讯云控制台添加厂商证书。|
-|厂商配置文件|厂商开放平台|华为、荣耀、Google FCM 等厂商需要将对应 JSON 配置文件添加到工程中。|
+|厂商配置文件|厂商开放平台|华为、荣耀、Google FCM 需要将对应 JSON 配置文件添加到工程中。|
 |测试真机|目标厂商设备|厂商通道建议使用对应厂商真机验证。设备厂商与配置厂商不一致时，验证结果可能误导。|
 |TIMPush 版本号 `VERSION`|更新日志|Gradle 依赖版本。本文使用 `VERSION` 占位，请替换为实际版本号。建议使用最新版本；如使用 7.7.5283 以下版本，荣耀通道配置可能有差异。|
 
@@ -19,17 +19,13 @@
 
 ## AI 集成
 
-通过 npx 安装 [@tencent-rtc/trtc-push-skill](https://www.npmjs.com/package/@tencent-rtc/trtc-push-skill/v/1.0.1#%E7%AE%80%E4%BD%93%E4%B8%AD%E6%96%87) 到本地 AI IDE 中，辅助完成 TIMPush 离线推送集成。安装后，您可以直接向 AI 输入“集成 Android 离线推送”“帮我集成 Android TIMPush”等需求，AI 将根据项目类型引导您完成环境检测、厂商通道配置、凭据填写、代码接入和验证等步骤。
+通过 npx 安装 [@tencent-rtc/trtc-push-skill](https://www.npmjs.com/package/@tencent-rtc/trtc-push-skill/v/1.0.1#%E7%AE%80%E4%BD%93%E4%B8%AD%E6%96%87) 到本地 AI IDE 中，辅助完成 TIMPush 离线推送集成。安装后，您可以直接向 AI 输入“集成 Android 离线推送”等需求，AI 将根据项目类型引导您完成环境检测、厂商通道配置、凭据填写、代码接入和验证等步骤。详情可参考 AI Coding。
 
-> **注意：**
-> 使用 Push Skill AI 集成不是全自动流程，依然需要开发者在厂商配置控制台、腾讯云控制台等配置 Push 相关信息。具体的配置方法请参考下文相关章节。
->
+## 手动集成
 
-## 集成 TIMPush
+### 步骤1：集成 TIMPush SDK
 
-如果您想手动集成，请按下述操作步骤依次完成放置配置文件、配置 Gradle、补充 Manifest 与混淆。
-
-### 下载并添加 TIMPush 配置文件
+#### 下载并添加 TIMPush 配置文件
 
 下载后，将该文件添加到应用模块的 `assets` 目录。推荐存储路径：`app/src/main/assets/timpush-configs.json`，其中 app 是您项目的应用模块，可替换成实际名称。如果工程中没有 `assets` 目录，请在 `src/main/` 下手动创建。
 
@@ -37,28 +33,9 @@
 > TIMPush 注册推送时会读取该文件中的厂商证书配置，不要放在 MainActivity 同级目录、工程根目录或 res 目录。如果文件缺失或放错目录，SDK 无法获得对应厂商通道配置，可能导致注册或收消息失败。
 >
 
-### 添加厂商配置文件
-
-部分厂商还需要把平台生成的配置文件添加到 Android 工程中。配置文件通常包含厂商项目、应用包名、证书指纹或服务账号等信息，厂商插件会在后续 Gradle 构建时读取这些文件。请在厂商配置阶段下载最新配置文件，并按厂商要求放置。
-
-|**厂商**|**配置文件**|**说明**|
-|---------|---------|---------|
-|荣耀|`mcs-services.json`|在荣耀开发者服务平台下载。修改项目、应用信息或开发服务设置后，需要重新下载。|
-|Google FCM|`google-services.json`|在 Firebase 控制台下载。|
-
-推荐放置路径如下（与应用模块的 `build.gradle` / `build.gradle.kts` 同级），其中 app 是您项目的应用模块，可替换成实际名称：
-``` text
-app/mcs-services.json            # 荣耀
-app/google-services.json         # Google FCM
-```
-
-> **注意：**
-> 修改厂商平台项目、应用信息、证书指纹或开发服务设置后，厂商配置文件需要重新下载并替换。
->
-
-### 配置 Gradle 仓库
+#### 配置 Gradle 仓库
 
-配置仓库的目的是让 Gradle 能下载 TIMPush、厂商通道 SDK 和厂商插件。腾讯云 Maven 仓库用于解析腾讯云相关依赖；华为、荣耀 SDK 依赖厂商 Maven 仓库。如果仓库缺失，常见表现是 Gradle Sync 报依赖找不到。
+配置仓库的目的是让 Gradle 能下载 TIMPush 及相关依赖。本节只配置与厂商无关的公共仓库：`google()`、`mavenCentral()` 用于解析 Android 官方组件，腾讯云 Maven 仓库用于解析 TIMPush 等腾讯云依赖。
 
 Android 工程可能使用 Groovy DSL 或 Kotlin DSL，请先根据文件后缀判断当前工程使用的 DSL 类型：
 
@@ -85,8 +62,6 @@ pluginManagement {
         google()
         mavenCentral()
         maven { url "https://mirrors.tencent.com/nexus/repository/maven-public/" }
-        maven { url "https://developer.huawei.com/repo/" }
-        maven { url "https://developer.hihonor.com/repo" }
     }
 }
 
@@ -96,8 +71,6 @@ dependencyResolutionManagement {
         google()
         mavenCentral()
         maven { url "https://mirrors.tencent.com/nexus/repository/maven-public/" }
-        maven { url "https://developer.huawei.com/repo/" }
-        maven { url "https://developer.hihonor.com/repo" }
     }
 }
 ```
@@ -110,8 +83,6 @@ pluginManagement {
         google()
         mavenCentral()
         maven { url = uri("https://mirrors.tencent.com/nexus/repository/maven-public/") }
-        maven { url = uri("https://developer.huawei.com/repo/") }
-        maven { url = uri("https://developer.hihonor.com/repo") }
     }
 }
 
@@ -121,8 +92,6 @@ dependencyResolutionManagement {
         google()
         mavenCentral()
         maven { url = uri("https://mirrors.tencent.com/nexus/repository/maven-public/") }
-        maven { url = uri("https://developer.huawei.com/repo/") }
-        maven { url = uri("https://developer.hihonor.com/repo") }
     }
 }
 ```
@@ -138,13 +107,6 @@ buildscript {
         google()
         mavenCentral()
         maven { url "https://mirrors.tencent.com/nexus/repository/maven-public/" }
-        maven { url "https://developer.huawei.com/repo/" }
-        maven { url "https://developer.hihonor.com/repo" }
-    }
-    dependencies {
-        classpath 'com.google.gms:google-services:4.3.15'
-        classpath 'com.huawei.agconnect:agcp:1.6.0.300'
-        classpath 'com.hihonor.mcs:asplugin:2.0.1.300'
     }
 }
 ```
@@ -157,65 +119,748 @@ dependencyResolutionManagement {
         google()
         mavenCentral()
         maven { url "https://mirrors.tencent.com/nexus/repository/maven-public/" }
+    }
+}
+```
+
+【Gradle 7.0 以下版本】
+
+Gradle 7.0 以下版本通常使用 Groovy DSL。如您的工程使用 Kotlin DSL，请将单引号改为双引号，`url "..."` 改为 `url = uri("...")`。
+
+在项目级 `build.gradle` 的 `buildscript > repositories` 和 `allprojects > repositories` 中添加仓库。
+``` groovy
+buildscript {
+    repositories {
+        google()
+        mavenCentral()
+        maven { url "https://mirrors.tencent.com/nexus/repository/maven-public/" }
+    }
+}
+
+allprojects {
+    repositories {
+        google()
+        mavenCentral()
+        maven { url "https://mirrors.tencent.com/nexus/repository/maven-public/" }
+    }
+}
+```
+
+#### 集成 TIMPush 基础依赖
+
+在应用模块的 `build.gradle` 或 `build.gradle.kts` 中添加 TIMPush 基础依赖。基础包提供 TIMPush 注册、监听和通用能力。
+
+下方示例中的 `VERSION` 均指 TIMPush SDK 的版本号（如 `8.9.7537`），不是 Android 系统版本或厂商 SDK 版本。获取最新版本号请查看更新日志。
+
+【Groovy DSL】
+``` groovy
+dependencies {
+    implementation 'com.tencent.timpush:timpush:VERSION'
+    implementation 'com.tencent.liteav.tuikit:tuicore:VERSION'
+}
+```
+
+【Kotlin DSL】
+``` kotlin
+dependencies {
+    implementation("com.tencent.timpush:timpush:VERSION")
+    implementation("com.tencent.liteav.tuikit:tuicore:VERSION")
+}
+```
+
+添加依赖后，请在 Android Studio 中单击 **Sync Now**，或选择 **File > Sync Project with Gradle Files** 触发 Gradle 同步。
+
+> **注意：**
+> `TIMPush`、`TUICore` 和各厂商通道包建议使用相同 `VERSION`，避免依赖冲突。项目已接入 IM SDK 或 TUIKit 时，也需要确认相关 SDK 版本兼容。
+>
+
+**验证**：Gradle Sync 成功完成，无报错。如果报依赖找不到，请检查 `VERSION` 是否正确、腾讯云 Maven 仓库是否缺失。
+
+#### 设置混淆规则
+
+如果应用开启了代码混淆，请在 `proguard-rules.pro` 中加入 TIMPush 相关类不混淆规则。该配置用于避免 Release 包中 TIMPush 相关类、回调或厂商适配逻辑被混淆后无法正常调用：
+``` proguard
+-keep class com.tencent.qcloud.** { *; }
+-keep class com.tencent.timpush.** { *; }
+```
+
+完成后，请重新构建 Release 包，并在真机上验证注册和收消息链路。
+
+**验证**：App 可在目标厂商真机上正常安装和启动，无崩溃。如果启动崩溃，请检查 `Application` 声明、配置文件位置和 Manifest 合并错误。同时确认测试真机厂商与目标厂商通道一致（如不要在华为设备上验证荣耀通道）。
+
+### 步骤2：集成厂商通道 SDK
+
+请按目标厂商页签配置对应通道。只集成某个厂商时，只添加该厂商需要的配置文件、插件和依赖即可。
+
+【小米】
+
+#### **前置**
+
+请先完成 小米厂商配置，并确认：
+- 已在腾讯云控制台添加小米厂商证书；
+
+- 已重新下载包含小米证书的 `timpush-configs.json`，并放入应用模块 `assets` 目录；
+
+- 使用小米真机验证。
+
+#### **1. 集成 TIMPush 厂商依赖**
+
+在应用模块 `build.gradle` 或 `build.gradle.kts` 的 `dependencies` 中追加小米通道包，`VERSION` 与基础包保持一致：
+
+【Groovy DSL】
+``` groovy
+implementation 'com.tencent.timpush:xiaomi:VERSION'
+```
+
+【Kotlin DSL】
+``` kotlin
+implementation("com.tencent.timpush:xiaomi:VERSION")
+```
+
+集成结果判断：Gradle Sync 成功完成，无报错。
+
+#### **2. 配置消息触达统计（可选）**
+
+小米通道当前无需在客户端额外配置回执地址。如需统计，请按 小米厂商配置 完成控制台侧配置。
+
+#### **3. 配置消息分类（可选）**
+
+发送离线推送时可通过 SDK API 设置小米渠道 ID，API 设置优先级通常高于控制台证书默认配置。调用 [`setAndroidXiaoMiChannelID(String channelID)`](https://im.sdk.qcloud.com/doc/zh-cn/classcom_1_1tencent_1_1imsdk_1_1v2_1_1V2TIMOfflinePushInfo.html#ac769aec48cdbc9a57416c5a79504617a) 设置小米渠道 `channelID`：
+``` java
+V2TIMOfflinePushInfo pushInfo = new V2TIMOfflinePushInfo();
+pushInfo.setAndroidXiaoMiChannelID("your_xiaomi_channel_id");
+```
+
+【华为】
+
+#### **前置**
+
+请先完成 华为厂商配置，并确认：
+- 已在腾讯云控制台添加华为厂商证书；
+
+- 已重新下载包含华为证书的 `timpush-configs.json`，并放入应用模块 `assets` 目录；
+
+- 测试包当前签名（debug 或 release）的 SHA-256 已在华为控制台 **项目设置 > 常规 > SHA 证书指纹** 中添加，指纹不一致会报 `6003: certificate fingerprint error`；
+
+- 使用华为真机验证。
+
+#### **1. 添加厂商配置文件**
+
+``` text
+
+```
+
+修改项目、应用信息、证书指纹或服务配置后，建议重新下载并替换。后续构建时，华为 AGConnect 插件会读取该文件并将厂商要求的资源、Manifest 信息合并进应用包。
+
+#### **2. 配置 Gradle 插件**
+
+##### **追加厂商 Maven 仓库**
+
+请在已添加的公共仓库基础上追加华为仓库。
+
+【Gradle 7.1 及以上】
+
+在 `settings.gradle` 或 `settings.gradle.kts` 的 `pluginManagement > repositories` 和 `dependencyResolutionManagement > repositories` 中追加：
+
+【Groovy DSL】
+``` java
+maven { url "https://developer.huawei.com/repo/" }
+```
+
+【Kotlin DSL】
+``` java
+maven { url = uri("https://developer.huawei.com/repo/") }
+```
+
+【Gradle 7.0 及以下】
+
+在项目级 `build.gradle` 的 `buildscript > repositories`，以及 `settings.gradle` 的 `dependencyResolutionManagement > repositories`（Gradle 7.0）或 `allprojects > repositories`（Gradle 7.0 以下）中追加：
+``` groovy
+maven { url "https://developer.huawei.com/repo/" }
+```
+
+##### **配置项目级插件依赖**
+
+【Gradle 7.1 及以上】
+
+Gradle 7.1 及以上项目通常在 `settings.gradle` 中配置依赖仓库。由于华为插件通过 `buildscript > dependencies > classpath` 声明，还需要在项目级 `build.gradle` 或 `build.gradle.kts` 的 `buildscript > repositories` 中包含 `google()` 和华为仓库，否则可能出现插件 classpath 依赖解析失败。
+
+如果项目级 `build.gradle.kts` 已通过 `plugins {}` 块声明 AGP，原有 `plugins {}` 块保留不动，在 `dependencies` 中声明 `com.android.tools.build:gradle` 即可。如果项目同时使用 Kotlin Android 插件，也请声明 `org.jetbrains.kotlin:kotlin-gradle-plugin`。
+
+【Groovy DSL（build.gradle）】
+``` java
+buildscript {
+    repositories {
+        google()
+        mavenCentral()
+        gradlePluginPortal()
+        maven { url "https://mirrors.tencent.com/nexus/repository/maven-public/" }
         maven { url "https://developer.huawei.com/repo/" }
-        maven { url "https://developer.hihonor.com/repo" }
     }
+    dependencies {
+        // 请与项目当前 Android Gradle Plugin 版本保持一致。
+        classpath 'com.android.tools.build:gradle:<AGP_VERSION>'
+        // 如果项目使用 Kotlin Android 插件，请与项目当前 Kotlin Gradle Plugin 版本保持一致。
+        classpath 'org.jetbrains.kotlin:kotlin-gradle-plugin:<KOTLIN_VERSION>'
+        // 华为 AGConnect。Gradle 8 / AGP 8 项目不要继续使用 1.6.0.300。
+        classpath 'com.huawei.agconnect:agcp:1.9.1.301'
+    }
+}
+```
+
+【Kotlin DSL（build.gradle.kts）】
+``` java
+buildscript {
+    repositories {
+        google()
+        mavenCentral()
+        gradlePluginPortal()
+        maven { url = uri("https://mirrors.tencent.com/nexus/repository/maven-public/") }
+        maven { url = uri("https://developer.huawei.com/repo/") }
+    }
+    dependencies {
+        // 请与项目当前 Android Gradle Plugin 版本保持一致。
+        classpath("com.android.tools.build:gradle:<AGP_VERSION>")
+        // 如果项目使用 Kotlin Android 插件，请与项目当前 Kotlin Gradle Plugin 版本保持一致。
+        classpath("org.jetbrains.kotlin:kotlin-gradle-plugin:<KOTLIN_VERSION>")
+        // 华为 AGConnect。Gradle 8 / AGP 8 项目不要继续使用 1.6.0.300。
+        classpath("com.huawei.agconnect:agcp:1.9.1.301")
+    }
+}
+```
+1. 请将`<AGP_VERSION>`替换为项目当前使用的 Android Gradle Plugin 版本，例如 `8.9.1`。如果项目级 `plugins {}` 块中已经声明了 `com.android.application` 版本，两个位置的 AGP 版本需要保持一致。
+
+2. 请将`<KOTLIN_VERSION>` 替换为项目当前使用的 Kotlin Gradle Plugin 版本；如果项目未使用 Kotlin Android 插件，可删除该行。
+
+> **注意：**
+> 对于 Gradle 8 / AGP 8 项目，请不要继续使用 `com.huawei.agconnect:agcp:1.6.0.300`。AGP 8.0 已移除 Transform API，旧版 AGC 插件存在兼容风险，建议使用 `com.huawei.agconnect:agcp:1.9.1.301` 或更高已验证版本。
+>
+
+【Gradle 7.0 及以下】
+
+在项目级 `build.gradle` 的 `buildscript > dependencies` 中追加：
+``` groovy
+classpath 'com.huawei.agconnect:agcp:1.6.0.300'
+```
+
+如果旧工程已升级到 Gradle 8 / AGP 8，请不要继续使用 `1.6.0.300`，建议改为 `com.huawei.agconnect:agcp:1.9.1.301` 或更高已验证版本。
+
+##### **在应用模块启用插件**
+
+完成项目级插件依赖配置后，还需要在应用模块的 `build.gradle` 或 `build.gradle.kts` 中启用华为插件。应用模块通常为 `app`。
+
+如果应用模块中已经存在 `plugins` 块，请在现有 `plugins` 块中追加，不要重复添加已有的 `com.android.application` 插件。
+
+【Groovy DSL（app/build.gradle）】
+``` groovy
+plugins {
+    // 华为 AGConnect。
+    id 'com.huawei.agconnect'
+}
+// 或：apply plugin: 'com.huawei.agconnect'
+```
+
+【Kotlin DSL（app/build.gradle.kts）】
+``` kotlin
+plugins {
+    // 华为 AGConnect。
+    id("com.huawei.agconnect")
 }
+// 或：apply(plugin = "com.huawei.agconnect")
+```
+
+完成配置后，请在 Android Studio 中单击 **Sync Now**，或选择 **File > Sync Project with Gradle Files** 触发 Gradle 同步。同步成功后，再执行构建验证。
+
+#### **3. 集成 TIMPush 厂商依赖**
+
+在应用模块 `build.gradle` 或 `build.gradle.kts` 的 `dependencies` 中追加华为通道包，`VERSION` 与基础包保持一致：
+
+【Groovy DSL】
+``` groovy
+implementation 'com.tencent.timpush:huawei:VERSION'
+```
+
+【Kotlin DSL】
+``` kotlin
+implementation("com.tencent.timpush:huawei:VERSION")
+```
+
+#### **4. 配置消息触达统计（可选）**
+
+如需统计触达或点击数据，请配置回执地址 `https://api.im.qcloud.com/v3/offline_push_report/huawei`。华为推送证书 ID `<= 11344` 时使用华为推送 v2 接口，不支持触达和点击回执；如需支持统计，请重新生成并更新证书 ID。回执地址不配置或配置错误，都会影响触达统计。
+
+#### **5. 配置消息分类（可选）**
+
+发送离线推送时可通过 SDK API 设置华为消息分类，API 设置优先级通常高于控制台证书默认配置。调用 [`setAndroidHuaWeiCategory(String category)`](https://im.sdk.qcloud.com/doc/zh-cn/classcom_1_1tencent_1_1imsdk_1_1v2_1_1V2TIMOfflinePushInfo.html#ad9dea3cb382c0c1a3c1a63738697fc1f) 设置华为推送消息分类：
+``` java
+V2TIMOfflinePushInfo pushInfo = new V2TIMOfflinePushInfo();
+pushInfo.setAndroidHuaWeiCategory("IM");
+```
+
+【OPPO】
+
+#### **前置**
+
+请先完成 OPPO 厂商配置，并确认：
+- 已在腾讯云控制台添加 OPPO 厂商证书；
+
+- 已重新下载包含 OPPO 证书的 `timpush-configs.json`，并放入应用模块 `assets` 目录；
+
+- 使用 OPPO 真机验证。
+
+#### **1. 集成 TIMPush 厂商依赖**
+
+在应用模块 `build.gradle` 或 `build.gradle.kts` 的 `dependencies` 中追加 OPPO 通道包，`VERSION` 与基础包保持一致：
+
+【Groovy DSL】
+``` groovy
+implementation 'com.tencent.timpush:oppo:VERSION'
+```
+
+【Kotlin DSL】
+``` kotlin
+implementation("com.tencent.timpush:oppo:VERSION")
+```
+
+集成结果判断：Gradle Sync 成功完成，无报错。
+
+#### **2. 配置消息触达统计（可选）**
+
+OPPO 通道当前无需在客户端额外配置回执地址。如需统计，请按 OPPO 厂商配置 完成控制台侧配置。
+
+#### **3. 配置消息分类（可选）**
+
+OPPO 同时存在新规则和旧规则，不要混用。
+- 新规则：适用于新接入应用，或按 OPPO 新消息分类改造的应用。使用 `category`、私信模板参数，以及可选的 `notify_level`。
+
+- 旧规则：仅适用于此前已开通 OPPO 私信通道权限的存量应用，使用已创建并在 OPPO 推送运营后台登记的私信通道 `ChannelID`。
+
+只有 IM 聊天、订单、交易、账号变更等用户预期强、需要及时触达的消息，才建议申请或使用高优先级分类。营销、广告、活动、资讯类消息不应滥用高优分类，否则可能被厂商降级、限频或冻结权限。
+
+发送离线推送时可通过 SDK API 设置，API 设置优先级通常高于控制台证书默认配置。
+
+##### **OPPO 新规则配置**
+
+OPPO 新接入应用建议使用新消息分类规则。IM 聊天、音视频通话等需要及时触达的消息，通常使用 `category=IM`，并按 OPPO 要求申请通讯与服务不限量权益或私信模板。
+``` java
+V2TIMOfflinePushInfo pushInfo = new V2TIMOfflinePushInfo();
+
+// New OPPO message classification rule. Use IM for chat and call messages.
+pushInfo.setAndroidOPPOCategory("IM");
+
+// Optional. 1 = notification bar, 2 = notification bar + lock screen + sound + vibration.
+// Use 16 only after OPPO strong reminder capability is approved.
+pushInfo.setAndroidOPPONotifyLevel(2);
+```
+
+对应 API：
+- [`setAndroidOPPOCategory(String category)`](https://im.sdk.qcloud.com/doc/zh-cn/classcom_1_1tencent_1_1imsdk_1_1v2_1_1V2TIMOfflinePushInfo.html#a6a62542254c53626b81ce24380b0a2fb)：设置 OPPO 新消息分类，例如 IM 消息使用 `IM`。
+
+- [`setAndroidOPPONotifyLevel(int level)`](https://im.sdk.qcloud.com/doc/zh-cn/classcom_1_1tencent_1_1imsdk_1_1v2_1_1V2TIMOfflinePushInfo.html#a1fd2e7d168b5412fc263274842855c57)：设置 OPPO 通知栏消息提醒等级。使用前需要先设置 `category`；如需 `16`，需先向 OPPO 申请强提醒能力。
+
+如需使用 OPPO 私信模板，可通过 [`V2TIMOfflinePushInfo.setVendorParams(String vendorParams)`](https://im.sdk.qcloud.com/doc/zh-cn/classcom_1_1tencent_1_1imsdk_1_1v2_1_1V2TIMOfflinePushInfo.html#aedaa6ba7f49f3abfc04a8efaaf45e0c7) 携带厂商扩展参数。根据腾讯云离线推送消息属性设置文档，`vendorParams` 是 JSON 字符串，且 `oppoTitleParam`、`oppoContentParam` 等字段本身也需要序列化为 JSON 字符串。
+``` java
+Map<String, Object> vendorParams = new HashMap<>();
+vendorParams.put("oppoTemplateId", "OPPO 私信模板 ID");
+
+Map<String, Object> titleParams = new HashMap<>();
+titleParams.put("title", "推送标题");
+vendorParams.put("oppoTitleParam", new Gson().toJson(titleParams));
+
+Map<String, Object> contentParams = new HashMap<>();
+contentParams.put("desc", "推送内容");
+vendorParams.put("oppoContentParam", new Gson().toJson(contentParams));
+
+pushInfo.setVendorParams(new Gson().toJson(vendorParams));
+```
+
+`vendorParams` 扩展参数能力要求 IMSDK 8.7 及以上版本。`oppoTemplateId` 必须是 OPPO 私信申请得到的模板 ID，不支持开发者自拟。`oppoTitleParam` 和 `oppoContentParam` 中的 key 需要与 OPPO 模板中的占位符一致。
+
+##### **OPPO 旧规则配置**
+
+旧规则仅适用于此前已开通 OPPO 私信通道权限的存量应用。如果应用仍按旧规则使用私信通道，请确保客户端创建的通道 ID 已在 OPPO 推送运营后台登记，并与发送离线推送时设置的 `channelID` 保持一致。
+``` java
+V2TIMOfflinePushInfo pushInfo = new V2TIMOfflinePushInfo();
+
+// Old OPPO private channel rule for existing apps only.
+pushInfo.setAndroidOPPOChannelID("your_oppo_private_channel_id");
+```
+
+新接入应用不要把 [`setAndroidOPPOChannelID`](https://im.sdk.qcloud.com/doc/zh-cn/classcom_1_1tencent_1_1imsdk_1_1v2_1_1V2TIMOfflinePushInfo.html#a32d340e95395bb64cc3e8f62321aafe1) 当作 OPPO 新消息分类的必配项。新规则优先使用 [`setAndroidOPPOCategory`](https://im.sdk.qcloud.com/doc/zh-cn/classcom_1_1tencent_1_1imsdk_1_1v2_1_1V2TIMOfflinePushInfo.html#a6a62542254c53626b81ce24380b0a2fb)，并按需配置 [`setVendorParams`](https://im.sdk.qcloud.com/doc/zh-cn/classcom_1_1tencent_1_1imsdk_1_1v2_1_1V2TIMOfflinePushInfo.html#aedaa6ba7f49f3abfc04a8efaaf45e0c7) 和 [`setAndroidOPPONotifyLevel`](https://im.sdk.qcloud.com/doc/zh-cn/classcom_1_1tencent_1_1imsdk_1_1v2_1_1V2TIMOfflinePushInfo.html#a1fd2e7d168b5412fc263274842855c57)。
+
+【vivo】
+
+#### **前置**
+
+请先完成 vivo 厂商配置，并确认：
+- 已在腾讯云控制台添加 vivo 厂商证书；
+
+- 已重新下载包含 vivo 证书的 `timpush-configs.json`，并放入应用模块 `assets` 目录；
+
+- 使用 vivo 真机验证。
+
+#### **1. 集成 TIMPush 厂商依赖**
+
+在应用模块 `build.gradle` 或 `build.gradle.kts` 的 `dependencies` 中追加 vivo 通道包，`VERSION` 与基础包保持一致：
+
+【Groovy DSL】
+``` groovy
+implementation 'com.tencent.timpush:vivo:VERSION'
+```
+
+【Kotlin DSL】
+``` kotlin
+implementation("com.tencent.timpush:vivo:VERSION")
+```
+
+#### **2. 配置 manifestPlaceholders 和 AndroidManifest.xml**
+
+vivo 需要将厂商分配的 AppID / AppKey 配置到清单文件中。厂商 SDK 会从 Manifest 中读取这些值来识别当前应用；缺失或填写错误可能导致编译失败或厂商注册失败。您可以选择 `manifestPlaceholders` 或直接在 `AndroidManifest.xml` 中配置 `meta-data`。
+
+【方法 1：配置 manifestPlaceholders】
+
+在 `manifestPlaceholders` 里添加条目：
+
+【Groovy DSL】
+``` groovy
+android {
+    defaultConfig {
+        manifestPlaceholders = [
+            "VIVO_APPKEY": "您应用分配的证书 APPKEY",
+            "VIVO_APPID" : "您应用分配的证书 APPID"
+        ]
+    }
+}
+```
+
+【Kotlin DSL】
+``` kotlin
+android {
+    defaultConfig {
+        manifestPlaceholders["VIVO_APPKEY"] = "您应用分配的证书 APPKEY"
+        manifestPlaceholders["VIVO_APPID"] = "您应用分配的证书 APPID"
+    }
+}
+```
+
+【方法 2：配置 AndroidManifest.xml】
+
+在 `AndroidManifest.xml` 中配置 `meta-data`：
+``` xml
+<application>
+    <!-- vivo begin -->
+    <meta-data
+        tools:replace="android:value"
+        android:name="com.vivo.push.api_key"
+        android:value="您应用分配的证书 APPKEY" />
+
+    <meta-data
+        tools:replace="android:value"
+        android:name="com.vivo.push.app_id"
+        android:value="您应用分配的证书 APPID" />
+    <!-- vivo end -->
+</application>
+```
+
+如果使用 `tools:replace`，请确认 `manifest` 根节点包含 `tools` 命名空间：
+``` xml
+<manifest xmlns:android="http://schemas.android.com/apk/res/android"
+    xmlns:tools="http://schemas.android.com/tools">
+</manifest>
+```
+
+集成结果判断：Gradle Sync 成功完成，无报错。
+
+#### **3. 配置消息触达统计（可选）**
+
+如需统计触达或点击数据，请配置回执地址 `https://api.im.qcloud.com/v3/offline_push_report/vivo`，并按控制台要求配置回执 ID。回执地址不配置或配置错误，都会影响触达统计。
+
+#### **4. 配置消息分类（可选）**
+
+发送离线推送时可通过 SDK API 设置 vivo 消息类别，API 设置优先级通常高于控制台证书默认配置。调用 [`setAndroidVIVOCategory(String category)`](https://im.sdk.qcloud.com/doc/zh-cn/classcom_1_1tencent_1_1imsdk_1_1v2_1_1V2TIMOfflinePushInfo.html#ae7341caa3c58aec949cf186cb25af591) 设置 vivo 推送消息类别：
+``` java
+V2TIMOfflinePushInfo pushInfo = new V2TIMOfflinePushInfo();
+pushInfo.setAndroidVIVOCategory("IM");
+```
+
+【荣耀】
+
+#### **前置**
+
+请先完成 荣耀厂商配置，并确认：
+- 已在腾讯云控制台添加荣耀厂商证书；
+
+- 已重新下载包含荣耀证书的 `timpush-configs.json`，并放入应用模块 `assets` 目录；
+
+- 测试包当前签名（debug 或 release）的 SHA-256 已在荣耀控制台 **项目设置 > 常规 > SHA 证书指纹** 中添加，指纹不一致会报 `6003: certificate fingerprint error`；
+
+- 使用荣耀真机验证。不要在华为设备上验证荣耀通道。
+
+#### **1. 添加厂商配置文件**
+
+在荣耀开发者服务平台下载 `mcs-services.json`，添加到应用模块根目录（与应用模块的 `build.gradle` / `build.gradle.kts` 同级）：
+``` text
+app/mcs-services.json
+```
+
+修改项目、应用信息或开发服务设置后，需要重新下载并替换。后续构建时，荣耀插件会读取该文件并将厂商要求的资源、Manifest 信息合并进应用包。
+
+#### **2. 配置 Gradle 插件**
+
+荣耀需要通过 `com.hihonor.mcs:asplugin` 在构建期读取 `mcs-services.json`，并依赖荣耀 Maven 仓库解析插件与 SDK。荣耀官方示例统一使用 `buildscript > dependencies > classpath` 形式，未提供 `plugins {}` 块写法。
+
+##### **追加厂商 Maven 仓库**
+
+请在「配置 Gradle 仓库」已添加的公共仓库基础上，追加荣耀仓库。
+
+【Gradle 7.1 及以上】
+
+在 `settings.gradle` 或 `settings.gradle.kts` 的 `pluginManagement > repositories` 和 `dependencyResolutionManagement > repositories` 中追加：
+
+【Groovy DSL】
+``` java
+maven { url "https://developer.hihonor.com/repo" }
+```
+
+【Kotlin DSL】
+``` java
+maven { url = uri("https://developer.hihonor.com/repo") }
+```
+
+【Gradle 7.0 及以下】
+
+在项目级 `build.gradle` 的 `buildscript > repositories`，以及 `settings.gradle` 的 `dependencyResolutionManagement > repositories`（Gradle 7.0）或 `allprojects > repositories`（Gradle 7.0 以下）中追加：
+``` groovy
+maven { url "https://developer.hihonor.com/repo" }
+```
+
+##### **配置项目级插件依赖**
+
+【Gradle 7.1 及以上】
+
+如果项目级 `build.gradle.kts` 已通过 `plugins {}` 块声明 AGP（新建 Kotlin DSL 项目的默认方式），原有 `plugins {}` 块保留不动，不需要整体迁移到 `buildscript` 写法。由于荣耀官方示例统一使用 `buildscript > dependencies > classpath` 声明 `asplugin`，请在项目级 Gradle 文件中额外补充 `buildscript` 配置，并在 `dependencies` 中声明 `com.android.tools.build:gradle`。如果项目同时使用 Kotlin Android 插件，也请声明 `org.jetbrains.kotlin:kotlin-gradle-plugin`。
+
+【Groovy DSL（build.gradle）】
+``` java
+buildscript {
+    repositories {
+        google()
+        mavenCentral()
+        gradlePluginPortal()
+        maven { url "https://mirrors.tencent.com/nexus/repository/maven-public/" }
+        maven { url "https://developer.hihonor.com/repo" }
+    }
+    dependencies {
+        // 请与项目当前 Android Gradle Plugin 版本保持一致。
+        classpath 'com.android.tools.build:gradle:<AGP_VERSION>'
+        // 如果项目使用 Kotlin Android 插件，请与项目当前 Kotlin Gradle Plugin 版本保持一致。
+        classpath 'org.jetbrains.kotlin:kotlin-gradle-plugin:<KOTLIN_VERSION>'
+        // 荣耀 Push。
+        classpath 'com.hihonor.mcs:asplugin:2.0.1.300'
+    }
+}
+```
+
+【Kotlin DSL（build.gradle.kts）】
+``` java
+buildscript {
+    repositories {
+        google()
+        mavenCentral()
+        gradlePluginPortal()
+        maven { url = uri("https://mirrors.tencent.com/nexus/repository/maven-public/") }
+        maven { url = uri("https://developer.hihonor.com/repo") }
+    }
+    dependencies {
+        // 请与项目当前 Android Gradle Plugin 版本保持一致。
+        classpath("com.android.tools.build:gradle:<AGP_VERSION>")
+        // 如果项目使用 Kotlin Android 插件，请与项目当前 Kotlin Gradle Plugin 版本保持一致。
+        classpath("org.jetbrains.kotlin:kotlin-gradle-plugin:<KOTLIN_VERSION>")
+        // 荣耀 Push。
+        classpath("com.hihonor.mcs:asplugin:2.0.1.300")
+    }
+}
+```
+1. 请将`<AGP_VERSION>`替换为项目当前使用的 Android Gradle Plugin 版本，例如 `8.9.1`。如果项目级 `plugins {}` 块中已经声明了 `com.android.application` 版本，两个位置的 AGP 版本需要保持一致。
+
+2. 请将`<KOTLIN_VERSION>` 替换为项目当前使用的 Kotlin Gradle Plugin 版本；如果项目未使用 Kotlin Android 插件，可删除该行。
+
+【Gradle 7.0 及以下】
+
+在项目级 `build.gradle` 的 `buildscript > dependencies` 中追加：
+``` groovy
+classpath 'com.hihonor.mcs:asplugin:2.0.1.300'
+```
+
+##### **在应用模块启用插件**
+
+完成项目级插件依赖配置后，还需要在应用模块的 `build.gradle` 或 `build.gradle.kts` 中启用荣耀插件。应用模块通常为 `app`。
+
+如果应用模块中已经存在 `plugins` 块，请在现有 `plugins` 块中追加，不要重复添加已有的 `com.android.application` 插件。应用级 `plugins { id("com.hihonor.mcs.asplugin") }` 可省略版本号（由项目级 classpath 提供），或改写为 `apply plugin`。
+
+【Groovy DSL（app/build.gradle）】
+``` groovy
+plugins {
+    // 荣耀 Push。
+    id 'com.hihonor.mcs.asplugin'
+}
+// 或：apply plugin: 'com.hihonor.mcs.asplugin'
+```
+
+【Kotlin DSL（app/build.gradle.kts）】
+``` kotlin
+plugins {
+    // 荣耀 Push。
+    id("com.hihonor.mcs.asplugin")
+}
+// 或：apply(plugin = "com.hihonor.mcs.asplugin")
+```
+
+完成配置后，请在 Android Studio 中单击 **Sync Now**，或选择 **File > Sync Project with Gradle Files** 触发 Gradle 同步。
+
+#### **3. 集成 TIMPush 厂商依赖**
+
+在应用模块 `build.gradle` 或 `build.gradle.kts` 的 `dependencies` 中追加荣耀通道包，`VERSION` 与基础包保持一致：
+
+【Groovy DSL】
+``` groovy
+implementation 'com.tencent.timpush:honor:VERSION'
+```
+
+【Kotlin DSL】
+``` kotlin
+implementation("com.tencent.timpush:honor:VERSION")
+```
+
+#### **4. 配置 manifestPlaceholders 和 AndroidManifest.xml**
+
+荣耀需要将厂商分配的 AppID 配置到清单文件中。厂商 SDK 会从 Manifest 中读取该值来识别当前应用；缺失或填写错误可能导致编译失败或厂商注册失败。您可以选择 `manifestPlaceholders` 或直接在 `AndroidManifest.xml` 中配置 `meta-data`。
+
+【方法 1：配置 manifestPlaceholders】
+
+【Groovy DSL】
+``` groovy
+android {
+    defaultConfig {
+        manifestPlaceholders = [
+            "HONOR_APPID": "您应用分配的证书 APPID"
+        ]
+    }
+}
+```
+
+【Kotlin DSL】
+``` kotlin
+android {
+    defaultConfig {
+        manifestPlaceholders["HONOR_APPID"] = "您应用分配的证书 APPID"
+    }
+}
+```
+
+【方法 2：配置 AndroidManifest.xml】
+``` xml
+<application>
+    <!-- honor begin -->
+    <meta-data
+        tools:replace="android:value"
+        android:name="com.hihonor.push.app_id"
+        android:value="您应用分配的证书 APPID" />
+    <!-- honor end -->
+</application>
+```
+
+如果使用 `tools:replace`，请确认 `manifest` 根节点包含 `tools` 命名空间：
+``` xml
+<manifest xmlns:android="http://schemas.android.com/apk/res/android"
+    xmlns:tools="http://schemas.android.com/tools">
+</manifest>
+```
+
+集成结果判断：Gradle Sync 成功完成，无报错；确认 `mcs-services.json` 已放在应用模块根目录。
+
+#### **5. 配置消息触达统计（可选）**
+
+如需统计触达或点击数据，请配置回执地址 `https://api.im.qcloud.com/v3/offline_push_report/honor`。回执地址不配置或配置错误，都会影响触达统计。
+
+#### **6. 配置消息分类（可选）**
+
+发送离线推送时可通过 SDK API 设置荣耀消息分类，API 设置优先级通常高于控制台证书默认配置。调用 [`setAndroidHonorImportance(String importance)`](https://im.sdk.qcloud.com/doc/zh-cn/classcom_1_1tencent_1_1imsdk_1_1v2_1_1V2TIMOfflinePushInfo.html#a3167229118ad659378b2066821935c79) 设置荣耀消息分类，`NORMAL` 表示服务通讯类消息，`LOW` 表示资讯营销类消息：
+``` java
+V2TIMOfflinePushInfo pushInfo = new V2TIMOfflinePushInfo();
+pushInfo.setAndroidHonorImportance("NORMAL");
+```
+
+【魅族】
+
+#### **前置**
+
+请先完成 魅族厂商配置，并确认：
+- 已在腾讯云控制台添加魅族厂商证书；
+
+- 已重新下载包含魅族证书的 `timpush-configs.json`，并放入应用模块 `assets` 目录；
+
+- 使用魅族真机验证。
+
+#### **1. 集成 TIMPush 厂商依赖**
+
+在应用模块 `build.gradle` 或 `build.gradle.kts` 的 `dependencies` 中追加魅族通道包，`VERSION` 与基础包保持一致：
+
+【Groovy DSL】
+``` groovy
+implementation 'com.tencent.timpush:meizu:VERSION'
+```
+
+【Kotlin DSL】
+``` kotlin
+implementation("com.tencent.timpush:meizu:VERSION")
+```
+
+集成结果判断：Gradle Sync 成功完成，无报错。
+
+#### **2. 配置消息触达统计（可选）**
+
+如需统计触达或点击数据，请打开回执开关并配置回执地址 `https://api.im.qcloud.com/v3/offline_push_report/meizu`。回执地址不配置或配置错误，都会影响触达统计。
+
+#### **3. 配置消息分类（可选）**
+
+发送离线推送时可通过 SDK API 设置魅族消息分类，API 设置优先级通常高于控制台证书默认配置。调用 [`setAndroidMeizuNotifyType(int type)`](https://im.sdk.qcloud.com/doc/zh-cn/classcom_1_1tencent_1_1imsdk_1_1v2_1_1V2TIMOfflinePushInfo.html#a7e26dd03042cad06c4e7352845079be0) 设置魅族消息分类，`0` 表示公信消息，`1` 表示私信消息：
+``` java
+V2TIMOfflinePushInfo pushInfo = new V2TIMOfflinePushInfo();
+pushInfo.setAndroidMeizuNotifyType(1);
 ```
 
-【Gradle 7.0 以下版本】
+【Google FCM】
 
-Gradle 7.0 以下版本通常使用 Groovy DSL。如您的工程使用 Kotlin DSL，请将单引号改为双引号，`url "..."` 改为 `url = uri("...")`。
+#### **前置**
 
-在项目级 `build.gradle` 的 `buildscript > repositories` 和 `allprojects > repositories` 中添加仓库。
-``` groovy
-buildscript {
-    repositories {
-        google()
-        mavenCentral()
-        maven { url "https://mirrors.tencent.com/nexus/repository/maven-public/" }
-        maven { url "https://developer.huawei.com/repo/" }
-        maven { url "https://developer.hihonor.com/repo" }
-    }
-    dependencies {
-        classpath 'com.google.gms:google-services:4.3.15'
-        classpath 'com.huawei.agconnect:agcp:1.6.0.300'
-        classpath 'com.hihonor.mcs:asplugin:2.0.1.300'
-    }
-}
+请先完成 Google FCM 厂商配置，并确认：
+- 已在腾讯云控制台添加 FCM 厂商证书；
 
-allprojects {
-    repositories {
-        google()
-        mavenCentral()
-        maven { url "https://mirrors.tencent.com/nexus/repository/maven-public/" }
-        maven { url "https://developer.huawei.com/repo/" }
-        maven { url "https://developer.hihonor.com/repo" }
-    }
-}
-```
+- 已重新下载包含 FCM 证书的 `timpush-configs.json`，并放入应用模块 `assets` 目录；
 
-> **说明：**
-> - 如果旧工程已升级到 Gradle 8 / AGP 8，请不要继续使用 `com.huawei.agconnect:agcp:1.6.0.300`，建议改为 `com.huawei.agconnect:agcp:1.9.1.301` 或更高已验证版本。
-> - 若使用 Google FCM，`com.google.gms:google-services:4.4.2` 要求 AGP 7.3.0 及以上；如果项目的 AGP 低于 7.3.0，请改用与当前 AGP 兼容的 Google Services Gradle Plugin 版本，例如 `4.3.15`。
+- 测试设备具备可用的 Google Play 服务（国内无 GMS 的设备无法验证 FCM 通道）。
 
-### 配置厂商插件
+#### **1. 添加厂商配置文件**
+
+在 Firebase 控制台下载 `google-services.json`，添加到应用模块根目录（与应用模块的 `build.gradle` / `build.gradle.kts` 同级）：
+``` text
+app/google-services.json
+```
 
-华为、荣耀和 Google FCM 需要按厂商要求集成对应 Gradle 插件。插件会在构建期读取上一步放置的厂商配置文件，并将厂商要求的资源、Manifest 信息或初始化配置合并进应用包。
+后续构建时，Google Services 插件会读取该文件并将 FCM 要求的资源、Manifest 信息合并进应用包。
 
-如果只集成某个厂商，只添加该厂商需要的插件和配置文件即可。例如未接入 FCM 时，不需要添加 `com.google.gms.google-services` 插件和 `google-services.json`。
+#### **2. 配置 Gradle 插件**
 
-#### 配置项目级插件依赖
+Google FCM 需要通过 Google Services Gradle 插件在构建期读取 `google-services.json`。请按工程 Gradle 版本选择配置方式。FCM 无需额外的厂商 Maven 仓库，相关依赖通过 `google()` 仓库解析。
 
-项目级插件依赖用于让 Gradle 在构建期找到并加载华为、荣耀、Google FCM 等厂商插件。请先根据项目使用的 Gradle 版本选择对应配置。
+##### **配置项目级插件依赖**
 
 【Gradle 7.1 及以上】
 
-Gradle 7.1 及以上项目通常会在 `settings.gradle` 或 `settings.gradle.kts` 中配置依赖仓库。但如果厂商插件通过 `buildscript > dependencies > classpath` 声明，还需要在项目级 `build.gradle` 或 `build.gradle.kts` 的 `buildscript > repositories` 中同步配置插件仓库，否则可能出现厂商插件 classpath 依赖解析失败。
-
-如果项目级 `build.gradle.kts` 已通过 `plugins {}` 块声明 AGP（新建 Kotlin DSL 项目的默认方式），原有 `plugins {}` 块保留不动，不需要整体迁移到 `buildscript` 写法。由于荣耀官方示例统一使用 `buildscript > dependencies > classpath` 声明 `asplugin`，请在项目级 Gradle 文件中额外补充 `buildscript` 配置，并在 `dependencies` 中声明 `com.android.tools.build:gradle`。如果项目同时使用 Kotlin Android 插件，也请声明 `org.jetbrains.kotlin:kotlin-gradle-plugin`。
+Gradle 7.1 及以上项目通常在 `settings.gradle` 或 `settings.gradle.kts` 中配置依赖仓库。由于 Google Services 插件通过 `buildscript > dependencies > classpath` 声明，还需要在项目级 `build.gradle` 或 `build.gradle.kts` 的 `buildscript > repositories` 中包含 `google()` 等仓库，否则可能出现插件 classpath 依赖解析失败。
 
-请在 Android 工程的项目级 `build.gradle` 或 `build.gradle.kts` 中添加以下配置。
+如果项目级 `build.gradle.kts` 已通过 `plugins {}` 块声明 AGP（新建 Kotlin DSL 项目的默认方式），原有 `plugins {}` 块保留不动，不需要整体迁移到 `buildscript` 写法，在 `dependencies` 中声明 `com.android.tools.build:gradle` 即可。如果项目同时使用 Kotlin Android 插件，也请声明 `org.jetbrains.kotlin:kotlin-gradle-plugin`。
 
 【Groovy DSL（build.gradle）】
 ``` java
@@ -225,20 +870,14 @@ buildscript {
         mavenCentral()
         gradlePluginPortal()
         maven { url "https://mirrors.tencent.com/nexus/repository/maven-public/" }
-        maven { url "https://developer.huawei.com/repo/" }
-        maven { url "https://developer.hihonor.com/repo" }
     }
     dependencies {
         // 请与项目当前 Android Gradle Plugin 版本保持一致。
         classpath 'com.android.tools.build:gradle:<AGP_VERSION>'
         // 如果项目使用 Kotlin Android 插件，请与项目当前 Kotlin Gradle Plugin 版本保持一致。
         classpath 'org.jetbrains.kotlin:kotlin-gradle-plugin:<KOTLIN_VERSION>'
-        // Google FCM。
+        // Google FCM。4.4.2 要求 AGP 7.3.0 及以上，更低的 AGP 请改用 4.3.15。
         classpath 'com.google.gms:google-services:4.4.2'
-        // 华为 AGConnect。Gradle 8 / AGP 8 项目不要继续使用 1.6.0.300。
-        classpath 'com.huawei.agconnect:agcp:1.9.1.301'
-        // 荣耀 Push。
-        classpath 'com.hihonor.mcs:asplugin:2.0.1.300'
     }
 }
 ```
@@ -251,20 +890,14 @@ buildscript {
         mavenCentral()
         gradlePluginPortal()
         maven { url = uri("https://mirrors.tencent.com/nexus/repository/maven-public/") }
-        maven { url = uri("https://developer.huawei.com/repo/") }
-        maven { url = uri("https://developer.hihonor.com/repo") }
     }
     dependencies {
         // 请与项目当前 Android Gradle Plugin 版本保持一致。
         classpath("com.android.tools.build:gradle:<AGP_VERSION>")
         // 如果项目使用 Kotlin Android 插件，请与项目当前 Kotlin Gradle Plugin 版本保持一致。
         classpath("org.jetbrains.kotlin:kotlin-gradle-plugin:<KOTLIN_VERSION>")
-        // Google FCM。
+        // Google FCM。4.4.2 要求 AGP 7.3.0 及以上，更低的 AGP 请改用 4.3.15。
         classpath("com.google.gms:google-services:4.4.2")
-        // 华为 AGConnect。Gradle 8 / AGP 8 项目不要继续使用 1.6.0.300。
-        classpath("com.huawei.agconnect:agcp:1.9.1.301")
-        // 荣耀 Push。
-        classpath("com.hihonor.mcs:asplugin:2.0.1.300")
     }
 }
 ```
@@ -272,39 +905,30 @@ buildscript {
 
 2. 请将`<KOTLIN_VERSION>` 替换为项目当前使用的 Kotlin Gradle Plugin 版本；如果项目未使用 Kotlin Android 插件，可删除该行。
 
-> **注意：**
-> 对于 Gradle 8 / AGP 8 项目，请不要继续使用 `com.huawei.agconnect:agcp:1.6.0.300`。AGP 8.0 已移除 Transform API，旧版 AGC 插件存在兼容风险，建议使用 `com.huawei.agconnect:agcp:1.9.1.301` 或更高已验证版本。若使用 Google FCM，`com.google.gms:google-services:4.4.2` 要求 AGP 7.3.0 及以上。
+> **说明：**
+> `com.google.gms:google-services:4.4.2` 要求 AGP 7.3.0 及以上；如果项目的 AGP 低于 7.3.0，请改用与当前 AGP 兼容的 Google Services Gradle Plugin 版本，例如 `4.3.15`。
 >
 
 【Gradle 7.0 及以下】
 
-如果您已在上一节「配置 Gradle 仓库」中按照 Gradle 7.0 或 Gradle 7.0 以下示例配置了 `buildscript > repositories` 和 `buildscript > dependencies`，可以跳过本节的项目级插件依赖配置。
-
-如果尚未配置，请回到上一节，根据当前 Gradle 版本补充 `buildscript` 中的仓库和插件 classpath。
+在项目级 `build.gradle` 的 `buildscript > dependencies` 中追加：
+``` groovy
+classpath 'com.google.gms:google-services:4.3.15'
+```
 
-#### 在应用模块启用厂商插件
+##### **在应用模块启用插件**
 
-完成项目级插件依赖配置后，还需要在应用模块的 `build.gradle` 或 `build.gradle.kts` 中启用厂商插件。应用模块通常为 `app`。
+完成项目级插件依赖配置后，还需要在应用模块的 `build.gradle` 或 `build.gradle.kts` 中启用 Google Services 插件。应用模块通常为 `app`。
 
-如果应用模块中已经存在 `plugins` 块，请在现有 `plugins` 块中追加厂商插件，不要重复添加已有的 `com.android.application` 插件。
+如果应用模块中已经存在 `plugins` 块，请在现有 `plugins` 块中追加，不要重复添加已有的 `com.android.application` 插件。
 
 【Groovy DSL（app/build.gradle）】
 ``` groovy
 plugins {
     // Google FCM。
     id 'com.google.gms.google-services'
-    // 华为 AGConnect。
-    id 'com.huawei.agconnect'
-    // 荣耀 Push。
-    id 'com.hihonor.mcs.asplugin'
 }
-```
-
-如果您的应用级 `build.gradle` 使用 `apply plugin` 写法，也可以写成：
-``` groovy
-apply plugin: 'com.google.gms.google-services'
-apply plugin: 'com.huawei.agconnect'
-apply plugin: 'com.hihonor.mcs.asplugin'
+// 或：apply plugin: 'com.google.gms.google-services'
 ```
 
 【Kotlin DSL（app/build.gradle.kts）】
@@ -312,162 +936,52 @@ apply plugin: 'com.hihonor.mcs.asplugin'
 plugins {
     // Google FCM。
     id("com.google.gms.google-services")
-    // 华为 AGConnect。
-    id("com.huawei.agconnect")
-    // 荣耀 Push。
-    id("com.hihonor.mcs.asplugin")
 }
-```
-
-如果您的应用级 `build.gradle.kts` 使用 `apply` 写法，也可以写成：
-``` kotlin
-apply(plugin = "com.google.gms.google-services")
-apply(plugin = "com.huawei.agconnect")
-apply(plugin = "com.hihonor.mcs.asplugin")
+// 或：apply(plugin = "com.google.gms.google-services")
 ```
 
 完成配置后，请在 Android Studio 中单击 **Sync Now**，或选择 **File > Sync Project with Gradle Files** 触发 Gradle 同步。同步成功后，再执行构建验证。
 
-### 集成 TIMPush 依赖
-
-在应用模块的 `build.gradle` 或 `build.gradle.kts` 中添加 TIMPush 依赖。基础包提供 TIMPush 注册、监听和通用能力；厂商包用于对接对应厂商离线推送通道。只集成基础包而不集成目标厂商包时，设备可能无法通过该厂商通道收到离线推送。
-
-下方示例中的 `VERSION` 均指 TIMPush SDK 的版本号（如 `8.9.7537`），不是 Android 系统版本或厂商 SDK 版本。获取最新版本号请查看更新日志。
-
-【Groovy DSL】
-``` groovy
-dependencies {
-    implementation 'com.tencent.timpush:timpush:VERSION'
-    implementation 'com.tencent.liteav.tuikit:tuicore:VERSION'
-
-    implementation 'com.tencent.timpush:huawei:VERSION'
-    implementation 'com.tencent.timpush:xiaomi:VERSION'
-    implementation 'com.tencent.timpush:oppo:VERSION'
-    implementation 'com.tencent.timpush:vivo:VERSION'
-    implementation 'com.tencent.timpush:honor:VERSION'
-    implementation 'com.tencent.timpush:meizu:VERSION'
-    implementation 'com.tencent.timpush:fcm:VERSION'
-}
-```
-
-【Kotlin DSL】
-``` kotlin
-dependencies {
-    implementation("com.tencent.timpush:timpush:VERSION")
-    implementation("com.tencent.liteav.tuikit:tuicore:VERSION")
-
-    implementation("com.tencent.timpush:huawei:VERSION")
-    implementation("com.tencent.timpush:xiaomi:VERSION")
-    implementation("com.tencent.timpush:oppo:VERSION")
-    implementation("com.tencent.timpush:vivo:VERSION")
-    implementation("com.tencent.timpush:honor:VERSION")
-    implementation("com.tencent.timpush:meizu:VERSION")
-    implementation("com.tencent.timpush:fcm:VERSION")
-}
-```
-
-请按实际目标厂商添加依赖。
-
-|**目标厂商**|**依赖**|
-|---------|---------|
-|华为|`com.tencent.timpush:huawei:VERSION`|
-|小米|`com.tencent.timpush:xiaomi:VERSION`|
-|OPPO|`com.tencent.timpush:oppo:VERSION`|
-|vivo|`com.tencent.timpush:vivo:VERSION`|
-|荣耀|`com.tencent.timpush:honor:VERSION`|
-|魅族|`com.tencent.timpush:meizu:VERSION`|
-|Google FCM|`com.tencent.timpush:fcm:VERSION`|
-
-添加依赖后，请在 Android Studio 中单击 **Sync Now**，或选择 **File > Sync Project with Gradle Files** 触发 Gradle 同步。
-
-> **注意：**
-> `TIMPush`、`TUICore` 和各厂商通道包建议使用相同 `VERSION`，避免依赖冲突。项目已接入 IM SDK 或 TUIKit 时，也需要确认相关 SDK 版本兼容。
->
-
-**验证**：Gradle Sync 成功完成，无报错。如果报依赖找不到，请检查 `VERSION` 是否正确、厂商 Maven 仓库是否缺失、插件 classpath 是否配置到正确文件。
-
-### 配置 `manifestPlaceholders` 和 `AndroidManifest.xml`
-
-vivo 和荣耀需要将厂商分配的 AppID / AppKey 配置到清单文件中。厂商 SDK 会从 Manifest 中读取这些值来识别当前应用；缺失或填写错误可能导致编译失败或厂商注册失败。您可以选择 `manifestPlaceholders` 或直接在 `AndroidManifest.xml` 中配置 `meta-data`。
-
-【方法 1：配置 manifestPlaceholders】
+#### **3. 集成 TIMPush 厂商依赖**
 
-在 `manifestPlaceholders` 里添加条目：
+在应用模块 `build.gradle` 或 `build.gradle.kts` 的 `dependencies` 中追加 FCM 通道包，`VERSION` 与基础包保持一致：
 
 【Groovy DSL】
 ``` groovy
-android {
-    defaultConfig {
-        manifestPlaceholders = [
-            "VIVO_APPKEY": "您应用分配的证书 APPKEY",
-            "VIVO_APPID" : "您应用分配的证书 APPID",
-            "HONOR_APPID": "您应用分配的证书 APPID"
-        ]
-    }
-}
+implementation 'com.tencent.timpush:fcm:VERSION'
 ```
 
 【Kotlin DSL】
 ``` kotlin
-android {
-    defaultConfig {
-        manifestPlaceholders["VIVO_APPKEY"] = "您应用分配的证书 APPKEY"
-        manifestPlaceholders["VIVO_APPID"] = "您应用分配的证书 APPID"
-        manifestPlaceholders["HONOR_APPID"] = "您应用分配的证书 APPID"
-    }
-}
+implementation("com.tencent.timpush:fcm:VERSION")
 ```
 
-【方法 2：配置 AndroidManifest.xml】
-
-在 `AndroidManifest.xml` 中配置 `meta-data`：
-``` xml
-<application>
-    <!-- vivo begin -->
-    <meta-data
-        tools:replace="android:value"
-        android:name="com.vivo.push.api_key"
-        android:value="您应用分配的证书 APPKEY" />
-
-    <meta-data
-        tools:replace="android:value"
-        android:name="com.vivo.push.app_id"
-        android:value="您应用分配的证书 APPID" />
-    <!-- vivo end -->
+集成结果判断：Gradle Sync 成功完成，无报错；确认 `google-services.json` 已放在应用模块根目录。
 
-    <!-- honor begin -->
-    <meta-data
-        tools:replace="android:value"
-        android:name="com.hihonor.push.app_id"
-        android:value="您应用分配的证书 APPID" />
-    <!-- honor end -->
-</application>
-```
+#### **4. 配置消息触达统计（可选）**
 
-如果使用 `tools:replace`，请确认 `manifest` 根节点包含 `tools` 命名空间：
-``` xml
-<manifest xmlns:android="http://schemas.android.com/apk/res/android"
-    xmlns:tools="http://schemas.android.com/tools">
-</manifest>
-```
+FCM 暂不支持推送统计功能。
 
-### 设置混淆规则
+#### **5. 配置消息分类（可选）**
 
-如果应用开启了代码混淆，请在 `proguard-rules.pro` 中加入 TIMPush 相关类不混淆规则。该配置用于避免 Release 包中 TIMPush 相关类、回调或厂商适配逻辑被混淆后无法正常调用：
-``` proguard
--keep class com.tencent.qcloud.** { *; }
--keep class com.tencent.timpush.** { *; }
+Android 8.0 及以上可通过通知渠道 ID 控制 FCM 通知展示策略。渠道创建与配置见 Google FCM 厂商配置。发送离线推送时可通过 SDK API 设置，API 设置优先级通常高于控制台证书默认配置。调用 [`setAndroidFCMChannelID(String channelID)`](https://im.sdk.qcloud.com/doc/zh-cn/classcom_1_1tencent_1_1imsdk_1_1v2_1_1V2TIMOfflinePushInfo.html#a1e63514ec664a5f7bc8c6a5b09f0689e) 设置 FCM 通道通知渠道 ID：
+``` java
+V2TIMOfflinePushInfo pushInfo = new V2TIMOfflinePushInfo();
+pushInfo.setAndroidFCMChannelID("your_fcm_channel_id");
 ```
 
-完成后，请重新构建 Release 包，并在真机上验证注册和收消息链路。
-
-**验证**：App 可在目标厂商真机上正常安装和启动，无崩溃。如果启动崩溃，请检查 `Application` 声明、配置文件位置和 Manifest 合并错误。同时确认测试真机厂商与目标厂商通道一致（如不要在华为设备上验证荣耀通道）。
+> **警告：**
+> 请关注各厂商通道消息分类规则：
+>
+> - 厂商离线通道的消息分类机制会影响推送及时性、单设备每日接收数量、夜间展示、声音、横幅和厂商通道权限。
+> - 只有 IM 聊天、订单、交易、账号变更等用户预期强、需要及时触达的消息，才建议申请或使用高优先级分类。营销、广告、活动、资讯类消息不应滥用高优分类，**否则可能被厂商降级、限频或冻结权限。**
+> - 发送离线推送时，API 设置优先级高于腾讯云控制台证书默认配置。
 
-## 注册推送
+### 步骤3：注册推送服务
 
-### registerPush
+#### 调用 registerPush
 
-registerPush 用于向 TIMPush 注册当前设备的推送 token。推送 token 是厂商通道返回的设备凭证，通常由 SDK 自动处理。注册成功后，TIMPush 会为当前设备建立一个推送目标标识 `registrationID`；服务端、控制台接入测试和排查工具可以使用该标识向这台设备下发离线推送。若 App 同时接入 IM 并完成登录，也可以使用 `userID` 向该用户已建立推送关系的设备下发离线推送。
+registerPush 用于向 TIMPush 注册当前设备的推送 token。注册成功后，TIMPush 会为当前设备建立一个推送目标标识 `registrationID`；服务端、控制台接入测试和排查工具可以使用该标识向这台设备下发离线推送。若 App 同时接入 IM 并完成登录，也可以使用 `userID` 向该用户已建立推送关系的设备下发离线推送。
 
 `appKey` 的取值会影响注册方式和可用的推送标识：
 - `appKey = Push Key`：注册 TIMPush 独立推送能力。Push Key 客户端密钥。
@@ -491,6 +1005,8 @@ registerPush 用于向 TIMPush 注册当前设备的推送 token。推送 token
 
 App 冷启动、用户同意隐私政策后调用 `registerPush(appKey = Push Key)`。如果工程已有自定义 `Application`，将注册逻辑放在该类中；如果没有，需新建并在 `AndroidManifest.xml` 中声明。
 
+建议在 `registerPush` 成功回调里调用 `getRegistrationID` 打印 `registrationID`，方便后续根据 `registrationID` 发送离线推送消息。
+
 【Java】
 ``` java
 import android.app.Application;
@@ -515,6 +1031,19 @@ public class App extends Application {
             @Override
             public void onSuccess(Object data) {
                 Log.d(TAG, ">>>>> registerPush success, data = " + data);
+                // 获取并打印出 registrationID，方便后续根据 registrationID 发送离线推送消息
+                TIMPushManager.getInstance().getRegistrationID(new TIMPushCallback<Object>() {
+                    @Override
+                    public void onSuccess(Object data) {
+                        String registrationID = (String) data;
+                        Log.d(TAG, ">>>>> getRegistrationID success, registrationID = " + registrationID);
+                    }
+                    @Override
+                    public void onError(int errCode, String errMsg, Object data) {
+                        Log.e(TAG, ">>>>> getRegistrationID failed, errCode = " + errCode
+                                + ", errMsg = " + errMsg);
+                    }
+                });
             }
 
             @Override
@@ -547,6 +1076,15 @@ class App : Application() {
         TIMPushManager.getInstance().registerPush(this, sdkAppId, appKey, object : TIMPushCallback<Any?>() {
             override fun onSuccess(data: Any?) {
                 Log.d("TIMPush", ">>>>> registerPush success, data = $data")
+                // 获取并打印出 registrationID，方便后续根据 registrationID 发送离线推送消息
+                TIMPushManager.getInstance().getRegistrationID(object : TIMPushCallback<Any?>() {
+                    override fun onSuccess(data: Any?) {
+                        Log.d("TIMPush", ">>>>> getRegistrationID success, registrationID = $data")
+                    }
+                    override fun onError(errCode: Int, errMsg: String?, data: Any?) {
+                        Log.e("TIMPush", ">>>>> getRegistrationID failed, errCode = $errCode, errMsg = $errMsg")
+                    }
+                })
             }
 
             override fun onError(errCode: Int, errMsg: String?, data: Any?) {
@@ -567,7 +1105,7 @@ class App : Application() {
 
 【IM 登录后注册推送（appKey 传 null）】
 
-请在 IM `login` 成功回调中调用 `registerPush(appKey = null)`。
+请在 IM `login` 成功回调中调用 `registerPush(appKey = null)`。建议在 `registerPush` 成功回调里调用 `getRegistrationID` 打印 `registrationID`，方便后续根据 `registrationID` 发送离线推送消息。
 
 【Java】
 ``` java
@@ -598,6 +1136,19 @@ public void loginIMAndRegisterPush(Context context) {
                 @Override
                 public void onSuccess(Object data) {
                     Log.d("TIMPush", ">>>>> registerPush success, data = " + data);
+                    // 获取并打印出 registrationID，方便后续根据 registrationID 发送离线推送消息
+                    TIMPushManager.getInstance().getRegistrationID(new TIMPushCallback<Object>() {
+                        @Override
+                        public void onSuccess(Object data) {
+                            String registrationID = (String) data;
+                            Log.d(TAG, ">>>>> getRegistrationID success, registrationID = " + registrationID);
+                        }
+                        @Override
+                        public void onError(int errCode, String errMsg, Object data) {
+                            Log.e(TAG, ">>>>> getRegistrationID failed, errCode = " + errCode
+                                    + ", errMsg = " + errMsg);
+                        }
+                    });
                 }
 
                 @Override
@@ -642,6 +1193,15 @@ fun loginIMAndRegisterPush(context: Context) {
             TIMPushManager.getInstance().registerPush(context, sdkAppId, null, object : TIMPushCallback<Any>() {
                 override fun onSuccess(data: Any?) {
                     Log.d("TIMPush", ">>>>> registerPush success, data = $data")
+                    // 获取并打印出 registrationID，方便后续根据 registrationID 发送离线推送消息
+                    TIMPushManager.getInstance().getRegistrationID(object : TIMPushCallback<Any?>() {
+                        override fun onSuccess(data: Any?) {
+                            Log.d("TIMPush", ">>>>> getRegistrationID success, registrationID = $data")
+                        }
+                        override fun onError(errCode: Int, errMsg: String?, data: Any?) {
+                            Log.e("TIMPush", ">>>>> getRegistrationID failed, errCode = $errCode, errMsg = $errMsg")
+                        }
+                    })
                 }
 
                 override fun onError(errCode: Int, errMsg: String?, data: Any?) {
@@ -670,7 +1230,7 @@ fun loginIMAndRegisterPush(context: Context) {
 
 3. 如触发 `onError`，可按 错误码 查询 `code` 含义。
 
-### 自定义 registrationID（可选）
+#### 自定义 registrationID（可选）
 
 如需自定义推送标识（如使用业务侧用户 ID），可在 `registerPush` 前调用 setRegistrationID。
 
@@ -678,30 +1238,14 @@ fun loginIMAndRegisterPush(context: Context) {
 > 混用场景下，自定义 `registrationID` 必须与 IM 登录使用的 `userID` 完全一致，否则会产生账号互踢导致推送丢失。
 >
 
-## 配置消息触达统计（可选）
-
-如果业务需要统计消息触达或点击数据，请在厂商配置阶段完成回执和点击统计相关配置。该配置用于让厂商通道把触达或点击结果回传给腾讯云侧，便于在控制台查看推送效果。不同厂商支持情况不同：
-
-|**厂商**|**配置说明**|
-|---------|---------|
-|华为|如需统计触达或点击数据，请配置回执地址 `https://api.im.qcloud.com/v3/offline_push_report/huawei`。华为推送证书 ID `<= 11344` 时使用华为推送 v2 接口，不支持触达和点击回执；如需支持统计，请重新生成并更新证书 ID。|
-|荣耀|如需统计触达或点击数据，请配置回执地址 `https://api.im.qcloud.com/v3/offline_push_report/honor`。|
-|vivo|如需统计触达或点击数据，请配置回执地址 `https://api.im.qcloud.com/v3/offline_push_report/vivo`，并按控制台要求配置回执 ID。|
-|魅族|如需统计触达或点击数据，请打开回执开关并配置回执地址 `https://api.im.qcloud.com/v3/offline_push_report/meizu`。|
-|FCM|当前腾讯云快速接入文档说明 FCM 暂不支持推送统计功能。|
-
-> **注意：**
-> 回执地址不配置或配置错误，都会影响触达统计。
->
-
-## 测试推送
+### 步骤4：测试推送链路
 
 完成上述集成步骤后，需要通过发送测试消息验证链路是否打通。发送消息前请确认：
 1. Android 13 及以上已允许通知权限；
 
 2. Android 8.0 及以上目标通知渠道已开启（包括横幅、锁屏、声音开关）；
 
-3. App 已置于后台。
+3. **App 已置于后台**。
 
    发送测试消息可以采用下面几种方法：
 
@@ -713,11 +1257,11 @@ fun loginIMAndRegisterPush(context: Context) {
 
 【REST API 发送】
 
-如果需要通过服务端发送推送，可参考 [全员/标签推送](https://cloud.tencent.com/document/product/269/100634)。
+如果需要通过服务端发送推送，可参考 全员/标签推送。
 
 【SDK API 发送】
 
-如果您的项目已接入 IM SDK，可在调用 [sendMessage](https://cloud.tencent.com/document/product/269/75315) 发送消息时，通过 `V2TIMOfflinePushInfo` 设置离线推送参数。示例：
+如果您的项目已接入 IM SDK，可在调用 sendMessage 发送消息时，通过 `V2TIMOfflinePushInfo` 设置离线推送参数。示例：
 ``` java
 V2TIMOfflinePushInfo pushInfo = new V2TIMOfflinePushInfo();
 pushInfo.setTitle("推送标题");
@@ -751,19 +1295,15 @@ V2TIMManager.getMessageManager().sendMessage(
 
 `sendMessage` 属于 IMSDK 消息发送能力。仅集成 TIMPush 的用户不需要为了验证离线推送而额外接入完整 Chat 初始化、登录和消息发送流程。
 
- **验证**：App 置于后台后发送测试消息，设备能收到离线推送通知。如果手机通知栏开启权限，通知栏会弹出离线推送消息弹框。如果收不到。
-
-## 处理通知点击跳转
+### 步骤5：处理通知点击跳转
 
 通知点击跳转需要三步配合完成：控制台配置点击动作、发送推送时携带跳转参数、客户端注册监听并解析参数。三步缺一则跳转不生效。
 
-### 配置控制台点击动作
-
-在腾讯云控制台配置推送证书的「点击后续动作」，勾选「打开应用内指定页面」：
+#### **配置控制台点击动作**
 
-操作路径：腾讯云控制台 > **推送服务 Push** > **基础配置** > **对应厂商证书** > **编辑** > 点击后续动作，选择**打开应用内指定界面**，并保持默认填充值不修改。
+在腾讯云控制台配置**打开应用内指定页面。**操作路径：腾讯云控制台 > **推送服务 Push** > **基础配置** > **对应厂商证书** > **编辑** > 点击后续动作，选择**打开应用内指定界面**。
 
-### 发送推送时携带 `ext`
+#### **发送推送时携带** `ext`
 
 发送离线推送时，通过 `ext` 字段携带跳转所需的业务信息（如目标页面、会话 ID 等）。`ext` 是一个字符串，结构由业务自定义，推荐使用 JSON 格式便于客户端解析。下文示例统一使用如下结构演示：
 ``` json
@@ -870,7 +1410,7 @@ V2TIMManager.getMessageManager().sendMessage(
 )
 ```
 
-### 客户端注册监听并解析 `ext`
+#### **客户端注册监听并解析** `ext`
 
 请在 `Application.onCreate()` 中调用 addPushListener 注册 `TIMPushListener`，并在 onNotificationClicked 中解析 `ext` 后跳转到业务页面。
 
@@ -966,155 +1506,11 @@ class App : Application() {
 }
 ```
 
-**验证**：点击通知后 `onNotificationClicked` 被调用，且 `ext` 内容与发送时设置的一致。如果回调未触发，请检查：控制台点击动作是否选择了「打开应用内指定界面」并保持默认填充值、监听器是否在 `Application.onCreate()` 中注册、发送消息时是否设置了 `ext`。
+**验证**：点击通知后 `onNotificationClicked` 被调用，且 `ext` 内容与发送时设置的一致。
 
 > **说明：**
 > 旧版本工程中可能仍使用 `TUICore.registerEvent` 回调或 `LocalBroadcastManager` 广播处理点击通知。这两种方式在当前版本仍可工作，但新接入用户建议优先使用 `addPushListener`。如需从旧方案迁移，删除旧的事件注册或广播注册代码，改为在 `Application.onCreate()` 中调用 `addPushListener` 即可，回调中获取到的 `ext` 内容与旧方案一致。
 >
 
-## 配置消息分类（可选）
-
-厂商离线通道通常有消息分类机制。消息分类会影响推送及时性、单设备每日接收数量、夜间展示、声音、横幅和厂商通道权限。
-
-> **注意：**
-> 只有 IM 聊天、订单、交易、账号变更等用户预期强、需要及时触达的消息，才建议申请或使用高优先级分类。营销、广告、活动、资讯类消息不应滥用高优分类，否则可能被厂商降级、限频或冻结权限。
->
-
-发送离线推送时，可以通过 `V2TIMOfflinePushInfo` 设置厂商消息分类。API 设置优先级通常高于腾讯云控制台证书默认配置。
-
-|**厂商**|**API**|**说明**|
-|---------|---------|---------|
-|小米|[`setAndroidXiaoMiChannelID(String channelID)`](https://im.sdk.qcloud.com/doc/zh-cn/classcom_1_1tencent_1_1imsdk_1_1v2_1_1V2TIMOfflinePushInfo.html#ac769aec48cdbc9a57416c5a79504617a)|设置小米渠道 `channelID`。|
-|华为|[`setAndroidHuaWeiCategory(String category)`](https://im.sdk.qcloud.com/doc/zh-cn/classcom_1_1tencent_1_1imsdk_1_1v2_1_1V2TIMOfflinePushInfo.html#ad9dea3cb382c0c1a3c1a63738697fc1f)|设置华为推送消息分类。|
-|OPPO（新规则）|[`setAndroidOPPOCategory(String category)`](https://im.sdk.qcloud.com/doc/zh-cn/classcom_1_1tencent_1_1imsdk_1_1v2_1_1V2TIMOfflinePushInfo.html#a6a62542254c53626b81ce24380b0a2fb)|设置 OPPO 新消息分类，例如 IM 消息使用 `IM`。|
-|OPPO（新规则）|[`setAndroidOPPONotifyLevel(int level)`](https://im.sdk.qcloud.com/doc/zh-cn/classcom_1_1tencent_1_1imsdk_1_1v2_1_1V2TIMOfflinePushInfo.html#a1fd2e7d168b5412fc263274842855c57)|设置 OPPO 通知栏消息提醒等级。使用前需要先设置 `category`；如需 `16`，需先向 OPPO 申请强提醒能力。|
-|OPPO（新规则）|[`setVendorParams(String vendorParams)`](https://im.sdk.qcloud.com/doc/zh-cn/classcom_1_1tencent_1_1imsdk_1_1v2_1_1V2TIMOfflinePushInfo.html#aedaa6ba7f49f3abfc04a8efaaf45e0c7)|携带 OPPO 私信模板 ID 和模板参数，字段说明请参见 [离线推送消息属性设置](https://cloud.tencent.com/document/product/269/121188)。|
-|OPPO（旧规则）|[`setAndroidOPPOChannelID(String channelID)`](https://im.sdk.qcloud.com/doc/zh-cn/classcom_1_1tencent_1_1imsdk_1_1v2_1_1V2TIMOfflinePushInfo.html#a32d340e95395bb64cc3e8f62321aafe1)|仅适用于此前已开通 OPPO 私信通道权限的存量应用，用于设置已创建并登记的私信通道 ID。|
-|vivo|[`setAndroidVIVOCategory(String category)`](https://im.sdk.qcloud.com/doc/zh-cn/classcom_1_1tencent_1_1imsdk_1_1v2_1_1V2TIMOfflinePushInfo.html#ae7341caa3c58aec949cf186cb25af591)|设置 vivo 推送消息类别。|
-|荣耀|[`setAndroidHonorImportance(String importance)`](https://im.sdk.qcloud.com/doc/zh-cn/classcom_1_1tencent_1_1imsdk_1_1v2_1_1V2TIMOfflinePushInfo.html#a3167229118ad659378b2066821935c79)|设置荣耀消息分类，`NORMAL` 表示服务通讯类消息，`LOW` 表示资讯营销类消息。|
-|魅族|[`setAndroidMeizuNotifyType(int type)`](https://im.sdk.qcloud.com/doc/zh-cn/classcom_1_1tencent_1_1imsdk_1_1v2_1_1V2TIMOfflinePushInfo.html#a7e26dd03042cad06c4e7352845079be0)|设置魅族消息分类，`0` 表示公信消息，`1` 表示私信消息。|
-|FCM|[`setAndroidFCMChannelID(String channelID)`](https://im.sdk.qcloud.com/doc/zh-cn/classcom_1_1tencent_1_1imsdk_1_1v2_1_1V2TIMOfflinePushInfo.html#a1e63514ec664a5f7bc8c6a5b09f0689e)|设置 FCM 通道 Android 8.0 及以上通知渠道 ID。|
-
-通用示例：
-``` java
-V2TIMOfflinePushInfo pushInfo = new V2TIMOfflinePushInfo();
-
-pushInfo.setAndroidXiaoMiChannelID("your_xiaomi_channel_id");
-pushInfo.setAndroidHuaWeiCategory("IM");
-pushInfo.setAndroidVIVOCategory("IM");
-pushInfo.setAndroidHonorImportance("NORMAL");
-pushInfo.setAndroidMeizuNotifyType(1);
-pushInfo.setAndroidFCMChannelID("your_fcm_channel_id");
-```
-
-### OPPO 新规则配置
-
-OPPO 新接入应用建议使用新消息分类规则。IM 聊天、音视频通话等需要及时触达的消息，通常使用 `category=IM`，并按 OPPO 要求申请通讯与服务不限量权益或私信模板。
-``` java
-V2TIMOfflinePushInfo pushInfo = new V2TIMOfflinePushInfo();
-
-// New OPPO message classification rule. Use IM for chat and call messages.
-pushInfo.setAndroidOPPOCategory("IM");
-
-// Optional. 1 = notification bar, 2 = notification bar + lock screen + sound + vibration.
-// Use 16 only after OPPO strong reminder capability is approved.
-pushInfo.setAndroidOPPONotifyLevel(2);
-```
-
-如需使用 OPPO 私信模板，可通过 [`V2TIMOfflinePushInfo.setVendorParams(String vendorParams)`](https://im.sdk.qcloud.com/doc/zh-cn/classcom_1_1tencent_1_1imsdk_1_1v2_1_1V2TIMOfflinePushInfo.html#aedaa6ba7f49f3abfc04a8efaaf45e0c7) 携带厂商扩展参数。根据腾讯云[离线推送消息属性设置](https://cloud.tencent.com/document/product/269/121188)文档，`vendorParams` 是 JSON 字符串，且 `oppoTitleParam`、`oppoContentParam` 等字段本身也需要序列化为 JSON 字符串。
-``` java
-Map<String, Object> vendorParams = new HashMap<>();
-vendorParams.put("oppoTemplateId", "OPPO 私信模板 ID");
-
-Map<String, Object> titleParams = new HashMap<>();
-titleParams.put("title", "推送标题");
-vendorParams.put("oppoTitleParam", new Gson().toJson(titleParams));
-
-Map<String, Object> contentParams = new HashMap<>();
-contentParams.put("desc", "推送内容");
-vendorParams.put("oppoContentParam", new Gson().toJson(contentParams));
-
-pushInfo.setVendorParams(new Gson().toJson(vendorParams));
-```
-
-`vendorParams` 扩展参数能力要求 IMSDK 8.7 及以上版本。`oppoTemplateId` 必须是 OPPO 私信申请得到的模板 ID，不支持开发者自拟。`oppoTitleParam` 和 `oppoContentParam` 中的 key 需要与 OPPO 模板中的占位符一致。
-
-### OPPO 旧规则配置
-
-旧规则仅适用于此前已开通 OPPO 私信通道权限的存量应用。如果应用仍按旧规则使用私信通道，请确保客户端创建的通道 ID 已在 OPPO 推送运营后台登记，并与发送离线推送时设置的 `channelID` 保持一致。
-``` java
-V2TIMOfflinePushInfo pushInfo = new V2TIMOfflinePushInfo();
-
-// Old OPPO private channel rule for existing apps only.
-pushInfo.setAndroidOPPOChannelID("your_oppo_private_channel_id");
-```
-
-新接入应用不要把 [`setAndroidOPPOChannelID`](https://im.sdk.qcloud.com/doc/zh-cn/classcom_1_1tencent_1_1imsdk_1_1v2_1_1V2TIMOfflinePushInfo.html#a32d340e95395bb64cc3e8f62321aafe1) 当作 OPPO 新消息分类的必配项。新规则优先使用 [`setAndroidOPPOCategory`](https://im.sdk.qcloud.com/doc/zh-cn/classcom_1_1tencent_1_1imsdk_1_1v2_1_1V2TIMOfflinePushInfo.html#a6a62542254c53626b81ce24380b0a2fb)，并按需配置 [`setVendorParams`](https://im.sdk.qcloud.com/doc/zh-cn/classcom_1_1tencent_1_1imsdk_1_1v2_1_1V2TIMOfflinePushInfo.html#aedaa6ba7f49f3abfc04a8efaaf45e0c7) 和 [`setAndroidOPPONotifyLevel`](https://im.sdk.qcloud.com/doc/zh-cn/classcom_1_1tencent_1_1imsdk_1_1v2_1_1V2TIMOfflinePushInfo.html#a1fd2e7d168b5412fc263274842855c57)。
-
-## 收不到推送排障流程
-
-如果发送测试消息后设备没有收到推送，请按以下流程逐步排查。每一步确认通过后再进入下一步，可以快速定位问题所在环节。
-
-#### 步骤1：确认 registerPush 是否成功
-
-检查 `registerPush` 回调结果：
-- `onSuccess` **触发**：注册成功，进入第二步。
-
-- `onError` **触发**：注册失败。查看错误日志中的三层错误码：
-
-- TIMPush 错误码（如 `800006`）：在 错误码 中查询。
-
-- 厂商原始异常（如 `6003: certificate fingerprint error`）：优先根据此信息排查厂商侧配置。
-
-- 常见原因：`timpush-configs.json` 缺失或位置错误、厂商证书未添加、包名或 SHA256 指纹不匹配、厂商配置文件未放置。
-
-#### 步骤2：确认控制台能查到设备
-
-在控制台 [排查工具](https://cloud.tencent.com/document/product/269/100629) 中输入 `registrationID` 或 `userID`：
-- **能查到设备且状态正常**：进入第三步。
-
-- **查不到设备**：`registerPush` 可能实际未成功，或使用了错误的标识。重新确认 `registrationID` / `userID` 值是否正确。
-
-#### 步骤3：确认 App 状态
-
-离线推送只在 App 处于后台或已杀进程时触发：
-- **App 在前台**：将 App 切到后台或杀掉进程，重新发送测试消息。
-
-- **App 已在后台**：进入第四步。
-
-#### 步骤4：确认通知权限和通知渠道
-- **Android 13 及以上**：确认 App 已获得通知权限（系统设置 > 应用 > 通知 > 允许通知）。
-
-- **Android 8.0 及以上**：确认目标通知渠道的横幅、锁屏、声音开关已打开（系统设置 > 应用 > 通知 > 通知类别）。
-
-- 通知总开关打开不代表所有 channel 都已开启；需要进入具体通知类别检查。
-
-#### 步骤5：确认厂商通道配置
-- 测试真机厂商是否与目标厂商通道一致（如不要在华为设备上测试荣耀配置）。
-
-- 厂商平台应用包名是否与 Android 工程 `applicationId` 完全一致。
-
-- 厂商证书是否已在腾讯云控制台添加且未过期。
-
-- 华为/荣耀：测试包签名（debug 或 release）的 SHA-256 必须已在厂商控制台「项目设置 > 常规 > SHA 证书指纹」中添加，指纹不一致会报 `6003: certificate fingerprint error`。
-
-#### 步骤6：确认消息分类和厂商限制
-- 是否超出厂商单日推送限额（例如 vivo 运营消息每日限制、小米公信消息限额）。
-
-- 是否在夜间发送（部分厂商运营消息夜间不下发）。
-
-- 是否未申请消息分类导致走默认策略被限频。
-
-- 推送服务是否到期（试用到期后自动停止服务）。
-
-#### 步骤7：确认通知展示问题
-
-如果收到了推送（有声音或状态栏图标）但没有横幅或锁屏展示：
-- 检查系统通知类别中的「横幅通知」和「锁屏通知」开关。
-
-- 确认通知渠道不是"静默通知"模式。
-
-- 部分厂商定制系统可能额外限制通知展示方式。
-
-#### 联系方式
+## 接入排查