@tencentcloud/sdk-mcp 1.7.0 → 1.7.2

package/resource/integration/callkit/preset/flutter/integration.md

@@ -1,5 +1,9 @@
 本文将介绍如何快速接入 TUICallKit 组件。您可以在 10 分钟内完成以下关键步骤，最终获得一个功能完备的音视频通话界面。
 
+> **说明：**
+> 您也可以使用 TRTC Agent Skill 辅助将 TUICallKit 接入现有 Flutter 项目。安装后，在项目目录中告诉 AI “帮我在当前 Flutter 项目中接入音视频通话”，AI 将分析项目结构，并协助完成依赖、工程配置、登录、通话入口接入及验证。
+>
+
 ## 准备工作
 
 ### 环境要求
@@ -8,7 +12,7 @@ Flutter 3.24.0、Dart 3.5.0 及以上版本。
 
 ### 开通服务
 
-在使用腾讯云提供的音视频服务前，您需要前往控制台，为应用开通音视频服务。具体步骤详细参见 开通服务。开通服务后，请记录`SDKAppID` 和`SDKSecretKey`，在后续的步骤（登录）中会用到。
+在使用腾讯云提供的音视频服务前，您需要前往控制台，为应用开通音视频服务。具体步骤详情参见 开通服务。开通服务后，请记录 `SDKAppID` 和 `SDKSecretKey`，在后续的步骤（登录）中会用到。
 
 ## 快速接入
 
@@ -25,7 +29,7 @@ flutter pub add tencent_calls_uikit
 【Android】
 1. 由于 SDK 内部使用了 Java 反射机制（或特性），需要将部分 SDK 类加入不进行混淆处理的名单。
 
-  - 请在工程的`android/app/`目录下找到`build.gradle.kts`（或`build.gradle` ）文件中配置并开启混淆规则：
+  - 请在工程的 `android/app/` 目录下找到 `build.gradle.kts`（或 `build.gradle` ）文件中配置并开启混淆规则：
 
 【build.gradle.kts】
 ``` java
@@ -152,7 +156,7 @@ void login() async {
 |userSig|String|一种安全保护签名，用于对用户进行登录鉴权认证，确认用户是否真实，阻止恶意攻击者盗用您的云服务使用权。|
 
 > **说明：**
-> - **开发环境**：如果您在本地开发调试阶段，可以采用本地 `GenerateTestUserSig.genTestSig`函数生成 userSig。该方法中 secretKey 很容易被反编译逆向破解，一旦您的密钥泄露，攻击者就可以盗用您的腾讯云流量。
+> - **开发环境**：如果您在本地开发调试阶段，可以采用本地 `GenerateTestUserSig.genTestSig` 函数生成 userSig。该方法中 secretKey 很容易被反编译逆向破解，一旦您的密钥泄露，攻击者就可以盗用您的腾讯云流量。
 > - **生产环境**：如果您的项目要发布上线，请采用 服务端生成 UserSig 的方式。
 
 ### 步骤4：设置昵称和头像 [可选]

package/resource/integration/chat/preset/android/integration.md

@@ -519,3 +519,4 @@ TencentAiDeskCustomer.getInstance().initWithProfile(context, SDKAppID, userID, u
 #### **登录失败，提示签名错误？**
 
 请检查 SDKAppID 和 UserSig 是否正确，UserSig 是否已过期。可以参考上文 配置用户鉴权 重新生成 UserSig。
+

package/resource/integration/chat/preset/flutter/integration.md

@@ -5,9 +5,9 @@ TUIKit Flutter 是基于腾讯云 IM SDK 的一套 Flutter UI 组件库，提供
 > **说明：**
 > **花 30 秒，帮 Flutter TUIKit 变得更好用！**
 >
-> 正在接入、已经跑通、还是卡住了？都欢迎你填写 [Flutter TUIKit 接入体验问卷](https://wj.qq.com/s2/27299252/ff84/)**。**
+> 正在接入、已经跑通、还是卡住了？都欢迎您填写 [Flutter TUIKit 接入体验问卷](https://wj.qq.com/s2/27299252/ff84/)**。**
 >
-> **你的每一条卡点反馈和改进建议，官方都会及时跟进处理**。
+> **您的每一条卡点反馈和改进建议，官方都会及时跟进处理**。
 >
 
 ## 关键概念
@@ -20,12 +20,16 @@ TUIKit 提供了一套完整的即时通信 UI 组件，向下依赖 AtomicXCore
 - AtomicXCore（数据层）：提供数据管理和业务逻辑，包含各种 Store 和 Manager。
 
 ## 前提条件
+- **支持平台：**Android、iOS、HarmonyOS。
+
 - Flutter >= 3.29.0 版本，Dart >= 3.7.0 版本，Kotlin >= 1.9版本。
 
 - Android Studio Ladybug 2024.2.1 及以上版本，Android Gradle Plugin 7.3.1 以上版本，JDK 17 版本。
 
 - Xcode 12.0 及以上版本。
 
+- HarmonyOS：[Flutter-OH 3.35.7-ohos-release](https://gitcode.com/CPF-Flutter/flutter_flutter/tree/oh-3.35.7-release)、DevEco Studio 5.0+(可选)、HarmonyOS NEXT 真机 / 模拟器、hdc 命令行、ohpm。注意：标准 Flutter 不能构建鸿蒙 hap，必须使用 Flutter-OH 分支。
+
 - 一个有效的腾讯云账号及 Chat 应用。可参考 开通服务 从控制台获取以下信息：
 
   - SDKAppID：App 在控制台获取的 Chat 应用的 ID，为应用的唯一标识。
@@ -103,6 +107,8 @@ call/
 
 ### 配置项目
 
+#### iOS
+
 在 iOS 端添加必要的权限配置。请打开 ios/Podfile ，在文件末尾新增如下权限代码：
 ``` objectivec
 post_install do |installer|
