@tencentcloud/sdk-mcp 1.7.3 → 1.7.5

package/resource/knowledge/callkit/preset/uni-app/integration.md

@@ -0,0 +1,353 @@
+本文将介绍如何快速接入 TUICallKit 组件。您可以在 10 分钟内完成以下关键步骤，最终获得一个功能完备的音视频通话界面。
+
+> **说明：**
+> 自 2025 年 5 月 1 日起，由于 uni-app 官方限制，CallKit 原生语言插件已终止迭代，为保障业务持续稳定运行，现提供 CallKit UTS 插件方案。
+>
+> ​​CallKit UTS 插件核心优势：​​
+>
+> - 支持自定义 UI、深度界面定制。
+> - 支持 uni-app 项目。
+> - 提供插件版本锁定功能，避免因更新导致兼容性问题。
+
+## 准备工作
+
+### 环境要求
+
+> **说明：**
+> HBuilderX 4.64 和 4.65 版本对 UTS 插件打包存在已知兼容性问题，建议使用 4.66 或更高版本。
+>
+
+- [HBuilderX](https://www.dcloud.io/hbuilderx.html)：HBuilderX 是 **uni-app 官方**的集成开发环境（IDE），我们需要用它来导入、配置和运行我们的 Demo。
+
+- 2个移动设备： Android 5.0 以上的设备 / iOS 13.0 及以上设备。
+
+### 开通服务
+
+您需要开通腾讯云服务，以获取应用所需的唯一身份标识和密钥。 。
+
+## 代码集成
+
+### **步骤 1：下载 TUICallKit 源码**
+
+【Vue3】
+1. **克隆项目源码。**
+
+``` bash
+git clone https://github.com/Tencent-RTC/TUIKit_uni-app.git
+```
+2. **导入 atomic-x 组件。**
+
+   - 将源码中 `TUIKit_uni-app/App/uni_modules` 目录下的 `tuikit-atomic-x` 文件夹，完整拷贝到您项目根目录下的 `uni_modules` 文件夹中。
+
+   - 将源码中 `TUIKit_uni-app/App/components` 下的文件，完整地拷贝到您项目的 `components` 文件夹中。
+
+   - 将源码中 `TUIKit_uni-app/App/static` 目录下的文件，完整拷贝到您项目根目录下的同名文件夹下。
+
+   - 将源码中 `TUIKit_uni-app/App/debug` 文件夹拷贝到您项目的根目录下，这个目录提供可以方便您在客户端快速生成的 **UserSig** 的快捷函数。
+
+3. **合并 App.vue 配置。**
+
+**TUIKit_uni-app/App/App.vue** 文件中包含通话能力的初始化逻辑，因此您需要将 **TUIKit_uni-app/App/App.vue** 文件和您项目下的 **App.vue** 文件进行合并。
+
+   > **注意：**
+   >
+   > 不要直接覆盖 **App.vue** 文件！ 打开源码中的 **TUIKit_uni-app/App/App.vue**， 将其 `<script>` 部分的 ts 内容追加到您自己项目的 **App.vue** 的 `<script>`  标签内。
+   >
+
+【Vue2】
+1. **安装 TUIKit 插件。**
+
+进入[【官方】腾讯云聊天+通话+直播响应式 SDK](https://ext.dcloud.net.cn/plugin)。点击【下载插件并导入 HBuilderX】，将插件导入您的项目中。
+
+2.  **导入 atomic-x 组件。**
+
+   1. **转化兼容模式**：仅 Vue2 项目，Vue3 项目可忽略。
+
+      > **说明：**
+      >
+      > 该脚本用于将插件源码中 Vue3 的 Composition API 写法自动转换为 Vue2 的 Options API 写法，以确保在 Vue2 项目中正常运行。
+      >
+
+``` bash
+node ./uni_modules/tuikit-atomic-x/scripts/switch-to-compatible-mode.js
+```
+   2. **拷贝静态资源**：将 `⁠uni_modules/tuikit-atomic-x/quickstart/` ⁠下的 ⁠⁠`static/*⁠` 拷贝到项目 `static` 目录下。
+
+【Mac 端】
+``` java
+cp -r uni_modules/tuikit-atomic-x/quickstart/static/* static/
+```
+
+【Windows 端】
+``` bash
+xcopy /E /I /Y "uni_modules\tuikit-atomic-x\quickstart\static\*" "static\"
+```
+3.  **合并 App.vue 配置。**
+
+通话能力的初始化需要在应用唤醒的时候进行，因此需要您将以下代码和您项目中的 `App.vue` 中的逻辑进行合并处理。
+``` typescript
+import { initCallService } from '@/uni_modules/tuikit-atomic-x/server/callService';
+  export default {
+    onLaunch: function() {
+	    initCallService()
+	    console.log('App Launch')
+	  },
+	onShow: function() {
+		console.log('App Show')
+	},
+	onHide: function() {
+		console.log('App Hide')
+	}
+}
+```
+
+### 步骤 2：工程配置
+1. 配置 `manifest.json`。
+
+   打开您项目的 **manifest.json** 文件，在 **app-plus** > **distribute** 节点下，确保添加了以下必要的权限：
+
+   - Android 平台（`Android` 节点）：在 `permissions` 数组中，请确保包含以下权限：
+
+      ``` json
+      "<uses-permission android:name=\"android.permission.CAMERA\"/>",
+      "<uses-permission android:name=\"android.permission.RECORD_AUDIO\" />",
+      "<uses-permission android:name=\"android.permission.INTERNET\"/>",
+      "<uses-permission android:name=\"android.permission.ACCESS_NETWORK_STATE\"/>",
+      "<uses-permission android:name=\"android.permission.WRITE_EXTERNAL_STORAGE\"/>",
+      "<uses-permission android:name=\"android.permission.SYSTEM_ALERT_WINDOW\"/>",
+      "<uses-permission android:name=\"android.permission.VIBRATE\"/>"
+      ```
+   - iOS 平台（`iOS` 节点）：在 `privacyDescription` 对象中，请确保包含以下描述：
+
+      ``` json
+      "NSCameraUsageDescription" : "应用需要访问您的相机以进行通话",
+      "NSMicrophoneUsageDescription" : "应用需要访问您的麦克风以进行通话"
+      ```
+
+      在 `UIBackgroundModes` 数组中，添加 `audio` 以支持后台播放音频。
+
+      ``` json
+      "UIBackgroundModes" : [ "audio" ]
+      ```
+2. 制作自定义基座。
+
+   > **说明：**
+   >
+   > 由于 TUICallKit 包含原生代码（UTS 插件），您**必须**制作自定义调试基座才能在真机上运行。
+   >
+
+   1. 在 HBuilderX 顶部菜单选择**运行** > **运行到手机或模拟器** > **制作自定义调试基座**。
+
+   2. 制作成功后，再次选择**运行** > **运行到手机或模拟器**，在弹窗中勾选**使用自定义调试基座**后运行到您的手机。
+
+      具体操作指引参见 跑通 Demo 的步骤3。
+
+### 步骤 3：完成登录
+
+集成完成后，您需要完成登录。在您项目中需要使用到通话能力的地方进行登录，这是**使用 TUICallKit 的关键步骤**，因为只有在登录成功后才能正常使用 TUICallKit 的各项功能，故请您耐心检查相关参数是否配置正确：
+
+【Vue3】
+``` typescript
+import { onMounted } from 'vue';
+import { useLoginState } from "@/uni_modules/tuikit-atomic-x/state/LoginState";
+
+const { login } = useLoginState();
+onMounted(() => {
+  login({
+	sdkAppID: 1400000001,     // 请替换为开通服务控制台的 SDKAppID
+	userID: "denny",        // 请替换为您的 UserID
+	userSig: "xxxxxxxxxxx",  // 您可以在控制台中计算一个 UserSig 并填在这个位置
+  });
+});
+```
+
+【Vue2】
+``` typescript
+<script>
+import { useLoginState } from '@/uni_modules/tuikit-atomic-x/state/LoginState'
+
+export default {
+  data() {
+    var loginStore = useLoginState()
+    return {
+      loginStore: loginStore,
+      userId: '',
+      userSig: ''
+    }
+  },
+  methods: {
+    handleLogin: function () {
+      if (!this.userId || !this.userSig) return
+      var self = this
+      this.loginStore.login({
+        sdkAppID: 1400000001,  // 你的 SDKAppID
+        userID: this.userId,
+        userSig: this.userSig,
+      })
+    }
+  }
+}
+</script>
+
+```
+
+**登录接口参数说明**
+| 参数 | 类型 | 说明 |
+| --- | --- | --- |
+| SDKAppID | Number | 从 <a href="https://console.cloud.tencent.com/trtc">TRTC 控制台 > 应用管理</a> 获取。 |
+| userID | String | 当前用户的唯一 ID，仅包含英文字母、数字、连字符和下划线。 |
+| userSig | String | 用于腾讯云鉴权的票据。请注意：<br>- 开发环境：您可以采用本地 <code>GenerateTestUserSig.genTestSig</code> 函数生成 UserSig 或者通过 <a href="https://console.cloud.tencent.com/im/tool-usersig">UserSig 辅助工具</a> 生成临时的 UserSig。<br>- 生产环境：为了防止密钥泄露，请务必采用服务端生成 UserSig 的方式。详细信息请参见 <a href="https://cloud.tencent.com/document/product/647/17275#formal">服务端生成 UserSig</a>。<br>更多信息请参见 <a href="https://cloud.tencent.com/document/product/647/17275">如何计算及使用 UserSig</a>。 |
+
+### 步骤 4：注册通话页面
+
+现在，您需要在 `pages.json` 文件中告诉您的应用，这个新页面是存在的。
+
+打开您项目根目录下的 `pages.json` 文件，在 `"pages"` 数组中，添加以下对象来注册通话页。
+``` java
+{
+    "pages": [
+        // ... 您项目已有的其他页面配置
+        {
+            "path": "uni_modules/tuikit-atomic-x/pages/call",
+            "style": {
+                "navigationBarTitleText": "",
+                "disableSwipeBack": true, // 禁止右滑返回，防止直播中误操作退出
+                "app-plus": {
+                    "titleNView": false // 隐藏原生导航栏，使用页面内的自定义导航
+                }
+            }
+        }
+    ]
+    // ... 其他配置
+}
+
+```
+
+### 步骤5：跳转通话页面
+
+在您需要发起通话的地方（具体由您的业务决定，在其点击事件里执行），您需要先调用 calls 函数。在该函数成功执行的 success 回调中，再通过 uni.navigateTo 跳转到通话页面，以确保通话状态已正确建立。
+
+【Vue3】
+``` typescript
+import { useCallState } from '@/uni_modules/tuikit-atomic-x/state/CallState';
+import { useDeviceState } from "@/uni_modules/tuikit-atomic-x/state/DeviceState";
+const { calls } = useCallState()
+const { openLocalCamera, openLocalMicrophone } = useDeviceState();
+
+// 示例：在一个按钮的点击事件中
+function startCall() {
+    // 跳转到通话页
+    calls({
+      participantIds: ['xxx'],
+      mediaType: 1, // 1 是视频通话, 0 是语音通话
+      success: () => {
+        openLocalCamera({isFront: true})
+        openLocalMicrophone()
+        uni.navigateTo({
+          url: '/uni_modules/tuikit-atomic-x/pages/call?layoutTemplate=Float'
+        })
+      },
+      fail: (error) => {
+        console.log('calls fail:', error)
+      }
+    });
+}
+
+```
+
+【Vue2】
+``` typescript
+<script>
+import { useCallState, CallMediaType } from '@/uni_modules/tuikit-atomic-x/state/CallState'
+import { useDeviceState } from '@/uni_modules/tuikit-atomic-x/state/DeviceState'
+
+export default {
+  data() {
+    var callStore = useCallState()
+    var deviceStore = useDeviceState()
+    return {
+      callStore: callStore,
+      deviceStore: deviceStore,
+      // 要呼叫的用户 ID
+      participantId: 'xxx'
+    }
+  },
+  methods: {
+    startCall: function () {
+      var self = this
+
+      // 发起通话
+      this.callStore.calls({
+        participantIds: [this.participantId],  // 被呼叫者用户 ID 数组
+        mediaType: CallMediaType.Video,        // 1 是视频通话, 0 是语音通话
+        success: function () {
+          console.log('发起通话成功')
+
+          // 打开本地摄像头
+          self.deviceStore.openLocalCamera({
+            isFront: true,  // 使用前置摄像头
+            success: function () {
+              console.log('摄像头打开成功')
+            },
+            fail: function (errCode, errMsg) {
+              console.log('摄像头打开失败:', errMsg)
+            }
+          })
+
+          // 打开本地麦克风
+          self.deviceStore.openLocalMicrophone({
+            success: function () {
+              console.log('麦克风打开成功')
+            },
+            fail: function (errCode, errMsg) {
+              console.log('麦克风打开失败:', errMsg)
+            }
+          })
+
+          // 跳转到通话页面
+          uni.navigateTo({
+            url: '/uni_modules/tuikit-atomic-x/pages/call?layoutTemplate=Float'
+          })
+        },
+        fail: function (error) {
+          console.log('发起通话失败:', error)
+        }
+      })
+    }
+  }
+}
+</script>
+```
+
+> **说明：**
+> 在 `tuikit-atomic-x/server/callService` 文件中进行了默认处理被叫端收到呼叫的逻辑，若您需要自定义，可以修改该文件中的 `"onCallReceived"` 事件对应的处理逻辑。
+>
+
+## 常见问题
+
+### 调用接口没有反应？
+
+请检查您是否制作了自定义基座并且使用自定义基座运行项目。
+
+### 如何禁止系统侧滑返回上一个页面的行为？
+
+iOS 端可以通过设置页面上的 **disableSwipeBack** 属性进行禁止。详情参考 [uni-app 官方文档](https://uniapp.dcloud.net.cn/collocation/pages.html)。
+
+Android 端可以通过 **onBackPress** 拦截系统侧滑和物理返回，示例代码如下
+
+> **注意：**
+> 使用该方式进行系统侧滑和物理返回的拦截的前提是该页面使用的是 [自定义导航栏](https://uniapp.dcloud.net.cn/collocation/pages.html#customnav)。
+>
+
+``` typescript
+<script setup>
+  import { onBackPress } from '@dcloudio/uni-app'
+
+  // 拦截系统侧滑和物理返回键，防止通话中误退出
+  onBackPress((option) => {
+    if (option.from === 'backbutton') {
+      return true; // 返回 true 阻止默认回退行为
+    }
+  });
+</script>
+```

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

@@ -15,9 +15,9 @@ TUIKit 采用数据驱动的响应式架构与原生 Android View 体系（非 C
 
 - 一个有效的腾讯云账号及 Chat 应用。可参考 开通服务 从控制台获取以下信息：
 
-  - SDKAppID：App 在控制台获取的 Chat 应用的 ID，为应用的唯一标识。
+   - SDKAppID：App 在控制台获取的 Chat 应用的 ID，为应用的唯一标识。
 
-  - SDKSecretKey：应用的密钥。
+   - SDKSecretKey：应用的密钥。
 
       > **版本兼容性说明：**
       >
@@ -42,16 +42,16 @@ git clone https://cnb.cool/tencent/cloud/trtc/TUIKit_Android
 // 或者 git clone https://github.com/Tencent-RTC/TUIKit_Android.git
 ```
 
-将仓库根目录下的 `chat`、`atomic_x`（以及可选的、用于音视频通话的 `call`）文件夹整体复制到您的工程根目录下。复制完成后的目录结构如下：
+将仓库根目录下的 `chat`、`call` 和 `atomic_x` 文件夹整体复制到您的工程根目录下。复制完成后的目录结构如下：
 ``` text
 YourApplication/
 ├── app/                    # 您的应用模块
-├── atomic_x/               # 基础 UI 组件库（必要）
-├── call/                   # 音视频通话组件（可选）
+├── atomic_x/               # 基础 UI 组件库
+├── call/                   # 音视频通话组件
 │   └── tuicallkit-kt/
 ├── chat/                   # Chat 源码
-│   ├── demo/               # 示例工程（可参考，非必需）
-│   └── uikit/              # Chat UIKit 组件库（必要）
+│   ├── demo/               # 示例工程
+│   └── uikit/              # Chat UIKit 组件库
 ├── settings.gradle.kts
 └── build.gradle.kts
 ```
@@ -67,15 +67,12 @@ YourApplication/
 ``` kotlin
 // settings.gradle.kts
 
-// 引入 Chat UIKit 组件库（必要）
-include(":uikit")
-project(":uikit").projectDir = file("${settingsDir.path}/chat/uikit")
-
-// 引入 AtomicX 基础 UI 组件库（必要）
 include(":atomic_x")
 project(":atomic_x").projectDir = file("${settingsDir.path}/atomic_x")
 
-// 引入音视频通话组件（可选，集成音视频通话时需要）
+include(":uikit")
+project(":uikit").projectDir = file("${settingsDir.path}/chat/uikit")
+
 include(":tuicallkit-kt")
 project(":tuicallkit-kt").projectDir = file("${settingsDir.path}/call/tuicallkit-kt")
 ```
@@ -84,15 +81,12 @@ project(":tuicallkit-kt").projectDir = file("${settingsDir.path}/call/tuicallkit
 ``` groovy
 // settings.gradle
 
-// 引入 Chat UIKit 组件库（必要）
-include ':uikit'
-project(':uikit').projectDir = new File(settingsDir, 'chat/uikit')
-
-// 引入 AtomicX 基础 UI 组件库（必要）
 include ':atomic_x'
 project(':atomic_x').projectDir = new File(settingsDir, 'atomic_x')
 
-// 引入音视频通话组件（可选，集成音视频通话时需要）
+include ':uikit'
+project(':uikit').projectDir = new File(settingsDir, 'chat/uikit')
+
 include ':tuicallkit-kt'
 project(':tuicallkit-kt').projectDir = new File(settingsDir, 'call/tuicallkit-kt')
 ```
@@ -103,10 +97,8 @@ project(':tuicallkit-kt').projectDir = new File(settingsDir, 'call/tuicallkit-kt
 ``` kotlin
 // app/build.gradle.kts
 dependencies {
-    // TUIKit 组件库（必要）
-    implementation(project(":uikit"))
     implementation(project(":atomic_x"))
-    // 音视频通话（可选）
+    implementation(project(":uikit"))
     implementation(project(":tuicallkit-kt"))
 }
 ```
@@ -115,10 +107,8 @@ dependencies {
 ``` groovy
 // app/build.gradle
 dependencies {
-    // TUIKit 组件库（必要）
-    implementation project(':uikit')
     implementation project(':atomic_x')
-    // 音视频通话（可选）
+    implementation project(':uikit')
     implementation project(':tuicallkit-kt')
 }
 ```
@@ -137,6 +127,8 @@ dependencies {
 ``` java
 import io.trtc.tuikit.atomicxcore.api.CompletionHandler
 import io.trtc.tuikit.atomicxcore.api.login.LoginStore
+import com.tencent.cloud.tuikit.engine.call.TUICallEngine
+import com.tencent.cloud.tuikit.engine.common.TUICommonDefine
 
 LoginStore.shared.login(
     context,
@@ -145,7 +137,19 @@ LoginStore.shared.login(
     userSig,  // String，控制台或服务端生成
     object : CompletionHandler {
         override fun onSuccess() {
-            // 登录成功，可跳转会话列表或聊天页
+            // 登录成功
+            TUICallEngine.createInstance(context).init(
+                sdkAppID, userID, userSig,
+                object : TUICommonDefine.Callback {
+                    override fun onSuccess() {
+                        // 初始化成功，可使用音视频通话能力
+                    }
+
+                    override fun onError(errCode: Int, errMsg: String) {
+                        // 初始化失败
+                    }
+                }
+            )
         }
         override fun onFailure(code: Int, desc: String) {
             // 登录失败，可弹框报错
@@ -158,37 +162,7 @@ LoginStore.shared.login(
 > 在正式的生产环境中，建议在您的服务端生成 UserSig，在需要时由 App 向业务服务器发起请求获取动态 UserSig 进行鉴权。详见 [服务端生成 UserSig](https://cloud.tencent.com/document/product/269/32688)。
 >
 
-#### 步骤3：构建会话列表界面
-
-会话列表只需创建 `ConversationsPageView` 并加入到您的布局即可。它会自动从本地读取最近会话，点击某个会话时通过 `onConversationClick` 回调返回该会话的 `conversationID`，您可据此跳转聊天界面。
-``` kotlin
-import android.os.Bundle
-import androidx.appcompat.app.AppCompatActivity
-import io.trtc.tuikit.chat.uikit.pages.ConversationsPageView
-
-class ConversationActivity : AppCompatActivity() {
-    override fun onCreate(savedInstanceState: Bundle?) {
-        super.onCreate(savedInstanceState)
-
-        val conversationsPage = ConversationsPageView(this)
-        conversationsPage.setHeaderTitle("消息")
-
-        // 点击会话回调，conversationID 已带 c2c_ / group_ 前缀
-        conversationsPage.onConversationClick = { conversationID ->
-            // 跳转到您的聊天界面，并将 conversationID 传入（可参考步骤4 的 ChatActivity）
-        }
-        // 可选：搜索、发起单聊、创建群聊等入口回调
-        conversationsPage.onSearchClick = { /* 跳转搜索页 */ }
-        conversationsPage.onStartChatClick = { /* 发起单聊 */ }
-        conversationsPage.onCreateGroupClick = { /* 创建群聊 */ }
-
-        // 将会话列表设置为页面内容
-        setContentView(conversationsPage)
-    }
-}
-```
-
-#### 步骤4：构建聊天界面
+#### 步骤3：构建聊天界面
 
 聊天界面使用 `ChatPageView` 展示和收发消息，通过 `setup` 传入 `conversationID` 即可。`conversationID` 的格式为：单聊 `c2c_<对方 UserID>`，群聊 `group_<群 GroupID>`。
 ``` kotlin
@@ -225,55 +199,14 @@ class ChatActivity : AppCompatActivity() {
 > 示例工程（demo）中提供了基于 `ChatPageView` 封装好的聊天页 `ChatActivity`（带标题栏、未读角标、群事件处理等），可直接复用或参考其实现进行自定义：`ChatActivity.start(context, conversationID)`。
 >
 
-#### 步骤5：构建联系人界面
+#### 步骤4：音视频通话
 
-联系人界面使用 `ContactsPageView` 展示好友列表、群组列表等，通过 `setup` 设置点击回调。点击联系人或群组时跳转对应聊天界面。
-``` kotlin
-import android.os.Bundle
-import androidx.appcompat.app.AppCompatActivity
-import io.trtc.tuikit.chat.uikit.pages.ContactsPageView
-
-class ContactActivity : AppCompatActivity() {
-    override fun onCreate(savedInstanceState: Bundle?) {
-        super.onCreate(savedInstanceState)
-
-        val contactsPage = ContactsPageView(this)
-        contactsPage.setHeaderTitle("通讯录")
-        contactsPage.setup(
-            onContactClick = { contactInfo ->
-                // 跳转到您的聊天界面，单聊会话 ID 为 "c2c_" + contactInfo.userID（可参考步骤4 的 ChatActivity）
-            },
-            onGroupClick = { contactInfo ->
-                // 跳转到您的聊天界面，群聊会话 ID 为 "group_" + contactInfo.userID（可参考步骤4 的 ChatActivity）
-            }
-        )
-        setContentView(contactsPage)
-    }
-}
-```
-
-#### 步骤6：主题设置（可选）
-
-TUIKit 通过 `ThemeStore` 支持设置主题色与浅色 / 深色主题切换。
-``` kotlin
-import io.trtc.tuikit.atomicx.theme.Theme
-import io.trtc.tuikit.atomicx.theme.ThemeStore
-
-// 设置主题色
-ThemeStore.shared(context).setPrimaryColor("#1C66E5")
-
-// 切换浅色 / 深色主题
-ThemeStore.shared(context).setTheme(Theme.lightTheme(context))
-// ThemeStore.shared(context).setTheme(Theme.darkTheme(context))
-```
-
-#### 步骤7：音视频通话（可选）
-
-若需在聊天中支持音视频通话，请先 [开通音视频服务](https://console.cloud.tencent.com/im)，并在集成步骤中引入 `:tuicallkit-kt` 组件。**登录成功后**初始化 `TUICallEngine，`即可在 Chat 组件中正常使用该功能。
+**登录成功后**初始化 `TUICallEngine，`即可在 Chat 组件中正常使用该功能。如需开通音视频通话服务，
 ``` kotlin
 import com.tencent.cloud.tuikit.engine.call.TUICallEngine
 import com.tencent.cloud.tuikit.engine.common.TUICommonDefine
 
+// 在步骤 2 的 LoginStore 登录成功回调中初始化 TUICallEngine
 TUICallEngine.createInstance(context).init(
     sdkAppID, userID, userSig,
     object : TUICommonDefine.Callback {
@@ -288,7 +221,7 @@ TUICallEngine.createInstance(context).init(
 )
 ```
 
-#### 步骤8：接入智能客服 Desk 用户端（可选）
+#### 步骤5：接入智能客服 Desk 用户端
 
 若需同时集成智能客服 Desk 用户端，请先 [开通智能客服 Desk 服务](https://cloud.tencent.com/document/product/269/96059)，并根据 [Android 接入智能客服用户端](https://cloud.tencent.com/document/product/269/110809) 文档完成 `com.tencentcloud.desk:aideskcustomer` 包引入和配置，即可在您的应用中引入客服会话能力。
 ``` java
@@ -319,6 +252,10 @@ TencentAiDeskCustomer.getInstance().initWithProfile(context, SDKAppID, userID, u
 });
 ```
 
+## AI 助手：知识咨询与代码集成
+
+在接入 IM SDK 过程中，您可以通过 MCP 使用 AI 助手，快速完成知识咨询、报错排查和 UIKit 集成代码生成。支持 Web/Android/iOS/Flutter/uni-app 等平台，答案基于官方文档。适用于查询 SDK API、UI 组件用法、服务端 API 与 IM 产品配置等场景，[立即体验，提出您的第一个问题](https://cloud.tencent.com/document/product/269/126983)。
+
 ## 常见问题
 
 ### 音视频常见问题
@@ -332,6 +269,21 @@ TencentAiDeskCustomer.getInstance().initWithProfile(context, SDKAppID, userID, u
 
 - 如果是群聊通话邀请，被邀请者离线再上线后会自动拉取最近 30 秒内的邀请，TUIKit 会自动唤起群通话界面。
 
+##### **如何移除音视频通话功能？**
+
+如果您不需要集成音视频通话功能，请在 `settings.gradle.kts`(或 `settings.gradle`) 和 `app` 模块的 `build.gradle.kts`(或 `build.gradle`) 文件中移除 `tuicallkit-kt` 依赖，并在步骤 3 创建聊天界面中关闭音视频通话开关，代码如下所示：
+``` java
+val messageInputConfig = ChatMessageInputConfig(
+    isShowAudioCall = false,  // 关闭语音通话
+    isShowVideoCall = false   // 关闭视频通话
+)
+val chatPageView = ChatPageView(this)
+chatPageView.setup(
+    conversationID = conversationID,
+    messageInputConfig = messageInputConfig
+）
+```
+
 ### 其他常见问题
 
 ##### 表情包的使用

package/resource/knowledge/chat/preset/ios/features/language.md

@@ -26,7 +26,7 @@ iOS 端 `TUIKit`默认自带 **简体中文、英语** 和 **阿拉伯语** 语
 
 > **说明**
 >
->  语言代码清单见 附录。
+>  语言代码清单见 [附录](#code)。
 >
 
 ## 使用更多语言/自定义翻译表述
@@ -37,7 +37,7 @@ iOS 端 `TUIKit`默认自带 **简体中文、英语** 和 **阿拉伯语** 语
 
 我们自带的所有语言包，以String文件模板的形式，存储于您项目里Pods中`TUICore`组件的`TUIKitLocalizable/Localizable/` 路径。
 
-请新建目录并命名为`{语言编码}.lproj`，在此目录下新增 `Localizable.strings`文件，其中，`${语言编码}` 需要替换为 ISO 639-1 语言代码。（可以直接复制您熟悉的语言文件，如zh-Hans.lproj，并直接修改目录名称）
+请新建目录并命名为`{语言编码}.lproj`，在此目录下新增 `Localizable.strings`文件，其中，`${语言编码}` 需要替换为 [ISO 639-1 语言代码](#code)。（可以直接复制您熟悉的语言文件，如zh-Hans.lproj，并直接修改目录名称）
 如果您需要兼容支持多个新语言，复制多份，并准确指定每一份的语言编码即可。
 
 以韩语为例，新增`ko.lproj/Localizable.strings`的语言资源文件：
@@ -52,17 +52,17 @@ iOS 端 `TUIKit`默认自带 **简体中文、英语** 和 **阿拉伯语** 语
 
 如果是其他语种，则需要在 `TUIGlobalization.m`中的`+ (NSString *)tk_localizableLanguageKey`
 
-新增的语言词条包命名需要 符合标准，组件内部会跟随系统语言自适应。
+新增的语言词条包命名需要 [符合标准](#code)，组件内部会跟随系统语言自适应。
 
 > **说明**
 >
->  语言代码清单见 ISO 639-1 语言代码。
+>  语言代码清单见 [ISO 639-1 语言代码](#code)。
 >
 
 ### 指定显示的语言
 
 如果您需要指定`TUIKit`界面语言，请在`[TUIGlobalization setPreferredLanguage:@""]`中传入需要的语言，指定语言后，组件内部不再跟随系统语言。
-语言可选项，取值为 ISO 639-1 语言代码
+语言可选项，取值为 [ISO 639-1 语言代码](#code)
 以韩语为例，传入`[TUIGlobalization setPreferredLanguage:@"ko"];`
 
 ## 附录：语言代码表