@tencentcloud/sdk-mcp 1.7.3 → 1.7.5

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

@@ -1,1021 +1,283 @@
 TUIKit 是基于 IM SDK 的一款 UI 组件库，可通过 UI 组件快速实现聊天、会话、搜索、关系链、群组等功能。本文介绍如何快速集成 TUIKit 并实现核心功能。
 
-## 关键概念
-- **经典版 UI**：从 5.7.1435 版本开始，TUIKit 支持模块化集成，支持了经典版 UI（类微信 UI）。
+## 集成 TUIKit
 
-- **简约版 UI**：从 6.9.3557 版本开始，TUIKit 新增了全新的简约版 UI（类 WhatsApp UI）。
+TUIKit 采用数据驱动的响应式架构与原生 iOS UIKit 体系（非声明式 UI ），以源码方式开放集成。它提供会话列表、聊天、联系人、搜索、群组等完整 UI 能力。
 
-   您可以根据需求自由选择经典版或简约版 UI 组件。如果您还不了解各个界面库的功能，可以查阅文档 [TUIKit 界面库介绍](https://cloud.tencent.com/document/product/269/37190)。
+### 前提条件
+- **Xcode**：16.0 或以上版本（推荐 Xcode 16.x 系列）。
 
-## 前提条件
-- Xcode 15 及以上
+- **iOS**：14.0 及以上真机（暂时不支持模拟器）。
 
-- iOS 14.0 及以上
+- **CocoaPods**：1.12.0 及以上版本（推荐 1.16.x）。如尚未安装，请参考 [CocoaPods Getting Started](https://guides.cocoapods.org/using/getting-started.html) 进行安装。
 
 - 一个有效的腾讯云账号及 Chat 应用。可参考 开通服务 从控制台获取以下信息：
 
-  - SDKAppID：App 在控制台获取的 Chat 应用的 ID，为应用的唯一标识。
+   - SDKAppID：App 在控制台获取的 Chat 应用的 ID，为应用的唯一标识。
 
-  - SDKSecretKey：应用的密钥。
+   - SDKSecretKey：应用的密钥。
 
-## CocoaPods 集成
+## 集成并引入组件
 
-> **消息引用与回复功能的版本兼容性：**
->
-> 自 9.0.7652 版本起：
->
-> - **消息引用（Quote）**改用 IMSDK 原生引用能力实现，与旧版本引用消息格式不兼容。新旧版本互发的引用消息无法正确解析引用内容，请将收发双方统一升级至 9.0.7652 及以上版本。
-> - **消息回复（Reply）**功能已下线，相关接口与 UI 入口不再提供，如业务有相关需求，可参考旧版本 TUIKit 自行实现。
-> **两者区别：引用是发送新消息时附带一条历史消息的摘要卡片，点击可跳转原消息（一问一答）；回复是在某条消息下追加评论并聚合成回复列表（评论区式）。**
->
-
-1. 安装 CocoaPods。
-在终端窗口中输入如下命令（需要提前在 Mac 中安装 Ruby 环境）：
-
-   ``` bash
-   sudo gem install cocoapods
-   ```
-2. 创建 Podfile 文件。
-进入项目所在路径输入以下命令行，之后项目路径下会出现一个 Podfile 文件。
-
-   ``` bash
-   pod init
-   ```
-3. 根据业务需求在 Podfile 中添加对应的 TUIKit 组件。组件之间相互独立，添加或删除均不影响工程编译。您可以按需选择不同的 Podfile 集成方式：
-
-  - 远程 CocoaPods 集成。
-
-  - DevelopmentPods 本地集成。
-
-      上面两种集成方式的优缺点如下表所示：
-
-      |集成方式|适合场景|优点|缺点|
-      |---------|---------|---------|---------|
-      |远程 CocoaPods 集成|适合无源码修改时的集成。|当 TUIKit 有版本更新时，您只需再次 `Pod update` 即可完成更新。|当您有源码修改，使用 `Pod update` 更新时，新版本的 TUIKit 会覆盖您的修改。|
-      |本地 DevelopmentPods 集成|适合有涉及源码自定义修改的客户。|当您有自己的 git 仓库时，可以跟踪修改。修改源码后，使用 `Pod update` 更新其他远程 Pod 库时，不会覆盖您的修改。|您需要手动将 TUIKit 源码覆盖您本地 TUIKit 文件夹进行更新。|
-
-### 远程 CocoaPods 集成
-
-您可以在 Podfile 中按需添加组件库：
-
-> **注意：**
-> 从 8.5.6870 版本开始，TUIKit 支持 Swift 语言组件。
+> **说明：**
+> Demo：IM 在 [CNB](https://cnb.cool/tencent/cloud/trtc/TUIKit_iOS) 及 [GitHub](https://github.com/Tencent-RTC/TUIKit_iOS) 上提供即时通信完整 Demo，[5 分钟跑通聊天 + 音视频通话全功能](https://cloud.tencent.com/document/product/269/68228)。
 >
 
-【经典版】
+### 下载源码
 
-【Swift 组件】
+从 [CNB](https://cnb.cool/tencent/cloud/trtc/TUIKit_iOS) 或者 [GitHub](https://github.com/Tencent-RTC/TUIKit_iOS) 克隆 TUIKit iOS 源码
 ``` bash
-# Uncomment the next line to define a global platform for your project
-source 'https://github.com/CocoaPods/Specs.git'
-platform :ios, '14.0'
-# 防止 TUIKit 组件里的 *.xcassets 与您项目里面冲突。
-install! 'cocoapods', :disable_input_output_paths => true
-
-# 请使用您的真实项目名称替换 your_project_name
-target 'your_project_name' do
-  use_frameworks!
-  use_modular_headers!
-
-  # 集成聊天功能
-  pod 'TUIChat_Swift/UI_Classic'
-  # 集成会话功能
-  pod 'TUIConversation_Swift/UI_Classic'
-  # 集成关系链功能
-  pod 'TUIContact_Swift/UI_Classic'
-  # 集成搜索功能（需要购买旗舰版或企业版套餐）
-  pod 'TUISearch_Swift/UI_Classic'
-  # 集成音视频通话功能
-  pod 'TUICallKit_Swift'
-  # 集成投票插件
-  pod 'TUIPollPlugin_Swift'
-  # 集成群接龙插件
-  pod 'TUIGroupNotePlugin_Swift'
-  # 集成翻译插件（需开通增值功能，请联系腾讯云商务开通）
-  pod 'TUITranslationPlugin_Swift'
-  # 集成会话分组插件
-  pod 'TUIConversationGroupPlugin_Swift'
-  # 集成会话标记插件
-  pod 'TUIConversationMarkPlugin_Swift'
-  # 集成语音转文字插件
-  pod 'TUIVoiceToTextPlugin_Swift'
-  # 集成文字转语音插件
-  pod 'TUITextToVoicePlugin_Swift'
-  # 集成公众号插件
-  pod 'TUIOfficialAccountPlugin_Swift'
-  # 集成表情回应插件
-  pod 'TUIEmojiPlugin_Swift'
-end
+# 从 CNB 中克隆代码
+git clone https://cnb.cool/tencent/cloud/trtc/TUIKit_iOS.git
 
-#Pods config
-post_install do |installer|
-    installer.pods_project.targets.each do |target|
-        target.build_configurations.each do |config|
-            #Fix Xcode14 Bundle target error
-            config.build_settings['EXPANDED_CODE_SIGN_IDENTITY'] = ""
-            config.build_settings['CODE_SIGNING_REQUIRED'] = "NO"
-            config.build_settings['CODE_SIGNING_ALLOWED'] = "NO"
-            config.build_settings['ENABLE_BITCODE'] = "NO"
-            config.build_settings['IPHONEOS_DEPLOYMENT_TARGET'] = "14.0"
-            #Fix Xcode15 other links  flag  -ld64
-            xcode_version = `xcrun xcodebuild -version | grep Xcode | cut -d' ' -f2`.to_f
-            if xcode_version >= 15
-              xcconfig_path = config.base_configuration_reference.real_path
-              xcconfig = File.read(xcconfig_path)
-              if xcconfig.include?("OTHER_LDFLAGS") == false
-                xcconfig = xcconfig + "\n" + 'OTHER_LDFLAGS = $(inherited) "-ld64"'
-              else
-                if xcconfig.include?("OTHER_LDFLAGS = $(inherited)") == false
-                  xcconfig = xcconfig.sub("OTHER_LDFLAGS", "OTHER_LDFLAGS = $(inherited)")
-                end
-                if xcconfig.include?("-ld64") == false
-                  xcconfig = xcconfig.sub("OTHER_LDFLAGS = $(inherited)", 'OTHER_LDFLAGS = $(inherited) "-ld64"')
-                end
-              end
-              File.open(xcconfig_path, "w") { |file| file << xcconfig }
-            end
-        end
-    end
-end
+# 从 GitHub 中克隆代码
+git clone https://github.com/Tencent-RTC/TUIKit_iOS.git
 ```
 
-【简约版】
-
-【Swift 组件】
+将仓库根目录下的 `chat`、`call` 文件夹整体复制到您的工程根目录下。复制完成后的目录结构如下：
 ``` bash
-# Uncomment the next line to define a global platform for your project
-source 'https://github.com/CocoaPods/Specs.git'
-platform :ios, '14.0'
-# 防止 TUIKit 组件里的 *.xcassets 与您项目里面冲突。
-install! 'cocoapods', :disable_input_output_paths => true
-
-# 请使用您的真实项目名称替换 your_project_name
-target 'your_project_name' do
-  use_frameworks!
-  use_modular_headers!
-
-  # 集成聊天功能
-  pod 'TUIChat_Swift/UI_Minimalist'
-  # 集成会话功能
-  pod 'TUIConversation_Swift/UI_Minimalist'
-  # 集成关系链功能
-  pod 'TUIContact_Swift/UI_Minimalist'
-  # 集成搜索功能（需要购买旗舰版或企业版、套餐）
-  pod 'TUISearch_Swift/UI_Minimalist'
-  # 集成音视频通话功能
-  pod 'TUICallKit_Swift'
-  # 集成翻译插件（需单独购买翻译插件）
-  pod 'TUITranslationPlugin_Swift'
-  # 集成语音转文字插件
-  pod 'TUIVoiceToTextPlugin_Swift'
-  # 集成表情回应插件
-  pod 'TUIEmojiPlugin_Swift'
-end
-#Pods config
-post_install do |installer|
-    installer.pods_project.targets.each do |target|
-        target.build_configurations.each do |config|
-            #Fix Xcode14 Bundle target error
-            config.build_settings['EXPANDED_CODE_SIGN_IDENTITY'] = ""
-            config.build_settings['CODE_SIGNING_REQUIRED'] = "NO"
-            config.build_settings['CODE_SIGNING_ALLOWED'] = "NO"
-            config.build_settings['ENABLE_BITCODE'] = "NO"
-            config.build_settings['IPHONEOS_DEPLOYMENT_TARGET'] = "14.0"
-            #Fix Xcode15 other links  flag  -ld64
-            xcode_version = `xcrun xcodebuild -version | grep Xcode | cut -d' ' -f2`.to_f
-            if xcode_version >= 15
-              xcconfig_path = config.base_configuration_reference.real_path
-              xcconfig = File.read(xcconfig_path)
-              if xcconfig.include?("OTHER_LDFLAGS") == false
-                xcconfig = xcconfig + "\n" + 'OTHER_LDFLAGS = $(inherited) "-ld64"'
-              else
-                if xcconfig.include?("OTHER_LDFLAGS = $(inherited)") == false
-                  xcconfig = xcconfig.sub("OTHER_LDFLAGS", "OTHER_LDFLAGS = $(inherited)")
-                end
-                if xcconfig.include?("-ld64") == false
-                  xcconfig = xcconfig.sub("OTHER_LDFLAGS = $(inherited)", 'OTHER_LDFLAGS = $(inherited) "-ld64"')
-                end
-              end
-              File.open(xcconfig_path, "w") { |file| file << xcconfig }
-            end
-        end
-    end
-end
+YourApplication/
+├── source/                 # 您的工程代码
+├── call/                   # 音视频通话组件
+│   └── TUICallKit_Swift.podspec
+│   └── TUICallKit_Swift/
+├── chat/                   # Chat 源码
+│   ├── demo/               # 示例工程
+│   └── uikit/              # TUIChatKit 组件库
+├── Podfile                 # 依赖配置文件
+├── YourApplication.xcworkspace     # 您的项目文件
 ```
 
 > **说明：**
-> 1. 如果您直接 `pod 'TUIChat'`，不指定经典版或简约版，默认会集成两套版本 UI 组件。
-> 2. 经典版和简约版 UI 不能混用，集成多个组件时，您必须同时全部选择经典版 UI 或简约版 UI。例如，经典版 `TUIChat` 组件必须与经典版 `TUIConversation`、`TUIContact` 组件搭配使用。同理，简约版 `TUIChat` 组件必须与简约版 `TUIConversation`、`TUIContact` 组件搭配使用。
-
-Podfile 修改完毕后，执行以下命令，安装 TUIKit 组件。
-``` bash
-pod install
-```
-
-如果无法安装 TUIKit 最新版本，执行以下命令更新本地的 CocoaPods 仓库列表。
-``` bash
-pod repo update
-```
-
-之后执行以下命令，更新组件库的 Pod 版本。
-``` bash
-pod update
-```
-
-集成全部的 TUIKit 组件后的项目结构：
-
-### 本地 DevelopmentPods 源码集成
-
-> **消息引用与回复功能的版本兼容性：**
->
-> 自 9.0.7652 版本起：
->
-> - 消息引用（Quote） 改用 IMSDK 原生引用能力实现，与旧版本引用消息格式不兼容。新旧版本互发的引用消息无法正确解析引用内容，请将收发双方统一升级至 9.0.7652 及以上版本。
-> - 消息回复（Reply） 功能已下线，相关接口与 UI 入口不再提供，如业务有相关需求，可参考旧版本 TUIKit 自行实现。
-> *两者区别：引用是发送新消息时附带一条历史消息的摘要卡片，点击可跳转原消息（一问一答）；回复是在某条消息下追加评论并聚合成回复列表（评论区式）。*
+> TUIKit_iOS 是包含多个产品的开源仓库，Chat 的 UI 源码位于 `chat/` 目录下（`chat/uikit` 为 UIKit 组件库，`chat/demo` 为示例工程），其依赖的音视频通话组件 `call/TUICallKit_Swift` 位于仓库根目录。模块目录可放在工程任意位置，只需在 `Podfile` 中设置正确的相对路径即可。
 >
 
-1. 从 GitHub 下载 TUIKit 源码，将 TUIKit 目录直接拖入您的工程目录下:
+### 集成组件
+1. 在 Podfile 中引入对应模块（请按源码实际存放位置调整相对路径）：
 
-  - [Swift TUIKit 源码 GitHub 地址](https://github.com/Tencent-RTC/Chat_UIKit/tree/main/Swift/TUIKit)：
-
-  - [Objective-C TUIKit 源码 GitHub 地址](https://github.com/TencentCloud/TIMSDK/tree/master/iOS/TUIKit)：
-
-2. 修改您 Podfile 中每个组件的本地路径。path 是 TUIKit 文件夹相对于您工程 Podfile 文件的位置，常见的有：
-
-  - TUIKit 文件夹位于您工程 Podfile 文件**父目录**： `pod 'TUICore', :path => "../TUIKit/TUICore"`
-
-  - TUIKit 文件夹位于您工程 Podfile 文件**当前目录**： `pod 'TUICore', :path => "./TUIKit/TUICore"`
-
-  - TUIKit 文件夹位于您工程 Podfile 文件**子目录**：  `pod 'TUICore', :path => "/TUIKit/TUICore"`
-
-      以 TUIKit 文件夹位于您工程 Podfile 文件父目录为例：
-
-【Development Podfile】
-
-【Swift 组件】
-``` bash
-# Uncomment the next line to define a global platform for your project
-source 'https://github.com/CocoaPods/Specs.git'
-platform :ios, '14.0'
-install! 'cocoapods', :disable_input_output_paths => true
-
-# 请使用您的真实项目名称替换 your_project_name
-target 'your_project_name' do
-  # Uncomment the next line if you're using Swift or would like to use dynamic frameworks
-  use_frameworks!
-  use_modular_headers!
-
-  # 集成基础库（必选）
-  pod 'TUICore', :path => "../TUIKit/TUICore"
-  pod 'TIMCommon_Swift', :path => "../TUIKit/TIMCommon"
-  # 集成TUIKit组件（可选）
-  # 集成聊天功能
-  pod 'TUIChat_Swift', :path => "../TUIKit/TUIChat"
-  # 集成会话功能
-  pod 'TUIConversation_Swift', :path => "../TUIKit/TUIConversation"
-  # 集成关系链功能
-  pod 'TUIContact_Swift', :path => "../TUIKit/TUIContact"
-  # 集成搜索功能（需要购买旗舰版或企业版套餐）
-  pod 'TUISearch_Swift', :path => "../TUIKit/TUISearch"
-
-  # 集成音视频通话功能
-  pod 'TUICallKit_Swift'
-
-  # 集成 TUIKitPlugin 插件 （可选）
-  # 集成翻译插件（需单独购买插件）
-  pod 'TUITranslationPlugin_Swift'
-  # 集成语音转文字插件（需单独购买插件）
-  pod 'TUIVoiceToTextPlugin_Swift'
-
-  # 其他 Pod
-  pod 'MJRefresh'
-  pod 'SnapKit'
-end
-#Pods config
-post_install do |installer|
-    installer.pods_project.targets.each do |target|
-        target.build_configurations.each do |config|
-            #Fix Xcode14 Bundle target error
-            config.build_settings['EXPANDED_CODE_SIGN_IDENTITY'] = ""
-            config.build_settings['CODE_SIGNING_REQUIRED'] = "NO"
-            config.build_settings['CODE_SIGNING_ALLOWED'] = "NO"
-            config.build_settings['ENABLE_BITCODE'] = "NO"
-            config.build_settings['IPHONEOS_DEPLOYMENT_TARGET'] = "14.0"
-            #Fix Xcode15 other links  flag  -ld64
-            xcode_version = `xcrun xcodebuild -version | grep Xcode | cut -d' ' -f2`.to_f
-            if xcode_version >= 15
-              xcconfig_path = config.base_configuration_reference.real_path
-              xcconfig = File.read(xcconfig_path)
-              if xcconfig.include?("OTHER_LDFLAGS") == false
-                xcconfig = xcconfig + "\n" + 'OTHER_LDFLAGS = $(inherited) "-ld64"'
-              else
-                if xcconfig.include?("OTHER_LDFLAGS = $(inherited)") == false
-                  xcconfig = xcconfig.sub("OTHER_LDFLAGS", "OTHER_LDFLAGS = $(inherited)")
-                end
-                if xcconfig.include?("-ld64") == false
-                  xcconfig = xcconfig.sub("OTHER_LDFLAGS = $(inherited)", 'OTHER_LDFLAGS = $(inherited) "-ld64"')
-                end
-              end
-              File.open(xcconfig_path, "w") { |file| file << xcconfig }
-            end
-        end
-    end
-end
-```
+   ``` bash
+   # 请使用您的真实项目名称替换 your_project_name
+   target 'your_project_name' do
 
-【Objective-C 组件】
-``` bash
-# Uncomment the next line to define a global platform for your project
-source 'https://github.com/CocoaPods/Specs.git'
-platform :ios, '14.0'
-install! 'cocoapods', :disable_input_output_paths => true
-
-# 请使用您的真实项目名称替换 your_project_name
-target 'your_project_name' do
-  # Uncomment the next line if you're using Swift or would like to use dynamic frameworks
-  use_frameworks!
-  use_modular_headers!
-
-  # 集成基础库（必选）
-  pod 'TUICore', :path => "../TUIKit/TUICore"
-  pod 'TIMCommon', :path => "../TUIKit/TIMCommon"
-  # 集成TUIKit组件（可选）
-  # 集成聊天功能
-  pod 'TUIChat', :path => "../TUIKit/TUIChat"
-  # 集成会话功能
-  pod 'TUIConversation', :path => "../TUIKit/TUIConversation"
-  # 集成关系链功能
-  pod 'TUIContact', :path => "../TUIKit/TUIContact"
-  # 集成搜索功能（需要购买旗舰版或企业版套餐）
-  pod 'TUISearch', :path => "../TUIKit/TUISearch"
-
-  # 集成音视频通话功能
-  pod 'TUICallKit_Swift'
-  # 集成快速会议
-  pod 'TUIRoomKit'
-
-  # 集成TUIKitPlugin插件 （可选）
-  # 集成翻译插件，从 7.2 版本开始支持（需单独购买翻译插件）
-  pod 'TUITranslationPlugin'
-  # 集成推送插件
-  pod 'TIMPush'
-
-  # 其他 Pod
-  pod 'MJRefresh'
-  pod 'Masonry'
-end
-#Pods config
-post_install do |installer|
-    installer.pods_project.targets.each do |target|
-        target.build_configurations.each do |config|
-            #Fix Xcode14 Bundle target error
-            config.build_settings['EXPANDED_CODE_SIGN_IDENTITY'] = ""
-            config.build_settings['CODE_SIGNING_REQUIRED'] = "NO"
-            config.build_settings['CODE_SIGNING_ALLOWED'] = "NO"
-            config.build_settings['ENABLE_BITCODE'] = "NO"
-            config.build_settings['IPHONEOS_DEPLOYMENT_TARGET'] = "14.0"
-            #Fix Xcode15 other links  flag  -ld64
-            xcode_version = `xcrun xcodebuild -version | grep Xcode | cut -d' ' -f2`.to_f
-            if xcode_version >= 15
-              xcconfig_path = config.base_configuration_reference.real_path
-              xcconfig = File.read(xcconfig_path)
-              if xcconfig.include?("OTHER_LDFLAGS") == false
-                xcconfig = xcconfig + "\n" + 'OTHER_LDFLAGS = $(inherited) "-ld64"'
-              else
-                if xcconfig.include?("OTHER_LDFLAGS = $(inherited)") == false
-                  xcconfig = xcconfig.sub("OTHER_LDFLAGS", "OTHER_LDFLAGS = $(inherited)")
-                end
-                if xcconfig.include?("-ld64") == false
-                  xcconfig = xcconfig.sub("OTHER_LDFLAGS = $(inherited)", 'OTHER_LDFLAGS = $(inherited) "-ld64"')
-                end
-              end
-              File.open(xcconfig_path, "w") { |file| file << xcconfig }
-            end
-        end
-    end
-end
-```
+     # 补充如下内容 增加 TUIChatKit 和 TUICallKit_Swift 这两个依赖
+     # 注意 path 的相对路径
+     pod 'TUIChatKit', :path => 'chat/uikit/TUIChatKit.podspec'
+     pod 'TUICallKit_Swift', :path => 'call/TUICallKit_Swift.podspec'
+   end
 
-3. Podfile 修改完毕后，执行以下命令，安装本地 TUIKit 组件。示例：
+   ```
+2. Podfile 修改完毕后，执行以下命令，安装 TUIKit 组件。
 
    ``` bash
    pod install
-   ```
-
-   > **注意：**
-   >
-   > 1. 使用本地集成方案时，如需升级时需要从 GitHub 获取最新的组件代码，覆盖您本地项目的 TUIKit 目录。
-   > 2. 当私有化修改和远端有冲突时，需要手动合并，处理冲突。
-   > 3. TUIKit 插件需要依赖 TUICore 的版本，请确保插件版本和 "../TUIKit/TUICore/TUICore.spec" 中的 spec.version 一致。
-
-## 第三方库依赖
 
-TUIKit 依赖的第三方库的最低版本如下，如果您的版本较低，请升级到最新版本。
+   # 如果无法安装 TUIKit 最新版本，执行以下命令更新本地的 CocoaPods 仓库列表。
+   # pod repo update
+   # pod update
 
-【Swift 组件】
-``` plaintext
-- MJExtension (3.4.1)
-- MJRefresh (3.7.5)
-- SnapKit (5.7.1)
-- SSZipArchive (2.4.3)
-- SDWebImage (5.18.11)
-```
-
-【Objective-C 组件】
-``` plaintext
-- Masonry (1.1.0)
-- MJExtension (3.4.1)
-- MJRefresh (3.7.5)
-- ReactiveObjC (3.1.1)
-- SDWebImage (5.18.11):
-  - SDWebImage/Core (= 5.18.11)
-- SDWebImage/Core (5.18.11)
-- SnapKit (5.6.0)
-- SSZipArchive (2.4.3)
-```
+   ```
 
 ## 接入步骤
 
-常用的聊天软件都是由会话列表、聊天窗口、好友列表、音视频通话等几个基本的界面组成，参考下面步骤，您仅需几行代码即可在项目中快速搭建这些 UI 界面。 实操教学（Objective-C 组件版本）视频请参见：[极速集成 TUIKit（iOS）](https://cloud.tencent.com/edu/learning/quick-play/3130-82618)。
+完成上述集成后，参考以下步骤，您仅需几行代码即可在项目中快速搭建会话列表、聊天、联系人等核心界面。
 
 ### 步骤1：配置用户鉴权
 
-SDKAppID 需要在 [即时通信 IM 控制台](https://console.cloud.tencent.com/im) 创建并获取，userSig 需要按规则计算，详细步骤请参考文档 [跑通 Demo](https://cloud.tencent.com/document/product/269/68228)。
+在 [即时通信 IM 控制台](https://console.cloud.tencent.com/im/tool-usersig) 根据 UserID 获取 UserSig，用于后续登录时的用户鉴权。
 
 ### 步骤2：用户登录
 
-登录组件后才能正常使用组件的功能。用户在 App 上点击登录时，您可以登录 TUIKit 组件。
-
-示例代码如下所示：
-
-【Swift】
-``` swift
-import TUICore
-@objc func loginSDK(_ userID: String, userSig: String, succ: TSucc?, fail: TFail?) {
-    TUILogin.login(Int32(SDKAPPID), userID: userID, userSig: userSig, config: loginConfig, succ: {
-        // update UI
-        succ?()
-    }, fail: { code, msg in
-        // update UI
-        fail?(code, msg)
-    })
-}
-```
-
-【Objective-C】
-``` objectivec
-#import "TUILogin.h"
-
-- (void)loginSDK:(NSString *)userID userSig:(NSString *)sig succ:(TSucc)succ fail:(TFail)fail {
-    [TUILogin login:SDKAppID userID:userID userSig:sig succ:^{
-        NSLog(@"登录成功");
-    } fail:^(int code, NSString *msg) {
-        NSLog(@"登录失败");
-    }];
-}
-```
-
-### 步骤3：构建会话列表界面
-
-会话列表只需要创建 `TUIConversationListController` 对象即可。会话列表会从数据库中读取最近联系人，当用户点击联系人时，`TUIConversationListController` 将事件 `didSelectConversation` 回调给上层。
-
-示例代码如下所示：
-
-【经典版】
+登录鉴权后才能正常使用组件的功能。调用 `LoginStore` 的 `login` 接口，传入上文获取的 sdkAppID、userID、userSig 进行登录鉴权：
 
 【Swift】
 ``` swift
+import AtomicXCore
+import TUIChatKit
 import UIKit
-import TUICore
-import ImSDK_Plus
-import TIMCommon
-import TUIConversation
-// ConversationController 为您自己的 ViewController
-public class ConversationController: UIViewController, V2TIMSDKListener, TUIPopViewDelegate {
-       private var conv: TUIConversationListController?
-       override public func viewDidLoad() {
-         super.viewDidLoad()
-         setupNavigation()
-         conv = TUIConversationListController()
-         if let conv = conv {
-             addChild(conv)
-             view.addSubview(conv.view)
-         }
-    }
-}
-// 会话列表点击事件，可自定义，通常是打开聊天界面
-public protocol TUIConversationListControllerListener: AnyObject {
-    func conversationListController(_ conversationController: UIViewController, didSelectConversation conversation: TUIConversationCellData) -> Bool
-}
-```
-
-【Objective-C】
-``` objectivec
-#import "TUIConversationListController.h"
-
-// ConversationController 为您自己的 ViewController
-@implementation ConversationController
-- (void)viewDidLoad {
-    [super viewDidLoad];
-    // TUIConversationListController
-    TUIConversationListController *vc = [[TUIConversationListController alloc] init];
-    vc.delegate = self;
-    // 把 TUIConversationListController 添加到自己的 ViewController
-    [self addChildViewController:vc];
-    [self.view addSubview:vc.view];
-}
-
-- (void)conversationListController:(UIViewController *)conversationController
-             didSelectConversation:(TUIConversationCellData *)conversation {
-    // 会话列表点击事件，可自定义，通常是打开聊天界面
-}
-@end
-```
 
-【简约版】
-
-【Swift】
-``` swift
-// ConversationController 为您自己的 ViewController
-public class ConversationController: UIViewController, V2TIMSDKListener, TUIPopViewDelegate {
-    override public func viewDidLoad() {
-        super.viewDidLoad()
-        setupNavigation()
-
-        conv = TUIConversationListController_Minimalist()
-        if let conv = conv {
-            addChild(conv)
-            view.addSubview(conv.view)
+let yourSdkAppID: Int32 = 10_000_000_00 // 填写你的实际sdkAppID
+let testUserID = "testUserID"          // 你的测试用户ID
+let userSig = "xxxxxxx"                // 你的测试用户ID对应的 userSig （从IM 控制台获取，看上面的截图）
+
+LoginStore.shared.login(sdkAppID: yourSdkAppID, userID: testUserID, userSig: userSig) { [weak self] result in
+    DispatchQueue.main.async {
+        switch result {
+        case .success:
+            // 登录成功后 显示会话列表
+            // self?.showConversationList()
+        case .failure(let error):
+            print("login failed: \(error.code) \(error.message)")
         }
     }
 }
-// 会话列表点击事件，可自定义，通常是打开聊天界面
-public protocol TUIConversationListControllerListener: AnyObject {
-    func conversationListController(_ conversationController: UIViewController, didSelectConversation conversation: TUIConversationCellData) -> Bool
-}
 ```
 
-【Objective-C】
-``` objectivec
-#import "TUIConversationListController_Minimalist.h"
-
-// ConversationController 为您自己的 ViewController
-@implementation ConversationController
-- (void)viewDidLoad {
-    [super viewDidLoad];
-    // TUIConversationListController_Minimalist
-    TUIConversationListController_Minimalist *vc = [[TUIConversationListController_Minimalist alloc] init];
-    vc.delegate = self;
-    // 把 TUIConversationListController_Minimalist 添加到自己的 ViewController
-    [self addChildViewController:vc];
-    [self.view addSubview:vc.view];
-}
-
-- (void)conversationListController:(TUIConversationListController_Minimalist *)conversationController
-            didSelectConversation:(TUIConversationCell *)conversation
-{
-    // 会话列表点击事件，通常是打开聊天界面
-}
-@end
-```
-
-### 步骤4：构建聊天界面
-
-初始化聊天界面时，需要上层传入当前聊天界面对应的会话信息。
+> **警告：**
+> 在正式的生产环境中，建议在您的服务端生成 UserSig，在需要时由 App 向业务服务器发起请求获取动态 UserSig 进行鉴权。详见 [服务端生成 UserSig](https://cloud.tencent.com/document/product/269/32688)。
+>
 
-示例代码如下所示：
+### 步骤3：构建会话列表界面
 
-【经典版】
+登录成功后（步骤 2），即可展示会话列表。只需创建 `ConversationsPage` 对象，并将其 push 到导航控制器：
 
 【Swift】
-``` swift
+``` java
+import AtomicXCore
+import TUIChatKit
 import UIKit
-import TUICore
-import TIMCommon
-import TUIChat
-
-let conversationData = TUIChatConversationModel()
-conversationData.userID = userID ?? ""
-conversationData.groupID = groupID ?? ""
-if let chatVC = getChatViewController(conversationData) {
-    navigationController?.pushViewController(chatVC, animated: true)
-}
 
-private func getChatViewController(_ model: TUIChatConversationModel) -> TUIBaseChatViewController? {
-    var chat: TUIBaseChatViewController?
-    if let userID = model.userID, !userID.isEmpty {
-        chat = TUIC2CChatViewController()
-    } else if let groupID = model.groupID, !groupID.isEmpty {
-        chat = TUIGroupChatViewController()
-    }
-    chat?.conversationData = model
-    return chat
+func showConversationList() {
+    let conversationsPage = ConversationsPage(onConversationClick: { [weak self] info in
+        // 点击会话列表中的某条会话后，进入对应的聊天页
+        // self?.showChat(info.conversation)
+    })
+    navigationController.pushViewController(conversationsPage, animated: true)
 }
 ```
 
-【Objective-C】
-``` objectivec
-#import "TUIC2CChatViewController.h"
-
-// ChatViewController 为您自己的 ViewController
-@implementation ChatViewController
-- (void)viewDidLoad {
-  // 创建会话信息
-  TUIChatConversationModel *data = [[TUIChatConversationModel alloc] init];
-  data.userID = @"userID";
-  // TUIC2CChatViewController
-  TUIC2CChatViewController *vc = [[TUIC2CChatViewController alloc] init];
-  [vc setConversationData:data];
-  // 把 TUIC2CChatViewController 添加到自己的 ViewController
-  [self addChildViewController:vc];
-  [self.view addSubview:vc.view];
-}
-@end
-```
+`ConversationsPage` 会自动从本地数据库加载最近会话。当用户点击某条会话时，`ConversationsPage` 会通过 `onConversationClick` 回调，把所选会话的信息传递给上层，您可以在该回调中创建并进入聊天页（见 步骤 4）。
 
-> **说明：**
-> `TUIC2CChatViewController` 会自动拉取该用户的历史消息并展示出来。
->
+### 步骤4：构建聊天界面
 
-【简约版】
+聊天页由 ChatPage 承载，负责消息的展示与收发。构造 ChatPage 时必须传入一个 `ConversationInfo`，用于指定要进入的会话。其中 `conversationID` 与 `type` 是必填的关键字段，title 用于聊天页导航栏标题的初始展示。
 
 【Swift】
 ``` swift
-let conversationData = TUIChatConversationModel()
-conversationData.userID = userID ?? ""
-conversationData.groupID = groupID ?? ""
-if let chatVC = getChatViewController(conversationData) {
-    navigationController?.pushViewController(chatVC, animated: true)
-}
-
-private func getChatViewController(_ model: TUIChatConversationModel) -> TUIBaseChatViewController_Minimalist? {
-    var chat: TUIBaseChatViewController_Minimalist?
-    if let userID = model.userID, !userID.isEmpty {
-        chat = TUIC2CChatViewController_Minimalist()
-    } else if let groupID = model.groupID, !groupID.isEmpty {
-        chat = TUIGroupChatViewController_Minimalist()
-    }
-    chat?.conversationData = model
-    return chat
-}
-```
+import AtomicXCore
+import TUIChatKit
+import UIKit
 
-【Objective-C】
-``` objectivec
-#import "TUIC2CChatViewController_Minimalist.h"
-
-// ChatViewController 为您自己的 ViewController
-@implementation ChatViewController
-- (void)viewDidLoad {
-  // 创建会话信息
-  TUIChatConversationModel *data = [[TUIChatConversationModel alloc] init];
-  data.userID = @"userID";
-  // 创建 TUIC2CChatViewController_Minimalist
-  TUIC2CChatViewController_Minimalist *vc = [[TUIC2CChatViewController_Minimalist alloc] init];
-  [vc setConversationData:data];
-  // 把 TUIC2CChatViewController 添加到自己的 ViewController
-  [self addChildViewController:vc];
-  [self.view addSubview:vc.view];
+// 进入单聊
+let userID = "test_user"
+var conversation = ConversationInfo(conversationID: ChatUtil.getC2CConversationID(userID))
+conversation.type = .c2c
+conversation.title = "与 \(userID) 聊天"
+showChat(conversation)
+
+// 进入群聊
+let groupID = "@TGS#xxxxxx"
+var groupConversation = ConversationInfo(conversationID: ChatUtil.getGroupConversationID(groupID))
+groupConversation.type = .group
+groupConversation.title = "测试群"
+showChat(groupConversation)
+
+func showChat(_ info: ConversationInfo) {
+    let chatPage = ChatPage(conversation: info, onBack: { [weak self] in
+        self?.navigationController.popViewController(animated: true)
+    })
+    navigationController.pushViewController(chatPage, animated: true)
 }
-@end
 ```
 
-> **说明**
->
-> `TUIC2CChatViewController_Minimalist` 会自动拉取该用户的历史消息并展示出来。
+> **注意：**
+> 在聊天界面使用 相册/录像/视频通话等需要声明对应的权限，请在 App 的 Info.plist 中声明如下权限：
 >
 
-### 步骤5：构建联系人界面
+> `<key>NSCameraUsageDescription</key>`
+> `<string>需要访问您的相机权限，开启后才能发送图片或视频</string>`
+> `<key>NSMicrophoneUsageDescription</key>`
+> `<string>需要访问您的麦克风权限，开启后才能发送语音</string>`
+> `<key>NSPhotoLibraryAddUsageDescription</key>`
+> `<string>需要访问您的相册权限，开启后保存图片或视频</string>`
+> `<key>NSPhotoLibraryUsageDescription</key>`
+> `<string>需要访问您的相册权限，开启后才能发送图片或视频</string>`
 
-联系人列表界面不需要其它依赖，只需创建对象并显示出来即可。
+### 步骤5：构建联系人界面
 
-【经典版】
+联系人页由 ContactsPage 承载，展示当前用户的好友列表（按字母索引分组）与群列表入口 等。页面自带导航栏，右上角的 **+**按钮内置了**添加好友**和**加入群聊**两个功能入口。
 
 【Swift】
 ``` swift
+import AtomicXCore
+import TUIChatKit
 import UIKit
-import TUICore
-import TIMCommon
-import TUIContact
-// ContactController 为您自己的 ViewController
-public class ContactsController: UIViewController, TUIPopViewDelegate {
-    var contactVC: TUIContactController?
-    override public func viewDidLoad() {
-        super.viewDidLoad()
-
-        contactVC = TUIContactController()
-        if let contactVC = contactVC {
-            addChild(contactVC)
-            view.addSubview(contactVC.view)
+
+func showContacts() {
+    let contactsPage = ContactsPage(
+        onContactClick: { [weak self] contact in
+            // 点击好友列表中的某个联系人回调（ContactInfo），可在该回调中进入单聊
+            // self?.showChat(with: contact.userID, title: contact.nickname ?? contact.userID)
+        },
+        onGroupClick: { [weak self] group in
+            // 点击群列表中的某个群的回调（GroupInfo），可在该回调中进入群聊
+            // self?.showGroupChat(with: group.groupID, title: group.groupName)
         }
-    }
+    )
+    navigationController.pushViewController(contactsPage, animated: true)
 }
 ```
 
-【Objective-C】
-``` objectivec
-#import "TUIContactController.h"
-
-// ContactController 为您自己的 ViewController
-@implementation ContactController
-- (void)viewDidLoad {
-  // 创建 TUIContactController
-  TUIContactController *vc = [[TUIContactController alloc] init];
-  // 把 TUIContactController 添加到自己的 ViewController
-  [self addChildViewController:vc];
-  [self.view addSubview:vc.view];
-}
-@end
-```
+### 步骤 6：音视频通话
 
-注意，上面代码只能将 `TUIContactController` 初始化并展示出来，其中的点击行为（例如点击好友、添加好友等），TUIKit 会通过 `TUIContactControllerListener` 抛给上层处理：
+音视频通话能力由 TUICallKit_Swift 组件提供（Podfile 中需添加 pod 'TUICallKit_Swift'）。
+1. **开通音视频通话服务，请参考** [**开通音视频服务**](https://cloud.tencent.com/document/product/269/104815)**。**
 
-【Swift】
-``` swift
-import TUIContact
-protocol TUIContactControllerListener: NSObjectProtocol {
-    func onSelectFriend(_ cell: TUICommonContactCell) -> Bool
-    func onAddNewFriend(_ cell: TUICommonTableViewCell) -> Bool
-    func onGroupConversation(_ cell: TUICommonTableViewCell) -> Bool
-}
-
-```
+2. **登录成功后初始化通话引擎。**
 
-【Objective-C】
-``` objectivec
-#import “TUIContactController.h”
-@protocol TUIContactControllerListener <NSObject>
-@optional
-- (void)onSelectFriend:(TUICommonContactCell *)cell;
-- (void)onAddNewFriend:(TUICommonTableViewCell *)cell;
-- (void)onGroupConversation:(TUICommonTableViewCell *)cell;
-@end
-```
-
-【简约版】
+   `LoginStore` 登录只建立了消息通道，在登录成功后，通话引擎需单独初始化：
 
 【Swift】
 ``` swift
-// ContactController 为您自己的 ViewController
-public class ContactsController: UIViewController, TUIPopViewDelegate {
-    override public func viewDidLoad() {
-        super.viewDidLoad()
-
-        contactVC = TUIContactController_Minimalist()
-        if let contactVC = contactVC {
-            addChild(contactVC)
-            view.addSubview(contactVC.view)
-        }
-    }
-}
-```
 
-【Objective-C】
-``` objectivec
-#import "TUIContactController_Minimalist.h"
-
-// ContactController 为您自己的 ViewController
-@implementation ContactController
-- (void)viewDidLoad {
-  // 创建 TUIContactController_Minimalist
-  TUIContactController_Minimalist *vc = [[TUIContactController_Minimalist alloc] init];
-  // 把 TUIContactController_Minimalist 添加到自己的 ViewController
-  [self addChildViewController:vc];
-  [self.view addSubview:vc.view];
-}
-@end
-```
+import RTCRoomEngine
+import TUICallKit_Swift
 
-注意，上面代码只能将 `TUIContactController_Minimalist` 初始化并展示出来，其中的点击行为（例如点击好友、添加好友等），TUIKit 会通过 `TUIContactControllerListener_Minimalist` 抛给上层处理：
+func initCallEngine() {
+    let youSdkAppID: Int32 = 10_000_000_00 // 填写你的实际sdkAppID
+    let testUserID = "testUserID"          // 你的测试用户ID
+    let userSig = "xxxxxxx"                // 你的测试用户ID对应的 userSig （从IM 控制台获取，看上面的截图）
 
-【Swift】
-``` swift
-protocol TUIContactControllerListener_Minimalist: AnyObject {
-    func onSelectFriend(_ cell: TUICommonContactCell_Minimalist) -> Bool
-    func onAddNewFriend(_ cell: TUICommonTableViewCell) -> Bool
-    func onGroupConversation(_ cell: TUICommonTableViewCell) -> Bool
+    TUICallEngine.createInstance().`init`(youSdkAppID, userId: testUserID, userSig: userSig) {
+        // enableIncomingBanner(true) 用于开启被叫时的来电横幅通知
+        TUICallKit.createInstance().enableIncomingBanner(enable: true)
+    } fail: { code, message in
+        print("initCallEngine failed: \(code), \(message ?? "")")
+    }
 }
-```
 
-【Objective-C】
-``` objectivec
-@protocol TUIContactControllerListener_Minimalist <NSObject>
-@optional
-- (void)onSelectFriend:(TUICommonContactCell *)cell;
-- (void)onAddNewFriend:(TUICommonTableViewCell *)cell;
-- (void)onGroupConversation:(TUICommonTableViewCell *)cell;
-@end
 ```
 
-例如单击好友后，您可以将好友信息页展示出来：
-
-【经典版】
+3. **发起通话。**
 
 【Swift】
 ``` swift
-import TIMCommon
-import TUICore
-import UIKit
-@objc private func onSelectFriend(_ cell: TUICommonContactCell) {
-    if let delegate = delegate {
-        if delegate.onSelectFriend(cell) { return }
-    }
-    let data = cell.contactData
-    let vc = TUIFriendProfileController(style: .grouped)
-    vc.friendProfile = data?.friendProfile
-    navigationController?.pushViewController(vc, animated: true)
+func startVideoCall() {
+    TUICallKit.createInstance().calls(
+        userIdList: ["liu100"],  // 被叫用户 ID 列表。单人通话传一个元素；传多个则为群组通话
+        mediaType: .video,       // 通话类型：.video 视频通话、.audio 语音通话
+        params: nil,
+        completion: nil
+    )
 }
 ```
 
-【Objective-C】
-``` objectivec
-#import "TUIFriendProfileController.h"
-
-- (void)onSelectFriend:(TUICommonContactCell *)cell
-{
-    TUICommonContactCellData *data = cell.contactData;
-    // 创建好友资料 vc
-    TUIFriendProfileController *vc = [[TUIFriendProfileController alloc] init];
-    vc.friendProfile = data.friendProfile;
-    // 展示好友资料 vc
-    [self.navigationController pushViewController:(UIViewController *)vc animated:YES];
-}
-```
+   调用后 TUICallKit 会自动弹出全屏通话界面（含呼叫等待、接通、挂断全流程 UI），无需自行实现。
 
-【简约版】
+4. **如何移除音视频通话功能？**
+
+   ChatPage 默认集成了音视频通话功能，如果你不需要音视频通话功能。可以在 步骤 4 创建聊天界面 中关闭音视频通话开关，代码如下所示：
 
 【Swift】
 ``` swift
-@objc func onSelectFriend(_ cell: TUICommonContactCell_Minimalist) {
-    if let delegate = delegate {
-        if delegate.onSelectFriend(cell) { return }
+func showChat(_ info: ConversationInfo) {
+        // 在输入配置中关闭输入面板中的视频通话和音频通话功能
+        let inputConfig = ChatMessageInputConfig(isShowVideoCall: false, isShowAudioCall: false)
+        let chatPage = ChatPage(conversation: info, messageInputConfig: inputConfig, onBack: { [weak self] in
+            self?.navigationController.popViewController(animated: true)
+        })
+        navigationController.pushViewController(chatPage, animated: true)
     }
-    let data = cell.contactData
-    let vc = TUIFriendProfileController_Minimalist()
-    vc.friendProfile = data?.friendProfile
-    navigationController?.pushViewController(vc, animated: true)
-}
 ```
 
-【Objective-C】
-``` objectivec
-#import "TUIFriendProfileController_Minimalist.h"
-
-- (void)onSelectFriend:(TUICommonContactCell *)cell
-{
-    TUICommonContactCellData *data = cell.contactData;
-    // 创建好友资料 vc
-    TUIFriendProfileController_Minimalist *vc = [[TUIFriendProfileController_Minimalist alloc] init];
-    vc.friendProfile = data.friendProfile;
-    // 展示好友资料 vc
-    [self.navigationController pushViewController:(UIViewController *)vc animated:YES];
-}
-```
+## AI 助手：知识咨询与代码集成
 
-### 步骤6：接入智能客服 Desk 用户端（可选）
-
-若需同时集成智能客服 Desk 用户端，请先 [开通智能客服 Desk 服务](https://cloud.tencent.com/document/product/269/96059)，并根据 [iOS 接入智能客服用户端](https://cloud.tencent.com/document/product/269/110808) 文档完成 `TencentCloudAIDeskCustomer` 包引入和配置，即可在您的应用中引入客服会话能力。
-``` objectivec
-#import <TencentCloudAIDeskCustomer/TencentCloudCustomerManager.h>
-
-int SDKAppID = 0; // 开通了智能客服 Desk 的应用 ID
-NSString *userID = @"";
-NSString *userSig = @"";
-
-// 上述三个参数, 可以和您登录腾讯云 IM 的保持一致, 也可以使用不同的应用和用户
-
-// 用户昵称。设置后，用户端转人工成功时，人工客服在工作台可见。您可将用户手机号，用户来源等信息写入昵称，长度限制500字节
-// 注意！设置后，即时通信 IM 同 userID 的昵称也会被更新
-// 如您不希望变更，请设置为 @"" 或 nil
-NSString *nickName = @"";
-
-// 用户头像。设置后，用户端转人工成功时，人工客服在工作台可见
-// 注意！设置后，即时通信 IM 同 userID 的头像也会被更新
-// 如您不希望变更，请设置为 @"" 或 nil
-NSString *avatar = @"";
-
-[[TencentCloudCustomerManager sharedManager]
-    initWithProfile:SDKAppID
-    userID:userID
-    userSig:userSig
-    nickName:nickName
-    avatar:avatar
-    completion:^(NSError *error) {
-        if (error) {
-            NSLog(@"login failed. error:%@", error);
-        }
-    }];
-
-// 点击打开智能客服会话页面
-[[TencentCloudCustomerManager sharedManager] pushCustomerServiceChatFromController:self];
-```
-
-### 步骤7：构建音视频通话功能
-
-TUI 组件支持在聊天界面对用户发起音视频通话，仅需要简单几步就可以快速集成：
-
-1. 开通音视频服务。
-
-2. 登录 即时通信 IM 控制台 ，单击目标应用卡片，进入应用的基础配置页面。
-
-3. 在开通腾讯实时音视频服务功能区，单击**免费体验**即可开通 TUICallKit 的 7 天免费试用服务。
-
-4. 在弹出的开通实时音视频 TRTC 服务对话框中，单击确认，系统将为您在 [实时音视频控制台](https://console.cloud.tencent.com/trtc) 创建一个与当前 IM 应用相同 SDKAppID 的实时音视频应用，二者账号与鉴权可复用。
-
-5. 集成 TUICallKit 组件。
-在 podfile 文件中添加以下内容。
-
-   ``` objectivec
-   // 集成音视频通话组件
-   pod 'TUICallKit_Swift'
-   ```
-6. 使用音视频功能，需要授权摄像头和麦克风的使用权限，请根据实际项目需要，设置项目所需权限。
-
-   在 **Xcode** 中，选择 **TARGETS > Info > Custom iOS Target Properties** 菜单。
-
-     单击 **+**，添加摄像头和麦克风权限：
-
-  - Privacy - Camera Usage Description
-
-  - Privacy - Microphone Usage Description
-
-7. 发起和接收视频或语音通话。
-
-   集成 TUICallKit 组件后，聊天界面和联系人资料界面默认会出现 “视频通话” 和 “语音通话” 两个按钮，当用户点击按钮时，TUIKit 会自动展示通话邀请 UI，并给对方发起通话邀请请求。
-
-  - 当用户在线收到通话邀请时，TUIKit 会自动展示通话接收 UI，用户可以选择同意或者拒绝通话。
-
-  - 当用户离线收到通话邀请时，如果需要唤起 App 通话，就要使用到离线推送能力，离线推送的实现请参见 [添加离线推送](https://cloud.tencent.com/document/product/269/109894)。
-
-8. 添加离线推送。
-在使用离线推送之前，您需要开通 [IM 离线推送](https://cloud.tencent.com/document/product/269/75429) 服务。
-
-9. 关于 App 的配置，您可以参见文档：[集成推送服务（Push）跑通离线推送功能](https://cloud.tencent.com/document/product/269/109894)。
-
-   > **说明：**
-   >
-   > 配置完成后，当单击接收到的**音视频通话离线推送通知**时， TUICallKit 会自动拉起**音视频通话邀请界面**。
-   >
-
-10. 附加增值能力
-
-   集成 TUIChat 和 TUICallKit 的组件后，在聊天界面发送语音消息时，即可**录制带 AI 降噪和自动增益的语音消息**。该功能需要购买 [音视频通话能力](https://cloud.tencent.com/document/product/1640/79968) 进阶版及以上套餐，仅 IMSDK 7.0 及以上版本支持。当套餐过期后，录制语音消息会切换到系统 API 进行录音。
-
-   下面是使用两台华为 P10 同时录制的语音消息对比：
-
-<link rel="stylesheet" href="//cloudcache.tencentcs.com/open_proj/proj_qcloud_v2/gateway/portal/css/global-20209142343.css?max_age=31536000&amp;t=20191128" />
-<link rel="stylesheet" href="//cloudcache.tencentcs.com/open_proj/proj_qcloud_v2/gateway/portal/css/global-components.css?max_age=31536000&amp;t=20180817" />
-<link rel="stylesheet" href="//cloudcache.tencentcs.com/open_proj/proj_qcloud_v2/gateway/documentation/documentation-v4/css/pandect-20219091610.css" />
-<link rel="stylesheet" href="//cloudcache.tencentcs.com/open_proj/proj_qcloud_v2/gateway/documentation/documentation-v4/css/import-2-markdown-20219091610.css" />
-<link rel="stylesheet" href="//cloudcache.tencentcs.com/open_proj/proj_qcloud_v2/platform/documents/css/documents-202205161915.css" />
-<link rel="stylesheet" href="//cloudcache.tencentcs.com/open_proj/proj_qcloud_v2/gateway/documentation/documentation-v4/css/pandect-202012171130.css" />
-<link rel="stylesheet" href="//qcloudimg.tencent-cloud.cn/static/document/qcloud-document-sdk.v0.0.17.css" />
-<link rel="stylesheet" href="//cloudcache.tencentcs.com/qcloud/main/components/document-feedback/document-feedback.944df9c907.css" />
-<style>
-* {
-  font-family: 'pingfang SC','helvetica neue',arial,'hiragino sans gb','microsoft yahei ui','microsoft yahei',simsun,sans-serif;
-}
-</style>
-
-<div class="markdown-text-box">
-| <b>系统录制的语音消息<br></b> | <b>TUICallkit 录制的带 AI 降噪和自动增益的语音消息<br></b> |
-| --- | --- |
-| <audio id="audio" controls preload="none">
-	<source id="m4a" src="https://im.sdk.cloudcachetci.com/tools/resource/rain_system_record.m4a"></source>
-      </audio> | <audio id="audio" controls preload="none">
-	<source id="m4a" src="https://im.sdk.cloudcachetci.com/tools/resource/rain_tuicallkit_record_with_agc_aidenoise.m4a"></source>
-      </audio> |
-
-</div>
-
-### 步骤8：构建多人音视频功能
-
-TUI 组件支持在聊天界面对用户发起多人音视频，仅需要简单几步就可以快速集成：
-
-1. 开通音视频服务。
-
-2. 登录 [即时通信 IM 控制台](https://console.cloud.tencent.com/im)，单击目标应用卡片，进入应用的基础配置页面。
-
-3. 找到含 UI 低代码场景方案功能区，单击卡片下方的多人音视频（TUIRoomKit） > 免费体验。
-
-4. 在弹窗中单击免费试用 7 天，即可成功开通多人音视频免费体验版。开通完成后即可参见 [集成指引](https://cloud.tencent.com/document/product/269/84296) 进行集成。
-
-5. 集成 TUIRoomKit 组件。在 podfile 文件中添加以下内容。
-
-   ``` ruby
-   // 集成多人音视频组件
-   pod 'TUIRoomKit'
-   ```
-6. 发起多人音视频会议
-
-   集成 TUIRoomKit 组件后，聊天界面默认会出现 “快速会议” 按钮，当用户点击按钮时，TUIKit 会自动发起会议，并在聊天记录中展示一条会议邀请卡片。
+在接入 IM SDK 过程中，您可以通过 MCP 使用 AI 助手，快速完成知识咨询、报错排查和 UIKit 集成代码生成。支持 Web/Android/iOS/Flutter/uni-app 等平台，答案基于官方文档。适用于查询 SDK API、UI 组件用法、服务端 API 与 IM 产品配置等场景，[立即体验，提出您的第一个问题](https://cloud.tencent.com/document/product/269/126983)。
 
 ## 常见问题
 
-#### 音视频常见问题
+### 音视频常见问题
 
-##### 1. TUICallKit 和自己集成的音视频库冲突了？
+#### TUICallKit 和自己集成的音视频库冲突了？
 
 腾讯云的音视频库不能同时集成，可能存在符号冲突，可以按照下面的场景处理。
 1. 如果您使用了 `TXLiteAVSDK_TRTC` 库，不会发生符号冲突。可直接在 Podfile 文件中添加依赖，
@@ -1030,18 +292,34 @@ TUI 组件支持在聊天界面对用户发起多人音视频，仅需要简单
    ```
 3. 如果您使用了 `TXLiteAVSDK_Enterprise` 库，会产生符号冲突。建议升级到 `TXLiteAVSDK_Professional` 后使用 TUICallKit_Swift/Professional。
 
-##### 2. 通话邀请的超时时间默认是多久？
+#### 通话邀请的超时时间默认是多久？
 
 通话邀请的默认超时时间是 30 秒。
 
-##### 3. 在邀请超时时间内，被邀请者如果离线再上线，能否立即收到邀请？
+#### 在邀请超时时间内，被邀请者如果离线再上线，能否立即收到邀请？
 - 如果是单聊通话邀请，被邀请者离线再上线可以收到通话邀请，TUIKit 内部会自动唤起通话邀请界面。
 
 - 如果是群聊通话邀请，被邀请者离线再上线后会自动拉取最近 30 秒内的邀请，TUIKit 会自动唤起群通话界面。
 
-#### 上架常见问题
+#### 如何移除音视频通话功能？
+
+ChatPage 默认集成了音视频通话功能，如果你不需要音视频通话功能。可以在 步骤 3 创建聊天界面 中关闭音视频通话开关，代码如下所示：
+
+【Swift】
+``` swift
+func showChat(_ info: ConversationInfo) {
+        // 在输入配置中关闭输入面板中的视频通话和音频通话功能
+        let inputConfig = ChatMessageInputConfig(isShowVideoCall: false, isShowAudioCall: false)
+        let chatPage = ChatPage(conversation: info, messageInputConfig: inputConfig, onBack: { [weak self] in
+            self?.navigationController.popViewController(animated: true)
+        })
+        navigationController.pushViewController(chatPage, animated: true)
+    }
+```
 
-##### 1. 上架 App Store 时打包失败，提示 Unsupported Architectures。
+### 上架常见问题
+
+#### 上架 App Store 时打包失败，提示 Unsupported Architectures？
 
 您可以按照下面的步骤，在打包时去掉模拟器版本：
 1. 选中您工程的 Target，并点击 Build Phases 选项，在当前面板中添加 Run Script；
@@ -1087,7 +365,7 @@ TUI 组件支持在聊天界面对用户发起多人音视频，仅需要简单
 
 ### Xcode 集成常见问题
 
-#### 1.  [Xcodeproj] Unknown object version (60). (RuntimeError)
+#### [Xcodeproj] Unknown object version (60). (RuntimeError)
 
 使用 Xcode 15 创建新工程来集成 TUIKit 时，输入 **pod install** 后，可能会遇到此问题，原因是使用了较旧版本的 CocoaPods ，此时有两种解决办法：
 
@@ -1097,7 +375,7 @@ TUI 组件支持在聊天界面对用户发起多人音视频，仅需要简单
 
 您可以在终端输入 **pod --version** 查看当前的 Pods 版本。
 
-#### 2. -ld64链接器问题
+#### -ld64链接器问题？
 
 Assertion failed: (false && "compact unwind compressed function offset doesn't fit in 24 bits"), function operator(), file Layout.cpp,
 
@@ -1107,17 +385,17 @@ Assertion failed: (false && "compact unwind compressed function offset doesn't f
 
 在 **Build Settings** 中的 **Other Linker Flags** 中添加"**-ld64**"，即可解决。  参考资料： [https://developer.apple.com/forums/thread/735426](https://links.jianshu.com/go)。
 
-#### 3. Rosetta 模拟器问题
+#### Rosetta 模拟器问题？
 
 使用苹果芯片（M1\M2等系列芯片）时会遇到， 原因是包括 SDWebImage 在内的三方库，并未支持 xcframework，不过苹果依旧给出了适配办法，就是在模拟器上开启 Rosetta 设置， 一般情况下编译时会自动弹出 Rosetta 选项。
 
-#### 4. Xcode 15 开发者沙盒选项问题
+#### Xcode 15 开发者沙盒选项问题？
 
 Sandbox: bash(xxx) deny(1) file-write-create
 
 当您使用 Xcode 15 创建一个新工程时， 可能会因为此选项导致编译运行失败，建议您关闭此选项。
 
-#### 5. Xcode 16 不支持 Framework 开启 bitcode 问题
+#### Xcode 16 不支持 Framework 开启 bitcode 问题？
 
 **解决方案1：升级 SDK**
 
@@ -1146,23 +424,13 @@ end
 
 ### CocoaPods 集成常见问题
 
-#### 1. 使用远端集成时，Pod 依赖版本不匹配问题
-
-若您使用远端 Pods 集成时，出现 **Podfile.lock** 和 插件依赖的 TUICore 版本不一致时，
+若您执行 pod install，出现 **Podfile.lock** 和 插件依赖的版本不一致时，
 
 此时请删除 **Podfile.lock** 文件， 并使用 **pod repo update** 更新本地代码仓库， 之后使用 **pod update** 重新更新即可。
 
-#### 2. 使用本地集成时，Pod 依赖版本不匹配问题
-
-若您使用 DevelopPods 集成时 出现  插件依赖的 **TUICore** 版本较新，但本地 Pod 依赖的版本号是 **1.0.0** ，
-
-此时请您参见 [Podfile_local](https://github.com/TencentCloud/TIMSDK/blob/master/iOS/Demo/Podfile_local) 和 [TUICore.spec](https://github.com/TencentCloud/TIMSDK/blob/master/iOS/TUIKit/TUICore/TUICore.podspec) ， 插件需要跟随版本，需要和 TUICore.spec 中一致，正常情况下我们会帮您修改为一致。
-
-第一次使用本地集成时，建议您下载我们的示例 Demo 工程，将 Podfile 文件内容替换为 Podfile_local 的内容，执行 **Pod update** 后相互参照。
-
 ### 其他常见问题
 
-##### 表情包的使用
+#### 表情包的使用
 
 为了尊重版权，IM Demo/TUIKit 工程中默认不包含大表情元素切图。正式上线商用前请您替换为自己设计或拥有版权的其他表情包。下图所示默认的**小黄脸表情包版权归腾讯云所有**，可有偿授权使用，如需获得授权，您可以通过升级至 [IM 企业版套餐](https://buy.cloud.tencent.com/avc) 免费使用该表情包。