@tencentcloud/sdk-mcp 1.6.7 → 1.7.0

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

@@ -1,8 +1,22 @@
+## 前提条件
+
+请确认已 开通 Push 服务 并完成 厂商配置，获取到了下列信息：
+
+|资源|获取位置|用途|
+|---------|---------|---------|
+|`SDKAppID`|腾讯云控制台 > 即时通信 IM > **推送服务 Push** > **概览**|调用 `registerPush`。创建 Push 应用后，腾讯云控制台会自动创建相同 `SDKAppID` 的 Chat 应用。|
+|Push Key|腾讯云控制台 > 即时通信 IM > **推送服务 Push** > **概览** > **客户端密钥**|独立 Push 场景下，作为 `registerPush` 的 `appKey` 参数。|
+|Chat Key|腾讯云控制台 > 即时通信 IM > **消息服务 Chat** > **概览** > **密钥**|Chat 登录使用。不要把 Chat Key 当作 `registerPush` 的 `appKey` 传入。|
+|Push 服务开通状态|腾讯云控制台 > 即时通信 IM > **推送服务 Push** > **概览**|创建 Push 应用不等于已开通 Push 服务，请确认 Push 服务已开通。|
+|TIMPush iOS `VERSION`|更新日志|`VERSION` 是 Podfile 中 TIMPush 依赖的版本号占位符，例如 `8.9.7537`、`8.8.7357`、`8.7.7201` 等，请以实际接入版本为准。|
+
+本文示例中的 `VERSION`、`SDKAppID`、`AppKey`、`businessID`、App Group ID 均为占位符，请勿在代码仓库中提交真实密钥。
+
 ## 操作步骤
 
 ### 步骤1：集成 TIMPush
 
