@tencentcloud/sdk-mcp 1.7.3 → 1.7.4

package/resource/knowledge/livekit/preset/live/vue/features/live-view.md

@@ -46,7 +46,6 @@ LiveView 提供以下插槽，用于自定义视频流上层的 UI 内容。
   </template>
 </LiveView>
 
-<style scoped>.watermark-container{position:absolute;inset:0;overflow:hidden;pointer-events:none;user-select:none}.watermark-grid{position:absolute;top:-50%;left:-50%;width:200%;height:200%;display:flex;flex-wrap:wrap;align-content:center;justify-content:center;gap:60px 80px;transform:rotate(-30deg)}.watermark-item{color:rgba(255,255,255,.15);font-size:18px;font-weight:700;letter-spacing:2px;white-space:nowrap}</style>
 ```
 
 ##### 自定义刷新 Loading 示例
@@ -81,7 +80,6 @@ async function handleRefresh() {
 }
 </script>
 
-<style scoped>.refresh-overlay{display:flex;flex-direction:column;align-items:center;gap:12px;pointer-events:none}.refresh-logo{width:40px;height:40px;object-fit:contain}.refresh-spinner{width:32px;height:32px;border:3px solid rgba(255,255,255,.2);border-top-color:#fff;border-radius:50%;animation:spin 1s linear infinite}@keyframes spin{to{transform:rotate(360deg)}}.refresh-text{color:rgba(255,255,255,.8);font-size:14px}.watermark{color:rgba(255,255,255,.3);font-size:24px;font-weight:700;letter-spacing:2px;pointer-events:none;user-select:none;text-shadow:0 2px 8px rgba(0,0,0,.3)}</style>
 ```
 
 #### streamViewUI 插槽
@@ -109,7 +107,6 @@ const handleApplyForSeat = (seatIndex: number) => {
 };
 </script>
 
