@tencentcloud/sdk-mcp 1.4.6 → 1.6.0-beta.1

package/resource/{doc/chatkit/ios → knowledge/chat/preset/ios-uikit}/integration.md

@@ -1,22 +1,38 @@
-本文将介绍如何集成 `TUIKit` 组件。
+TUIKit 是基于 IM SDK 的一款 UI 组件库，可通过 UI 组件快速实现聊天、会话、搜索、关系链、群组等功能。本文介绍如何快速集成 TUIKit 并实现核心功能。
 
-> **说明：**
->
-> 1. 从 5.7.1435 版本开始，TUIKit 支持模块化集成，支持了经典版 UI，您可以根据自己的需求集成所需模块。
-> 2. 从 6.9.3557 版本开始，TUIKit 新增了全新的简约版 UI。
-> 3. 为了尊重版权，IM Demo/TUIKit 工程中默认不包含大表情元素切图。正式上线商用前请您替换为自己设计或拥有版权的其他表情包。下图所示默认的**小黄脸表情包版权归腾讯云所有**，可有偿授权使用，如需获得授权可您可以通过升级至 [IM 企业版套餐](https://buy.cloud.tencent.com/avc) 免费使用该表情包。
+> **架构说明**：本文档对应 **iOS TUIKit（UIKit 架构）**，适用于基于 UIKit 的项目。如需 SwiftUI 架构，请参考 iOS TUIKit SwiftUI 集成文档。
 
->
->
+## 关键概念
+- **经典版 UI**：从 5.7.1435 版本开始，TUIKit 支持模块化集成，支持了经典版 UI（类微信 UI）。
+
+- **简约版 UI**：从 6.9.3557 版本开始，TUIKit 新增了全新的简约版 UI（类 WhatsApp UI）。
+
+   您可以根据需求自由选择经典版或简约版 UI 组件。如果您还不了解各个界面库的功能，可以查阅文档 [TUIKit 界面库介绍](https://cloud.tencent.com/document/product/269/37190)。
+
+## 前提条件
+- Xcode 15 及以上
 
-您可以根据需求自由选择经典版或简约版 UI 组件。如果您还不了解各个界面库的功能，可以查阅文档 [TUIKit 界面库介绍](https://cloud.tencent.com/document/product/269/37190)。
+- iOS 14.0 及以上
 
-## 开发环境要求
-- Xcode 10 及以上
+- 一个有效的腾讯云账号及 Chat 应用。可参考 开通服务 从控制台获取以下信息：
 
-- iOS 9.0 及以上
+  - SDKAppID：App 在控制台获取的 Chat 应用的 ID，为应用的唯一标识。
+
+  - SDKSecretKey：应用的密钥。
 
 ## CocoaPods 集成
+
+> **消息引用与回复功能的版本兼容性：**
+>
+
+> 自 9.0.7652 版本起：
+>
+> - **消息引用（Quote）**改用 IMSDK 原生引用能力实现，与旧版本引用消息格式不兼容。新旧版本互发的引用消息无法正确解析引用内容，请将收发双方统一升级至 9.0.7652 及以上版本。
+> - **消息回复（Reply）**功能已下线，相关接口与 UI 入口不再提供，如业务有相关需求，可参考旧版本 TUIKit 自行实现。
+
+> **两者区别：引用是发送新消息时附带一条历史消息的摘要卡片，点击可跳转原消息（一问一答）；回复是在某条消息下追加评论并聚合成回复列表（评论区式）。**
+>
+
 1. 安装 CocoaPods。
 在终端窗口中输入如下命令（需要提前在 Mac 中安装 Ruby 环境）：
 
@@ -35,12 +51,12 @@
 
   - DevelopmentPods 本地集成。
 
-      以上两种集成方式的优缺点如下表所示：
+      上面两种集成方式的优缺点如下表所示：
 
-| 集成方式 | 适合场景 | 优点 | 缺点 |
-| --- | --- | --- | --- |
-| 远程 CocoaPods 集成 | 适合无源码修改时的集成。 | 当 TUIKit 有版本更新时，您只需再次` Pod update `即可完成更新。 | 当您有源码修改，使用 `Pod update` 更新时，新版本的 TUIKit 会覆盖您的修改。 |
-| 本地 DevelopmentPods 集成 | 适合有涉及源码自定义修改的客户。 | 当您有自己的 git 仓库时，可以跟踪修改。修改源码后，使用 `Pod update` 更新其他远程 Pod 库时，不会覆盖您的修改。 | 您需要手动将 TUIKit 源码覆盖您本地 TUIKit 文件夹进行更新。 |
+      |集成方式|适合场景|优点|缺点|
+      |---------|---------|---------|---------|
+      |远程 CocoaPods 集成|适合无源码修改时的集成。|当 TUIKit 有版本更新时，您只需再次` Pod update `即可完成更新。|当您有源码修改，使用 `Pod update` 更新时，新版本的 TUIKit 会覆盖您的修改。|
+      |本地 DevelopmentPods 集成|适合有涉及源码自定义修改的客户。|当您有自己的 git 仓库时，可以跟踪修改。修改源码后，使用 `Pod update` 更新其他远程 Pod 库时，不会覆盖您的修改。|您需要手动将 TUIKit 源码覆盖您本地 TUIKit 文件夹进行更新。|
 
 ### 远程 CocoaPods 集成
 
@@ -58,7 +74,7 @@
 ``` bash
 # Uncomment the next line to define a global platform for your project
 source 'https://github.com/CocoaPods/Specs.git'
-platform :ios, '13.0'
+platform :ios, '14.0'
 # 防止 TUIKit 组件里的 *.xcassets 与您项目里面冲突。
 install! 'cocoapods', :disable_input_output_paths => true
 
@@ -100,7 +116,7 @@ post_install do |installer|
             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'] = "13.0"
+            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
@@ -120,14 +136,14 @@ post_install do |installer|
             end
         end
     end
-
+end
 ```
 
 【Objective-C 组件】
 ``` bash
 # Uncomment the next line to define a global platform for your project
 source 'https://github.com/CocoaPods/Specs.git'
-platform :ios, '13.0'
+platform :ios, '14.0'
 # 防止 TUIKit 组件里的 *.xcassets 与您项目里面冲突。
 install! 'cocoapods', :disable_input_output_paths => true
 
@@ -136,7 +152,7 @@ target 'your_project_name' do
   # 从 7.1 版本开始，新增了 TUIKit 插件（TUIXXXPlugin），TUIKit 插件是动态库依赖，需要开启此设置。
   # 如果您不依赖 TUIKit 插件，该设置可以保持关闭。
   use_frameworks!
-  # 请按需开启 modular headers，开启后 Pod 模块才能使用 @import 导入，简化 Swift 引用 OC 的方式。
+  # 请按需开启 use_modular_headers!。开启后，Pod 会被生成为 Clang Module，OC 可用 @import 模块名;、Swift 可直接 import 模块名 引用，无需 Bridging Header。
   # use_modular_headers!
 
   # 集成聊天功能
@@ -176,7 +192,7 @@ post_install do |installer|
             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'] = "13.0"
+            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
@@ -196,7 +212,7 @@ post_install do |installer|
             end
         end
     end
-
+end
 ```
 
 【简约版】
@@ -205,7 +221,7 @@ post_install do |installer|
 ``` bash
 # Uncomment the next line to define a global platform for your project
 source 'https://github.com/CocoaPods/Specs.git'
-platform :ios, '13.0'
+platform :ios, '14.0'
 # 防止 TUIKit 组件里的 *.xcassets 与您项目里面冲突。
 install! 'cocoapods', :disable_input_output_paths => true
 
@@ -240,7 +256,7 @@ post_install do |installer|
             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'] = "13.0"
+            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
@@ -260,13 +276,14 @@ post_install do |installer|
             end
         end
     end
+end
 ```
 
 【Objective-C 组件】
 ``` bash
 # Uncomment the next line to define a global platform for your project
 source 'https://github.com/CocoaPods/Specs.git'
-platform :ios, '13.0'
+platform :ios, '14.0'
 # 防止 TUIKit 组件里的 *.xcassets 与您项目里面冲突。
 install! 'cocoapods', :disable_input_output_paths => true
 
@@ -275,7 +292,7 @@ target 'your_project_name' do
   # 从 7.1 版本开始，新增了 TUIKit 插件（TUIXXXPlugin），TUIKit 插件是动态库依赖，需要开启此设置。
   # 如果您不依赖 TUIKit 插件，该设置可以保持关闭。
   use_frameworks!
-  # 请按需开启 modular headers，开启后 Pod 模块才能使用 @import 导入，简化 Swift 引用 OC 的方式。
+  # 请按需开启 use_modular_headers!。开启后，Pod 会被生成为 Clang Module，OC 可用 @import 模块名;、Swift 可直接 import 模块名 引用，无需 Bridging Header。
   # use_modular_headers!
 
   # 集成聊天功能
@@ -306,7 +323,7 @@ post_install do |installer|
             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'] = "13.0"
+            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
@@ -326,13 +343,13 @@ post_install do |installer|
             end
         end
     end
+end
 ```
 
 > **说明：**
 >
 > 1. 如果您直接 `pod 'TUIChat'`，不指定经典版或简约版，默认会集成两套版本 UI 组件。
 > 2. 经典版和简约版 UI 不能混用，集成多个组件时，您必须同时全部选择经典版 UI 或简约版 UI。例如，经典版 `TUIChat` 组件必须与经典版 `TUIConversation`、`TUIContact` 组件搭配使用。同理，简约版 `TUIChat` 组件必须与简约版 `TUIConversation`、`TUIContact` 组件搭配使用。
-> 3. 如果您使用的是 Swift，请开启 `use_modular_headers!` ，并将头文件引用改成 @import 模块名形式引用。
 
 Podfile 修改完毕后，执行以下命令，安装 TUIKit 组件。
 ``` bash
@@ -344,25 +361,31 @@ pod install
 pod repo update
 ```
 
-之后执行以下命令，更新组件库的Pod版本。
+之后执行以下命令，更新组件库的 Pod 版本。
 ``` bash
 pod update
 ```
 
 集成全部的 TUIKit 组件后的项目结构：
 
-> **注意：**
+### 本地 DevelopmentPods 源码集成
+
+> **消息引用与回复功能的版本兼容性：**
 >
 
-> 若您操作遇到错误，可查阅文末的常见问题。
+> 自 9.0.7652 版本起：
+>
+> - 消息引用（Quote） 改用 IMSDK 原生引用能力实现，与旧版本引用消息格式不兼容。新旧版本互发的引用消息无法正确解析引用内容，请将收发双方统一升级至 9.0.7652 及以上版本。
+> - 消息回复（Reply） 功能已下线，相关接口与 UI 入口不再提供，如业务有相关需求，可参考旧版本 TUIKit 自行实现。
+
+> *两者区别：引用是发送新消息时附带一条历史消息的摘要卡片，点击可跳转原消息（一问一答）；回复是在某条消息下追加评论并聚合成回复列表（评论区式）。*
 >
 
-### 本地 DevelopmentPods 源码集成
 1. 从 GitHub 下载 TUIKit 源码，将 TUIKit 目录直接拖入您的工程目录下:
 
-  - [Swift TUIKit 源码 Github 地址](https://github.com/Tencent-RTC/Chat_UIKit/tree/main/Swift/TUIKit)：
+  - [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)：
+  - [Objective-C TUIKit 源码 GitHub 地址](https://github.com/TencentCloud/TIMSDK/tree/master/iOS/TUIKit)：
 
 2. 修改您 Podfile 中每个组件的本地路径。path 是 TUIKit 文件夹相对于您工程 Podfile 文件的位置，常见的有：
 
@@ -374,13 +397,13 @@ pod update
 
       以 TUIKit 文件夹位于您工程 Podfile 文件父目录为例：
 
-【DevelopmentPodfile】
+【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, '13.0'
+platform :ios, '14.0'
 install! 'cocoapods', :disable_input_output_paths => true
 
 # 请使用您的真实项目名称替换 your_project_name
@@ -424,7 +447,7 @@ post_install do |installer|
             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'] = "13.0"
+            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
@@ -444,14 +467,14 @@ post_install do |installer|
             end
         end
     end
-en
+end
 ```
 
 【Objective-C 组件】
 ``` bash
 # Uncomment the next line to define a global platform for your project
 source 'https://github.com/CocoaPods/Specs.git'
-platform :ios, '13.0'
+platform :ios, '14.0'
 install! 'cocoapods', :disable_input_output_paths => true
 
 # 请使用您的真实项目名称替换 your_project_name
@@ -497,7 +520,7 @@ post_install do |installer|
             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'] = "13.0"
+            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
@@ -517,7 +540,7 @@ post_install do |installer|
             end
         end
     end
-en
+end
 ```
 
 3. Podfile 修改完毕后，执行以下命令，安装本地 TUIKit 组件。示例：
@@ -528,7 +551,7 @@ en
 
    > **注意：**
    >
->   1. 使用本地集成方案时，如需升级时需要从 Github 获取最新的组件代码，覆盖您本地项目的 TUIKit 目录。
+>   1. 使用本地集成方案时，如需升级时需要从 GitHub 获取最新的组件代码，覆盖您本地项目的 TUIKit 目录。
 >   2. 当私有化修改和远端有冲突时，需要手动合并，处理冲突。
 >   3. TUIKit 插件需要依赖 TUICore 的版本，请确保插件版本和 "../TUIKit/TUICore/TUICore.spec" 中的 spec.version 一致。
 
@@ -558,27 +581,23 @@ TUIKit 依赖的第三方库的最低版本如下，如果您的版本较低，
 - SSZipArchive (2.4.3)
 ```
 
-## 快速搭建
+## 接入步骤
 
-常用的聊天软件都是由会话列表、聊天窗口、好友列表、音视频通话等几个基本的界面组成，参考下面步骤，您仅需几行代码即可在项目中快速搭建这些 UI 界面。
+常用的聊天软件都是由会话列表、聊天窗口、好友列表、音视频通话等几个基本的界面组成，参考下面步骤，您仅需几行代码即可在项目中快速搭建这些 UI 界面。 实操教学（Objective-C 组件版本）视频请参见：[极速集成 TUIKit（iOS）](https://cloud.tencent.com/edu/learning/quick-play/3130-82618)。
 
-> **说明：**
->
+### 步骤1：配置用户鉴权
 
->  关于 TUIKit 组件模块功能：
->
-> - 实操教学（Objective-C 组件版本）视频请参见：[极速集成 TUIKit（iOS）](https://cloud.tencent.com/edu/learning/course-3130-56699)。
-> - 如果想了解更多，您还可以 [下载并运行 TUIKitDemo 源码](https://cloud.tencent.com/document/product/269/68228)，内含常见功能示例。
+SDKAppID 需要在 [即时通信 IM 控制台](https://console.cloud.tencent.com/im) 创建并获取，userSig 需要按规则计算，详细步骤请参考文档 [跑通 Demo](https://cloud.tencent.com/document/product/269/68228)。
 
-### 步骤1：组件登录
+### 步骤2：用户登录
 
 登录组件后才能正常使用组件的功能。用户在 App 上点击登录时，您可以登录 TUIKit 组件。
-SDKAppID 需要在 [即时通信 IM 控制台](https://console.cloud.tencent.com/im) 创建并获取，userSig 需要按规则计算，详细步骤请参考文档 [快速入门](https://cloud.tencent.com/document/product/269/68228#.E6.93.8D.E4.BD.9C.E6.AD.A5.E9.AA.A4)。
 
 示例代码如下所示：
 
 【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
@@ -603,7 +622,7 @@ SDKAppID 需要在 [即时通信 IM 控制台](https://console.cloud.tencent.com
 }
 ```
 
-### 步骤2：构建会话列表
+### 步骤3：构建会话列表界面
 
 会话列表只需要创建 `TUIConversationListController` 对象即可。会话列表会从数据库中读取最近联系人，当用户点击联系人时，`TUIConversationListController` 将事件 `didSelectConversation` 回调给上层。
 
@@ -613,17 +632,22 @@ SDKAppID 需要在 [即时通信 IM 控制台](https://console.cloud.tencent.com
 
 【Swift】
 ``` swift
+import UIKit
+import TUICore
+import ImSDK_Plus
+import TIMCommon
+import TUIConversation
 // ConversationController 为您自己的 ViewController
 public class ConversationController: UIViewController, V2TIMSDKListener, TUIPopViewDelegate {
-    override public func viewDidLoad() {
-        super.viewDidLoad()
-        setupNavigation()
-
-        conv = TUIConversationListController()
-        if let conv = conv {
-            addChild(conv)
-            view.addSubview(conv.view)
-        }
+       private var conv: TUIConversationListController?
+       override public func viewDidLoad() {
+         super.viewDidLoad()
+         setupNavigation()
+         conv = TUIConversationListController()
+         if let conv = conv {
+             addChild(conv)
+             view.addSubview(conv.view)
+         }
     }
 }
 // 会话列表点击事件，可自定义，通常是打开聊天界面
@@ -702,7 +726,7 @@ public protocol TUIConversationListControllerListener: AnyObject {
 @end
 ```
 
-### 步骤3：构建聊天窗口
+### 步骤4：构建聊天界面
 
 初始化聊天界面时，需要上层传入当前聊天界面对应的会话信息。
 
@@ -712,6 +736,11 @@ public protocol TUIConversationListControllerListener: AnyObject {
 
 【Swift】
 ``` swift
+import UIKit
+import TUICore
+import TIMCommon
+import TUIChat
+
 let conversationData = TUIChatConversationModel()
 conversationData.userID = userID ?? ""
 conversationData.groupID = groupID ?? ""
@@ -806,16 +835,21 @@ private func getChatViewController(_ model: TUIChatConversationModel) -> TUIBase
 > `TUIC2CChatViewController_Minimalist` 会自动拉取该用户的历史消息并展示出来。
 >
 
-### 步骤4：构建通讯录界面
+### 步骤5：构建联系人界面
 
-通讯录界面不需要其它依赖，只需创建对象并显示出来即可。
+联系人列表界面不需要其它依赖，只需创建对象并显示出来即可。
 
 【经典版】
 
 【Swift】
 ``` swift
+import UIKit
+import TUICore
+import TIMCommon
+import TUIContact
 // ContactController 为您自己的 ViewController
 public class ContactsController: UIViewController, TUIPopViewDelegate {
+    var contactVC: TUIContactController?
     override public func viewDidLoad() {
         super.viewDidLoad()
 
@@ -848,6 +882,7 @@ public class ContactsController: UIViewController, TUIPopViewDelegate {
 
 【Swift】
 ``` swift
+import TUIContact
 protocol TUIContactControllerListener: NSObjectProtocol {
     func onSelectFriend(_ cell: TUICommonContactCell) -> Bool
     func onAddNewFriend(_ cell: TUICommonTableViewCell) -> Bool
@@ -858,6 +893,7 @@ protocol TUIContactControllerListener: NSObjectProtocol {
 
 【Objective-C】
 ``` objectivec
+#import “TUIContactController.h”
 @protocol TUIContactControllerListener <NSObject>
 @optional
 - (void)onSelectFriend:(TUICommonContactCell *)cell;
@@ -921,12 +957,15 @@ protocol TUIContactControllerListener_Minimalist: AnyObject {
 @end
 ```
 
-例如，单击好友后，您可以将好友信息页展示出来：
+例如单击好友后，您可以将好友信息页展示出来：
 
 【经典版】
 
 【Swift】
 ``` swift
+import TIMCommon
+import TUICore
+import UIKit
 @objc private func onSelectFriend(_ cell: TUICommonContactCell) {
     if let delegate = delegate {
         if delegate.onSelectFriend(cell) { return }
@@ -983,7 +1022,7 @@ protocol TUIContactControllerListener_Minimalist: AnyObject {
 }
 ```
 
-### 步骤5：构建音视频通话功能
+### 步骤6：构建音视频通话功能
 
 TUI 组件支持在聊天界面对用户发起音视频通话，仅需要简单几步就可以快速集成：
 | 视频通话 | 语音通话 |
@@ -1005,7 +1044,17 @@ TUI 组件支持在聊天界面对用户发起音视频通话，仅需要简单
    // 集成音视频通话组件
    pod 'TUICallKit_Swift'
    ```
-6. 发起和接收视频或语音通话。
+6. 使用音视频功能，需要授权摄像头和麦克风的使用权限，请根据实际项目需要，设置项目所需权限。
+
+   在 **Xcode** 中，选择** TARGETS > Info > Custom iOS Target Properties** 菜单。
+
+     单击 **+**，添加摄像头和麦克风权限：
+
+  - Privacy - Camera Usage Description
+
+  - Privacy - Microphone Usage Description
+
+7. 发起和接收视频或语音通话。
 
 | 消息页发起通话 | 联系人页发起通话 |
 | --- | --- |
@@ -1015,12 +1064,12 @@ TUI 组件支持在聊天界面对用户发起音视频通话，仅需要简单
 
   - 当用户在线收到通话邀请时，TUIKit 会自动展示通话接收 UI，用户可以选择同意或者拒绝通话。
 
-  - 当用户离线收到通话邀请时，如需唤起 App 通话，就要使用到离线推送能力，离线推送的实现请参见 [添加离线推送](https://cloud.tencent.com/document/product/269/109894)。
+  - 当用户离线收到通话邀请时，如果需要唤起 App 通话，就要使用到离线推送能力，离线推送的实现请参见 [添加离线推送](https://cloud.tencent.com/document/product/269/109894)。
 
-7. 添加离线推送。
+8. 添加离线推送。
 在使用离线推送之前，您需要开通 [IM 离线推送](https://cloud.tencent.com/document/product/269/75429) 服务。
 
-8. 关于 App 的配置，您可以参见文档：[集成 TUIOfflinePush 跑通离线推送功能](https://cloud.tencent.com/document/product/269/109894)。
+9. 关于 App 的配置，您可以参见文档：[集成推送服务（Push）跑通离线推送功能](https://cloud.tencent.com/document/product/269/109894)。
 
    > **说明：**
    >
@@ -1028,9 +1077,11 @@ TUI 组件支持在聊天界面对用户发起音视频通话，仅需要简单
    > 配置完成后，当单击接收到的**音视频通话离线推送通知**时， TUICallKit 会自动拉起**音视频通话邀请界面**。
    >
 
-9. 附加增值能力
-集成 TUIChat 和 TUICallkit 的组件后，在聊天界面发送语音消息时，即可**录制带 AI 降噪和自动增益的语音消息**。该功能需要购买 [音视频通话能力](https://cloud.tencent.com/document/product/1640/79968) 进阶版及以上套餐，仅 IMSDK 7.0 及以上版本支持。当套餐过期后，录制语音消息会切换到系统 API 进行录音。
-下面是使用两台华为 P10同时录制的语音消息对比：
+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" />
@@ -1057,7 +1108,7 @@ TUI 组件支持在聊天界面对用户发起音视频通话，仅需要简单
 
 </div>
 
-### 步骤6：构建多人音视频功能
+### 步骤7. 构建多人音视频功能
 
 TUI 组件支持在聊天界面对用户发起多人音视频，仅需要简单几步就可以快速集成：
 
@@ -1067,7 +1118,7 @@ TUI 组件支持在聊天界面对用户发起多人音视频，仅需要简单
 
 3. 找到含 UI 低代码场景方案功能区，单击卡片下方的多人音视频（TUIRoomKit） > 免费体验。
 
-4. 在弹窗中单击免费试用7天，即可成功开通多人音视频免费体验版。开通完成后即可参见 [集成指引](https://cloud.tencent.com/document/product/269/84296) 进行集成。
+4. 在弹窗中单击免费试用 7 天，即可成功开通多人音视频免费体验版。开通完成后即可参见 [集成指引](https://cloud.tencent.com/document/product/269/84296) 进行集成。
 
 5. 集成 TUIRoomKit 组件。在 podfile 文件中添加以下内容。
 
@@ -1081,7 +1132,9 @@ TUI 组件支持在聊天界面对用户发起多人音视频，仅需要简单
 
 ## 常见问题
 
-#### 1. TUICallKit 和自己集成的音视频库冲突了？
+#### 音视频常见问题
+
+##### 1. TUICallKit 和自己集成的音视频库冲突了？
 
 腾讯云的音视频库不能同时集成，可能存在符号冲突，可以按照下面的场景处理。
 1. 如果您使用了 `TXLiteAVSDK_TRTC` 库，不会发生符号冲突。可直接在 Podfile 文件中添加依赖，
@@ -1096,18 +1149,20 @@ TUI 组件支持在聊天界面对用户发起多人音视频，仅需要简单
    ```
 3. 如果您使用了 `TXLiteAVSDK_Enterprise` 库，会产生符号冲突。建议升级到 `TXLiteAVSDK_Professional` 后使用 TUICallKit_Swift/Professional。
 
-#### 2. 通话邀请的超时时间默认是多久？
+##### 2. 通话邀请的超时时间默认是多久？
 
 通话邀请的默认超时时间是 30 秒。
 
-#### 3. 在邀请超时时间内，被邀请者如果离线再上线，能否立即收到邀请？
+##### 3. 在邀请超时时间内，被邀请者如果离线再上线，能否立即收到邀请？
 - 如果是单聊通话邀请，被邀请者离线再上线可以收到通话邀请，TUIKit 内部会自动唤起通话邀请界面。
 
 - 如果是群聊通话邀请，被邀请者离线再上线后会自动拉取最近 30 秒内的邀请，TUIKit 会自动唤起群通话界面。
 
-#### 4. 上架 Appstore 时打包失败，提示 Unsupported Architectures。
+#### 上架常见问题
 
-问题现象如下图，打包时提示 ImSDK_Plus.framework 中包含了 Appstore 不支持的 x86_64 模拟器版本。该问题是由于 IMSDK 为了方便开发者调试，发布时会默认带上模拟器版本。
+##### 1. 上架 App Store 时打包失败，提示 Unsupported Architectures。
+
+问题现象如下图，打包时提示 ImSDK_Plus.framework 中包含了 App Store 不支持的 x86_64 模拟器版本。该问题是由于 IMSDK 为了方便开发者调试，发布时会默认带上模拟器版本。
 
 您可以按照下面的步骤，在打包时去掉模拟器版本：
 1. 选中您工程的 Target，并点击 Build Phases 选项，在当前面板中添加 Run Script；
@@ -1151,11 +1206,11 @@ TUI 组件支持在聊天界面对用户发起多人音视频，仅需要简单
    done
    ```
 
-## Xcode 集成常见问题
+### Xcode 集成常见问题
 
 #### 1.  [Xcodeproj] Unknown object version (60). (RuntimeError)
 
-使用 Xcode15 创建新工程来集成 TUIKit 时，输入**pod install** 后，可能会遇到此问题，原因是使用了较旧版本的 CocoaPods ，此时有两种解决办法：
+使用 Xcode15 创建新工程来集成 TUIKit 时，输入 **pod install** 后，可能会遇到此问题，原因是使用了较旧版本的 CocoaPods ，此时有两种解决办法：
 
 解决方式一： 修改 Xcode 工程的 **Project Format **版本。
 
@@ -1167,15 +1222,15 @@ TUI 组件支持在聊天界面对用户发起多人音视频，仅需要简单
 
 Assertion failed: (false && "compact unwind compressed function offset doesn't fit in 24 bits"), function operator(), file Layout.cpp,
 
-或是使用 XCode15 集成 TUIRoom 时，因最新链接器导致 TUIRoomEngine 的符号冲突，都属于该问题。
+或是使用 Xcode 15 集成 TUIRoom 时，因最新链接器导致 TUIRoomEngine 的符号冲突，都属于该问题。
 
 解决方式是：修改链接器配置
 
-在 **Build Settings** 中的**Other Linker Flags** 种添加"**-ld64**"，即可解决。  参考资料： [https://developer.apple.com/forums/thread/735426](https://links.jianshu.com/go?to=https%3A%2F%2Fdeveloper.apple.com%2Fforums%2Fthread%2F735426)。
+在 **Build Settings** 中的 **Other Linker Flags** 中添加"**-ld64**"，即可解决。  参考资料： [https://developer.apple.com/forums/thread/735426](https://links.jianshu.com/go)。
 
 #### 3. Rosetta 模拟器问题
 
-使用苹果芯片（m1\m2等系列芯片）时会遇到， 原因是包括 SDWebImage 在内的三方库，并未支持 xcframework，不过苹果依旧给出了适配办法，就是在模拟器上开启 Rosetta 设置， 一般情况下编译时会自动弹出 Rosetta 选项。
+使用苹果芯片（M1\M2等系列芯片）时会遇到， 原因是包括 SDWebImage 在内的三方库，并未支持 xcframework，不过苹果依旧给出了适配办法，就是在模拟器上开启 Rosetta 设置， 一般情况下编译时会自动弹出 Rosetta 选项。
 
 #### 4. Xcode 15 开发者沙盒选项问题
 
@@ -1183,10 +1238,12 @@ Sandbox: bash(xxx) deny(1) file-write-create
 
 当您使用 Xcode 15 创建一个新工程时， 可能会因为此选项导致编译运行失败，建议您关闭此选项。
 
-### 5. Xcode 16 不支持 Framework 开启 bitcode 问题
+#### 5. Xcode 16 不支持 Framework 开启 bitcode 问题
 
 **解决方案1：升级 SDK**
-如果您使用的是包含 Bitcode 的旧版本 SDK（如 TXIMSDK_iOS），建议您按照本文档的指引，将 SDK 升级至 TXIMSDK_Plus_iOS_XCFramework。
+
+如果您使用的是包含 Bitcode 的旧版本 SDK（例如 TXIMSDK_iOS），建议您按照本文档的指引，将 SDK 升级至 TXIMSDK_Plus_iOS_XCFramework。
+
 **解决方式2: 修改 Podfile 配置**
 
 在您的 Podfile 末尾新增如下配置，重新 Pod install。
@@ -1208,18 +1265,24 @@ post_install do |installer|
 end
 ```
 
-## CocoaPods 集成常见问题
+### CocoaPods 集成常见问题
 
-#### 1. 使用远端集成时，Pod依赖版本不匹配问题
+#### 1. 使用远端集成时，Pod 依赖版本不匹配问题
 
 若您使用远端 Pods 集成时，出现 **Podfile.lock** 和 插件依赖的 TUICore 版本不一致时，
 
 此时请删除 **Podfile.lock** 文件， 并使用 **pod repo update **更新本地代码仓库， 之后使用 **pod update** 重新更新即可。
 
-#### 2. 使用本地集成时，Pod依赖版本不匹配问题
+#### 2. 使用本地集成时，Pod 依赖版本不匹配问题
 
-若您使用DevelopPods集成时 出现  插件依赖的 **TUICore **版本较新，但本地 Pod 依赖的版本号是 **1.0.0** ，
+若您使用 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) 免费使用该表情包。