@@ -125,7 +131,9 @@ post_install do |installer|
 end
 
 ```
-- **清理 Gradle 全局配置（仅 Android 需要）：**如果您本地存在 `~/.gradle/init.gradle`，运行如下命令：
+
+#### Android
+- **清理 Gradle 全局配置：**如果您本地存在 `~/.gradle/init.gradle`，运行如下命令：
 
    ``` bash
    # 或者直接删除：rm -f ~/.gradle/init.gradle
@@ -137,13 +145,104 @@ end
    > 如果您本地不存在 Gradle 全局配置文件 `~/.gradle/init.gradle`，请忽略。如果存在，并且该文件里配置有 `allprojects.repositories`，可以删除 `allprojects.repositories` 相关内容，或者删除 `~/.gradle/init.gradle`（建议备份文件），以免引起运行报错。
    >
 
-- **配置 JDK 17（仅 Android 需要）：**在项目例如 `chat/demo` 目录下的 `gradle.properties` 里增加一条 `org.gradle.java.home`，用来配置 JDK 17 路径，请替换成您实际的 JDK 17 的完整路径。参考如下：
+- **配置 JDK 17：**在项目例如 `chat/demo` 目录下的 `gradle.properties` 里增加一条 `org.gradle.java.home`，用来配置 JDK 17 路径，请替换成您实际的 JDK 17 的完整路径。参考如下：
 
    ``` bash
    # 请替换为您本地 JDK 17 的真实完整路径
    org.gradle.java.home=xx/Java/JavaVirtualMachines/jdk-17.0.6.jdk/Contents/Home
    ```
 
