@tencentcloud/sdk-mcp 1.3.9 → 1.4.0

package/resource/doc/{chatuikit → chatkit}/android/faq.md

@@ -15,7 +15,6 @@ TUIKit 最新源码已经支持 Androidx。
 
 3. Android 请关注库文件是否未能全部加载，或是使用过程中被系统回收。
 
-
 ### code: 6205 desc: QALSERVICE not ready？
 
 在初始化后调用了 `stopQALService` 导致此错误，可以参考客户分享的 [配置方法](https://blog.csdn.net/qq_16131393/article/details/54895733)。
@@ -28,10 +27,8 @@ TUIKit 最新源码已经支持 Androidx。
 
 - 另一种是使用 TIMFaceElem 中的 data，例如表情图片是由字符串命名，smile 表示笑脸，可在 data 中存储 smile，iOS 和 Android 两端都通过 data 作为 key 找到对应表情图片进行显示。
 
-
    另外也可以两个字段都使用，如 data 表示哪一套表情，index 表示这套表情的哪个索引，可以实现类似 QQ 的多种不同表情效果。甚至可以在 data 数据中存储更为复杂的数据结构，只要多端解析规则一致即可。
 
-
 ### 有时进行操作时返回错误码：10002?
 
 在需要进行服务端验证的操作时，如果网络异常、超时或者票据切换失败，就会返回此状态码，遇到此状态码时稍后重试即可。
@@ -57,7 +54,6 @@ TUIKit 最新源码已经支持 Androidx。
 
 - -5：登录操作未完成，SDK 未获取到服务器返回的 a2key 和 tinyID 时，直接调用其它接口会出现“tinyid或a2为空”的错误提示信息和-5的错误码。
 
-
 ### 在 armeabi 平台上 SDK 报"java.lang.UnsatisfiedLinkError: No implementation found for"错误该如何处理？
 
 拷贝 imsdk 的 aar 里面的 jni/armeabi-v7a/libImSDK.so 到源码工程的 src/main/jniLibs/armeabi 目录里，并在 build.gradle 中加载即可。
@@ -74,44 +70,40 @@ TUIKit 最新源码已经支持 Androidx。
  c. 添加如下代码：
 
    ``` bash
-   APP_PATH="${TARGET_BUILD_DIR}/${WRAPPER_NAME}"  
-   
-   # This script loops through the frameworks embedded in the application and  
-   
-   # removes unused architectures.  
-   
-    find "$APP_PATH" -name '*.framework' -type d | while read -r FRAMEWORK  
-    do  
-    FRAMEWORK_EXECUTABLE_NAME=$(defaults read "$FRAMEWORK/Info.plist" CFBundleExecutable)  
-    FRAMEWORK_EXECUTABLE_PATH="$FRAMEWORK/$FRAMEWORK_EXECUTABLE_NAME"  
-    echo "Executable is $FRAMEWORK_EXECUTABLE_PATH"  
-   
-    EXTRACTED_ARCHS=()  
-   
-    for ARCH in $ARCHS  
-    do  
-    echo "Extracting $ARCH from $FRAMEWORK_EXECUTABLE_NAME"  
-    lipo -extract "$ARCH" "$FRAMEWORK_EXECUTABLE_PATH" -o "$FRAMEWORK_EXECUTABLE_PATH-$ARCH"  
-    EXTRACTED_ARCHS+=("$FRAMEWORK_EXECUTABLE_PATH-$ARCH")  
-    done  
-   
-    echo "Merging extracted architectures: ${ARCHS}"  
-    lipo -o "$FRAMEWORK_EXECUTABLE_PATH-merged" -create "${EXTRACTED_ARCHS[@]}"  
-    rm "${EXTRACTED_ARCHS[@]}"  
-   
-    echo "Replacing original executable with thinned version"  
-    rm "$FRAMEWORK_EXECUTABLE_PATH"  
-    mv "$FRAMEWORK_EXECUTABLE_PATH-merged" "$FRAMEWORK_EXECUTABLE_PATH"  
-   
+   APP_PATH="${TARGET_BUILD_DIR}/${WRAPPER_NAME}"
+
+   # This script loops through the frameworks embedded in the application and
+
+   # removes unused architectures.
+
+    find "$APP_PATH" -name '*.framework' -type d | while read -r FRAMEWORK
+    do
+    FRAMEWORK_EXECUTABLE_NAME=$(defaults read "$FRAMEWORK/Info.plist" CFBundleExecutable)
+    FRAMEWORK_EXECUTABLE_PATH="$FRAMEWORK/$FRAMEWORK_EXECUTABLE_NAME"
+    echo "Executable is $FRAMEWORK_EXECUTABLE_PATH"
+
+    EXTRACTED_ARCHS=()
+
+    for ARCH in $ARCHS
+    do
+    echo "Extracting $ARCH from $FRAMEWORK_EXECUTABLE_NAME"
+    lipo -extract "$ARCH" "$FRAMEWORK_EXECUTABLE_PATH" -o "$FRAMEWORK_EXECUTABLE_PATH-$ARCH"
+    EXTRACTED_ARCHS+=("$FRAMEWORK_EXECUTABLE_PATH-$ARCH")
+    done
+
+    echo "Merging extracted architectures: ${ARCHS}"
+    lipo -o "$FRAMEWORK_EXECUTABLE_PATH-merged" -create "${EXTRACTED_ARCHS[@]}"
+    rm "${EXTRACTED_ARCHS[@]}"
+
+    echo "Replacing original executable with thinned version"
+    rm "$FRAMEWORK_EXECUTABLE_PATH"
+    mv "$FRAMEWORK_EXECUTABLE_PATH-merged" "$FRAMEWORK_EXECUTABLE_PATH"
+
     done
    ```
-   ![](https://write-document-release-1258344699.cos.ap-guangzhou.tencentcos.cn/100025598411/f7592364ceda11edb580525400088f3a.png)
 
 3. 重新打包上传。
 
-
 ### IM 各端 Demo/TUIKit 工程中演示用的表情包，开发者是否可以直接使用？
 
 为了尊重版权，IM Demo/TUIKit 工程中默认不包含大表情元素切图。在正式上线商用前，请您替换为自己设计或拥有版权的其他表情包。请注意，下图所示的**默认小黄脸表情包版权属于腾讯云**，您可以通过升级至 [IM 企业版套餐](https://buy.cloud.tencent.com/avc) 免费使用该表情包。
-
-![](https://write-document-release-1258344699.cos.ap-guangzhou.tencentcos.cn/100027937867/7e1754a0391611ef9c9c525400d5f8ef.png)

package/resource/doc/{chatuikit → chatkit}/android/features/theme.md

@@ -1,28 +1,9 @@
 TUIKit Compose 提供了强大的外观定制能力，支持自定义应用的主题模式（浅色/深色/跟随系统）和主题色。通过简单的配置，开发者可以轻松实现应用级别的主题切换和品牌色定制。
 
 以消息列表为例，自定义主题模式和主题色的效果如下图所示：
-<table>
-<tr>
-<td rowspan="1" colSpan="1" >**浅色 + 默认颜色**</td>
-
-<td rowspan="1" colSpan="1" >**浅色 + 橘黄色**</td>
-
-<td rowspan="1" colSpan="1" >**深色 + 默认颜色**</td>
-
-<td rowspan="1" colSpan="1" >**深色 + 绿色主题**</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" ><br>![](https://write-document-release-1258344699.cos.ap-guangzhou.tencentcos.cn/100027983637/1dcc10b9bee511f08863525400e889b2.png)</td>
-
-<td rowspan="1" colSpan="1" ><br>![](https://write-document-release-1258344699.cos.ap-guangzhou.tencentcos.cn/100027983637/34013fd4bee511f0a808525400bf7822.png)</td>
-
-<td rowspan="1" colSpan="1" ><br>![](https://write-document-release-1258344699.cos.ap-guangzhou.tencentcos.cn/100027983637/4d036798bee511f0b4c35254001c06ec.png)</td>
-
-<td rowspan="1" colSpan="1" ><br>![](https://write-document-release-1258344699.cos.ap-guangzhou.tencentcos.cn/100027983637/61fff637bee511f08863525400e889b2.png)</td>
-</tr>
-</table>
-
+| **浅色 + 默认颜色** | **浅色 + 橘黄色** | **深色 + 默认颜色** | **深色 + 绿色主题** |
+| --- | --- | --- | --- |
+|  |  |  |  |
 
 ## 核心能力
 
@@ -33,7 +14,6 @@ TUIKit Compose 提供了强大的外观定制能力，支持自定义应用的
 
 - 跟随系统（System）：自动跟随系统外观设置。
 
-
    **主题色定制**
 
 - 预设主题色：提供蓝、绿、红、橙等标准色。
@@ -44,121 +24,36 @@ TUIKit Compose 提供了强大的外观定制能力，支持自定义应用的
 
 - 清除自定义：一键恢复默认主题色。
 
-
 ## API 说明
 
 以上功能基于 `ThemeState` 提供的一组简洁的 API，用于主题配置和信息查询。
 
 ### 设置主题模式
-<table>
-<tr>
-<td rowspan="1" colSpan="1" >方法</td>
-
-<td rowspan="1" colSpan="1" >参数</td>
-
-<td rowspan="1" colSpan="1" >返回值</td>
-
-<td rowspan="1" colSpan="1" >说明</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >`setThemeMode`</td>
-
-<td rowspan="1" colSpan="1" >`ThemeMode`</td>
-
-<td rowspan="1" colSpan="1" >`Unit`</td>
-
-<td rowspan="1" colSpan="1" >设置显示模式，自动保存并刷新。<br>• `ThemeMode.SYSTEM`：跟随系统外观。<br>• `ThemeMode.LIGHT`：强制使用浅色模式。<br>• `ThemeMode.DARK`：强制使用深色模式。</td>
-</tr>
-</table>
-
+| 方法 | 参数 | 返回值 | 说明 |
+| --- | --- | --- | --- |
+| `setThemeMode` | `ThemeMode` | `Unit` | 设置显示模式，自动保存并刷新。<br>• `ThemeMode.SYSTEM`：跟随系统外观。<br>• `ThemeMode.LIGHT`：强制使用浅色模式。<br>• `ThemeMode.DARK`：强制使用深色模式。 |
 
 ### 设置主题色
-<table>
-<tr>
-<td rowspan="1" colSpan="1" >方法</td>
-
-<td rowspan="1" colSpan="1" >参数</td>
-
-<td rowspan="1" colSpan="1" >返回值</td>
-
-<td rowspan="1" colSpan="1" >说明</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >`setPrimaryColor`</td>
-
-<td rowspan="1" colSpan="1" >`String`</td>
-
-<td rowspan="1" colSpan="1" >`Unit`</td>
-
-<td rowspan="1" colSpan="1" >设置主题色，需要 Hex 格式（例如 "#1C66E5"）。</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >`clearPrimaryColor`</td>
-
-<td rowspan="1" colSpan="1" >无</td>
-
-<td rowspan="1" colSpan="1" >`Unit`</td>
-
-<td rowspan="1" colSpan="1" >清除自定义主题色，恢复默认蓝色。</td>
-</tr>
-</table>
-
+| 方法 | 参数 | 返回值 | 说明 |
+| --- | --- | --- | --- |
+| `setPrimaryColor` | `String` | `Unit` | 设置主题色，需要 Hex 格式（例如 "#1C66E5"）。 |
+| `clearPrimaryColor` | 无 | `Unit` | 清除自定义主题色，恢复默认蓝色。 |
 
 > **说明：**
-> 
+>
 > - 调用 `setThemeMode` 或 `setPrimaryColor` 后，配置会自动保存到持久化存储，无需手动保存。下次启动应用时会自动加载。
 > - 修改主题配置时会自动清除缓存，确保色彩方案实时更新。开发者无需关心缓存管理。
 > - 使用设置 API 时需避免频繁切换主题（例如在循环中调用）。
 
-
 ### 查询 ThemeState 信息
 
 通过以下只读属性可以查询当前的主题配置状态和信息：
-<table>
-<tr>
-<td rowspan="1" colSpan="1" >属性</td>
-
-<td rowspan="1" colSpan="1" >类型</td>
-
-<td rowspan="1" colSpan="1" >说明</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >`currentMode`</td>
-
-<td rowspan="1" colSpan="1" >`ThemeMode`</td>
-
-<td rowspan="1" colSpan="1" >当前主题模式。</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >`currentPrimaryColor`</td>
-
-<td rowspan="1" colSpan="1" >`String?`</td>
-
-<td rowspan="1" colSpan="1" >当前主题色（Hex 格式）。</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >`hasCustomPrimaryColor`</td>
-
-<td rowspan="1" colSpan="1" >`Boolean`</td>
-
-<td rowspan="1" colSpan="1" >是否设置了自定义主题色。</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >`isDarkMode`</td>
-
-<td rowspan="1" colSpan="1" >`Boolean`</td>
-
-<td rowspan="1" colSpan="1" >当前是否为深色模式。</td>
-</tr>
-</table>
-
+| 属性 | 类型 | 说明 |
+| --- | --- | --- |
+| `currentMode` | `ThemeMode` | 当前主题模式。 |
+| `currentPrimaryColor` | `String?` | 当前主题色（Hex 格式）。 |
+| `hasCustomPrimaryColor` | `Boolean` | 是否设置了自定义主题色。 |
+| `isDarkMode` | `Boolean` | 当前是否为深色模式。 |
 
 ## 使用方式
 
@@ -170,9 +65,6 @@ AppBuilder是一个便捷式功能及 UI 自定义配置工具，通过 JSON 配
 
 您可以在 [Chat Web 体验馆](https://trtc.io/demo/homepage/#/detail?scene=messenger) 体验 AppBuilder 功能，体验入口：
 
-![](https://write-document-release-1258344699.cos.ap-guangzhou.tencentcos.cn/100027983637/321d5873b88211f09a6b525400454e06.png)
-
-
 虽然 Chat Web 体验馆上暂时无法实时观看移动端的配置效果，但移动端已经预先支持了 AppBuilder 的配置能力。
 
 接下来为您介绍在 Web 体验馆设置 AppBuilder 后，如何在移动端项目中应用该自定义配置。操作步骤比较简单，只有 2 步：
@@ -180,14 +72,10 @@ AppBuilder是一个便捷式功能及 UI 自定义配置工具，通过 JSON 配
 
 2. 将配置文件 appConfig.json 拖入您的 Android 项目中。
 
-
 ####  1. 下载配置文件
 
 访问 [Chat Web 体验馆](https://trtc.io/demo/homepage/#/detail?scene=messenger)，下载配置文件 appConfig.json。下载路径为：
 
-![](https://write-document-release-1258344699.cos.ap-guangzhou.tencentcos.cn/100027983637/3205aa68b88211f0a808525400bf7822.png)
-
-
 `appConfig.json`文件内容如下所示，与 AppBuilder 页面的配置项一一对应，与定义外观相关的配置是 `theme`及其子字段：
 ``` json
 {
@@ -229,46 +117,15 @@ AppBuilder是一个便捷式功能及 UI 自定义配置工具，通过 JSON 配
 ```
 
 **配置选项说明**
-<table>
-<tr>
-<td rowspan="1" colSpan="1" >参数说明</td>
-
-<td rowspan="1" colSpan="1" >类型</td>
-
-<td rowspan="1" colSpan="1" >可选值</td>
-
-<td rowspan="1" colSpan="1" >说明</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >`mode`</td>
-
-<td rowspan="1" colSpan="1" >String</td>
-
-<td rowspan="1" colSpan="1" >`"system"`、`"light"`、`"dark"`</td>
-
-<td rowspan="1" colSpan="1" >主题模式</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >`primaryColor`</td>
-
-<td rowspan="1" colSpan="1" >String</td>
-
-<td rowspan="1" colSpan="1" >Hex 颜色值，例如 `"#0ABF77"`</td>
-
-<td rowspan="1" colSpan="1" >主题色</td>
-</tr>
-</table>
-
+| 参数说明 | 类型 | 可选值 | 说明 |
+| --- | --- | --- | --- |
+| `mode` | String | `"system"`、`"light"`、`"dark"` | 主题模式 |
+| `primaryColor` | String | Hex 颜色值，例如 `"#0ABF77"` | 主题色 |
 
 #### 2. 将配置文件拖入项目中
 
 将 appConfig.json 拖入您的项目中。以 Github 开源 Demo [TUIKit Android Compose](https://github.com/Tencent-RTC/TUIKit_Android_Compose/blob/main/chat/demo/app/src/main/assets/appConfig.json) 项目为例，appConfig.json 位于 demo/app 的 assets 文件夹下：
 
-![](https://write-document-release-1258344699.cos.ap-guangzhou.tencentcos.cn/100027983637/ce0dba6fb88a11f0a808525400bf7822.png)
-
-
 至此，无需编写额外代码，启动 App 后，TUIKit Compose 组件的模式和主题色会自动显示成您在 appConfig.json 中设置的值。
 
 ### 方式二：代码设置主题模式
@@ -317,11 +174,10 @@ Column {
 ```
 
 > **使用建议：**
-> 
+>
 > - 对于大多数应用，推荐使用 JSON 配置文件的方式，简单可靠且支持多端统一。
 > - 在整个应用中统一使用 `themeState.colors` 中的颜色，确保主题切换时界面保持一致。
 
-
 ## 常见问题
 
 ### **如何判断当前是否为深色模式？**