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

package/resource/knowledge/callkit/preset/web/api.md

@@ -0,0 +1,79 @@
+## TUICallKit（含 UI 组件）
+
+TUICallKit API 是音视频通话组件的**含 UI 接口**，使用 TUICallKit API，您可以通过简单接口快速实现一个类微信的音视频通话场景。
+
+|<br>API|描述|
+|---------|---------|
+|[init](https://cloud.tencent.com/document/product/647/81015#init)|初始化 TUICallKit 组件实例。|
+|[calls](https://cloud.tencent.com/document/product/647/81015#calls)|发起单人或多人通话。|
+|[join](https://cloud.tencent.com/document/product/647/81015#join)|主动加入通话。|
+|[setCallingBell](https://cloud.tencent.com/document/product/647/81015#setCallingBell)|设置自定义来电铃音。|
+|[setSelfInfo](https://cloud.tencent.com/document/product/647/81015#setSelfInfo)|设置用户昵称和头像。|
+|[enableMuteMode](https://cloud.tencent.com/document/product/647/81015#enableMuteMode)|开启/关闭来电铃声。|
+|[enableFloatWindow](https://cloud.tencent.com/document/product/647/81015#enableFloatWindow)|开启/关闭悬浮窗功能。|
+|[enableVirtualBackground](https://cloud.tencent.com/document/product/647/81015#enableVirtualBackground)|开启/关闭模糊背景的功能按钮。|
+|[setLanguage](https://cloud.tencent.com/document/product/647/81015#setLanguage)|设置 TUICallKit 组件通话语言。|
+|[hideFeatureButton](https://cloud.tencent.com/document/product/647/81015#hideFeatureButton)|隐藏按钮。|
+|[setLocalViewBackgroundImage](https://cloud.tencent.com/document/product/647/81015#setLocalViewBackgroundImage)|设置本地用户通话界面背景图。|
+|[setRemoteViewBackgroundImage](https://cloud.tencent.com/document/product/647/81015#setRemoteViewBackgroundImage)|设置远端用户通话界面背景图。|
+|[setLayoutMode](https://cloud.tencent.com/document/product/647/81015#setLayoutMode)|设置通话界面布局模式。|
+|[setCameraDefaultState](https://cloud.tencent.com/document/product/647/81015#setCameraDefaultState)|设置摄像头是否默认打开。|
+|[destroyed](https://cloud.tencent.com/document/product/647/81015#destroyed)|销毁 TUICallKit 组件实例。|
+|[getTUICallEngineInstance](https://cloud.tencent.com/document/product/647/81015#getTUICallEngineInstance)|获取 TUICallEngine 实例。|
+
+## TUICallEngine (无 UI 接口)
+
+TUICallEngine API 是音视频通话组件的**无 UI 接口**，如果 CallKit 的交互并不满足您的需求，您可以使用这套 API 根据您的业务需求自定义封装。
+
+|**API**|**描述**|
+|---------|---------|
+|[createInstance](https://web.sdk.qcloud.com/component/trtccalling/doc/TUICallEngine/web/zh-cn/TUICallEngine.html#createInstance)|创建 TUICallEngine 实例（单例模式）。|
+|[destroyInstance](https://web.sdk.qcloud.com/component/trtccalling/doc/TUICallEngine/web/zh-cn/TUICallEngine.html#destroyInstance)|销毁 TUICallEngine 实例（单例模式）。|
+|[on](https://web.sdk.qcloud.com/component/trtccalling/doc/TUICallEngine/web/zh-cn/TUICallEngine.html#on)|监听事件。|
+|[off](https://web.sdk.qcloud.com/component/trtccalling/doc/TUICallEngine/web/zh-cn/TUICallEngine.html#off)|取消监听事件。|
+|[login](https://web.sdk.qcloud.com/component/trtccalling/doc/TUICallEngine/web/zh-cn/TUICallEngine.html#login)|登录接口。|
+|[logout](https://web.sdk.qcloud.com/component/trtccalling/doc/TUICallEngine/web/zh-cn/TUICallEngine.html#logout)|登出接口。|
+|[setSelfInfo](https://web.sdk.qcloud.com/component/trtccalling/doc/TUICallEngine/web/zh-cn/TUICallEngine.html#setSelfInfo)|设置用户昵称和头像。|
+|[calls](https://web.sdk.qcloud.com/component/trtccalling/doc/TUICallEngine/web/zh-cn/TUICallEngine.html#calls)|发起单人或多人通话。|
+|[join](https://web.sdk.qcloud.com/component/trtccalling/doc/TUICallEngine/web/zh-cn/TUICallEngine.html#join)|主动加入通话。|
+|[accept](https://web.sdk.qcloud.com/component/trtccalling/doc/TUICallEngine/web/zh-cn/TUICallEngine.html#accept)|接听通话。|
+|[reject](https://web.sdk.qcloud.com/component/trtccalling/doc/TUICallEngine/web/zh-cn/TUICallEngine.html#reject)|拒绝通话。|
+|[hangup](https://web.sdk.qcloud.com/component/trtccalling/doc/TUICallEngine/web/zh-cn/TUICallEngine.html#hangup)|结束通话。|
+|[startRemoteView](https://web.sdk.qcloud.com/component/trtccalling/doc/TUICallEngine/web/zh-cn/TUICallEngine.html#startRemoteView)|启动远端画面渲染。|
+|[stopRemoteView](https://web.sdk.qcloud.com/component/trtccalling/doc/TUICallEngine/web/zh-cn/TUICallEngine.html#stopRemoteView)|停止远端画面渲染。|
+|[openCamera](https://web.sdk.qcloud.com/component/trtccalling/doc/TUICallEngine/web/zh-cn/TUICallEngine.html#openCamera)|开启摄像头。|
+|[closeCamera](https://web.sdk.qcloud.com/component/trtccalling/doc/TUICallEngine/web/zh-cn/TUICallEngine.html#closeCamera)|关闭摄像头。|
+|[switchCamera](https://web.sdk.qcloud.com/component/trtccalling/doc/TUICallEngine/web/zh-cn/TUICallEngine.html#switchCamera)|切换前后置摄像头，仅移动端支持。|
+|[openMicrophone](https://web.sdk.qcloud.com/component/trtccalling/doc/TUICallEngine/web/zh-cn/TUICallEngine.html#openMicrophone)|打开麦克风。|
+|[closeMicrophone](https://web.sdk.qcloud.com/component/trtccalling/doc/TUICallEngine/web/zh-cn/TUICallEngine.html#closeMicrophone)|关闭麦克风。|
+|[setVideoQuality](https://web.sdk.qcloud.com/component/trtccalling/doc/TUICallEngine/web/zh-cn/TUICallEngine.html#setVideoQuality)|设置视频分辨率。|
+|[getDeviceList](https://web.sdk.qcloud.com/component/trtccalling/doc/TUICallEngine/web/zh-cn/TUICallEngine.html#getDeviceList)|获取设备列表。|
+|[switchDevice](https://web.sdk.qcloud.com/component/trtccalling/doc/TUICallEngine/web/zh-cn/TUICallEngine.html#switchDevice)|切换摄像头或麦克风设备。|
+|[enableAIVoice](https://web.sdk.qcloud.com/component/trtccalling/doc/TUICallEngine/web/zh-cn/TUICallEngine.html#enableAIVoice)|开启/关闭 AI 降噪。|
+|[enableMultiDeviceAbility](https://web.sdk.qcloud.com/component/trtccalling/doc/TUICallEngine/web/zh-cn/TUICallEngine.html#enableMultiDeviceAbility)|开启/关闭 TUICallEngine 的多设备登录模式。|
+|[setBlurBackground](https://web.sdk.qcloud.com/component/trtccalling/doc/TUICallEngine/web/zh-cn/TUICallEngine.html#setBlurBackground)|开关/设置背景虚化。|
+|[setVirtualBackground](https://web.sdk.qcloud.com/component/trtccalling/doc/TUICallEngine/web/zh-cn/TUICallEngine.html#setVirtualBackground)|开关/设置图片背景虚化。|
+
+## TUICallEvent
+
+TUICallEvent 是 TUICallEngine 对应的事件类，您可以通过监听如下事件，来监听自己感兴趣的事件。
+
+|EVENT|描述|
+|---------|---------|
+|[TUICallEvent.ERROR](https://cloud.tencent.com/document/product/647/78758#ERROR)|通话过程中错误事件。|
+|[TUICallEvent.KICKED_OUT](https://cloud.tencent.com/document/product/647/78758#KICKED_OUT)|用户重复登录，被踢下线。|
+|[TUICallEvent.USER_ACCEPT](https://cloud.tencent.com/document/product/647/78758#USER_ACCEPT)|xxxx 用户接通的事件，**v4.x.x 已废弃。**|
+|[TUICallEvent.USER_ENTER](https://cloud.tencent.com/document/product/647/78758#USER_ENTER)|xxxx 用户加入通话的事件。|
+|[TUICallEvent.USER_LEAVE](https://cloud.tencent.com/document/product/647/78758#USER_LEAVE)|xxxx 用户离开通话的事件。|
+|[TUICallEvent.REJECT](https://cloud.tencent.com/document/product/647/78758#REJECT)|xxxx 用户拒绝通话的事件。|
+|[TUICallEvent.NO_RESP](https://cloud.tencent.com/document/product/647/78758#NO_RESP)|xxxx 用户不响应的事件。|
+|[TUICallEvent.LINE_BUSY](https://cloud.tencent.com/document/product/647/78758#LINE_BUSY)|xxxx 用户忙线的事件。|
+|[TUICallEvent.USER_VIDEO_AVAILABLE](https://cloud.tencent.com/document/product/647/78758#USER_VIDEO_AVAILABLE)|xxxx 用户是否有视频流的事件。|
+|[TUICallEvent.USER_AUDIO_AVAILABLE](https://cloud.tencent.com/document/product/647/78758#USER_AUDIO_AVAILABLE)|xxxx 用户是否有音频流的事件。|
+|[TUICallEvent.USER_VOICE_VOLUME](https://cloud.tencent.com/document/product/647/78758#USER_VOICE_VOLUME)|所有用户音量大小的反馈事件。|
+|[TUICallEvent.ON_CALL_RECEIVED](https://cloud.tencent.com/document/product/647/78758#ON_CALL_RECEIVED)|通话请求的事件。|
+|TUICallEvent.ON_CALL_NOT_CONNECTED|通话未建立的事件。|
+|[TUICallEvent.ON_CALL_BEGIN](https://cloud.tencent.com/document/product/647/78758#ON_CALL_BEGIN)|通话接通时抛出的事件。|
+|TUICallEvent.ON_CALL_END|通话结束时抛出的事件。|
+|[TUICallEvent.DEVICED_UPDATED](https://cloud.tencent.com/document/product/647/78758#DEVICED_UPDATED)|设备列表更新的事件。|
+|[TUICallEvent.ON_USER_NETWORK_QUALITY_CHANGED](https://cloud.tencent.com/document/product/647/78758#ON_USER_NETWORK_QUALITY_CHANGED)|所有用户网络质量的事件。|

package/resource/knowledge/chat/preset/android/features/chat-setting.md

@@ -0,0 +1,72 @@
+## 组件概述
+
+ChatSetting 是基于 Jetpack Compose  构建的聊天设置组件集合，主要包含单聊设置（C2CChatSetting）和群聊设置（GroupChatSetting）两个核心组件。这些组件为用户提供了完整的聊天会话管理功能，包括用户信息管理、权限设置、群组管理等核心能力。
+| <strong>单聊设置界面</strong> | <strong>群聊设置界面</strong> |
+| --- | --- |
+|  |  |
+
+## 组件集成
+
+ChatSetting 组件属于 TUIKit Compose 的一部分，集成 TUIKit Compose 即可获取并使用 ChatSetting 组件。集成方法请参考文档 TUIKit Compose 里的集成步骤。
+
+## 组件构成
+
+ChatSetting 包含两个主要组件：C2CChatSetting（单聊设置）和 GroupChatSetting（群聊设置），每个组件都提供了丰富的配置选项。
+
+### 单聊设置（C2CChatSetting）
+
+#### 对外方法
+| 方法名 | 参数 | 描述 |
+| --- | --- | --- |
+| <code>C2CChatSetting</code> | <code>userID: String</code> | 聊天对象的用户 ID。 |
+| <code>modifier: Modifier</code> | Jetpack Compose 中用来设置组件的样式、布局、行为和外观。 |  |
+| <code>onSendMessageClick: () -> Unit</code> | 发送消息按钮点击回调，可选参数。 |  |
+| <code>onContactDelete: () -> Unit</code> | 删除联系人按钮点击回调，可选参数。 |  |
+| <code>c2cChatSettingViewModelFactory: C2CChatSettingViewModelFactory</code> | 创建组件内部 C2CChatSettingViewModel 的工厂类。通常情况下，您无需手动创建，组件已提供默认实现。 |  |
+
+### 群聊设置（GroupChatSetting）
+
+#### 对外方法
+| 方法名 | 参数 | 描述 |
+| --- | --- | --- |
+| <code>GroupChatSetting</code> | <code>groupID: String</code> | 群组 ID，用于标识群聊。 |
+| <code>modifier: Modifier</code> | Jetpack Compose 中用来设置组件的样式、布局、行为和外观。 |  |
+| <code>onSendMessageClick: () -> Unit</code> | 发送消息按钮点击回调，可选参数。 |  |
+| <code>onGroupMemberClick: (GroupMember) -> Unit </code> | 群成员点击回调，可选参数。 |  |
+| <code>onGroupDelete: () -> Unit</code> | 解散/退出群组点击回调，可选参数。 |  |
+| <code>groupChatSettingViewModelFactory: GroupChatSettingViewModelFactory</code> | 创建组件内部 GroupChatSettingViewModel 的工厂类。通常情况下，您无需手动创建，组件已提供默认实现。 |  |
+
+## 基础用法
+
+初始化 C2CChatSetting 即可直接展示单聊设置页面，示例代码如下：
+``` swift
+Box {
+    C2CChatSetting(
+        userID = userID,
+        onSendMessageClick = {
+            // 处理发送消息点击事件
+        },
+        onContactDelete = {
+            // 处理联系人删除点击事件
+        },
+    )
+}
+```
+
+初始化 GroupChatSetting 即可直接展示群聊设置页面，示例代码如下：
+``` swift
+Box {
+    GroupChatSetting(
+        groupID = groupID,
+        onGroupMemberClick = { groupMember ->
+            // 处理点击群成员事件
+        },
+        onSendMessageClick = {
+            // 处理发送消息点击事件
+        },
+        onGroupDelete = {
+            // 处理解散退出群组事件
+        },
+    )
+}
+```

package/resource/knowledge/chat/preset/android/features/contact-list.md

@@ -0,0 +1,41 @@
+## 组件概述
+
+ContactList 是基于 Jetpack Compose 构建的联系人列表组件，为用户提供完整的联系人管理功能。该组件支持好友列表展示、好友申请处理、群组列表管理、黑名单管理等功能，并提供了丰富的交互回调接口。
+| <strong>联系人列表</strong> | <strong>群组列表</strong> | <strong>好友申请列表</strong> |
+| --- | --- | --- |
+|  |  |  |
+
+## 组件集成
+
+`ContactList` 组件属于 TUIKit Compose 的一部分，集成 TUIKit Compose 即可获取并使用 `ContactList` 组件。集成方法请参考文档 [TUIKit Compose](https://cloud.tencent.com/document/product/269/125127) 里的集成步骤。
+
+## 组件构成
+
+`ContactList` 是联系人列表里的主组件，对应着整个联系人列表页框架：
+| <strong>方法名</strong> | <strong>参数</strong> | <strong>描述</strong> |
+| --- | --- | --- |
+| <code>ContactList</code> | <code>modifier: Modifier</code> | Jetpack Compose 中用来设置组件的样式、布局、行为和外观。 |
+| <code>onGroupClick: (ContactInfo) -> Unit</code> | 点击群组的回调，可选参数。 |  |
+| <code>onContactClick: (ContactInfo) -> Unit</code> | 点击联系人的回调，可选参数。 |  |
+| <code>contactListViewModelFactory: ContactListViewModelFactory</code> | 创建组件内部 ContactListViewModel 的工厂类。通常情况下，您无需手动创建，组件已提供默认实现。 |  |
+
+`ContactList` 上半部分预留了各个子视图的入口 cell，例如好友申请、群聊申请、群聊列表和黑名单列表。下半部分内嵌了联系人列表，如下图所示：
+
+## 基础用法
+
+在 `ContactList` 中点击好友申请、群聊申请、群聊列表和黑名单列表入口时，由组件自动完成路由，无需额外处理；点击群聊列表中的群组或联系人列表/黑名单中的个人时，会触发相应的回调接口 (`onGroupClick/onContactClick`)，需监听回调并实现自定义跳转。路由跳转示例图如下所示：
+
+初始化 ContactList 即可直接展示联系人列表，示例代码如下：
+``` swift
+Box(
+    modifier = Modifier
+        .fillMaxSize()
+        .systemBarsPadding()
+) {
+    ContactList(onGroupClick = {
+        // 处理群组点击事件
+    }, onContactClick = {
+        // 处理联系人点击事件
+    })
+}
+```

package/resource/knowledge/chat/preset/android/features/conversation-list.md

@@ -0,0 +1,123 @@
+## 组件概述
+
+ConversationList 是一个基于 Jetpack Compose 构建的会话列表组件，主要用于展示和管理用户的聊天会话。该组件提供了完整的会话列表功能，包括会话展示、交互操作等核心能力。
+| <strong>会话列表</strong> | <strong>会话操作</strong> |
+| --- | --- |
+|  |  |
+
+## 组件集成
+
+ConversationList 是属于 TUIKit Compose 的一个组件，集成 TUIKit Compose 即可获取并使用 ConversationList，集成方法请参考文档 TUIKit Compose 里的集成步骤。
+
+## 组件构成
+
+ConversationList 组件对外仅暴露了会话列表的初始化方法，其他逻辑均封装在 ConversationList 中。
+
+#### 对外方法
+| 方法名 | 参数 | 描述 |
+| --- | --- | --- |
+| <code>ConversationList</code> | <code>modifier: Modifier</code> | Jetpack Compose 中用来设置组件的样式、布局、行为和外观。 |
+| <code>conversationListViewModelFactory: ConversationListViewModelFactory</code> | 创建组件内部 ConversationListViewModel 的工厂类。通常情况下，您无需手动创建，组件已提供默认实现。 |  |
+| <code>config: ConversationActionConfigProtocol</code> | 初始化组件，设置会话操作菜单项，选填。 |  |
+| <code>customActions: List</code> | 初始化组件，设置自定义会话操作选项，选填。 |  |
+| <code>onConversationClick: (ConversationInfo) -> Unit</code> | 设置会话点击回调。 |  |
+
+## 基础用法
+
+ConversationList 组件可直接初始化使用，需要传入 onConversationClick 回调。
+
+|参数名|类型|描述|
+|---------|---------|---------|
+|`onConversationClick`|`(ConversationInfo) -> Unit`|会话点击回调，当用户点击某个会话 cell 时触发。|
+
+示例代码如下：
+``` swift
+Box(
+    modifier = Modifier
+        .fillMaxSize()
+        .systemBarsPadding()
+) {
+    ConversationList(onConversationClick = {
+        // 这里建议导航到聊天页面
+    })
+}
+```
+
+## 自定义组件
+
+您可以自定义会话列表的操作项。方法如下。
+
+#### 方式 1. 局部隐藏会话操作项
+
+初始化 ConversationList 时设置 `actions`，表示当前在会话列表 cell 上展示哪些操作项：
+``` swift
+Box {
+    ConversationList(
+        // 不展示 ClearHistory
+        config = ChatConversationActionConfig(
+            isSupportDelete = true,
+            isSupportPin = true,
+            isSupportClearHistory = false
+        )
+    ) {
+        // 点击会话 cell 跳转
+    }
+}
+```
+
+**目前支持的菜单项开关操作**
+
+|操作类型|描述|
+|---------|---------|
+|`isSupportDelete`|是否支持删除会话。|
+|`isSupportPin`|是否支持置顶会话。|
+|`isSupportClearHistory`|是否支持清空历史消息。|
+
+#### 方式 2. 局部增加会话操作项
+
+初始化 ConversationList 时传入 `customActions`，ConversationList 内部会在默认的 action 底部添加您增加的自定义选项：
+
+|参数名|类型|描述|
+|---------|---------|---------|
+|`customActions`|`List<ConversationCustomAction>`|自定义会话操作，当用户点击会话操作菜单时展示。|
+
+示例代码如下：
+``` swift
+Box {
+    ConversationList(
+        customActions = listOf(ConversationCustomAction(title = "Share") {
+            println("Share conversation: ${it.title}")
+        })
+    ) {
+        // 处理点击事件
+    }
+}
+```
+
+#### 方式 3. 全局配置方式
+
+通过 `AppBuilderConfig` 进行全局配置：
+``` swift
+// 在应用启动时配置，不包含则不支持
+AppBuilderConfig.conversationActionList = listOf(
+    ConversationAction.DELETE,           // 支持删除
+    ConversationAction.PIN,              // 支持置顶
+    ConversationAction.CLEAR_HISTORY     // 清空会话消息
+)
+
+// 接下来再初始化 ConversationList，所有的 ConversationList 都会遵守上面 conversationActionList 的配置
+ConversationList() {
+    // 这里可以导航到聊天页面
+}
+```
+
+> **注意：**
+>
+
+> 局部配置的优先级大于全局配置。
+>
+
+自定义效果如下图所示：
+| 会话操作（默认选项） | 会话操作（隐藏<strong>删除</strong>选项） | 会话操作（新增<strong>隐藏会话</strong>选项） |
+| --- | --- | --- |
+|  |  |  |

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

@@ -0,0 +1,142 @@
+## 功能描述
+
+Android 端 `TUIKit` 默认自带 **简体中文、英语 **和** 阿拉伯语** 语言包，作为界面展示语言。
+
+根据此文档指引，您可以使用默认语言包，也可自定义语言翻译表述和增加其他语言包。
+
+> **说明：**
+>
+
+> TUIKit 从 7.5.4852 版本开始，新增 RTL 语言（文字方向从右到左的语言，例如阿拉伯语、希伯来语等）支持，当应用内语言为 RTL 语言时，TUIKit 会自动切换到 RTL 样式；同时内置语言新增了阿拉伯语。
+>
+
+|简体中文|英文|阿拉伯语|
+|---------|---------|---------|
+||||
+
+## 使用自带语言
+
+如果您的 App 需要的语言仅包括 **简体中文**、**英语 **和** 阿拉伯语**，请参考本部分。
+
+### 跟随系统语言
+
+直接使用 `TUIKit` 即可，无需额外步骤。组件内部语言会跟随系统语言。
+
+### 指定显示的语言
+
+如果您需要指定 TUIKit 界面的语言，需要在 Appliction 初始化时调用以下代码进行设置，例如设置为英文：
+``` java
+public class MyApplication extends Application {
+    @Override
+    protected void onCreate() {
+        super.onCreate();
+        TUIThemeManager.getInstance().changeLanguage(this, TUIThemeManager.LANGUAGE_EN);
+    }
+
+    /**
+    * 语言可选枚举为：
+    * TUIThemeManager.LANGUAGE_EN        ---- 英文
+    * TUIThemeManager.LANGUAGE_ZH_CN     ---- 简体中文
+    * TUIThemeManager.LANGUAGE_AR        ---- 阿拉伯语
+    */
+}
+```
+
+> **注意**
+>
+
+> 调用 `changeLanguage` 方法并不会自动刷新 UI，需要获取字符串之后重新设置到控件上才能生效。
+>
+
+### 实时动态修改
+
+您可以参考 `TUIKitDemo` 的 [LanguageSelectActivity.java](https://github.com/TencentCloud/TIMSDK/blob/master/Android/Demo/app/src/main/java/com/tencent/qcloud/tim/demo/login/LanguageSelectActivity.java) 文件中的代码。也可以使用如下方法切换语言，例如切换为英文：
+``` java
+TUIThemeManager.getInstance().changeLanguage(context, TUIThemeManager.LANGUAGE_EN);
+System.exit(0);
+Intent intent = context.getPackageManager().getLaunchIntentForPackage(context.getPackageName());
+context.startActivity(intent);
+```
+
+### 使用 WebView 之后发现语言切换失败处理方法
+
+使用 WebView 之后导致语言切换失败是 Android 7 及以后版本的 bug，原因是 WebView 初始化时会修改 App 的语言为手机系统语言。需要在 [TUIThemeManager.java](https://github.com/TencentCloud/TIMSDK/blob/master/Android/TUIKit/TUICore/tuicore/src/main/java/com/tencent/qcloud/tuicore/TUIThemeManager.java) 的 `setThemeInternal` 方法中调用以下代码解决此问题：
+``` java
+setWebViewLanguage(appContext);
+```
+
+添加之后：
+``` java
+private void setThemeInternal(Context context) {
+    if (context == null) {
+        return;
+    }
+
+    Context appContext = context.getApplicationContext();
+    if (!isInit) {
+        isInit = true;
+        if (appContext instanceof Application) {
+            ((Application) appContext).registerActivityLifecycleCallbacks(new ThemeAndLanguageCallback());
+        }
+
+        /**
+        * 在此处添加代码  begin
+        */
+        setWebViewLanguage(appContext);
+        /**
+        * 在此处添加代码  end
+        */
+        Locale defaultLocale = getLocale(appContext);
+        SPUtils spUtils = SPUtils.getInstance(SP_THEME_AND_LANGUAGE_NAME);
+        currentLanguage = spUtils.getString(SP_KEY_LANGUAGE, defaultLocale.getLanguage());
+        currentThemeID = spUtils.getInt(SP_KEY_THEME, THEME_LIGHT);
+
+        // The language only needs to be initialized once
+        applyLanguage(appContext);
+    }
+    // The theme needs to be updated multiple times
+    applyTheme(appContext);
+}
+```
+
+## 使用更多语言/自定义翻译表述
+
+如果您的 App 需要支持更多语言，或更改部分词条的翻译，请参考本部分。
+
+本章节以 `TUIGroup` 组件添加韩语语言包为例，讲解新增语言包和自定义翻译的流程。
+
+### 新增语言资源文件
+
+在 Android Studio 中的 `TUIGroup` 组件目录下，右键菜单中新增 Android Resource File：
+
+输入文件名 `strings`，由 `Locale` 维度创建资源目录：
+
+语言选择为韩语（"ko: Korean"），地区选为"KR: South Korea" ，点击确定，这样就创建好了韩语资源文件 `values-ko-rKR/strings.xml`。
+
+### 个性化自定义翻译
+
+上一步已经创建好了韩语资源文件 `values-ko-rKR/strings.xml`，现在把 `values/strings.xml` 文件中的内容复制到 `values-ko-rKR/strings.xml`，用韩语替换对应的英文，如图所示：
+
+不同语言资源文件中语言的 `name` 是相同的，具体内容可以自定义翻译。
+
+### 跟随系统语言
+
+直接使用 `TUIKit` 即可，将手机默认语言设置为韩语后启动 App ，App 语言可以自动显示为韩语。
+
+### 指定显示的语言
+
+如果您需要指定 `TUIKit` 界面的语言为韩语，应该先在 `Appliction` 初始化时向语言管理器中添加韩语，然后再设置 `TUIKit` 界面的语言为韩语：
+``` java
+public class MyApplication extends Application {
+    @Override
+    protected void onCreate() {
+        super.onCreate();
+        // 添加韩语
+        TUIThemeManager.addLanguage("ko-rKR", Locale.KOREA);
+        // 应用语言改为韩语
+        TUIThemeManager.getInstance().changeLanguage(this, "ko-rKR");
+    }
+}
+```
+
+效果如图所示：

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

@@ -0,0 +1,57 @@
+## 组件概述
+
+MessageInput 是基于 Jetpack Compose  构建的消息输入组件，为用户提供完整的消息编辑和发送功能。该组件支持多种消息类型的输入和发送，包括文本消息、图片、视频、文件、语音等，同时提供表情选择等增强功能，支持多种样式配置和自定义选项。
+| <strong>消息输入界面</strong> | <strong>表情选择器</strong> |
+| --- | --- |
+|  |  |
+
+## 组件集成
+
+MessageInput 组件属于 TUIKit Compose 的一部分，集成 TUIKit Compose 即可获取并使用 MessageInput 组件。集成方法请参考文档 TUIKit Compose 里的集成步骤。
+
+## 组件构成
+
+MessageInput 组件包含消息输入核心组件和样式配置协议，提供了消息输入功能，并支持自定义。
+
+#### 对外方法
+| 方法名 | 参数 | 描述 |
+| --- | --- | --- |
+| <code> MessageInput</code> | <code>conversationID: String</code> | 会话 ID，用于标识当前聊天会话。如果是单聊，组成方式为 c2c_userID。如果是群聊，组成方式为 group_groupID。 |
+| <code>modifier: Modifier</code> | Jetpack Compose 中用来设置组件的样式、布局、行为和外观。 |  |
+| <code>config: MessageInputConfigProtocol</code> | 输入样式配置，控制各功能按钮的显示。 |  |
+| <code>messageInputViewModelFactory: MessageInputViewModelFactory</code> | 创建组件内部 MessageInputViewModel 的工厂类。通常情况下，您无需手动创建，组件已提供默认实现。 |  |
+
+## 基础用法
+
+MessageInput 组件可直接初始化使用，需要提供会话 ID。
+``` swift
+Box(
+    modifier = Modifier
+        .fillMaxWidth()
+) {
+    MessageInput(
+        conversationID = conversationID,
+        modifier = Modifier.navigationBarsPadding()
+    )
+}
+```
+
+## 自定义组件
+
+您可以自定义决定是否显示输入栏上的功能入口：
+``` swift
+// 自定义显示哪些功能按钮
+MessageInput(
+    conversationID = conversationID,
+    config = ChatMessageInputConfig(
+        isShowAudioRecorder = false,   // 隐藏语音录制
+        isShowPhotoTaker = true,       // 显示拍照功能
+        isShowMore = true,             // 显示更多功能
+    )
+)
+```
+
+自定义效果如下图所示：
+| 默认输入框 | 隐藏输入框上的语音录制功能 | 隐藏输入框上的全部功能 |
+| --- | --- | --- |
+|  |  |  |

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

@@ -0,0 +1,142 @@
+## 组件概述
+
+MessageList 是一个基于 Jetpack Compose 构建的消息列表组件，主要用于展示和管理聊天消息。该组件提供了完整的消息类型展示功能：
+- 消息类型支持：文本、图片、视频、语音、文件、系统消息、表情消息等。
+
+- 消息操作：支持长按菜单操作，例如复制、删除、撤回、以及自定义操作。
+
+- 高度可定制：支持多种样式配置（例如气泡颜色、圆角、字体）和自定义操作项。
+
+| <strong>聊天消息列表</strong> | <strong>消息长按菜单</strong> |
+| --- | --- |
+|  |  |
+
+## 组件集成
+
+MessageList 是属于 TUIKit Compose 的一个组件，集成 TUIKit Compose 即可获取并使用 MessageList，集成方法请参考文档 TUIKit Compose 里的集成步骤。
+
+## 组件构成
+
+MessageList 组件对外仅暴露了消息列表的初始化方法，其他逻辑均封装在 MessageList 中。
+
+#### 对外方法
+| 方法名 | 参数 | 描述 |
+| --- | --- | --- |
+| <code>MessageList</code> | <code>conversationID: String</code> | 初始化组件，设置会话 ID。如果是单聊，组成方式为 c2c_userID。如果是群聊，组成方式为 group_groupID。 |
+| <code>modifier: Modifier </code> | Jetpack Compose 中用来设置组件的样式、布局、行为和外观。 |  |
+| <code>config: MessageListConfigProtocol</code> | 初始化组件，设置消息列表样式。 |  |
+| <code>customActions: List<MessageCustomAction></code> | 初始化组件，设置自定义消息菜单选项。 |  |
+| <code>locateMessage: MessageInfo?</code> | 初始化组件，设置定位消息。通常用于从消息搜索结果页跳转消息页同时定位到目标消息。 |  |
+| <code>messageListViewModelFactory: MessageListViewModelFactory</code> | 创建组件内部 MessageListViewModel 的工厂类。通常情况下，您无需手动创建，组件已提供默认实现。 |  |
+| <code>onUserClick: (String) -> Unit</code> | 初始化组件，设置点击用户头像跳转响应事件。 |  |
+
+## 基础用法
+
+MessageList 组件可直接初始化使用，需要提供会话 ID。除此之外，我们还建议您在初始化方法中实现 onUserClick。
+``` swift
+Box(modifier = Modifier.systemBarsPadding()) {
+    MessageList(conversationID = conversationID) {
+        // 点击用户头像响应事件
+    }
+}
+```
+
+## 自定义组件
+
+您可以自定义消息列表的样式和操作项。方法如下。
+
+#### 自定义样式
+
+您可以实现 `MessageListConfigProtocol` 来创建完全自定义的样式：
+``` swift
+class MyCustomConfig(
+    override val alignment: MessageAlignment = MessageAlignment.TWO_SIDED,
+    override val isShowTimeMessage: Boolean = true,
+    override val isShowLeftAvatar: Boolean = true,
+    override val isShowLeftNickname: Boolean = true,
+    override val isShowRightAvatar: Boolean = true,
+    override val isShowRightNickname: Boolean = true,
+    // ... 其他必须属性
+) : MessageListConfigProtocol
+
+MessageList(conversationID = conversationID, config = MyCustomConfig()) {
+    // 点击用户头像响应事件
+}
+```
+
+`MessageListConfigProtocol` 属性说明：
+| 属性名 | 类型 | 描述 | 备注 |
+| --- | --- | --- | --- |
+| <code>alignment</code> | <code>MessageAlignment</code> | 消息对齐方式 | - <code>MessageAlignment.LEFT</code>：左对齐。<br>- <code>MessageAlignment.RIGHT</code>：右对齐。<br>- <code>MessageAlignment.TWO_SIDED</code>：左右对齐。 |
+| <code>isShowTimeMessage</code> | <code>Boolean</code> | 是否显示时间消息 | 控制是否显示消息时间戳。 |
+| <code>isShowLeftAvatar</code> | <code>Boolean</code> | 是否显示左侧头像 | 控制接收消息时是否显示发送者头像。 |
+| <code>isShowLeftNickname</code> | <code>Boolean</code> | 是否显示左侧昵称 | 控制接收消息时是否显示发送者昵称。 |
+| <code>isShowRightAvatar</code> | <code>Boolean</code> | 是否显示右侧头像 | 控制发送消息时是否显示自己头像。 |
+| <code>isShowRightNickname</code> | <code>Boolean</code> | 是否显示右侧昵称 | 控制发送消息时是否显示自己昵称。 |
+| <code>isShowTimeInBubble</code> | <code>Boolean</code> | 是否在气泡内显示时间 | 控制时间戳是否显示在消息气泡内部。 |
+| <code>cellSpacing</code> | <code>Dp</code> | 消息间距 | 控制相邻消息之间的间距。 |
+| <code>isShowSystemMessage</code> | <code>Boolean</code> | 是否显示系统消息 | 控制是否显示系统通知类消息。 |
+| <code>isShowUnsupportMessage</code> | <code>Boolean</code> | 是否显示不支持的消息 | 控制是否显示不支持类型的消息。 |
+| <code>horizontalPadding</code> | <code>Dp</code> | 水平内边距 | 控制消息列表的左右内边距。 |
+| <code>avatarSpacing</code> | <code>Dp</code> | 头像间距 | 控制头像与消息内容之间的间距。 |
+| <code>isSupportCopy</code> | <code>Boolean</code> | 消息操作菜单是否支持复制 | - |
+| <code>isSupportDelete</code> | <code>Boolean</code> | 消息操作菜单是否支持删除 | - |
+| <code>isSupportRecall</code> | <code>Boolean</code> | 消息操作菜单是否支持撤回 | - |
+
+### **自定义操作项**
+
+您可以采用多种方式自定义长按消息菜单项。
+
+#### 方式 1. 局部隐藏/显示操作项
+
+初始化 MessageList 时，通过设置 config 中的 `isSupportCopy`、`isSupportDelete`、`isSupportRecall`显示操作项：
+``` swift
+MessageList(
+    conversationID = conversationID,
+    config = ChatMessageListConfig(isSupportCopy = false)
+) {
+    // 点击用户头像响应事件
+}
+```
+
+#### 方式 2. 局部增加操作项
+
+初始化 MessageList 时传入 `customActions`，MessageList 内部会在默认的 action 底部添加您增加的自定义选项：
+``` swift
+MessageList(
+    conversationID = conversationID,
+    customActions = listOf(
+        MessageCustomAction(title = "Share", iconResID = R.drawable.message_list_menu_forward_icon) {
+            println("Share Message")
+        }
+    )
+)
+```
+
+#### **方式 3. 全局配置操作项**
+
+通过 `AppBuilderConfig` 进行全局配置：
+``` swift
+// 在应用启动时配置
+AppBuilderConfig.messageActionList = listOf(
+    MessageAction.COPY,    // 支持复制
+    MessageAction.DELETE,  // 支持删除
+    MessageAction.RECALL   // 支持撤回
+)
+
+// 接下来再初始化 MessageList，所有的 MessageList 都会遵守上面的配置
+MessageList(
+    conversationID = conversationID,
+)
+```
+
+> **注意：**
+>
+
+> 局部配置的优先级大于全局配置。
+>
+
+自定义效果如下图所示：
+| 消息列表操作（默认选项） | 消息列表操作（隐藏<strong>复制</strong>选项） | 消息列表操作（新增<strong>分享</strong>选项） |
+| --- | --- | --- |
+|  |  |  |