+#### HarmonyOS
+- 参考 [鸿蒙 Flutter 仓库文档](https://gitcode.com/CPF-Flutter/flutter_flutter/tree/oh-3.35.7-release) 的开发指南搭建环境。
+
+- 在您项目的 `pubspec.yaml` 文件中依赖重写（dependency_overrides）鸿蒙适配的第三方库，参考 `chat/demo/pubspec.yaml` 文件：
+
+   ``` javascript
+   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"
+     url_launcher:
+       git:
+         url: "https://gitcode.com/openharmony-tpc/flutter_packages.git"
+         path: "packages/url_launcher/url_launcher"
+         ref: "url_launcher_v6.3.2-ohos-1.0.0"
+
+   ```
+- 声明 HarmonyOS 权限，参考 `chat/demo/ohos/entry/src/main/module.json5` 在 `requestPermissions` 数组中加入所需权限。
+
+   ``` java
+   {
+     "module": {
+       "requestPermissions": [
+         // ===== system_grant(声明即得) =====
+         { "name": "ohos.permission.INTERNET" },
+         { "name": "ohos.permission.GET_NETWORK_INFO" },
+         { "name": "ohos.permission.VIBRATE" },
+         // ===== user_grant(需运行时申请,必须提供 reason 和 usedScene) =====
+         {
+           "name": "ohos.permission.CAMERA",
+           "reason": "$string:permission_reason_camera",
+           "usedScene": {
+             "abilities": [ "EntryAbility" ],
+             "when": "inuse"
+           }
+         },
+         {
+           "name": "ohos.permission.MICROPHONE",
+           "reason": "$string:permission_reason_microphone",
+           "usedScene": {
+             "abilities": [ "EntryAbility" ],
+             "when": "inuse"
+           }
+         },
+         {
+           "name": "ohos.permission.WRITE_IMAGEVIDEO",
+           "reason": "$string:permission_reason_write_media",
+           "usedScene": {
+             "abilities": [ "EntryAbility" ],
+             "when": "inuse"
+           }
+         },
+         {
+           "name": "ohos.permission.READ_PASTEBOARD",
+           "reason": "$string:permission_reason_read_pasteboard",
+           "usedScene": {
+             "abilities": [ "EntryAbility" ],
+             "when": "inuse"
+           }
+         }
+       ]
+     }
+   }
+
+   ```
+- 在项目根目录 `ohos/build-profile.json5` 里启用 `useNormalizedOHMUrl`，否则会报“Bytecode HARs not supported when useNormalizedOHMUrl is not true”的错误。
+
+   ``` java
+   {
+     "app": {
+       "products": [{
+         "name": "default",
+         "buildOption": {
+           "arkOptions": { "useNormalizedOHMUrl": true }
+         }
+       }]
+     }
+   }
+
+   ```
+
 ## 接入步骤
 
 ### 步骤1：配置用户鉴权
@@ -386,16 +485,16 @@ import 'package:tencentcloud_ai_desk_customer/tencentcloud_ai_desk_customer.dart
 // 上述sdkAppID、userID和userSig三个参数, 可以同您登录腾讯云 IM 的保持一致, 也可以使用不同的应用和用户
 
 TencentCloudAIDeskCustomer.init(
-  sdkAppID: SDKAppID， // 开通了智能客服 Desk 的应用 ID
-  userID: userID， // 详情可参见腾讯云 IM 登录鉴权
-  userSig: userSig， // 详情可参见腾讯云 IM 登录鉴权
+  sdkAppID: SDKAppID, // 开通了智能客服 Desk 的应用 ID
+  userID: userID, // 详情可参见腾讯云 IM 登录鉴权
+  userSig: userSig, // 详情可参见腾讯云 IM 登录鉴权
 );
 
 // 打开智能客服会话页面
 TencentCloudAIDeskCustomer.navigate(
-  context: context， // BuildContext
-  customerServiceID: "@customer_service_account"， // 可选, 如不配置多客服号或修改默认的客服号 UserID, 可无需传入. 客服号 UserID 可从智能客服管理端查看: https://desk.qcloud.com/
-  config: TencentCloudCustomerConfig()， // 可选针对该客服会话的特殊配置，具体参数及使用方式可查看该类注释. 此处仅需手动指定相比全局配置的增项和修改项即可，其余配置来自全局默认配置.
+  context: context, // BuildContext
+  customerServiceID: "@customer_service_account", // 可选, 如不配置多客服号或修改默认的客服号 UserID, 可无需传入. 客服号 UserID 可从智能客服管理端查看: https://desk.qcloud.com/
+  config: TencentCloudCustomerConfig(), // 可选针对该客服会话的特殊配置，具体参数及使用方式可查看该类注释. 此处仅需手动指定相比全局配置的增项和修改项即可，其余配置来自全局默认配置.
 );
 ```
 
@@ -408,3 +507,4 @@ TencentCloudAIDeskCustomer.navigate(
 ### **登录失败，提示签名错误怎么办？**
 
 请检查 SDKAppID 和 UserSig 是否正确，UserSig 是否已过期。可以参考上文 配置用户鉴权 重新生成 UserSig。
+

package/resource/integration/chat/preset/ios/integration.md

@@ -595,3 +595,4 @@ NSString *avatar = @"";
 #### **登录失败，提示签名错误怎么办？**
 
 请检查 SDKAppID 和 UserSig 是否正确，UserSig 是否已过期。可以参考上文“配置用户鉴权”重新生成 UserSig。
+

package/resource/integration/chat/preset/react/integration.md

@@ -510,3 +510,4 @@ function onChatSettingClose() {
 - [chat-uikit-react npm](https://www.npmjs.com/package/@tencentcloud/chat-uikit-react)
 
 - [GitHub Demo](https://github.com/TencentCloud/chat-uikit-react)
+

package/resource/integration/chat/preset/uni-app/integration.md

@@ -544,3 +544,4 @@ import MessageInput, { DEFAULT_TOOLS } from '@/uni_modules/tuikit-atomic-x/compo
 const customToolList = computed(() => DEFAULT_TOOLS.filter(tool => tool.id !== 'videoCall' && tool.id !== 'voiceCall'));
 </script>
 ```
+

package/resource/integration/chat/preset/vue/integration.md

@@ -549,3 +549,4 @@ const isChatSettingShow = ref(false);
 ### GitHub
 
 [GitHub Demo](https://github.com/Tencent-RTC/TUIKit_Vue3/tree/main/demos/rtcube-vite-vue3)
+

package/resource/integration/livekit/preset/live/android/prepare-integration.md

@@ -256,3 +256,4 @@ class YourLoginService {
 ### 集成代码后还需要添加摄像头麦克风等权限的声明吗？
 
 不需要，TUILiveKit 中已经内置了摄像头麦克风等权限的声明，在接入过程中您无需再关心这些权限的声明。
+

package/resource/integration/livekit/preset/live/vue/live-player-desk-integration.md

@@ -131,8 +131,8 @@ import { UIKitProvider } from '@tencentcloud/uikit-base-component-vue3';
 我们支持您根据项目需求对观众观看页面进行 UI 定制——除页面布局调整外，还可对**颜色主题、字体、圆角、输入框、弹框**等内容进行增删改；若需新增或替换按钮（Button）、图标（Icon）等控件，也可找到对应控件的指定位置源码，直接进行增加、删除、替换等操作，满足您的 UI 定制需要。
 | <strong>类别</strong> | <strong>功能</strong> | <strong>描述</strong> | <strong>组件详细定制指引</strong> |
 | --- | --- | --- | --- |
-| <strong>素材管理</strong> | 自定义素材管理区域展示 | <strong>支持：</strong><br>- <strong>调整展示 Icon 的大小、颜色或对 Icon 进行替换。</strong> | <a href="https://cloud.tencent.com/document/product/647/123838">媒体源配置面板</a> |
-| <strong>在线观众</strong> | 自定义观众信息展示 | <strong>支持：</strong><br>- <strong>展示或隐藏观众等级。</strong><br>- <strong>观众信息字体、颜色 UI 自定义设置。</strong><br>- <strong>替换为您需要的 Icon 风格。</strong> | <a href="https://cloud.tencent.com/document/product/647/123834">视频源编辑画板</a> |
+| <strong>直播视频</strong> | 自定义直播视频区域展示 | <strong>支持：</strong><br>- <strong>调整展示 Icon 的大小、颜色或对 Icon 进行替换。</strong><br>- <strong>自定义视频挂件。</strong> | 直播视频组件 |
+| <strong>在线观众</strong> | 自定义观众信息展示 | <strong>支持：</strong><br>- <strong>展示或隐藏观众等级。</strong><br>- <strong>观众信息字体、颜色 UI 自定义设置。</strong><br>- <strong>替换为您需要的 Icon 风格。</strong> | 观众列表 |
 | <strong>消息列表</strong> | 自定义消息弹幕区域展示 | <strong>支持：</strong><br>- <strong>展示或隐藏聊天输入区域。</strong><br>- <strong>支持 UI 定制聊天气泡风格、定制观众等级等内容。</strong> | <a href="https://cloud.tencent.com/document/product/647/123836">聊天弹幕组件</a> |
 
 ## 常见问题

package/resource/integration/livekit/preset/live/vue/live-pusher-integration.md

@@ -660,9 +660,9 @@ import { UIKitProvider } from '@tencentcloud/uikit-base-component-vue3';
 我们支持您根据项目需求对观众观看页面进行 UI 定制——除页面布局调整外，还可对**颜色主题、字体、圆角、输入框、弹框**等内容进行增删改；若需新增或替换按钮（Button）、图标（Icon）等控件，也可找到对应控件的指定位置源码，直接进行增加、删除、替换等操作，满足您的 UI 定制需要。
 | <strong>类别</strong> | <strong>功能</strong> | <strong>描述</strong> | <strong>组件详细定制指引</strong> |
 | --- | --- | --- | --- |
-| <strong>素材管理</strong> | 自定义素材管理区域展示 | <strong>支持：</strong><br>- <strong>调整展示 Icon 的大小、颜色或对 Icon 进行替换。</strong> | <a href="https://cloud.tencent.com/document/product/647/123838">媒体源配置面板</a> |
-| <strong>在线观众</strong> | 自定义观众信息展示 | <strong>支持：</strong><br>- <strong>展示/隐藏观众等级。</strong><br>- <strong>观众信息字体、颜色 UI 自定义设置。</strong><br>- <strong>替换为您需要的 Icon 风格。</strong> | <a href="https://cloud.tencent.com/document/product/647/123834">视频源编辑画板</a> |
-| <strong>消息列表</strong> | 自定义消息弹幕区域展示 | <strong>支持：</strong><br>- <strong>展示/隐藏聊天输入区域。</strong><br>- <strong>支持 UI 定制聊天气泡风格、定制观众等级等内容。</strong> | <a href="https://cloud.tencent.com/document/product/647/123836">聊天弹幕组件</a> |
+| <strong>直播视频</strong> | 自定义直播视频区域展示 | <strong>支持：</strong><br>- <strong>调整展示 Icon 的大小、颜色或对 Icon 进行替换。</strong><br>- <strong>自定义视频挂件。</strong> | 直播视频组件 |
+| <strong>在线观众</strong> | 自定义观众信息展示 | <strong>支持：</strong><br>- <strong>展示或隐藏观众等级。</strong><br>- <strong>观众信息字体、颜色 UI 自定义设置。</strong><br>- <strong>替换为您需要的 Icon 风格。</strong> | 观众列表 |
+| <strong>消息列表</strong> | 自定义消息弹幕区域展示 | <strong>支持：</strong><br>- <strong>展示或隐藏聊天输入区域。</strong><br>- <strong>支持 UI 定制聊天气泡风格、定制观众等级等内容。</strong> | <a href="https://cloud.tencent.com/document/product/647/123836">聊天弹幕组件</a> |
 
 ## 下一步
 

package/resource/integration/roomkit/preset/vue/integration.md

@@ -849,3 +849,4 @@ TUIRoomKit 已提供丰富的 UI 自定义能力，包括 主题及语言、界
 // 请替换为 TUIRoomKit 源码真实路径
 src/components/RoomKit
 ```
+

package/resource/knowledge/callkit/core-sdk/android/answer-call.md

@@ -827,3 +827,4 @@ class CallActivity : AppCompatActivity() {
 ### 在通话邀请超时时间内，被邀请者如果离线再上线，能否收到来电事件？
 
 单人通话时，如果在超时时间内上线，会触发来电邀请；群组通话，如果在超时时间内上线，会拉起未处理的20条群消息，如果存在通话邀请，则触发来电邀请事件。
+

package/resource/knowledge/callkit/core-sdk/android/make-call.md

@@ -912,3 +912,4 @@ MainScope().launch {
 ### 在通话邀请超时时间内，被邀请者如果离线再上线，能否收到来电事件？
 
 单人通话时，如果在超时时间内上线，会触发来电邀请；群组通话，如果在超时时间内上线，会拉起未处理的20条群消息，如果存在通话邀请，则触发来电邀请事件。
+

package/resource/knowledge/callkit/core-sdk/flutter/answer-call.md

@@ -1122,3 +1122,4 @@ iOS 端支持通过底层 TRTC 引擎实现应用外画中画功能。当应用
 ### 在通话邀请超时时间内，被邀请者如果离线再上线，能否收到来电事件？
 
 单人通话时，如果在超时时间内上线，会触发来电邀请；群组通话，如果在超时时间内上线，会拉起未处理的20条群消息，如果存在通话邀请，则触发来电邀请事件。
+

package/resource/knowledge/callkit/core-sdk/flutter/make-call.md

@@ -1195,3 +1195,4 @@ CallStore.shared.state.selfInfo.addListener(() {
 ### 在通话邀请超时时间内，被邀请者如果离线再上线，能否收到来电事件？
 
 单人通话时，如果在超时时间内上线，会触发来电邀请；群组通话，如果在超时时间内上线，会拉起未处理的20条群消息，如果存在通话邀请，则触发来电邀请事件。
+

package/resource/knowledge/callkit/core-sdk/ios/answer-call.md

@@ -1171,3 +1171,4 @@ class CallViewController: UIViewController {
 ### 在通话邀请超时时间内，被邀请者如果离线再上线，能否收到来电事件？
 
 单人通话时，如果在超时时间内上线，会触发来电邀请；群组通话，如果在超时时间内上线，会拉起未处理的20条群消息，如果存在通话邀请，则触发来电邀请事件。
+

package/resource/knowledge/callkit/core-sdk/ios/make-call.md

@@ -1272,3 +1272,4 @@ private func observeSelfCallStatus() {
 ### 在通话邀请超时时间内，被邀请者如果离线再上线，能否收到来电事件？
 
 单人通话时，如果在超时时间内上线，会触发来电邀请；群组通话，如果在超时时间内上线，会拉起未处理的20条群消息，如果存在通话邀请，则触发来电邀请事件。
+

package/resource/knowledge/callkit/core-sdk/ios/offline-push.md

@@ -1,4 +1,4 @@
-本文档将指导您如何基于 TIMPush 服务实现 VoIP 推送功能，适用于使用 AtomicXCore 进行无 UI 集成的场景。
+本文档将指导您如何基于 [TIMPush](https://cloud.tencent.com/document/product/269/133003) 服务实现 VoIP 推送功能，适用于使用 AtomicXCore 进行无 UI 集成的场景。
 
 > **注意：**
 > - 使用 **VoIP** 推送功能首先需要 开通 TIMPush 服务。

package/resource/knowledge/callkit/core-sdk/uni-app/answer-call.md

@@ -930,3 +930,4 @@ Android 端可以通过 onBackPress 拦截系统侧滑和物理返回，示例
   });
 </script>
 ```
+

package/resource/knowledge/callkit/core-sdk/uni-app/make-call.md

@@ -1038,3 +1038,4 @@ Android 端可以通过 onBackPress 拦截系统侧滑和物理返回，示例
   });
 </script>
 ```
+

package/resource/knowledge/callkit/faq/flutter.md

@@ -50,3 +50,4 @@ iOS 在执行`pod install`出现如下报错：
 3. 登录 API 调整更规范，不需要再指定参数。
 
 4. 离线推送参数构造优化。
+

package/resource/knowledge/callkit/faq/uniapp-app.md

@@ -85,3 +85,4 @@
 [uni-app 官网文档介绍](https://nativesupport.dcloud.net.cn/AppDocs/usemodule/androidModuleConfig/android_Library) 第三方 SDK 使用 LiteAVSDK（weex_livepusher-release.aar）做直播推流，和 uniapp TUICallKit 使用的 LiteAVSDK_TRTC 类冲突。和 uni-app 技术沟通后，对方反馈不清楚 SDK 属于哪个版本类型，因此 uni-app 他们无法对 livepusher 进行升级。
 
 **解决方案：**
+

package/resource/knowledge/chat/preset/android-view/integration.md

@@ -329,3 +329,4 @@ TencentAiDeskCustomer.getInstance().initWithProfile(context, SDKAppID, userID, u
 ##### 表情包的使用
 
 为了尊重版权，IM Demo/TUIKit 工程中默认不包含大表情元素切图。正式上线商用前请您替换为自己设计或拥有版权的其他表情包。下图所示默认的**小黄脸表情包版权归腾讯云所有**，可有偿授权使用，如需获得授权，您可以通过升级至 [IM 企业版套餐](https://buy.cloud.tencent.com/avc) 免费使用该表情包。
+

package/resource/knowledge/chat/preset/ios-uikit/integration.md

@@ -1165,3 +1165,4 @@ end
 ##### 表情包的使用
 
 为了尊重版权，IM Demo/TUIKit 工程中默认不包含大表情元素切图。正式上线商用前请您替换为自己设计或拥有版权的其他表情包。下图所示默认的**小黄脸表情包版权归腾讯云所有**，可有偿授权使用，如需获得授权，您可以通过升级至 [IM 企业版套餐](https://buy.cloud.tencent.com/avc) 免费使用该表情包。
+

package/resource/knowledge/chat/preset/react/features/message-input.md

@@ -13,7 +13,8 @@ MessageInput 是一个功能完整的消息输入组件，提供了文本编辑
 |className|string|undefined|根容器自定义 CSS 类名|
 |style|React.CSSProperties|undefined|根容器自定义内联样式|
 |attachmentPickerMode|'collapsed' \| 'expanded'|'collapsed'|附件选择器显示模式|
-|actions|MessageInputActions|['EmojiPicker', 'AttachmentPicker']|工具栏操作按钮配置|
+|actions|MessageInputActions|['EmojiPicker', 'FilePicker']|工具栏操作按钮配置|
+|setOfflinePushInfo|(payload: SendMessagePayload) => OfflinePushInfo \| undefined|undefined|发送消息时修改携带的离线推送参数|
 |slots|MessageInputSlots|undefined|插槽配置对象|
 |TextEditor|JSX.Element|undefined|自定义文本编辑器组件|
 |EmojiPicker|JSX.Element|undefined|自定义表情选择器组件|
@@ -73,8 +74,8 @@ attachmentPickerMode 用于设置附件选择器的显示模式，默认值为 `
    >
    > 默认的 AttachmentPicker 意为附件选择器，包括文件选择、图片选择和视频选择。
    >
-   > 1. 当 attachmentPickerModel 为 "collapsed" 时，点击附件选择器会弹出一个 popup 菜单展示文件选择、图片选择、视频选择。
-   > 2. 当 attachmentPickerModel 为 "expanded" 时，附件选择器会默认展开，平铺展示文件选择、图片选择、视频选择。
+   > 1. 当 attachmentPickerMode 为 "collapsed" 时，点击附件选择器会弹出一个 popup 菜单展示文件选择、图片选择、视频选择。
+   > 2. 当 attachmentPickerMode 为 "expanded" 时，附件选择器会默认展开，平铺展示文件选择、图片选择、视频选择。
 
 ### actions
 
@@ -186,6 +187,63 @@ function CustomerServiceChat() {
 }
 ```
 
+### setOfflinePushInfo
+
+参数类型：`(payload: SendMessagePayload) => OfflinePushInfo | undefined`
+
+setOfflinePushInfo 用于在发送前根据当前的消息内容设置自定义的离线推送参数。
+``` typescript
+type SendMessagePayload = {
+    type: 'textMessage';
+    text: string;
+} | {
+    type: 'customMessage';
+    customData: string;
+    description?: string;
+    extensionInfo?: string;
+} | {
+    type: 'imageMessage';
+    file: File | HTMLInputElement;
+    width?: number;
+    height?: number;
+} | {
+    type: 'audioMessage';
+    file: File | HTMLInputElement;
+    duration: number;
+} | {
+    type: 'videoMessage';
+    file: File | HTMLInputElement;
+    duration: number;
+    snapshotFile?: File | HTMLInputElement;
+    snapshotWidth?: number;
+    snapshotHeight?: number;
+} | {
+    type: 'fileMessage';
+    file: File | HTMLInputElement;
+} | {
+    type: 'locationMessage';
+    description: string;
+    longitude: number;
+    latitude: number;
+} | {
+    type: 'faceMessage';
+    index: number;
+    data: string;
+};
+
+interface OfflinePushInfo {
+    title: string;
+    description: string;
+    extensionInfo: {
+      disablePush: boolean;
+      disableVoipPush: boolean;
+      extension: string;
+      androidInfo: Record<string, any>;
+      apnsInfo: Record<string, any>;
+    };
+}
+```
+
 ### slots
 
 参数类型: `MessageInputSlots`

package/resource/knowledge/chat/preset/react/features/message-list.md

@@ -10,6 +10,7 @@ MessageList 是一个功能强大的聊天消息列表组件，提供了完整
 | messageActionList | IMessageAction[] | ['copy', 'recall', 'quote', 'forward', 'delete'] | 自定义消息操作列表，例如复制、撤回、删除等。 |
 | messageAggregationTime | number | 300 (5分钟) | 消息聚合时间间隔（秒），相同发送者在此时间内的连续消息会被聚合显示。 |
 | filter | (message: MessageInfo) => boolean | undefined | 消息过滤函数，用于控制哪些消息需要显示。 |
+| showSelfAvatar | boolean | false | 自己发出的消息是否展示头像。 |
 | className | string | undefined | 自定义 CSS 类名。 |
 | style | React.CSSProperties | undefined | 自定义内联样式。 |
 | Message | React.ComponentType | Message | 自定义消息组件。 |
@@ -175,6 +176,12 @@ function ChatApp() {
 }
 ```
 
+### showSelfAvatar
+
+参数类型: `boolean`
+
+为了更好的利用屏幕效率，自己发送的消息默认不展示头像，默认值为 `false`。
+
 ### className
 
 参数类型: `string`

package/resource/knowledge/chat/preset/vue/features/message-input.md

@@ -10,6 +10,7 @@ MessageInput 是一个功能完整的消息输入组件，专为 Vue3 应用设
 |disabled|boolean|false|是否禁用输入组件|
 |placeholder|string|''|输入框占位符文本|
 |actions|MessageInputActions|['EmojiPicker', 'ImagePicker', 'FilePicker', 'VideoPicker']|工具栏操作按钮配置|
+|setOfflinePushInfo|(payload: SendMessagePayload) => OfflinePushInfo \| undefined|undefined|发送消息时修改携带的离线推送参数|
 
 ## Slots 配置
 
@@ -35,11 +36,6 @@ MessageInput 是一个功能完整的消息输入组件，专为 Vue3 应用设
 
 - 详细说明：disabled 用于设置是否禁用整个输入组件，包括文本输入和所有操作按钮，默认值为 `false`。
 
-### hideSendButton
-- 类型：`boolean`
-
-- 详细说明：hideSendButton 用于设置是否隐藏发送按钮，适用于需要自定义发送触发方式的场景，默认值为 `false`。
-
 ### placeholder
 - 类型：`string`
 
@@ -357,6 +353,63 @@ const CustomEmojiPicker = defineComponent({
 
 示例效果：
 
+### setOfflinePushInfo
+
+参数类型：`(payload: SendMessagePayload) => OfflinePushInfo | undefined`
+
+setOfflinePushInfo 用于在发送前根据当前的消息内容设置自定义的离线推送参数。
+``` typescript
+type SendMessagePayload = {
+    type: 'textMessage';
+    text: string;
+} | {
+    type: 'customMessage';
+    customData: string;
+    description?: string;
+    extensionInfo?: string;
+} | {
+    type: 'imageMessage';
+    file: File | HTMLInputElement;
+    width?: number;
+    height?: number;
+} | {
+    type: 'audioMessage';
+    file: File | HTMLInputElement;
+    duration: number;
+} | {
+    type: 'videoMessage';
+    file: File | HTMLInputElement;
+    duration: number;
+    snapshotFile?: File | HTMLInputElement;
+    snapshotWidth?: number;
+    snapshotHeight?: number;
+} | {
+    type: 'fileMessage';
+    file: File | HTMLInputElement;
+} | {
+    type: 'locationMessage';
+    description: string;
+    longitude: number;
+    latitude: number;
+} | {
+    type: 'faceMessage';
+    index: number;
+    data: string;
+};
+
+interface OfflinePushInfo {
+    title: string;
+    description: string;
+    extensionInfo: {
+      disablePush: boolean;
+      disableVoipPush: boolean;
+      extension: string;
+      androidInfo: Record<string, any>;
+      apnsInfo: Record<string, any>;
+    };
+}
+```
+
 ## Slots 详解
 - 类型：`MessageInputSlots`
 

package/resource/knowledge/chat/preset/vue/features/message-list.md

@@ -50,6 +50,7 @@ import { UIKitProvider, Chat, MessageList, MessageInput } from '@tencentcloud/ch
 |messageActionList|MessageAction[]|undefined|自定义消息操作列表，例如撤回、删除等。|
 |messageAggregationTime|number|300 (秒)|消息聚合的时间间隔（秒），在此时间内发送的同一发送者的消息会被聚合。设置为 0 可禁用消息聚合。|
 |filter|(message: MessageInfo) => boolean|undefined|自定义消息过滤函数，用于控制哪些消息应该显示。|
+|showSelfAvatar|boolean|false|自己发出的消息是否展示头像。|
 |enableReadReceipt|boolean|false|是否启用消息已读回执功能。|
 |Message|Component|undefined|自定义消息组件，用于渲染单条消息。|
 |MessageTimeDivider|Component|undefined|自定义消息时间分割线组件。|
@@ -228,6 +229,12 @@ const customMessageFilter = (message: MessageInfo): boolean => {
 </script>
 ```
 
+### showSelfAvatar
+
+参数类型: `boolean`
+
+为了更好的利用屏幕效率，自己发送的消息默认不展示头像，默认值为 `false`。
+
 ### Message
 - 类型：Component | undefined
 

package/resource/knowledge/chat/urls/product.md

@@ -24,18 +24,18 @@
 | 单聊消息权限控制与配置 | `https://cloud.tencent.com/document/product/269/3662` |
 | 群组消息管理（App 管理员发送消息/群消息发送控制/消息优先级与频率控制
 ） | `https://cloud.tencent.com/document/product/269/3663` |
-| 不同类型群组基础能力操作差异 | `https://cloud.tencent.com/document/product/269/1502` |
-| 不同类型群组加群方式差异 | `https://cloud.tencent.com/document/product/269/1502` |
-| 不同类型群组成员管理能力差异 | `https://cloud.tencent.com/document/product/269/1502` |
-| 不同类型群组群组限制差异 | `https://cloud.tencent.com/document/product/269/1502` |
-| 不同类型群组消息能力差异 | `https://cloud.tencent.com/document/product/269/1502` |
+| 群组基础能力操作差异 | `https://cloud.tencent.com/document/product/269/1502` |
+| 群组加群方式差异 | `https://cloud.tencent.com/document/product/269/1502` |
+| 群组成员管理能力差异 | `https://cloud.tencent.com/document/product/269/1502` |
+| 群组限制差异 | `https://cloud.tencent.com/document/product/269/1502` |
+| 群组消息能力差异 | `https://cloud.tencent.com/document/product/269/1502` |
 | 群组/群成员/群消息导入 | `https://cloud.tencent.com/document/product/269/1502` |
 | 群组自动回收能力 | `https://cloud.tencent.com/document/product/269/1502` |
 | 自定义群组ID(话题 ID) | `https://cloud.tencent.com/document/product/269/1502` |
 | 群组自定义字段 | `https://cloud.tencent.com/document/product/269/1502` |
 | 云端审核能力介绍 | `https://cloud.tencent.com/document/product/269/83795` |
 
-### 使用限制
+## 使用限制
 
 | 子问题 | 目标文档 |
 |--------|---------|
@@ -46,7 +46,7 @@
 | 关系链管理限制（添加与删除好友限制/好友分组限制/黑名单限制/批量好友接口上限等） | `https://cloud.tencent.com/document/product/269/32429` |
 | 群组管理限制（群主转让/群成员禁言/群封禁人数限制/群计数器限制/群自定义字段数等） | `https://cloud.tencent.com/document/product/269/32429` |
 
-## 出海解决方案
+## 海外解决方案
 
 | 子问题 | 目标文档 |
 |--------|---------|
@@ -54,7 +54,7 @@
 | 海外节点全球加速 | `https://cloud.tencent.com/document/product/269/86463` |
 | 海外数据安全合规 | `https://cloud.tencent.com/document/product/269/86464` |
 
-## 场景解决方案
+## 内网代理实现方案
 
 | 子问题 | 目标文档 |
 |--------|---------|