-<style scoped>.custom-stream-ui{position:absolute;bottom:0;left:0;right:0;padding:8px 12px;background:linear-gradient(transparent,rgba(0,0,0,.6));pointer-events:none}.custom-stream-ui .user-name{color:#fff;font-size:14px;font-weight:500}</style>
 ```
 
 ##### 自定义连麦 UI 示例
@@ -174,7 +171,6 @@ const isCameraOn = (userInfo: SeatUserInfo) => {
 };
 </script>
 
-<style scoped>.stream-overlay{position:absolute;top:0;left:0;width:100%;height:100%;pointer-events:none;box-sizing:border-box;border-radius:6px;overflow:hidden}.top-bar{position:absolute;top:6px;left:6px;z-index:2}.role-badge{display:inline-flex;align-items:center;gap:4px;padding:2px 8px;border-radius:10px;font-size:10px;font-weight:500;line-height:16px;background:rgba(0,0,0,.45);backdrop-filter:blur(6px);-webkit-backdrop-filter:blur(6px);color:rgba(255,255,255,.85)}.anchor-badge{background:linear-gradient(135deg,#ff6b35,#e8461e);color:#fff}.badge-dot{width:5px;height:5px;border-radius:50%;background:currentColor;flex-shrink:0}.anchor-badge .badge-dot{background:#fff;animation:pulse-dot 2s ease-in-out infinite}@keyframes pulse-dot{0%,100%{opacity:1}50%{opacity:.4}}.bottom-bar{position:absolute;bottom:0;left:0;right:0;z-index:2;display:flex;align-items:flex-end;justify-content:space-between;padding:28px 8px 6px;background:linear-gradient(to top,rgba(0,0,0,.6) 0%,rgba(0,0,0,.2) 50%,transparent 100%)}.user-info{flex:1;min-width:0}.user-name-text{display:block;color:#fff;font-size:11px;font-weight:500;line-height:16px;text-shadow:0 1px 3px rgba(0,0,0,.7);overflow:hidden;text-overflow:ellipsis;white-space:nowrap}.device-icons{display:flex;align-items:center;gap:3px;flex-shrink:0;margin-left:6px}.icon-wrapper{position:relative;width:16px;height:16px;color:rgba(255,255,255,.9);transition:color .2s ease}.icon-wrapper.off{color:rgba(255,255,255,.3)}.icon-wrapper svg{position:absolute;top:0;left:0;width:100%;height:100%}.icon-wrapper .slash-line{z-index:1}</style>
 ```
 
 ### 自定义控制栏操作按钮
@@ -367,7 +363,6 @@ function startAutoHide() {
 }
 </script>
 
-<style scoped>.my-player{position:relative;width:100%;height:100%}.my-controls{position:absolute;bottom:0;left:0;right:0;z-index:20;pointer-events:auto;display:flex;align-items:center;justify-content:space-between;padding:8px 12px;background:linear-gradient(to top,rgba(0,0,0,.75) 0%,rgba(0,0,0,.3) 70%,transparent 100%);transition:opacity .3s ease,transform .3s ease}.my-controls.hidden{opacity:0;transform:translateY(8px);pointer-events:none}.controls-left,.controls-right{display:flex;align-items:center;gap:4px}.ctrl-btn{display:flex;align-items:center;justify-content:center;width:32px;height:32px;padding:0;border:none;border-radius:6px;background:transparent;color:rgba(255,255,255,.85);cursor:pointer;transition:background .15s ease,color .15s ease}.ctrl-btn:hover{background:rgba(255,255,255,.12);color:#fff}.ctrl-btn:active{background:rgba(255,255,255,.2)}.ctrl-btn svg{width:18px;height:18px}.volume-group{display:flex;align-items:center;gap:2px}.volume-slider{width:70px;height:3px;-webkit-appearance:none;appearance:none;background:rgba(255,255,255,.25);border-radius:2px;outline:none;cursor:pointer}.volume-slider::-webkit-slider-thumb{-webkit-appearance:none;width:10px;height:10px;border-radius:50%;background:#fff;cursor:pointer;box-shadow:0 0 4px rgba(0,0,0,.3)}.resolution-select{height:28px;padding:0 8px;border:1px solid rgba(255,255,255,.15);border-radius:6px;background:rgba(0,0,0,.4);color:rgba(255,255,255,.85);font-size:11px;cursor:pointer;outline:none}.resolution-select:hover{border-color:rgba(255,255,255,.35)}.resolution-select option{background:#1a1a1a;color:#fff}</style>
 ```
 
 ### 播放控制 API 汇总

package/resource/knowledge/push/api-reference/harmonyos.md

@@ -2,13 +2,13 @@
 
 |API|描述|
 |---------|---------|
-|registerPush|注册推送服务， (必须在 App 用户同意了隐私政策后，再调用该接口使用推送服务)。|
-|unRegisterPush|反注册关闭推送服务。|
-|setRegistrationID|RegistrationID 是推送接收设备的唯一标识 ID。默认情况下，注册推送服务成功时自动生成该 ID，同时也支持您自定义设置。您可根据 RegistrationID 向指定设备推送消息。需要注意的是，卸载并重新安装设备会更改 RegistrationID，因此需要在注册推送服务之前调用 setRegistrationID 接口。|
-|getRegistrationID|在成功注册推送服务后，调用此接口可获取推送接收设备的唯一标识 ID，即 RegistrationID。|
-|addPushListener|添加 Push 监听器。|
-|removePushListener|移除 Push 监听器。|
-|disablePostNotificationInForeground|应用在前台时，开/关通知栏通知（默认开）。|
+|[registerPush](#c624c0f8-1505-4d15-8a44-dcacbaaac784)|注册推送服务， (必须在 App 用户同意了隐私政策后，再调用该接口使用推送服务)。|
+|[unRegisterPush](#a6df0ca4-f85e-4678-8db4-1498fb67606b)|反注册关闭推送服务。|
+|[setRegistrationID](#e54d1228-3bc5-4053-bb2a-c72d3320c7db)|RegistrationID 是推送接收设备的唯一标识 ID。默认情况下，注册推送服务成功时自动生成该 ID，同时也支持您自定义设置。您可根据 RegistrationID 向指定设备推送消息。需要注意的是，卸载并重新安装设备会更改 RegistrationID，因此需要在注册推送服务之前调用 setRegistrationID 接口。|
+|[getRegistrationID](#2557dabd-b043-4f66-bb82-34315459c8b7)|在成功注册推送服务后，调用此接口可获取推送接收设备的唯一标识 ID，即 RegistrationID。|
+|[addPushListener](#8efda8f7-f11e-40d3-a9ee-9c2fbad7f63e)|添加 Push 监听器。|
+|[removePushListener](#4ee794ce-67d1-4b96-b7a5-bffe18f6d521)|移除 Push 监听器。|
+|[disablePostNotificationInForeground](#f8fe8ed3-ce77-4241-9eb1-3fe7e0ba16d2)|应用在前台时，开/关通知栏通知（默认开）。|
 
 ## 接口详情
 
@@ -78,7 +78,7 @@ addPushListener(listener: TIMPushListener): void;
 
 |参数|类型|说明|
 |---------|---------|---------|
-|listener|TIMPushListener|推送事件处理方法。|
+|listener|[TIMPushListener](#cff83260-e519-4071-b968-e427b2517ff1)|推送事件处理方法。|
 
 ### 移除 Push 监听器
 
@@ -91,7 +91,7 @@ removePushListener(listener: TIMPushListener): void;
 
 |参数|类型|说明|
 |---------|---------|---------|
-|listener|TIMPushListener|推送事件处理方法。|
+|listener|[TIMPushListener](#cff83260-e519-4071-b968-e427b2517ff1)|推送事件处理方法。|
 
 ### 应用在前台时，开/关通知栏通知
 

package/resource/knowledge/push/api-reference/unity.md

@@ -8,24 +8,24 @@ public class PushManager：推送插件接口类。
 
 |API|描述|
 |---------|---------|
-|RegisterPush|注册推送服务（必须在 App 用户同意了隐私政策后，再调用该接口使用推送服务）。|
-|UnRegisterPush|关闭推送服务。|
-|SetRegistrationID|RegistrationID 是推送接收设备的唯一标识 ID。默认情况下，注册推送服务成功时自动生成该 ID，同时也支持您自定义设置。您可根据 RegistrationID 向指定设备推送消息。需要注意的是，卸载并重新安装设备会更改 RegistrationID，因此需要在注册推送服务之前调用 setRegistrationID 接口。|
-|GetRegistrationID|在成功注册推送服务后，可通过调用 getRegistrationID 接口获取推送接收设备的唯一标识 ID，即RegistrationID。您可根据 RegistrationID 向指定设备推送消息。|
+|[RegisterPush](#RegisterPush)|注册推送服务（必须在 App 用户同意了隐私政策后，再调用该接口使用推送服务）。|
+|[UnRegisterPush](#UnRegisterPush)|关闭推送服务。|
+|[SetRegistrationID](#SetRegistrationID)|RegistrationID 是推送接收设备的唯一标识 ID。默认情况下，注册推送服务成功时自动生成该 ID，同时也支持您自定义设置。您可根据 RegistrationID 向指定设备推送消息。需要注意的是，卸载并重新安装设备会更改 RegistrationID，因此需要在注册推送服务之前调用 setRegistrationID 接口。|
+|[GetRegistrationID](#GetRegistrationID)|在成功注册推送服务后，可通过调用 getRegistrationID 接口获取推送接收设备的唯一标识 ID，即RegistrationID。您可根据 RegistrationID 向指定设备推送消息。|
 
 #### Push 全局监听接口
 
 |API|描述|
 |---------|---------|
-|AddPushListener|添加 Push 监听器。|
-|RemovePushListener|移除 Push 监听器。|
+|[AddPushListener](#AddPushListener)|添加 Push 监听器。|
+|[RemovePushListener](#RemovePushListener)|移除 Push 监听器。|
 
 #### 自定义配置接口
 
 |API|描述|
 |---------|---------|
-|ForceUseFCMPushChannel|指定设备离线推送使用 FCM 通道，需要在注册推送服务之前调用。|
-|DisablePostNotificationInForeground|关闭 App 在前台时弹出通知栏。|
+|[ForceUseFCMPushChannel](#ForceUseFCMPushChannel)|指定设备离线推送使用 FCM 通道，需要在注册推送服务之前调用。|
+|[DisablePostNotificationInForeground](#DisablePostNotificationInForeground)|关闭 App 在前台时弹出通知栏。|
 
 ### 接口详情
 
@@ -59,11 +59,11 @@ public class PushManager：推送插件接口类。
 
 注册推送服务成功后，获取推送 ID 标识，即 RegistrationID。
 
-##### abstract void AddPushListener(PushListener listener)
+##### abstract void AddPushListener([PushListener](#PushListener) listener)
 
 添加 Push 监听器
 
-##### abstract void RemovePushListener(PushListener listener)
+##### abstract void RemovePushListener([PushListener](#PushListener) listener)
 
 移除 Push 监听器
 

package/resource/knowledge/push/api-reference/unreal-engine.md

@@ -8,24 +8,24 @@ class PushManager：推送插件接口类。
 
 |API|描述|
 |---------|---------|
-|RegisterPush|注册推送服务（必须在 App 用户同意了隐私政策后，再调用该接口使用推送服务）。|
-|UnRegisterPush|关闭推送服务。|
-|SetRegistrationID|RegistrationID 是推送接收设备的唯一标识 ID。默认情况下，注册推送服务成功时自动生成该 ID，同时也支持您自定义设置。您可根据 RegistrationID 向指定设备推送消息。需要注意的是，卸载并重新安装设备会更改 RegistrationID，因此需要在注册推送服务之前调用 setRegistrationID 接口。|
-|GetRegistrationID|在成功注册推送服务后，可通过调用 getRegistrationID 接口获取推送接收设备的唯一标识 ID，即RegistrationID。您可根据 RegistrationID 向指定设备推送消息。|
+|[RegisterPush](#RegisterPush)|注册推送服务（必须在 App 用户同意了隐私政策后，再调用该接口使用推送服务）。|
+|[UnRegisterPush](#UnRegisterPush)|关闭推送服务。|
+|[SetRegistrationID](#SetRegistrationID)|RegistrationID 是推送接收设备的唯一标识 ID。默认情况下，注册推送服务成功时自动生成该 ID，同时也支持您自定义设置。您可根据 RegistrationID 向指定设备推送消息。需要注意的是，卸载并重新安装设备会更改 RegistrationID，因此需要在注册推送服务之前调用 setRegistrationID 接口。|
+|[GetRegistrationID](#GetRegistrationID)|在成功注册推送服务后，可通过调用 getRegistrationID 接口获取推送接收设备的唯一标识 ID，即RegistrationID。您可根据 RegistrationID 向指定设备推送消息。|
 
 #### Push 全局监听接口
 
 |API|描述|
 |---------|---------|
-|AddPushListener|添加 Push 监听器。|
-|RemovePushListener|移除 Push 监听器。|
+|[AddPushListener](#addPushListener)|添加 Push 监听器。|
+|[RemovePushListener](#RemovePushListener)|移除 Push 监听器。|
 
 #### 自定义配置接口
 
 |API|描述|
 |---------|---------|
-|ForceUseFCMPushChannel|指定设备离线推送使用 FCM 通道，需要在注册推送服务之前调用。|
-|DisablePostNotificationInForeground|关闭 App 在前台时弹出通知栏。|
+|[ForceUseFCMPushChannel](#ForceUseFCMPushChannel)|指定设备离线推送使用 FCM 通道，需要在注册推送服务之前调用。|
+|[DisablePostNotificationInForeground](#DisablePostNotificationInForeground)|关闭 App 在前台时弹出通知栏。|
 
 ### 接口详情
 
@@ -97,9 +97,9 @@ class PushListener：Push 监听器类
 
 |API|描述|
 |---------|---------|
-|OnRecvPushMessage|收到 Push 消息。|
-|OnRevokePushMessage|收到 Push 消息撤回的通知。|
-|OnNotificationClicked|点击通知栏消息回调。|
+|[OnRecvPushMessage](#OnRecvPushMessage)|收到 Push 消息。|
+|[OnRevokePushMessage](#OnRevokePushMessage)|收到 Push 消息撤回的通知。|
+|[OnNotificationClicked](#OnNotificationClicked)|点击通知栏消息回调。|
 
 ### 接口详情
 

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

@@ -35,7 +35,7 @@
 
 #### 配置 Gradle 仓库
 
-配置仓库的目的是让 Gradle 能下载 TIMPush 及相关依赖。本节只配置与厂商无关的公共仓库：`google()`、`mavenCentral()` 用于解析 Android 官方组件，腾讯云 Maven 仓库用于解析 TIMPush 等腾讯云依赖。华为、荣耀的厂商 Maven 仓库请在「厂商通道集成」对应厂商 Tab 中追加。
+配置仓库的目的是让 Gradle 能下载 TIMPush 及相关依赖。本节只配置与厂商无关的公共仓库：`google()`、`mavenCentral()` 用于解析 Android 官方组件，腾讯云 Maven 仓库用于解析 TIMPush 等腾讯云依赖。
 
 Android 工程可能使用 Groovy DSL 或 Kotlin DSL，请先根据文件后缀判断当前工程使用的 DSL 类型：
 
@@ -99,7 +99,7 @@ dependencyResolutionManagement {
 【Gradle 7.0 版本】
 
 Gradle 7.0 版本通常使用 Groovy DSL。如您的工程使用 Kotlin DSL，请将单引号改为双引号，`url "..."` 改为 `url = uri("...")`。
-1. 在项目级 `build.gradle` 的 `buildscript > repositories` 中添加插件仓库。华为、荣耀、Google FCM 的插件 classpath 请在「厂商通道集成」对应厂商 Tab 中追加。
+1. 在项目级 `build.gradle` 的 `buildscript > repositories` 中添加插件仓库。
 
 ``` groovy
 buildscript {
@@ -127,7 +127,7 @@ dependencyResolutionManagement {
 
 Gradle 7.0 以下版本通常使用 Groovy DSL。如您的工程使用 Kotlin DSL，请将单引号改为双引号，`url "..."` 改为 `url = uri("...")`。
 
-在项目级 `build.gradle` 的 `buildscript > repositories` 和 `allprojects > repositories` 中添加仓库。华为、荣耀、Google FCM 的插件 classpath 请在「厂商通道集成」对应厂商 Tab 中追加。
+在项目级 `build.gradle` 的 `buildscript > repositories` 和 `allprojects > repositories` 中添加仓库。
 ``` groovy
 buildscript {
     repositories {
@@ -240,7 +240,7 @@ pushInfo.setAndroidXiaoMiChannelID("your_xiaomi_channel_id");
 
 - 已重新下载包含华为证书的 `timpush-configs.json`，并放入应用模块 `assets` 目录；
 
-- 测试包当前签名（debug 或 release）的 SHA-256 已在华为控制台「项目设置 > 常规 > SHA 证书指纹」中添加，指纹不一致会报 `6003: certificate fingerprint error`；
+- 测试包当前签名（debug 或 release）的 SHA-256 已在华为控制台 **项目设置 > 常规 > SHA 证书指纹** 中添加，指纹不一致会报 `6003: certificate fingerprint error`；
 
 - 使用华为真机验证。
 
@@ -256,7 +256,7 @@ pushInfo.setAndroidXiaoMiChannelID("your_xiaomi_channel_id");
 
 ##### **追加厂商 Maven 仓库**
 
-请在「配置 Gradle 仓库」已添加的公共仓库基础上，追加华为仓库。
+请在已添加的公共仓库基础上追加华为仓库。
 
 【Gradle 7.1 及以上】
 
@@ -592,7 +592,7 @@ pushInfo.setAndroidVIVOCategory("IM");
 
 - 已重新下载包含荣耀证书的 `timpush-configs.json`，并放入应用模块 `assets` 目录；
 
-- 测试包当前签名（debug 或 release）的 SHA-256 已在荣耀控制台「项目设置 > 常规 > SHA 证书指纹」中添加，指纹不一致会报 `6003: certificate fingerprint error`；
+- 测试包当前签名（debug 或 release）的 SHA-256 已在荣耀控制台 **项目设置 > 常规 > SHA 证书指纹** 中添加，指纹不一致会报 `6003: certificate fingerprint error`；
 
 - 使用荣耀真机验证。不要在华为设备上验证荣耀通道。
 
@@ -973,9 +973,9 @@ pushInfo.setAndroidFCMChannelID("your_fcm_channel_id");
 > **警告：**
 > 请关注各厂商通道消息分类规则：
 >
-> 1. 厂商离线通道的消息分类机制会影响推送及时性、单设备每日接收数量、夜间展示、声音、横幅和厂商通道权限。
-> 2. 只有 IM 聊天、订单、交易、账号变更等用户预期强、需要及时触达的消息，才建议申请或使用高优先级分类。营销、广告、活动、资讯类消息不应滥用高优分类，**否则可能被厂商降级、限频或冻结权限。**
-> 3. 发送离线推送时，API 设置优先级高于腾讯云控制台证书默认配置。
+> - 厂商离线通道的消息分类机制会影响推送及时性、单设备每日接收数量、夜间展示、声音、横幅和厂商通道权限。
+> - 只有 IM 聊天、订单、交易、账号变更等用户预期强、需要及时触达的消息，才建议申请或使用高优先级分类。营销、广告、活动、资讯类消息不应滥用高优分类，**否则可能被厂商降级、限频或冻结权限。**
+> - 发送离线推送时，API 设置优先级高于腾讯云控制台证书默认配置。
 
 ### 步骤3：注册推送服务
 
@@ -1005,6 +1005,8 @@ registerPush 用于向 TIMPush 注册当前设备的推送 token。注册成功
 
 App 冷启动、用户同意隐私政策后调用 `registerPush(appKey = Push Key)`。如果工程已有自定义 `Application`，将注册逻辑放在该类中；如果没有，需新建并在 `AndroidManifest.xml` 中声明。
 
+建议在 `registerPush` 成功回调里调用 `getRegistrationID` 打印 `registrationID`，方便后续根据 `registrationID` 发送离线推送消息。
+
 【Java】
 ``` java
 import android.app.Application;
@@ -1029,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
@@ -1061,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?) {
@@ -1081,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
@@ -1112,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
@@ -1156,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?) {
@@ -1255,9 +1301,7 @@ V2TIMManager.getMessageManager().sendMessage(
 
 #### **配置控制台点击动作**
 
-在腾讯云控制台配置推送证书的「点击后续动作」，勾选「打开应用内指定页面」：
-
-操作路径：腾讯云控制台 > **推送服务 Push** > **基础配置** > **对应厂商证书** > **编辑** > 点击后续动作，选择**打开应用内指定界面**。
+在腾讯云控制台配置**打开应用内指定页面。**操作路径：腾讯云控制台 > **推送服务 Push** > **基础配置** > **对应厂商证书** > **编辑** > 点击后续动作，选择**打开应用内指定界面**。
 
 #### **发送推送时携带** `ext`
 

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

@@ -1,9 +1,9 @@
 ## 前提条件
-1. 在 [微信开发者工具](https://developers.weixin.qq.com/miniprogram/dev/platform-capabilities/miniapp/intro/) 中开启推送服务，默认支持在线推送。
+- 在 [微信开发者工具](https://developers.weixin.qq.com/miniprogram/dev/platform-capabilities/miniapp/intro/) 中开启推送服务，默认支持在线推送。
 
-2. 如果您需要使用离线推送，请先完成对应原生平台的推送前提配置：请参见 [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)。
+- 如果您需要使用离线推送，请先完成对应原生平台的推送前提配置：请参见 [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)。
 
-3. 微信开发者工具版本需 ≥ 1.06.2410152，您可进入 [下载地址](https://developers.weixin.qq.com/miniprogram/dev/devtools/nightly.html) 进行版本下载。
+- 微信开发者工具版本需 ≥ 1.06.2410152，您可进入 [下载地址](https://developers.weixin.qq.com/miniprogram/dev/devtools/nightly.html) 进行版本下载。
 
 ## 操作步骤
 

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

@@ -2,45 +2,27 @@
 
 ## 前提条件
 
-开始接入前，请先完成目标平台的推送前提配置，并准备好注册所需参数。按平台查看：
-
 【Android】
 
-请确认已 开通 Push 服务，并按需完成 Android 厂商配置（小米 / 华为 / OPPO / vivo / 荣耀 / 魅族 / Google FCM）。Flutter Android 侧至少需要准备：
-
-|资源|用途|
-|---------|---------|
-|`SDKAppID`、客户端密钥（Push Key）|调用 `registerPush`|
-|`timpush-configs.json`|放入 Android 应用模块 `assets`|
-|目标厂商配置文件（如有）|华为、荣耀、Google FCM 等按厂商要求放入工程|
-|工程 `applicationId`|与厂商平台应用包名一致|
-|TIMPush 版本号 `VERSION`|厂商通道包依赖版本，见 更新日志|
-
-完整资源清单与获取路径见 Android 前提条件。
+请确认已 开通 Push 服务，并按需完成 Android 厂商配置（小米 / 华为 / OPPO / vivo / 荣耀 / 魅族 / Google FCM）。
 
 【iOS】
 
-请确认已 开通 Push 服务 并完成 iOS 厂商配置。Flutter iOS 侧至少需要准备：
-
-|资源|用途|
-|---------|---------|
-|`SDKAppID`、Push Key|调用 `registerPush`|
-|证书 ID（`businessID` / `apnsCertificateID`）|腾讯云控制台上传 APNs 证书后生成，经 `registerPush` 传入|
-|App Group ID（可选）|仅触达统计需要，经 `registerPush` 的 `applicationGroupID` 传入|
+请确认已 开通 Push 服务 并完成 iOS 厂商配置。
 
-完整资源清单见 iOS 前提条件。
+【HarmonyOS】
 
-本文示例中的 `VERSION`、`SDKAppID`、`AppKey`、证书 ID、App Group ID 均为占位符，请勿在代码仓库中提交真实密钥。
+请确认已 开通 Push 服务 并完成 [HarmonyOS 厂商配置](https://cloud.tencent.com/document/product/269/108856)。
 
 ## 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 输入“集成 Flutter 离线推送”“帮我集成 Flutter TIMPush”等需求，AI 将根据项目类型引导你完成环境检测、厂商通道配置、凭据填写、代码接入和验证等步骤。详情可参考 AI Coding。
+通过 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 输入“集成 Flutter 离线推送”“帮我集成 Flutter TIMPush”等需求，AI 将根据项目类型引导您完成环境检测、厂商通道配置、凭据填写、代码接入和验证等步骤。详情可参考 AI Coding。
 
 ## 手动集成
 
 ### 步骤1：集成 TIMPush SDK
 
-如果你想手动集成，请按顺序完成下述步骤。
+如果您想手动集成，请按顺序完成下述步骤。
 
 #### 集成 Flutter 插件
 
@@ -209,6 +191,34 @@ import tencent_cloud_chat_push
 }
 ```
 
+【HarmonyOS】
+1. 参考 [鸿蒙 Flutter 仓库文档](https://gitcode.com/CPF-Flutter/flutter_flutter/tree/oh-3.35.7-release) 的开发指南搭建环境。
+
+2. 在您项目的 pubspec.yaml 中依赖重写（dependency_overrides）鸿蒙适配的第三方库：
+
+``` java
+dependency_overrides:
+  # ... 已有的 override 保持不变 ...
+  # HarmonyOS 专用(仅在使用 Flutter-OH 构建时启用,构建 Android/iOS 时请注释掉)
+  path_provider:
+    git:
+      url: "https://gitcode.com/openharmony-tpc/flutter_packages.git"
+      path: "packages/path_provider/path_provider"
+      ref: "provider-v2.1.5-ohos-1.0.0"
+  shared_preferences:
+    git:
+      url: "https://gitcode.com/openharmony-tpc/flutter_packages.git"
+      path: "packages/shared_preferences/shared_preferences"
+      ref: "shared_preferences-v2.5.4-ohos-1.0.0"
+```
+3. 添加 `timpush-configs.json` 文件到您项目中 `ohos/entry/src/main/resources/rawfile/timpush-configs.json`，文件内容中的 `businessID` 值是在厂商配置中 [腾讯云 IM 控制台配置](https://cloud.tencent.com/document/product/269/108856#e87ea0c0-b307-4ce1-b8d3-aed8e9aed5ce) 得到的证书 ID。
+
+``` java
+{
+  "businessID": "替换成您的证书 ID"
+}
+```
+
 ### 步骤2：注册推送服务
 
 registerPush 用于向 TIMPush 注册当前设备的推送 token。注册成功后，TIMPush 会为当前设备建立一个推送目标标识 `registrationID`；服务端、控制台接入测试和排查工具可以使用该标识向这台设备下发离线推送。若 App 同时接入 IM 并完成登录，也可以使用 `userID` 向该用户已建立推送关系的设备下发离线推送。
@@ -338,6 +348,10 @@ Flutter 额外确认两点：
 
 2. `ios/Runner/AppDelegate.swift` 中已实现 `applicationGroupID()`。
 
+【HarmonyOS】
+
+请按 [HarmonyOS 配置消息触达统计](https://cloud.tencent.com/document/product/269/108892#daa658b0-1ac0-44a8-8a47-7ec8822ebe82) 完成配置。Flutter 侧无额外 Dart 代码。
+
 ### 步骤4：测试推送链路
 
 完成上述集成步骤后，需要通过发送测试消息验证链路是否打通。

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

@@ -1,16 +1,6 @@
 ## 前提条件
 
-请确认已 开通 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`均为占位符，请勿在代码仓库中提交真实密钥。
+请确认已 开通 Push 服务 并完成 厂商配置。
 
 ## AI 集成
 

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

@@ -24,7 +24,7 @@
 
 ### 步骤1：集成 TIMPush SDK
 
-如果你想手动集成，请按顺序完成下文配置。
+如果您想手动集成，请按顺序完成下文配置。
 
 #### 在主 App target 中集成 TIMPush
 
@@ -145,7 +145,7 @@ registerPush 用于向 TIMPush 注册当前设备的推送 token。注册成功
 
 【App 冷启动注册 TIMPush（appKey 传 Push Key）】
 
-App 冷启动、用户同意隐私政策后调用 `registerPush(appKey = Push Key)`。
+App 冷启动、用户同意隐私政策后调用 `registerPush(appKey = Push Key)`。建议在 `registerPush` 成功回调里调用 `getRegistrationID` 打印 `registrationID`，方便后续根据 `registrationID` 发送离线推送消息。
 
 【Swift】
 ``` swift
@@ -159,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)")
     })
@@ -174,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);
     }];
@@ -188,7 +195,7 @@ func registerTIMPush() {
 
 【IM 登录后注册推送（appKey 传 null）】
 
-请在 IM `login` 成功回调中调用 `registerPush(appKey = nil)`。
+请在 IM `login` 成功回调中调用 `registerPush(appKey = nil)`。建议在 `registerPush` 成功回调里调用 `getRegistrationID` 打印 `registrationID`，方便后续根据 `registrationID` 发送离线推送消息。
 
 【Swift】
 ``` swift
@@ -210,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)")
         })
@@ -242,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);
         }];
@@ -253,7 +268,7 @@ func loginIMAndRegisterPush() {
 
    > **警告：**
    >
-   > 如果你的业务仅使用即时通信 IM 聊天能力，请勿在 IM 登录前先调用 `registerPush`。否则 SDK 可能会按独立推送场景注册 Push 类型账号，并产生对应的 Push DAU。Push DAU 超出套餐额度后，可能会产生额外费用。
+   > 如果您的业务仅使用即时通信 IM 聊天能力，请勿在 IM 登录前先调用 `registerPush`。否则 SDK 可能会按独立推送场景注册 Push 类型账号，并产生对应的 Push DAU。Push DAU 超出套餐额度后，可能会产生额外费用。
    >
 
    **验证**：
@@ -498,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

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

@@ -278,7 +278,7 @@ npm run ios
 
 ### 步骤7：消息推送触达统计
 
-如果你需要统计设备触达数据，请按照 华为/荣耀/vivo/魅族/iOS 步骤完成配置。其余支持厂商不需要配置，FCM 暂不支持推送统计功能。
+如果您需要统计设备触达数据，请按照 华为/荣耀/vivo/魅族/iOS 步骤完成配置。其余支持厂商不需要配置，FCM 暂不支持推送统计功能。
 
 ## 接入排查
 

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

@@ -18,7 +18,7 @@
 
 ### 步骤1：集成 TencentCloud-Push
 
-如果你想手动集成，请按下述步骤依次完成下载插件并导入 HBuilderX、配置离线推送文件。
+如果您想手动集成，请按下述步骤依次完成下载插件并导入 HBuilderX、配置离线推送文件。
 
 #### 下载插件并导入 HBuilderX
 1. 完成上述「前提条件」中目标平台的厂商配置后，打开 [uni-app 腾讯云推送服务（Push）](https://ext.dcloud.net.cn/plugin)，单击**下载插件并导入 HBuilderX**，将插件导入 HBuilderX 工程中。

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

@@ -280,7 +280,7 @@ PushManager.RegisterPush(sdkAppId: 您的sdkAppId, appKey: "客户端密钥", ne
 
 ### 步骤6：消息推送触达统计
 
-如果你需要统计设备触达数据，请按照 华为/荣耀/vivo/魅族/iOS 完成配置。其余支持厂商不需要配置，FCM 暂不支持推送统计功能。
+如果您需要统计设备触达数据，请按照 华为/荣耀/vivo/魅族/iOS 完成配置。其余支持厂商不需要配置，FCM 暂不支持推送统计功能。
 
 ## 接入排查
 

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。
 

package/resource/knowledge/roomkit/core-sdk/android/room-state.md

@@ -79,7 +79,7 @@ fun createAndJoinRoom() {
 | --- | --- | --- | --- |
 | <code>roomID</code> | <code>String</code> | 是 | - 字符串类型的房间唯一标识符。<br>- 限制长度为 0-48 字节。<br>-  建议仅包含数字、英文字母（区分大小写）、下划线（_）和连字符（-）。避免使用空格和中文字符。 |
 | <code>roomType</code> | <code>RoomType</code> | 是 | 房间类型<br>- <code>STANDARD</code>：标准房间（默认值）。<br>- <code>WEBINAR</code>：大型研讨会房间。<br>多人会议场景这里填写 <code>STANDARD</code> 房间类型。 |
-| <code>options</code> | <code>CreateRoomOptions</code> | 是 | - 创建房间配置对象。<br>- 详细用法
+| <code>options</code> | <code>CreateRoomOptions</code> | 是 | - 创建房间配置对象。<br>- 详细用法请参考：<a href="#a065626d-21a2-476e-bbaf-65bca29b44d2">CreateRoomOptions 结构体详细说明</a> |
 | <code>completion</code> | <code>CompletionHandler</code> | 否 | 操作完成回调，用于返回创建和加入房间的结果。若创建失败则会返回错误码和错误信息。 |
 
 ##### CreateRoomOptions 结构体详细说明
@@ -225,8 +225,8 @@ fun updateRoomInfo() {
 | 参数名 | 类型 | 必填 | 说明 |
 | --- | --- | --- | --- |
 | <code>roomID</code> | <code>String</code> | 是 | - 字符串类型的房间唯一标识符。<br>- 限制长度为 0-48 字节。<br>- 建议仅包含数字、英文字母（区分大小写）、下划线（_）和连字符（-）。避免使用空格和中文字符。 |
-| <code>options</code> | <code>UpdateRoomOptions</code> | 是 | - 更新房间属性配置对象。<br>- 详细用法
-| <code>modifyFlagList</code> | <code>List<UpdateRoomOptions.ModifyFlag></code> | 是 | - 更新房间属性修改标志位。目前支持更新<strong>房间名称</strong>、<strong>房间密码</strong>。<br>- 详细用法。 |
+| <code>options</code> | <code>UpdateRoomOptions</code> | 是 | - 更新房间属性配置对象。<br>- 详细用法请参考：<a href="#UpdateRoomOptionsStruct">UpdateRoomOptions 结构体详细说明</a> |
+| <code>modifyFlagList</code> | <code>List<UpdateRoomOptions.ModifyFlag></code> | 是 | - 更新房间属性修改标志位。目前支持更新<strong>房间名称</strong>、<strong>房间密码</strong>。<br>- 详细用法请参考：<a href="#UpdateRoomOptions.ModifyFlag">UpdateRoomOptions.ModifyFlag 详细说明</a>。 |
 | <code>completion</code> | <code>CompletionHandler</code> | 否 | 操作完成回调，用于返回更新房间信息的结果。若更新失败则会返回错误码和错误信息。 |
 
 **UpdateRoomOptions 结构体详细说明**