@tencentcloud/sdk-mcp 1.7.2 → 1.7.4

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

@@ -12,23 +12,21 @@
 |证书 ID|腾讯云控制台上传 APNs 证书后生成|证书 ID 即 `businessID`，在 AppDelegate 中返回给 TIMPush。|
 |App Group ID|Apple Developer Center / **Xcode Capabilities**|仅在需要推送触达统计时使用。|
 |Push 服务开通状态|腾讯云控制台 > 即时通信 IM > **推送服务 Push** > **概览**|创建 Push 应用不等于已开通 Push 服务，请确认 Push 服务已开通。|
-|TIMPush iOS `VERSION`|[更新日志](https://cloud.tencent.com/document/product/269/114289)|`VERSION` 是 Podfile 中 TIMPush 依赖的版本号占位符，例如 `8.9.7537`、`8.8.7357`、`8.7.7201` 等，请以实际接入版本为准。|
+|TIMPush iOS `VERSION`|[更新日志](https://cloud.tencent.com/document/product/269/114289)|`VERSION` 是 Podfile 中 TIMPush 依赖的版本号占位符，例如 `8.9.7537`等，请以实际接入版本为准。|
 
 本文示例中的 `VERSION`、`SDKAppID`、`AppKey`、`businessID`、App Group ID 均为占位符，请勿在代码仓库中提交真实密钥。
 
 ## 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 将根据项目类型引导你完成环境检测、厂商通道配置、凭据填写、代码接入和验证等步骤。
+通过 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 离线推送”等需求，AI 将根据项目类型引导您完成环境检测、厂商通道配置、凭据填写、代码接入和验证等步骤。详情可参考 AI Coding。
 
-> **注意：**
-> 使用 Push Skill AI 集成不是全自动流程，依然需要开发者在厂商配置控制台、腾讯云控制台等配置 Push 相关信息。具体的配置方法请参考下文相关章节。
->
+## 手动集成
 
-## 集成 TIMPush
+### 步骤1：集成 TIMPush SDK
 
-如果你想手动集成，请按顺序完成下文配置。
+如果您想手动集成，请按顺序完成下文配置。
 
-### 主 App target 集成
+#### 在主 App target 中集成 TIMPush
 
 TIMPush 通过 CocoaPods 集成。请在 `Podfile` 中为主 App target 添加 TIMPush 依赖。Podfile 示例：
 ``` ruby
@@ -62,11 +60,9 @@ pod install
 > 无论 Swift 还是 Objective-C 项目，都请集成 TXIMSDK_Plus_iOS_XCFramework。
 >
 
-**验证**：`pod install` 输出 `Installing TIMPush (VERSION)`，工程内可以 `import TIMPush` / `#import <TIMPush/TIMPushManager.h>` 且编译通过。
-
-### 配置推送参数
+#### 配置推送参数
 
-#### 配置 `businessID`
+##### 配置 `businessID`
 
 `businessID` 是腾讯云控制台上传 APNs 证书后生成的证书 ID。TIMPush 通过该 ID 识别当前 App 使用控制台中的哪一份 iOS 推送证书。
 
@@ -95,9 +91,7 @@ import TIMPush
 }
 ```
 
-**验证**：在 `businessID` 方法内打 log，启动 App 后观察该方法是否被调用，且返回值与腾讯云控制台显示的证书 ID 一致。
-
-#### 配置 `applicationGroupID`（可选）
+##### 配置 `applicationGroupID`（可选）
 
 如果您需要统计推送触达率，需要配置 App Group ID 并实现 applicationGroupID() 方法 ，该 ID 应与您在厂商配置阶段准备的 App Group ID 保持一致。如果不需要推送触达统计，可以跳过本节。
 
@@ -125,11 +119,11 @@ import TIMPush
 
 **验证**：在 Apple Developer Center 和 Xcode 中确认主 App 与 Notification Service Extension 已绑定到同一个 App Group ID，且 AppDelegate 返回的 `group.<#YOUR_APP_GROUP_ID#>` 与之一致。
 
-## 注册推送
+### 步骤2：注册推送服务
 
-### 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 为腾讯云控制台 > 即时通信 IM > **推送服务 Push** > **概览**中的客户端密钥。
@@ -151,7 +145,7 @@ registerPush 用于向 TIMPush 注册当前设备的推送 token。推送 token
 
 【App 冷启动注册 TIMPush（appKey 传 Push Key）】
 
-App 冷启动、用户同意隐私政策后调用 `registerPush(appKey = Push Key)`。
+App 冷启动、用户同意隐私政策后调用 `registerPush(appKey = Push Key)`。建议在 `registerPush` 成功回调里调用 `getRegistrationID` 打印 `registrationID`，方便后续根据 `registrationID` 发送离线推送消息。
 
 【Swift】
 ``` swift
@@ -165,6 +159,10 @@ func registerTIMPush() {
 
     TIMPushManager.registerPush(sdkAppID, appKey: appKey, succ: { deviceToken in
         print(">>>>> TIMPush register success")
+        // 获取并打印出 registrationID，方便后续根据 registrationID 发送离线推送消息
+        TIMPushManager.getRegistrationID { registrationID in
+            print(">>>>> TIMPush registrationID: \(registrationID)")
+        }
     }, fail: { code, desc in
         print(">>>>> TIMPush register failed, code:\(code), desc:\(desc)")
     })
@@ -180,11 +178,14 @@ func registerTIMPush() {
     int sdkAppID = 0;
     // TODO: Replace @"<#YOUR_PUSH_KEY#>" with your Push Key.
     NSString *appKey = @"<#YOUR_PUSH_KEY#>";
-
     [TIMPushManager registerPush:sdkAppID
                           appKey:appKey
                             succ:^(NSData * _Nonnull deviceToken) {
         NSLog(@">>>>> TIMPush register success");
+        // 获取并打印出 registrationID，方便后续根据 registrationID 发送离线推送消息
+        [TIMPushManager getRegistrationID:^(NSString * _Nonnull registrationID) {
+            NSLog(@">>>>> TIMPush registrationID: %@", registrationID);
+        }];
     } fail:^(int code, NSString * _Nonnull desc) {
         NSLog(@">>>>> TIMPush register failed, code:%d, desc:%@", code, desc);
     }];
@@ -194,7 +195,7 @@ func registerTIMPush() {
 
 【IM 登录后注册推送（appKey 传 null）】
 
-请在 IM `login` 成功回调中调用 `registerPush(appKey = nil)`。
+请在 IM `login` 成功回调中调用 `registerPush(appKey = nil)`。建议在 `registerPush` 成功回调里调用 `getRegistrationID` 打印 `registrationID`，方便后续根据 `registrationID` 发送离线推送消息。
 
 【Swift】
 ``` swift
@@ -216,6 +217,10 @@ func loginIMAndRegisterPush() {
     V2TIMManager.sharedInstance().login(userID: userID, userSig: userSig) {
         TIMPushManager.registerPush(sdkAppID, appKey: "", succ: { deviceToken in
             print(">>>>> TIMPush register success")
+            // 获取并打印出 registrationID，方便后续根据 registrationID 发送离线推送消息
+            TIMPushManager.getRegistrationID { registrationID in
+                print(">>>>> TIMPush registrationID: \(registrationID)")
+            }
         }, fail: { code, desc in
             print(">>>>> TIMPush register failed, code:\(code), desc:\(desc)")
         })
@@ -248,6 +253,10 @@ func loginIMAndRegisterPush() {
                               appKey:nil
                                 succ:^(NSData * _Nonnull deviceToken) {
             NSLog(@">>>>> TIMPush register success");
+            // 获取并打印出 registrationID，方便后续根据 registrationID 发送离线推送消息
+            [TIMPushManager getRegistrationID:^(NSString * _Nonnull registrationID) {
+                NSLog(@">>>>> TIMPush registrationID: %@", registrationID);
+            }];
         } fail:^(int code, NSString * _Nonnull desc) {
             NSLog(@">>>>> TIMPush register failed, code:%d, desc:%@", code, desc);
         }];
@@ -259,7 +268,7 @@ func loginIMAndRegisterPush() {
 
    > **警告：**
    >
-   > 如果你的业务仅使用即时通信 IM 聊天能力，请勿在 IM 登录前先调用 `registerPush`。否则 SDK 可能会按独立推送场景注册 Push 类型账号，并产生对应的 Push DAU。Push DAU 超出套餐额度后，可能会产生额外费用。
+   > 如果您的业务仅使用即时通信 IM 聊天能力，请勿在 IM 登录前先调用 `registerPush`。否则 SDK 可能会按独立推送场景注册 Push 类型账号，并产生对应的 Push DAU。Push DAU 超出套餐额度后，可能会产生额外费用。
    >
 
    **验证**：
@@ -270,7 +279,7 @@ func loginIMAndRegisterPush() {
 
 3. 如触发 `onError`，可按 错误码 查询 `code` 含义。
 
-### 自定义 registrationID（可选）
+#### 自定义 registrationID（可选）
 
 如需自定义推送标识（如使用业务侧用户 ID），可在 `registerPush` **前**调用 setRegistrationID。
 
@@ -278,7 +287,7 @@ func loginIMAndRegisterPush() {
 > 混用场景下，自定义 `registrationID` 必须与 IM 登录使用的 `userID` 完全一致，否则会产生账号互踢导致推送丢失。
 >
 
-## 配置消息触达统计（可选）
+### 步骤3：配置消息触达统计（可选）
 
 仅当您需要统计推送触达率时，才需要完成本节配置；如果只需要接收普通离线推送，可跳过本节。
 
@@ -289,7 +298,7 @@ func loginIMAndRegisterPush() {
 
 3. 在 Extension 中调用 TIMPush 处理通知。
 
-### 创建并配置 Notification Service Extension target
+#### 创建并配置 Notification Service Extension target
 1. 在 Xcode 中选择 **File** > **New** > **Target**。
 
 2. 选择 **Notification Service Extension**。
@@ -317,7 +326,7 @@ func loginIMAndRegisterPush() {
    > Extension target 是独立 target，不能复用主 App target 的 Pod 依赖。若未在 Extension target 中添加 `TIMPush`，在 `NotificationService` 中 `import TIMPush` 或 `#import <TIMPush/TIMPushManager.h>` 会失败。
    >
 
-### 开启 `mutable-content`
+#### 开启 `mutable-content`
 
 `mutable-content` 是 APNs payload 字段，由发送方在推送内容中设置。只有 payload 中开启 `mutable-content`，iOS 10 及以上系统才会在送达前调用 Notification Service Extension，触达统计才能生效。请确保通过以下任一方式开启 `mutable-content`：
 - **腾讯云控制台推送**：在控制台页面，勾选 `mutable-content` 。页面路径：控制台 > 推送服务 Push > 推送设置 > 厂商配置 > iOS > 添加/编辑证书 > 开启 mutable-content。示例图如下：
@@ -326,7 +335,7 @@ func loginIMAndRegisterPush() {
 
 - **Chat SDK 发送**：以 Chat SDK 离线推送配置文档为准。
 
-### 在 Extension 中处理通知
+#### 在 Extension 中处理通知
 
 请将 `group.<#YOUR_APP_GROUP_ID#>` 替换为您在 Apple Developer Center 和 Xcode 中配置的 App Group ID。主 App 和 Extension 必须使用同一个 App Group ID。以下 Swift 写法基于 OC 接口自动桥接，参数命名可能随 SDK 版本调整，请以 SDK 头文件 `TIMPushManager.h` 为准。
 
@@ -389,9 +398,7 @@ class NotificationService: UNNotificationServiceExtension {
 @end
 ```
 
-**验证**：发送一条带 `mutable-content` 的测试推送，在 `didReceive` 内打断点或 log 确认 Extension 被调用；后续在腾讯云控制台触达统计页面应能看到上报数据。
-
-## 测试推送
+### 步骤4：测试推送链路
 
 完成上述集成步骤后，需要通过发送测试消息验证整体链路是否打通。发送消息前请确认：
 1. App 已获得系统通知权限；
@@ -469,19 +476,15 @@ V2TIMMessage *message = [[V2TIMManager sharedInstance] createTextMessage:@"Hello
 
 `sendMessage` 属于 IMSDK 消息发送能力。仅集成 TIMPush 的用户不需要为了验证离线推送而额外接入完整 Chat 初始化、登录和消息发送流程。
 
- **验证**：App 置于后台后发送测试消息，设备能收到离线推送通知。如果手机通知栏开启权限，通知栏会弹出离线推送消息弹框。如果收不到。
-
-## 处理通知点击跳转
+### 步骤5：处理通知点击跳转
 
 通知点击跳转需要三步配合完成：控制台配置点击动作、发送推送时携带跳转参数、客户端注册监听并解析参数。三步缺一则跳转不生效。
 
-### 配置控制台点击动作
+#### **配置控制台点击动作**
 
-在腾讯云控制台配置推送证书的「点击后续动作」，勾选「打开应用内指定页面」：
+在腾讯云控制台选择「打开应用内指定页面」。操作路径：腾讯云控制台 > 即时通信 IM > **推送服务 Push** > **推送设置** > **厂商配置** > **iOS** > **对应 APNs 证书** > **编辑** > 点击后续动作 > 打开应用内指定页面。
 
-操作路径：腾讯云控制台 > 即时通信 IM > **推送服务 Push** > **推送设置** > **厂商配置** > **iOS** > **对应 APNs 证书** > **编辑** > 点击后续动作 > 打开应用内指定页面。
-
-### 发送推送时携带 `ext`
+#### **发送推送时携带** `ext`
 
 发送离线推送时，通过 `ext` 字段携带跳转所需的业务信息（如目标页面、会话 ID 等）。`ext` 是一个字符串，结构由业务自定义，推荐使用 JSON 格式便于客户端解析。下文示例统一使用如下结构演示：
 ``` json
@@ -510,7 +513,7 @@ V2TIMMessage *message = [[V2TIMManager sharedInstance] createTextMessage:@"Hello
 
 通过 [`V2TIMOfflinePushInfo`](https://im.sdk.qcloud.com/doc/zh-cn/interfaceV2TIMOfflinePushInfo.html) 的 `ext` 属性携带跳转参数，再随消息一起发送。
 
-如果你接入了 TUIKit，TUIKit 内置的消息发送链路会自动用 `OfflinePushExtInfo` 组装 `ext`，无需手动设置。下方示例适用于自行调用 IM SDK 发送消息的场景。
+如果您接入了 TUIKit，TUIKit 内置的消息发送链路会自动用 `OfflinePushExtInfo` 组装 `ext`，无需手动设置。下方示例适用于自行调用 IM SDK 发送消息的场景。
 
 【Swift】
 ``` swift
@@ -565,7 +568,7 @@ V2TIMMessage *message = [[V2TIMManager sharedInstance] createTextMessage:@"Hello
 }];
 ```
 
-### 客户端注册监听并解析 `ext`
+#### **客户端注册监听并解析** `ext`
 
 请在 AppDelegate 中遵循 TIMPushListener 协议，在 `didFinishLaunchingWithOptions` 中调用 addPushListener 注册监听器，并在 onNotificationClicked 中解析 `ext` 后跳转到业务页面。
 
@@ -662,63 +665,5 @@ class AppDelegate: UIResponder, UIApplicationDelegate, TIMPushListener {
 
 **验证**：点击通知后 `onNotificationClicked` 被调用，且 `ext` 内容与发送时设置的一致。如果回调未触发，请检查：控制台点击动作是否选择了**打开应用内指定页面**、监听器是否在 `didFinishLaunchingWithOptions` 中注册、发送消息时是否设置了 `ext`。
 
-## 收不到推送排障流程
-
-如果发送测试消息后设备没有收到推送，请按以下流程逐步排查。每一步确认通过后再进入下一步，可以快速定位问题所在环节。不要只凭单条 APNs 配置成功日志判断接入成功；运行 App 后可过滤 `TIMPush` 关键字观察整体日志。
-
-### 步骤1：确认 APNs 权限和 Push Notifications 能力
-- App 是否已获得系统通知权限。
-
-- Xcode 主 App target 的 **Signing & Capabilities** 是否已开启 **Push Notifications**。
-
-- Apple Developer Center 对应 App ID 的 **Capabilities** 是否已勾选 **Push Notifications**。
-
-   通过后，进入第二步。
-
-### 步骤2：确认 `registerPush` 是否成功
-
-检查 `registerPush` 回调结果：
-- `succ` **已触发**：注册成功，进入第三步。
-
-- `fail` **触发**：注册失败。结合下文「错误码」表查询 `code` 含义，并按返回的 `desc` 排查 `SDKAppID`、`appKey` 取值（独立 Push 用 Push Key，Chat / TUIKit 用 `nil`）以及调用时机。
-
-### 步骤3：确认控制台排查工具能查到 token
-
-在腾讯云控制台 **即时通信 IM > 推送服务 Push** 的排查工具中输入 `registrationID` 或 `userID`：
-- **能查到设备且 token 正常**：进入步骤4。
-
-- **查不到设备 / 显示「没有上传成功 token」**：常见原因是 Chat 场景未在 Chat 登录成功后调用 `registerPush`，或调用顺序错误。请重新核对调用时机。
-
-### 步骤4：确认 `businessID` / Bundle ID / APNs 环境匹配
-
-控制台显示「不允许向该主题推送」或仅部分设备能收到推送时，通常是这一层出了问题：
-- Xcode 主 App target 的 Bundle Identifier 是否与 Apple App ID 一致。
-
-- 腾讯云控制台上传的 APNs 证书是否绑定同一个 Bundle ID。
-
-- AppDelegate 返回的 `businessID` 是否为该 Bundle ID 对应的证书 ID。
-
-- APNs 环境（开发 / 生产）是否与 App 安装包环境匹配。
-
-- p8 / p12 证书是否上传到正确应用。
-
-### 步骤5：确认 Chat / TUIKit 场景登录顺序
-
-仅 Chat / TUIKit 场景需要检查：
-- `registerPush` 是否在 Chat 登录成功回调（或 `TUILogin.login` 成功回调）之后调用。
-
-- `appKey` 参数是否传 `nil`，而不是 Push Key 或 Chat Key。
-
-- 自定义 `registrationID` 是否与 Chat 登录使用的 `userID` 完全一致（不一致会产生账号互踢）。
-
-### 步骤6：确认测试消息发送目标和设备状态
-- 测试消息发送给的 `registrationID` 或 `userID` 是否与 `getRegistrationID:` 返回值一致。
-
-- App 是否处于后台或已杀进程（前台时离线推送可能不触发）。
-
-- 设备是否处于可接收通知状态（勿扰模式、通知权限等）。
-
-- 推送服务是否到期（试用到期后自动停止服务）。
-
-### 仍无法解决
+## 接入排查
 

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

@@ -278,6 +278,7 @@ npm run ios
 
 ### 步骤7：消息推送触达统计
 
-如果你需要统计设备触达数据，请按照 华为/荣耀/vivo/魅族/iOS 步骤完成配置。其余支持厂商不需要配置，FCM 暂不支持推送统计功能。
+如果您需要统计设备触达数据，请按照 华为/荣耀/vivo/魅族/iOS 步骤完成配置。其余支持厂商不需要配置，FCM 暂不支持推送统计功能。
+
+## 接入排查
 
-如果接入完成收不到推送，请使用 [排查工具](https://cloud.tencent.com/document/product/269/100629) 查看具体原因。

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

@@ -12,22 +12,20 @@
 
 ## 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 将根据项目类型引导你完成环境检测、厂商通道配置、凭据填写、代码接入和验证等步骤。
+通过 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 离线推送”等需求，AI 将根据项目类型引导您完成环境检测、厂商通道配置、凭据填写、代码接入和验证等步骤。详情可参考 AI Coding。
 
-> **注意：**
-> 使用 Push Skill AI 集成不是全自动流程，依然需要开发者在厂商配置控制台、腾讯云控制台等配置 Push 相关信息。具体的配置方法请参考下文相关章节。
->
+## 手动集成
 
-## 集成 TencentCloud-Push
+### 步骤1：集成 TencentCloud-Push
 
-如果你想手动集成，请按下述步骤依次完成下载插件并导入 HBuilderX、配置离线推送文件。
+如果您想手动集成，请按下述步骤依次完成下载插件并导入 HBuilderX、配置离线推送文件。
 
-### 下载插件并导入 HBuilderX
+#### 下载插件并导入 HBuilderX
 1. 完成上述「前提条件」中目标平台的厂商配置后，打开 [uni-app 腾讯云推送服务（Push）](https://ext.dcloud.net.cn/plugin)，单击**下载插件并导入 HBuilderX**，将插件导入 HBuilderX 工程中。
 
 2. 选择需要集成的工程并单击**确定**。
 
-### 配置离线推送文件
+#### 配置离线推送文件
 
 > **说明：**
 > - 推送配置文件统一放在与 `uni_modules` 平级的 `nativeResources` 目录下，若该目录不存在请手动新建。
@@ -128,7 +126,7 @@
 }
 ```
 
-## 注册推送
+### 步骤2：注册推送服务
 
 完成插件导入和离线推送文件配置后，在 App 启动、用户同意隐私政策后调用 `registerPush` 注册推送服务，并按需注册通知点击、在线推送等监听。
 
@@ -143,7 +141,7 @@
 > - 仅使用 TIMPush（独立推送）：直接调用 `registerPush`，后台使用 `getRegistrationID` 返回的 `registrationID` 推送即可。
 > - 与 Chat 打通：在 `registerPush` 前调用 `setRegistrationID(userID)`，且 `userID` 必须与 Chat 登录使用的 `userID` 完全一致，否则会产生账号互踢导致推送丢失。
 
-### 引入并注册推送服务
+#### 引入并注册推送服务
 
 ``` javascript
 // 集成 TencentCloud-Push
@@ -187,7 +185,7 @@ addPushListener(EVENT.MESSAGE_REVOKED, (res) => {
 
 **验证**：`registerPush` 成功回调被触发；登录 [IM 控制台 > 推送服务 Push 排查工具](https://cloud.tencent.com/document/product/269/100629)，输入 `userID` 或 `registrationID`，确认 token 已上传。如触发失败回调，可按 错误码 查询 `errCode` 含义。
 
-### 自定义 registrationID（可选）
+#### 自定义 registrationID（可选）
 
 如需自定义推送标识（如使用业务侧用户 ID），可在 `registerPush` 前调用 `setRegistrationID`。
 ``` javascript
@@ -208,7 +206,7 @@ setRegistrationID(userID, () => {
 > 混用场景下，自定义 `registrationID` 必须与 IM 登录使用的 `userID` 完全一致，否则会产生账号互踢导致推送丢失。
 >
 
-## 生成自定义调试基座（Android、iOS）
+### 步骤3：生成自定义调试基座（Android、iOS）
 
 > **说明：**
 > Harmony 不需要自定义基座。
@@ -218,7 +216,7 @@ setRegistrationID(userID, () => {
 
 **验证**：自定义基座制作成功，可在目标厂商真机上正常安装并运行 App，无崩溃。如启动崩溃，请检查 `config.json` 依赖/插件配置、厂商配置文件位置是否正确。
 
-## 测试推送
+### 步骤4：测试推送链路
 
 完成上述集成步骤后，需要通过发送测试消息验证链路是否打通。发送消息前请确认：
 1. Android 13 及以上已允许通知权限；
@@ -231,17 +229,17 @@ setRegistrationID(userID, () => {
 
  **验证**：App 置于后台后发送测试消息，设备能收到离线推送通知。如果收不到。
 
-## 处理通知点击跳转
+### 步骤5：处理通知点击跳转
 
 通知点击跳转需要三步配合完成：控制台配置点击动作、发送推送时携带跳转参数、客户端注册监听并解析参数。三步缺一则跳转不生效。
 
-### 配置控制台点击动作
+#### 配置控制台点击动作
 
 在 IM 控制台配置推送证书的「点击后续动作」，勾选「打开应用内指定界面」：
 
 操作路径：IM 控制台 > **推送服务 Push** > **推送设置** > **对应厂商证书** > **编辑** > 点击后续动作，选择**打开应用内指定界面**，并保持默认填充值不修改。
 
-### 发送推送时携带 ext
+#### 发送推送时携带 ext
 
 发送离线推送时，通过 `ext` 字段携带跳转所需的业务信息（如目标页面、会话 ID 等）。`ext` 是一个字符串，结构由业务自定义，推荐使用 JSON 格式便于客户端解析。下文示例统一使用如下结构演示：
 ``` json
@@ -268,7 +266,7 @@ setRegistrationID(userID, () => {
 }
 ```
 
-### 客户端注册监听并解析 ext
+#### 客户端注册监听并解析 ext
 
 在 App 启动时调用 `addPushListener` 注册 `EVENT.NOTIFICATION_CLICKED` 事件，回调中的 `res` 为发送端通过 `ext` 携带的推送扩展信息。解析后即可跳转到业务页面。以下示例只演示解析核心逻辑，跳转部分用 `TODO` 占位，请按自身业务补充：
 ``` javascript
@@ -303,25 +301,7 @@ addPushListener(EVENT.NOTIFICATION_CLICKED, (res) => {
 
 **验证**：点击通知后 `EVENT.NOTIFICATION_CLICKED` 回调被调用，且 `res` 内容与发送时设置的 `ext` 一致。如果回调未触发，请检查：控制台点击动作是否选择了「打开应用内指定界面」并保持默认填充值、监听器是否在 App 启动时注册、发送消息时是否设置了 `ext`。
 
-## 推送结果回调
-
-开启推送服务后，推送结果可以通过配置基础回调的方式，将结果转发给 App 后台，
-- [普通推送结果回调](https://cloud.tencent.com/document/product/269/102567)
-
-- [全员推送结果回调](https://cloud.tencent.com/document/product/269/102568)
-
-## 设备通知栏设置
-
-推送的直观表现就是通知栏提示，所以同其他通知一样受设备通知相关设置的影响，以华为为例：
-- “手机设置 > 通知 > 锁屏通知 > 隐藏或者不显示通知”，会影响锁屏状态下推送通知显示。
-
-- “手机设置 > 通知 > 更多通知设置 > 状态栏显示通知图标”，会影响状态栏下推送通知的图标显示。
-
-- “手机设置 > 通知 > 应用的通知管理 > 允许通知”，打开关闭会直接影响推送通知显示。
-
-- “手机设置 > 通知 > 应用的通知管理 > 通知铃声” 和 “手机设置 > 通知 > 应用的通知管理 > 静默通知”，会影响推送通知铃声的效果。
-
-## 配置消息分类（可选）
+### 步骤6：配置消息分类
 
 厂商离线通道通常有消息分类机制。消息分类会影响推送及时性、单设备每日接收数量、夜间展示、声音、横幅以及厂商通道权限。
 
@@ -341,15 +321,9 @@ addPushListener(EVENT.NOTIFICATION_CLICKED, (res) => {
 |魅族|区分公信消息与私信消息。|
 |FCM|通过通道 `channelID` 设置 Android 8.0 及以上通知渠道。|
 
-## 厂商推送限制
-
-> **注意：**
-> 只有 IM 聊天、订单、交易、账号变更等用户预期强、需要及时触达的消息，才建议申请或使用高优先级分类。营销、广告、活动、资讯类消息不应滥用高优分类，否则可能被厂商降级、限频或冻结权限。
->
-
-- 国内厂商都有消息分类机制，不同类型也会有不同的推送策略。如果想要推送及时可靠，需要按照厂商规则设置自己应用的推送类型为高优先级的系统消息类型或者重要消息类型。反之，推送消息会受厂商推送消息分类影响，与预期会有差异。
+### 步骤7：检查厂商推送限制
 
-- 另外，一些厂商对于应用每天的推送数量也是有限制的，可以在厂商控制台查看应用每日限制的推送数量。如果推送消息出现推送不及时或者偶尔收不到情况，需要考虑下这里：
+一些厂商对于应用每天的推送数量也是有限制的，可以在厂商控制台查看应用每日限制的推送数量。如果推送消息出现推送不及时或者偶尔收不到情况，需要检查这里：
 
 【华为】
 
@@ -378,75 +352,23 @@ addPushListener(EVENT.NOTIFICATION_CLICKED, (res) => {
 
 推送上行消息频率有限制。具体请参见 [厂商描述](https://firebase.google.com/docs/cloud-messaging/scale-fcm)。
 
-## 收不到推送排障流程
-
-如果发送测试消息后设备没有收到推送，请按以下流程逐步排查。每一步确认通过后再进入下一步，可以快速定位问题所在环节。
-
-#### 步骤1：确认 registerPush 是否成功
-
-检查 `registerPush` 回调结果：
-- **成功回调触发**：注册成功，进入第二步。
-
-- **失败回调触发**：注册失败。查看 `errCode`、`errMsg`：
-
-- 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：确认基座与打包配置
-- 是否使用云端证书制作了自定义基座，并在自定义基座上运行（标准基座不包含厂商推送通道）。
-
-- `config.json` 中的 `dependencies` / `plugins` 是否按目标厂商正确配置。
-
-#### 步骤6：确认厂商通道配置
-- 测试真机厂商是否与目标厂商通道一致（如不要在华为设备上测试荣耀配置）。
-
-- 厂商平台应用包名是否与 uni-app 工程包名完全一致。
-
-- 厂商证书是否已在 IM 控制台添加且未过期。
-
-- 华为/荣耀：测试包签名的 SHA-256 必须已在厂商控制台「项目设置 > 常规 > SHA 证书指纹」中添加，指纹不一致会报 `6003: certificate fingerprint error`。
-
-#### 步骤7：确认消息分类和厂商限制
-- 是否超出厂商单日推送限额（如 vivo 运营消息每日限制、小米普通消息限额）。
+## 推送结果回调
 
-- 是否在夜间发送（部分厂商运营消息夜间不下发）。
+开启推送服务后，推送结果可以通过配置基础回调的方式，将结果转发给 App 后台，
+- [普通推送结果回调](https://cloud.tencent.com/document/product/269/102567)
 
-- 是否未申请消息分类导致走默认策略被限频。
+- [全员推送结果回调](https://cloud.tencent.com/document/product/269/102568)
 
-- 推送服务是否到期（试用到期后自动停止服务）。
+## 设备通知栏设置
 
-#### 步骤8：确认通知展示问题
+推送的直观表现就是通知栏提示，所以同其他通知一样受设备通知相关设置的影响，以华为为例：
+- “手机设置 > 通知 > 锁屏通知 > 隐藏或者不显示通知”，会影响锁屏状态下推送通知显示。
 
-如果收到了推送（有声音或状态栏图标）但没有横幅或锁屏展示：
-- 检查系统通知类别中的「横幅通知」和「锁屏通知」开关。
+- “手机设置 > 通知 > 更多通知设置 > 状态栏显示通知图标”，会影响状态栏下推送通知的图标显示。
 
-- 确认通知渠道不是“静默通知”模式。
+- “手机设置 > 通知 > 应用的通知管理 > 允许通知”，打开关闭会直接影响推送通知显示。
 
-- 部分厂商定制系统可能额外限制通知展示方式。
+- “手机设置 > 通知 > 应用的通知管理 > 通知铃声” 和 “手机设置 > 通知 > 应用的通知管理 > 静默通知”，会影响推送通知铃声的效果。
 
-#### 仍无法解决
+## 接入排查
 

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

@@ -280,6 +280,7 @@ PushManager.RegisterPush(sdkAppId: 您的sdkAppId, appKey: "客户端密钥", ne
 
 ### 步骤6：消息推送触达统计
 
-如果你需要统计设备触达数据，请按照 华为/荣耀/vivo/魅族/iOS 完成配置。其余支持厂商不需要配置，FCM 暂不支持推送统计功能。
+如果您需要统计设备触达数据，请按照 华为/荣耀/vivo/魅族/iOS 完成配置。其余支持厂商不需要配置，FCM 暂不支持推送统计功能。
+
+## 接入排查
 
-接入完成收不到推送，请使用 [排查工具](https://cloud.tencent.com/document/product/269/100629) 查看具体原因。

package/resource/knowledge/push/integration/unreal-engine.md

@@ -258,9 +258,9 @@ PushManager::GetInstance()->RegisterPush(您的 sdkAppId, "您的 appKey", callb
 ```
 
 ### 步骤6：消息推送触达统计
-- 如果你需要统计 Android 设备触达数据，请按照 华为/荣耀/vivo/魅族 配置。
+- 如果您需要统计 Android 设备触达数据，请按照 华为/荣耀/vivo/魅族 配置。
 
-- 如果你需要统计 iOS 设备触达数据，
+- 如果您需要统计 iOS 设备触达数据，
 
   1. 在上文的推送参数配置章节中，将“YourGroupID”修改为自己的 App Group ID。
 
@@ -291,4 +291,5 @@ PushManager::GetInstance()->RegisterPush(您的 sdkAppId, "您的 appKey", callb
       ```
 - 其余支持厂商不需要配置，FCM 暂不支持推送统计功能。
 
-   如果接入完成却收不到推送，请使用 [排查工具](https://cloud.tencent.com/document/product/269/100629) 查看具体原因。
+## 接入排查
+

package/resource/knowledge/roomkit/best-practice/vue/screen-share-auto-stop-on-leave.md

@@ -0,0 +1,62 @@
+---
+title: TUIRoomKit Vue3 离开房间/结束会议时屏幕分享是否自动停止
+product: room
+frameworks: [vue, web]
+scope: platform_specific
+tags: [TUIRoomKit, 屏幕分享, stopScreenShare, startScreenShare, leaveRoom, endRoom, 离开房间, 结束会议, 关闭浏览器, useDeviceState, useRoomState, screenStatus, vue3, Atomicx]
+version_range: ">=2.0.0"
+---
+
+# TUIRoomKit Vue3 离开房间/结束会议时屏幕分享是否自动停止
+
+## 1. 核心结论
+
+- 用户离开房间（`leaveRoom`）、结束会议（`endRoom`）、以及关闭浏览器 / 关闭网页等退出房间的操作，都会自动结束当前的屏幕分享，无需业务侧再手动调用 `stopScreenShare`。
+- 屏幕分享是房间会话的一部分：退出房间即释放该用户的共享通道，屏幕分享随之停止。
+- 无需为「退房时清理屏幕分享」编写额外收尾代码；仅在**会中主动关闭**屏幕分享（不退房）时，才需要显式调用 `stopScreenShare`。
+- 该行为对无 UI 集成（`tuikit-atomicx-vue3`）与含 UI 集成（`@tencentcloud/roomkit-web-vue3`）一致。
+
+## 2. 字段语义对照
+
+| 字段/能力 | 作用 | 说明 |
+|---|---|---|
+| `startScreenShare` | 开启屏幕分享 | `useDeviceState()` 提供，开启后共享给房间内其他成员 |
+| `stopScreenShare` | 停止屏幕分享 | 仅在**会中主动停止且不退房**时需要显式调用 |
+| `screenStatus` | 屏幕分享状态 | `useDeviceState()` 提供，`DeviceStatus.On` 表示分享中 |
+| `leaveRoom` | 离开房间 | 成员退出房间；会自动结束该成员的屏幕分享 |
+| `endRoom` | 结束会议 | 房主解散房间；会自动结束屏幕分享 |
+| 关闭浏览器/网页 | 异常/正常退出 | 断开房间会话，屏幕分享随之结束 |
+
+## 3. 机制/时序
+
+用户在会中开启屏幕分享（`startScreenShare`，`screenStatus = On`） -> 触发退出房间的动作（`leaveRoom` / `endRoom` / 关闭浏览器或网页） -> 房间会话断开、该用户的共享通道被释放 -> 屏幕分享自动停止，房间内其他成员不再看到该共享画面。
+
+## 4. 标准用法
+
+1. 会中开启屏幕分享：调用 `useDeviceState()` 的 `startScreenShare`。
+2. 需要在**不退房**的前提下停止分享时：显式调用 `stopScreenShare`。
+3. 用户离开房间时：调用 `leaveRoom`（或房主 `endRoom`）即可，屏幕分享会自动结束，不必先调用 `stopScreenShare`。
+4. 关闭浏览器 / 关闭网页等退出场景：无需额外处理，屏幕分享随房间会话断开而自动结束。
+
+## 5. 结果判定
+
+- 调用 `leaveRoom` / `endRoom` 后，该用户的屏幕分享停止，房间内其他成员的共享画面消失。
+- 关闭浏览器或网页后，房间内其他成员不再收到该用户的屏幕共享流。
+- 会中未退房、仅调用 `stopScreenShare` 时，屏幕分享停止而用户仍留在房间内。
+
+## 6. 常见误区
+
+- 误区 1：认为退房前必须先手动调用 `stopScreenShare`，否则屏幕分享会残留（退房会自动结束分享）。
+- 误区 2：认为关闭浏览器/网页后屏幕分享仍在继续（房间会话断开后分享即结束）。
+- 误区 3：把 `leaveRoom`/`endRoom` 与 `stopScreenShare` 的职责混为一谈（前者退房并自动清理，后者仅停分享、不退房）。
+
+## 7. 问题定义（检索辅助，极简）
+
+TUIRoomKit Vue3 中，用户 `leaveRoom`/`endRoom` 或关闭浏览器网页时，屏幕分享是否会自动停止。
+
+## 8. 同义问法覆盖（检索召回，极简）
+
+- leaveRoom / endRoom 时会自动 stopScreenShare 吗？
+- 离开房间后屏幕分享还会继续吗？
+- 关闭浏览器网页后屏幕共享会自动结束吗？
+- 退房前需要手动停止屏幕分享吗？