-完成 [厂商配置](https://cloud.tencent.com/document/product/269/108856) 后，集成 SDK：
+集成 SDK：
 ``` java
 // 版本号 “VERSION” 请前往  中获取配置。
 // oh-package.json5 中配置集成包
@@ -15,13 +29,6 @@ dependencies: {
 ### 步骤2：注册推送
 
 调用接口推送注册成功后，就可以收到离线推送通知了。
-
-> **说明：**
->
-> 注册接口必填参数 SDKAppID 和客户端密钥 AppKey 的获取路径是 [IM 控制台 > 推送服务 Push > 概览](https://console.cloud.tencent.com/im/push-plugin-push-identifier)，如下图所示：
->
->
-
 ``` java
 import { TIMPushListener, TIMPushManager, TIMPushMessage } from '@tencentcloud/timpush';
 
@@ -43,14 +50,13 @@ TIMPushManager.getInstance()
 
 ### 步骤4：发送推送消息
 
-您可以在 [控制台 > 接入测试](https://console.cloud.tencent.com/im/push-plugin-push-check) 指定 `RegistrationID/userID` 进行离线推送测试。REST API 接口详细说明可参见：[REST API 接口 > 发起全员/标签推送](https://cloud.tencent.com/document/product/269/100634)。
+您可以在 [接入测试](https://console.cloud.tencent.com/im/push-plugin-push-check) 指定 `RegistrationID/userID` 进行离线推送测试。REST API 接口详细说明可参见：[全员/标签推送](https://cloud.tencent.com/document/product/269/100634)。
 
 ### 步骤5：解析离线推送消息
 
 收到推送消息后点击通知栏，组件会回调该点击事件和透传离线消息。
 
 > **注意：**
->
 > 1. 注册回调时机必须放在应用 [UIAbility](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/uiability-lifecycle) 的 onCreate() 函数中。
 > 2. 控制台配置点击后续动作按如下配置，选择**打开应用内指定界面**，请勿修改默认值。
 >
@@ -65,9 +71,4 @@ let pushListener: TIMPushListener = {
 TIMPushManager.getInstance().addPushListener(pushListener);
 ```
 
-恭喜您已经完成了推送插件的接入，需要提醒您：推送插件**试用或购买到期后，将自动停止提供推送服务（包括普通消息离线推送、全员/标签推送等服务）**。为避免影响您业务正常使用，请提前 [购买](https://buy.cloud.tencent.com/avc)/[续费](https://console.cloud.tencent.com/account/renewal)。
-
-> **说明：**
->
-> - 接入完成收不到推送，请先自助使用 [排查工具](https://cloud.tencent.com/document/product/269/100629) 查看下具体原因。推送指标数据查看，请使用 [数据统计](https://cloud.tencent.com/document/product/269/100628) 查询。
-> - 全员/标签推送功能请参见：[REST API 接口 - 发起全员/标签推送](https://cloud.tencent.com/document/product/269/100634)。
+恭喜您已经完成了推送插件的接入。如果接入完成收不到推送，请使用 [排查工具](https://cloud.tencent.com/document/product/269/100629) 查看具体原因。

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

@@ -18,10 +18,9 @@
 
 ## AI 集成
 
-通过 npm 安装 [@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 输入“集成 iOS 离线推送”“帮我集成 iOS 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 输入“集成 iOS 离线推送”“帮我集成 iOS TIMPush”等需求，AI 将根据项目类型引导你完成环境检测、厂商通道配置、凭据填写、代码接入和验证等步骤。
 
 > **注意：**
->
 > 使用 Push Skill AI 集成不是全自动流程，依然需要开发者在厂商配置控制台、腾讯云控制台等配置 Push 相关信息。具体的配置方法请参考下文相关章节。
 >
 
@@ -60,7 +59,6 @@ pod install
 如果无法安装 TIMPush 最新版本，可先执行 `pod repo update` 更新本地 CocoaPods 仓库列表后再 `pod install`。仓库更新可能耗时较长且影响依赖解析结果，建议在确认版本后执行。
 
 > **注意：**
->
 > 无论 Swift 还是 Objective-C 项目，都请集成 TXIMSDK_Plus_iOS_XCFramework。
 >
 
@@ -131,8 +129,10 @@ import TIMPush
 
 ### registerPush
 
-registerPush 用于注册当前设备的推送 token。注册成功后，后台才能根据 `registrationID` 或 `userID` 向该设备下发离线推送。其中 `appKey` 的取值会影响注册方式：
-- `appKey = Push Key`：注册 TIMPush 独立推送能力。Push Key 为腾讯云控制台 > 即时通信 IM > 推送服务 Push > 概览中的客户端密钥。
+registerPush 用于向 TIMPush 注册当前设备的推送 token。推送 token 是厂商通道返回的设备凭证，通常由 SDK 自动处理。注册成功后，TIMPush 会为当前设备建立一个推送目标标识 `registrationID`；服务端、控制台接入测试和排查工具可以使用该标识向这台设备下发离线推送。若 App 同时接入 IM 并完成登录，也可以使用 `userID` 向该用户已建立推送关系的设备下发离线推送。
+
+`appKey` 的取值会影响注册方式和可用的推送标识：
+- `appKey = Push Key`：注册 TIMPush 独立推送能力。Push Key 为腾讯云控制台 > 即时通信 IM > **推送服务 Push** > **概览**中的客户端密钥。
 
 - `appKey = nil`：复用 IM 登录态注册推送，必须在 IM `login` 成功后调用。
 
@@ -207,8 +207,13 @@ func loginIMAndRegisterPush() {
     let userID = "<#YOUR_USER_ID#>"
     let userSig = "<#YOUR_USER_SIG#>"
 
+    let initSuccess = V2TIMManager.sharedInstance().initSDK(sdkAppID, config: V2TIMSDKConfig())
+    if !initSuccess {
+        print(">>>>> IM SDK init failed")
+        return
+    }
+
     V2TIMManager.sharedInstance().login(userID: userID, userSig: userSig) {
-        // Swift 桥接下 appKey 类型为非可选 String，IM 登录场景传空字符串等同于 OC 接口传 nil。
         TIMPushManager.registerPush(sdkAppID, appKey: "", succ: { deviceToken in
             print(">>>>> TIMPush register success")
         }, fail: { code, desc in
@@ -231,6 +236,13 @@ func loginIMAndRegisterPush() {
     NSString *userID = @"<#YOUR_USER_ID#>";
     NSString *userSig = @"<#YOUR_USER_SIG#>";
 
+    V2TIMSDKConfig *config = [[V2TIMSDKConfig alloc] init];
+    BOOL initSuccess = [[V2TIMManager sharedInstance] initSDK:sdkAppID config:config];
+    if (!initSuccess) {
+        NSLog(@">>>>> IM SDK init failed");
+        return;
+    }
+
     [[V2TIMManager sharedInstance] login:userID userSig:userSig succ:^{
         [TIMPushManager registerPush:sdkAppID
                               appKey:nil
@@ -242,9 +254,14 @@ func loginIMAndRegisterPush() {
     } fail:^(int code, NSString *msg) {
         NSLog(@">>>>> IM login failed, code:%d, msg:%@", code, msg);
     }];
-}Objective-C
+}
 ```
 
+   > **警告：**
+   >
+   > 如果你的业务仅使用即时通信 IM 聊天能力，请勿在 IM 登录前先调用 `registerPush`。否则 SDK 可能会按独立推送场景注册 Push 类型账号，并产生对应的 Push DAU。Push DAU 超出套餐额度后，可能会产生额外费用。
+   >
+
    **验证**：
 
 1. `registerPush` 的 `onSuccess` 回调被触发。
@@ -258,7 +275,6 @@ func loginIMAndRegisterPush() {
 如需自定义推送标识（如使用业务侧用户 ID），可在 `registerPush` **前**调用 setRegistrationID。
 
 > **注意：**
->
 > 混用场景下，自定义 `registrationID` 必须与 IM 登录使用的 `userID` 完全一致，否则会产生账号互踢导致推送丢失。
 >
 
@@ -303,12 +319,10 @@ func loginIMAndRegisterPush() {
 
 ### 开启 `mutable-content`
 
-`mutable-content` 是 APNs payload 字段，由发送方在推送内容中设置。只有 payload 中开启 `mutable-content`，iOS 10 及以上系统才会在送达前调用 Notification Service Extension，触达统计才能生效。
-
-请确保通过以下任一方式开启 `mutable-content`：
-- **腾讯云控制台推送**：在控制台推送测试或发送页面，勾选 `mutable-content` 相关选项。
+`mutable-content` 是 APNs payload 字段，由发送方在推送内容中设置。只有 payload 中开启 `mutable-content`，iOS 10 及以上系统才会在送达前调用 Notification Service Extension，触达统计才能生效。请确保通过以下任一方式开启 `mutable-content`：
+- **腾讯云控制台推送**：在控制台页面，勾选 `mutable-content` 。页面路径：控制台 > 推送服务 Push > 推送设置 > 厂商配置 > iOS > 添加/编辑证书 > 开启 mutable-content。示例图如下：
 
-- **服务端 REST API**：在 APNs payload 中设置 `"mutable-content": 1`。
+- **服务端 REST API**：在 [ApnsInfo](https://cloud.tencent.com/document/product/269/128209#c4a6ae39-6bdc-439a-b769-0f4e92f6d539) 中设置 `"MutableContent": 1`。
 
 - **Chat SDK 发送**：以 Chat SDK 离线推送配置文档为准。
 
@@ -409,7 +423,6 @@ import ImSDK_Plus
 let pushInfo = V2TIMOfflinePushInfo()
 pushInfo.title = "推送标题"
 pushInfo.desc = "推送内容"
-pushInfo.ext = "{\"action\":\"open_chat\",\"conversationID\":\"c2c_userA\"}"
 
 let message = V2TIMManager.sharedInstance().createTextMessage("Hello TIMPush")
 
@@ -437,7 +450,6 @@ V2TIMManager.sharedInstance().sendMessage(
 V2TIMOfflinePushInfo *pushInfo = [[V2TIMOfflinePushInfo alloc] init];
 pushInfo.title = @"推送标题";
 pushInfo.desc = @"推送内容";
-pushInfo.ext = @"{\"action\":\"open_chat\",\"conversationID\":\"c2c_userA\"}";
 
 V2TIMMessage *message = [[V2TIMManager sharedInstance] createTextMessage:@"Hello TIMPush"];
 
@@ -457,7 +469,7 @@ V2TIMMessage *message = [[V2TIMManager sharedInstance] createTextMessage:@"Hello
 
 `sendMessage` 属于 IMSDK 消息发送能力。仅集成 TIMPush 的用户不需要为了验证离线推送而额外接入完整 Chat 初始化、登录和消息发送流程。
 
-   **验证**：App 置于后台后发送测试消息，设备能收到离线推送通知。如果手机通知栏开启权限，通知栏会弹出离线推送消息弹框。如果收不到，请参见下文「收不到推送排障流程」逐步排查。
+ **验证**：App 置于后台后发送测试消息，设备能收到离线推送通知。如果手机通知栏开启权限，通知栏会弹出离线推送消息弹框。如果收不到。
 
 ## 处理通知点击跳转
 
@@ -648,7 +660,7 @@ class AppDelegate: UIResponder, UIApplicationDelegate, TIMPushListener {
 @end
 ```
 
-**验证**：点击通知后 `onNotificationClicked` 被调用，且 `ext` 内容与发送时设置的一致。如果回调未触发，请检查：控制台点击动作是否选择了「打开应用内指定页面」、监听器是否在 `didFinishLaunchingWithOptions` 中注册、发送消息时是否设置了 `ext`。
+**验证**：点击通知后 `onNotificationClicked` 被调用，且 `ext` 内容与发送时设置的一致。如果回调未触发，请检查：控制台点击动作是否选择了**打开应用内指定页面**、监听器是否在 `didFinishLaunchingWithOptions` 中注册、发送消息时是否设置了 `ext`。
 
 ## 收不到推送排障流程
 
@@ -673,7 +685,7 @@ class AppDelegate: UIResponder, UIApplicationDelegate, TIMPushListener {
 ### 步骤3：确认控制台排查工具能查到 token
 
 在腾讯云控制台 **即时通信 IM > 推送服务 Push** 的排查工具中输入 `registrationID` 或 `userID`：
-- **能查到设备且 token 正常**：进入第四步。
+- **能查到设备且 token 正常**：进入步骤4。
 
 - **查不到设备 / 显示「没有上传成功 token」**：常见原因是 Chat 场景未在 Chat 登录成功后调用 `registerPush`，或调用顺序错误。请重新核对调用时机。
 

package/resource/knowledge/push/integration/react-native.md

@@ -1,10 +1,14 @@
 ### 效果展示
-| 小米 11 Pro | iPhone 13 | 三星 Galaxy A23 海外版（Google FCM 推送） |
-| --- | --- | --- |
+
+## 前提条件
+
+开始接入前，请先完成对应原生平台的推送前提配置：请参见 [iOS 前提条件](https://cloud.tencent.com/document/product/269/100627#.E5.89.8D.E6.8F.90.E6.9D.A1.E4.BB.B6) 和 [Android 前提条件](https://cloud.tencent.com/document/product/269/100626#.E5.89.8D.E6.8F.90.E6.9D.A1.E4.BB.B6)。
+
+## 操作步骤
 
 ### 步骤1：新建项目（可选）
 
-完成 [厂商配置](https://cloud.tencent.com/document/product/269/104004) 后，创建一个 React Native 项目，已有项目可忽略此步骤。
+完成各原生平台厂商配置后，创建一个 React Native 项目，已有项目可忽略此步骤。
 ``` bash
 npx @react-native-community/cli@latest init MyReactNativeApp --version 0.75.0
 ```
@@ -28,7 +32,6 @@ yarn add @tencentcloud/react-native-push
 复制下面的代码到 `App.tsx`，将 `SDKAppID` 和 `appKey` 替换为您在 [IM 控制台 > 推送服务 Push > 概览](https://console.cloud.tencent.com/im/push-plugin-push-identifier) 获取的应用的信息。
 
 > **说明：**
->
 > `registerPush` 注册推送服务成功后，您可通过 `getRegistrationID` 获取推送 ID 标识, 即 RegistrationID。您可以向指定的 RegistrationID 推送消息。
 >
 
@@ -77,20 +80,16 @@ if (Push) {
 ### 步骤4：配置厂商推送
 
 【Android】
-1. 请您完成控制台厂商推送信息填写后，从控制台下载 `timpush-configs.json` 文件，并添加到项目的 `MyReactNativeApp/android/app/src/main/assets` 目录下，如果该目录不存在，请手动创建。如图所示：
 
 2. 华为、荣耀、vivo、FCM。
 
 【FCM】
 
-您需要支持 FCM 推送时，须配置 `google-services.json` 文件到 `MyReactNativeApp/android/app` 目录下，如图所示：
-
 （**请注意：不是 "**`MyReactNativeApp/android/app/src/main/assets" 目录`）。
 
 【华为】
 
 【荣耀】
-1. 您需要支持荣耀推送时，须配置 `AppID` 到 `MyReactNativeApp/android/app/build.gradle` 文件中。如图所示：
 
 ``` bash
 ......
@@ -105,15 +104,10 @@ android {
 }
 ```
 
-|获取荣耀的 appID|配置荣耀的 appID|
-|---------|---------|
-|||
-
 2. 从[荣耀开发者管理中心](https://developer.honor.com/cn/)下载 `mcs-services.json` 文件，并配置到 `MyReactNativeApp/android/app` 目录下（**请注意！不是** `MyReactNativeApp/android/app/src/main/assets 目录`）。
 
 【vivo】
 
-您需要支持 vivo 推送时，须配置 `appID` 和 `appKey` 到 `MyReactNativeApp/android/app/build.gradle` 文件中。如图所示：
 ``` bash
 ......
 android {
@@ -128,12 +122,7 @@ android {
 }
 ```
 
-|获取 vivo 的 appID && appKey|配置 vivo 的 appID && appKey|
-|---------|---------|
-|||
-
 【iOS】
-1. 请将您在厂商配置步骤中, 获取到的 iOS APNs 推送证书，上传至 IM 控制台。IM 控制台会为您分配一个证书 ID，如图所示：
 
 2. 在 `MyReactNativeApp/ios/MyReactNativeApp` 目录下，新建 `Resources` 文件夹，并新建 `timpush-configs.json` 文件。编辑 `timpush-configs.json`，填入控制台获取的证书 ID，如下所示：
 
@@ -143,14 +132,11 @@ android {
 }
 ```
 
-3. Xcode 打开 MyReactNativeApp 项目，右键单击项目 > **Add Files to "MyReactNativeApp"**，将 `timpush-configs.json` 文件添加到工程。如图所示：
-
 ### 步骤5：**配置 Native Modules 和相关依赖**
 
 【Android】
 
 > **说明：**
->
 > 请确保 `timpush-configs.json` 文件内的包名和 `MyReactNativeApp/android/app/build.gradle` 文件内的 `applicationId` 值一致，不一致则会导致离线推送不可用。
 >
 
@@ -274,7 +260,7 @@ pod install
 # 如果无法安装最新版本，执行以下命令更新本地的 CocoaPods 仓库列表
 pod repo update
 ```
-3. 在 App 中启用推送通知功能。打开 Xcode 项目，在 **Project > Target > Capabilities** 页面选择并添加 **Push Notifications**。
+3. 在 App 中启用推送通知功能。参考 iOS 配置消息触达统计。
 
 ### 步骤6：运行
 
@@ -292,42 +278,6 @@ npm run ios
 
 ### 步骤7：消息推送触达统计
 
-如果您需要统计触达数据，请按照如下完成配置：
-
-【华为】
-
-回执地址：`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】
-
-|回调地址配置|回执 ID 配置到 IM 控制台|
-|---------|---------|
-|<br>回执地址：`https://api.im.qcloud.com/v3/offline_push_report/vivo`||
-
-【魅族】
-
-|打开回执开关|配置回执地址|
-|---------|---------|
-|||
-
-回执地址：`https://api.im.qcloud.com/v3/offline_push_report/meizu`
-
-> **说明：**
->
-> 打开回执开关后，请务必确保回执地址正确配置。不配置或者配置地址错误，都会影响推送功能。
->
-
-【iOS】
-
-iOS 端推送触达统计配置，详细请参见 [**统计推送抵达率**](https://cloud.tencent.com/document/product/269/100627#2412d9f3-8e82-4df6-baf9-2855aaaa0a2c)。
+如果你需要统计设备触达数据，请按照 华为/荣耀/vivo/魅族/iOS 步骤完成配置。其余支持厂商不需要配置，FCM 暂不支持推送统计功能。
 
-其余支持厂商不需要配置，FCM 暂不支持推送统计功能。
+如果接入完成收不到推送，请使用 [排查工具](https://cloud.tencent.com/document/product/269/100629) 查看具体原因。

package/resource/knowledge/push/integration/uni-app.md

@@ -12,10 +12,9 @@
 
 ## AI 集成
 
-通过 npm 安装 [@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 输入“集成 uniapp 离线推送”“帮我集成 uniapp 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 输入“集成 uniapp 离线推送”“帮我集成 uniapp TIMPush”等需求，AI 将根据项目类型引导你完成环境检测、厂商通道配置、凭据填写、代码接入和验证等步骤。
 
 > **注意：**
->
 > 使用 Push Skill AI 集成不是全自动流程，依然需要开发者在厂商配置控制台、腾讯云控制台等配置 Push 相关信息。具体的配置方法请参考下文相关章节。
 >
 
@@ -28,12 +27,9 @@
 
 2. 选择需要集成的工程并单击**确定**。
 
-3. 集成后效果如下图所示：
-
 ### 配置离线推送文件
 
 > **说明：**
->
 > - 推送配置文件统一放在与 `uni_modules` 平级的 `nativeResources` 目录下，若该目录不存在请手动新建。
 > - 建议将 HBuilderX 与 TencentCloud-Push 插件升级到最新版本，以规避旧版本（如 HBuilderX 4.36 之前）在 vivo/荣耀 等厂商通道上的兼容性问题。
 
@@ -42,8 +38,6 @@
 【Android】
 1. 新建 `nativeResources/android/assets` 目录。
 
-2. 配置 `timpush-configs.json`（在 [推送服务 Push > 推送设置 > 厂商配置](https://console.cloud.tencent.com/im/push-plugin-push-setting) 下载），到 `nativeResources/android/assets/` 目录下。如图所示：
-
 3. 按目标厂商配置华为、荣耀、vivo、FCM。
 
 【FCM】
@@ -63,19 +57,13 @@
 }
 ```
 
-2. 配置 `google-services.json` 文件到 `nativeResources/android/`目录下（注意！请勿配置到 `nativeResources/android/assets` 目录下）。如图所示：
-
 【华为】
 
 > **注意：**
->
 > **请勿配置**到 `nativeResources/android/assets` 目录下。
 >
 
-如图所示：
-
 【荣耀】
-1. 编辑 `uni_modules/TencentCloud-Push/utssdk/app-android/config.json` 的 `dependencies`，添加 `"com.tencent.timpush:honor:xxxx"`。如图所示：
 
 ``` bash
 {
@@ -87,8 +75,6 @@
 }
 ```
 
-2. 配置 `mcs-services.json` 文件到 `nativeResources/android`（在荣耀开发者服务平台下载，详见 荣耀厂商配置）目录下。如图所示：
-
 3. 配置 `appID` 到 `nativeResources/android/manifestPlaceholders.json` 中的 `"HONOR_APPID"`。
 
 ``` bash
@@ -98,7 +84,6 @@
 ```
 
 【vivo】
-1. 编辑 `uni_modules/TencentCloud-Push/utssdk/app-android/config.json` 的 `dependencies`，添加 `"com.tencent.timpush:vivo:xxxx"`。如图所示：
 
 ``` bash
 {
@@ -155,14 +140,11 @@
 |`userID`|与 Chat 登录打通的业务用户标识。希望后台直接向 Chat 登录 `userID` 推送（即接收 Chat 离线消息）时使用。|在 `registerPush` 前调用 `setRegistrationID(userID)` 绑定，绑定后 `registrationID` 即等于该 `userID`。|
 
 > **注意：**
->
 > - 仅使用 TIMPush（独立推送）：直接调用 `registerPush`，后台使用 `getRegistrationID` 返回的 `registrationID` 推送即可。
 > - 与 Chat 打通：在 `registerPush` 前调用 `setRegistrationID(userID)`，且 `userID` 必须与 Chat 登录使用的 `userID` 完全一致，否则会产生账号互踢导致推送丢失。
 
 ### 引入并注册推送服务
 
-将 `SDKAppID` 和 `appKey` 替换为您在 [IM 控制台 > 推送服务 Push > 概览](https://console.cloud.tencent.com/im/push-plugin-push-identifier) 获取的应用信息。如图所示：
-
 ``` javascript
 // 集成 TencentCloud-Push
 import { setRegistrationID, registerPush, getRegistrationID, EVENT, addPushListener } from '@/uni_modules/TencentCloud-Push';
@@ -223,14 +205,12 @@ setRegistrationID(userID, () => {
 ```
 
 > **注意：**
->
 > 混用场景下，自定义 `registrationID` 必须与 IM 登录使用的 `userID` 完全一致，否则会产生账号互踢导致推送丢失。
 >
 
 ## 生成自定义调试基座（Android、iOS）
 
 > **说明：**
->
 > Harmony 不需要自定义基座。
 >
 
@@ -249,7 +229,7 @@ setRegistrationID(userID, () => {
 
    在测试推送前，请务必打开通知和状态栏。进入 [推送服务 Push > 接入测试](https://console.cloud.tencent.com/im/push-plugin-push-check) 发送您的第一条推送。
 
-   **验证**：App 置于后台后发送测试消息，设备能收到离线推送通知。如果收不到，请参见下文「收不到推送排障流程」逐步排查。
+ **验证**：App 置于后台后发送测试消息，设备能收到离线推送通知。如果收不到。
 
 ## 处理通知点击跳转
 
@@ -325,7 +305,7 @@ addPushListener(EVENT.NOTIFICATION_CLICKED, (res) => {
 
 ## 推送结果回调
 
-开启推送服务后，推送结果可以通过配置基础回调的方式，将结果转发给 App 后台，详见：
+开启推送服务后，推送结果可以通过配置基础回调的方式，将结果转发给 App 后台，
 - [普通推送结果回调](https://cloud.tencent.com/document/product/269/102567)
 
 - [全员推送结果回调](https://cloud.tencent.com/document/product/269/102568)
@@ -346,7 +326,6 @@ addPushListener(EVENT.NOTIFICATION_CLICKED, (res) => {
 厂商离线通道通常有消息分类机制。消息分类会影响推送及时性、单设备每日接收数量、夜间展示、声音、横幅以及厂商通道权限。
 
 > **注意：**
->
 > 只有 IM 聊天、订单、交易、账号变更等用户预期强、需要及时触达的消息，才建议申请或使用高优先级分类。营销、广告、活动、资讯类消息不应滥用高优分类，否则可能被厂商降级、限频或冻结权限。
 >
 
@@ -365,7 +344,6 @@ addPushListener(EVENT.NOTIFICATION_CLICKED, (res) => {
 ## 厂商推送限制
 
 > **注意：**
->
 > 只有 IM 聊天、订单、交易、账号变更等用户预期强、需要及时触达的消息，才建议申请或使用高优先级分类。营销、广告、活动、资讯类消息不应滥用高优分类，否则可能被厂商降级、限频或冻结权限。
 >
 

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

@@ -1,8 +1,12 @@
+## 前提条件
+
+开始接入前，请先完成对应原生平台的推送前提配置：请参见 [iOS 前提条件](https://cloud.tencent.com/document/product/269/100627#.E5.89.8D.E6.8F.90.E6.9D.A1.E4.BB.B6) 和 [Android 前提条件](https://cloud.tencent.com/document/product/269/100626#.E5.89.8D.E6.8F.90.E6.9D.A1.E4.BB.B6)。
+
 ## 操作步骤
 
 ### 步骤1：集成消息推送插件
 
-完成 [厂商配置](https://cloud.tencent.com/document/product/269/123768) 后集成推送插件，需调整 `Packages/manifest.json` 文件，添加相关依赖：
+完成各原生平台厂商配置后集成推送插件，需调整 `Packages/manifest.json` 文件，添加相关依赖：
 ``` json
 {
   "dependencies": {
@@ -16,10 +20,6 @@
 
 【iOS】
 
-请将您在 厂商配置 步骤中，获取到的 iOS APNs 推送证书， 上传至 [IM 控制台](https://console.cloud.tencent.com/im/push-plugin-push-identifier)。
-
-IM 控制台会为您分配一个证书 ID，见下图：
-
 您需要在 `Assets/Plugins/iOS` 目录下创建文件 `UnityIMPush.mm`（若目录不存在，需要手动创建），并且在文件中实现 `businessID` 协议方法返回证书 ID 即可，可以参考如下实现：
 ``` objectivec
 #import "TPush/TPush.h"
@@ -54,7 +54,7 @@ IM 控制台会为您分配一个证书 ID，见下图：
 
 【Android】
 
-完成 [IM 控制台](https://console.cloud.tencent.com/im/push-plugin-push-identifier) 厂商推送信息填写后，下载并添加配置文件到工程。将下载的 `timpush-configs.json` 文件添加到项目的 `Assets/Plugins/Android` 目录下，如果该目录不存在，请手动创建。
+完成厂商配置后，下载并添加配置文件到工程。将下载的 `timpush-configs.json` 文件添加到项目的 `Assets/Plugins/Android` 目录下，如果该目录不存在，请手动创建。
 
 ### 步骤3: 客户端厂商配置
 
@@ -246,7 +246,6 @@ apply plugin: 'com.hihonor.mcs.asplugin'
 如果您需要自定义解析收到的远程推送，您可按照如下方法实现：
 
 > **注意：**
->
 > 1. 注册回调时机必须放在程序入口函数中。
 > 2. 控制台中**点击后续动作**的配置请按如下方式处理，选择**打开应用内指定界面，**请勿修改使用默认值。
 >
@@ -268,7 +267,6 @@ PushManager.AddPushListener(listener);
 调用 `PushManager.RegisterPush` 方法成功后，就可以收到离线推送通知了。
 
 > **注意：**
->
 > 如果您已经集成 IM 产品并在 IM 登录成功后调用该接口，请将 appKey 参数设置为 null，否则会将 IM 账号下线。
 >
 
@@ -282,73 +280,6 @@ PushManager.RegisterPush(sdkAppId: 您的sdkAppId, appKey: "客户端密钥", ne
 
 ### 步骤6: 消息推送触达统计
 
-如果您需要统计触达数据，请按照如下完成配置：
-
-【华为】
-
-回执地址：`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】
-
-|回调地址配置|回执 ID 配置到 IM 控制台|
-|---------|---------|
-|<br>回执地址：`https://api.im.qcloud.com/v3/offline_push_report/vivo`||
-
-【魅族】
-
-|打开回执开关|配置回执地址|
-|---------|---------|
-|||
-
-回执地址：`https://api.im.qcloud.com/v3/offline_push_report/meizu`
-
-> **注意：**
->
-> 打开回执开关后，请务必确保回执地址正确配置。不配置或者配置地址错误，都会影响推送功能。
->
-
-【iOS】
-
-iOS 端推送触达统计配置，请参见：
-  - 如果您需要统计推送的抵达和点击数据，您需要在 AppDelegate.m 文件中实现 `- applicationGroupID` 方法，这里可参考推送参数配置部分，返回 App Group ID （生成方式可参见 厂商配置-生成 App GroupID）。
-
-  - 在 [Notification Service Extension](https://github.com/TencentCloud/TIMSDK/blob/master/iOS/Demo/pushservice/NotificationService.m) 的 `-didReceiveNotificationRequest:withContentHandler:` 方法中调用推送抵达率统计函数:
-
-``` java
-@implementation NotificationService
-
-- (void)didReceiveNotificationRequest:(UNNotificationRequest *)request withContentHandler:(void (^)(UNNotificationContent * _Nonnull))contentHandler {
-    //appGroup 标识当前主 APP 和 Extension 之间共享的 APP Group，需要在主 APP 的 Capability 中配置 App Groups 能力。
-    //格式为group + [主bundleID]+ key
-    //如group.com.tencent.im.pushkey
-    NSString * appGroupID = kTIMPushAppGroupKey;
-    __weak typeof(self) weakSelf = self;
-    [TIMPushManager handleNotificationServiceRequest:request appGroupID:appGroupID callback:^(UNNotificationContent *content) {
-        weakSelf.bestAttemptContent = [content mutableCopy];
-        // Modify the notification content here...
-        // self.bestAttemptContent.title = [NSString stringWithFormat:@"%@ [modified]", self.bestAttemptContent.title];
-        weakSelf.contentHandler(weakSelf.bestAttemptContent);
-    }];
-}
-
-@end
-```
-
-      > **注意：**
-      >
-      > 1. 上报推送触达数据，需要开启 mutable-content 开关来支持 iOS 10 的 Extension 功能。
-      >
-      > 2. 数据详情可在推送数据页面查看，推送数据页面仅限 [购买推送插件](https://console.cloud.tencent.com/im/plugin/TIMPush)  后使用。
-
-其余支持厂商不需要配置，FCM 暂不支持推送统计功能。
+如果你需要统计设备触达数据，请按照 华为/荣耀/vivo/魅族/iOS 完成配置。其余支持厂商不需要配置，FCM 暂不支持推送统计功能。
 
-恭喜您已经完成了推送插件的接入，需要提醒您：推送插件**试用或购买到期后，将自动停止提供推送服务（包括普通消息离线推送、全员/标签推送等服务）**。为避免影响您业务正常使用，请提前[购买](https://buy.cloud.tencent.com/avc)/[续费](https://console.cloud.tencent.com/account/renewal)。
+接入完成收不到推送，请使用 [排查工具](https://cloud.tencent.com/document/product/269/100629) 查看具体原因。