@tencentcloud/sdk-mcp 1.2.6 → 1.2.8

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tencentcloud/sdk-mcp",
-  "version": "1.2.6",
+  "version": "1.2.8",
   "description": "Tencent Cloud MCP Server for SDK",
   "type": "module",
   "main": "index.js",

package/resource/doc/chatuikit/faq/common/server_error_code.md

@@ -0,0 +1,74 @@
+---
+product: 'Chat'
+tech_stack: 'server'
+framework: 'common'
+title: '服务端错误码大全'
+keywords: ['错误码', '报错', '登录失败', '70001']
+---
+
+# 服务端错误码大全
+
+## 服务端错误码 (Topic: Server)
+
+## 错误码 70001
+**原因：** userSig 已过期。
+**解决方案：** 请重新生成。建议 userSig 有效期设置不小于24小时。
+
+## 错误码 70003
+**原因：** userSig 非法。
+**解决方案：** 请重新生成，生成方式可参考官网文档：https://cloud.tencent.com/document/product/269/32688。
+
+## 错误码 70009
+**原因：** userSig 验证失败，怀疑 UserSig 是用其他 SDKAppID 的密钥或私钥生成的。
+**解决方案：** 请检查请求的 SDKAppID 和生成 UserSig 的密钥或私钥是否一致。
+
+## 错误码 70013
+**原因：** 请求中的 userID 与生成 userSig 时使用的 userID 不一致。
+**解决方案：** 建议检查一下您登录 im 的 userID 和 生成 userSig 的 userID 是否一致。
+
+## 错误码 70014
+**原因：** 请求中的 SDKAppID 与生成 UserSig 时使用的 SDKAppID 不一致。
+**解决方案：** 您可以使用【即时通信 IM 控制台 > 开发工具 > UserSig生成&校验】（https://console.cloud.tencent.com/im/tool-usersig）校验 UserSig。
+
+## 错误码 20003
+**原因：** 消息发送方或接收方 userID 无效或不存在。
+**解决方案：** 请确认一下您使用的 userID 是否已经在您使用的 sdkappid 下登录过即时通信 IM。
+
+## 错误码 20009
+**原因：** 收发双方非好友，禁止发送。
+**解决方案：** 消息发送双方互相不是好友，禁止发送（配置单聊消息校验好友关系才会出现），如果需要给非好友发送消息，需要在控制台进行配置，或者先加对方为好友。
+
+## 错误码 20010
+**原因：** 发送方不是接收方好友，禁止发送。
+**解决方案：** 发送单聊消息，自己不是对方的好友（单向关系），禁止发送。
+
+## 错误码 3122
+**原因：** 您当前购买使用的套餐包暂未不支持此功能。
+**解决方案：** 您可以升级到套餐为【旗舰版】（https://buy.cloud.tencent.com/avc）。
+
+## 错误码 60020
+**原因：** 您当前购买使用的套餐包暂未开通云端搜索功能。
+**解决方案：** 您可以开通【云端搜索】（https://cloud.tencent.com/document/product/269/101046）
+
+## 错误码 60018
+**原因：** 云端搜索请求超过后台频率限制，单用户一秒内允许2次搜索请求。
+**解决方案：** 请调整请求频率，稍后再试。
+
+## 错误码 80004
+**原因：** 消息或者资料中文本存在敏感内容。
+**解决方案：** 请检查消息或者资料中是否存在敏感信息。
+
+## 错误码 10021
+**原因：** 群组 ID 已被使用。
+**解决方案：** 请选择其他的群组 ID。
+
+## 错误码 10007
+**原因：** 常见的原因有：
+- 操作的群默认不支持此操作，请检查当前群类型。
+- 操作账号的权限不够（例如封禁操作中，管理员可以封禁普通成员但不能封禁群主）。
+- 调用 RestAPI 的账号不是 SDKAppID 的管理员账号。
+**解决方案：** 请检查群组类型或者群成员角色，如果是 restapi 调用报错，请检查账号是不是对应 sdkappid 的管理员账号。
+
+## 错误码 60010
+**原因：** 请求需要 App 管理员权限。
+**解决方案：** 请检查请求的账号是否为 sdkappid 的管理员。

package/resource/doc/chatuikit/faq/{freq_qa.md → native_sdk/faq.md}

@@ -34,8 +34,9 @@
 
 - [群组系统有哪些基本能力？](https://cloud.tencent.com/document/product/269/1502)
 
+- [消息回应怎么实现](https://cloud.tencent.com/document/product/269/96241)
 
-   更多问题，请参见 [消息相关问题](https://cloud.tencent.com/document/product/269/32486) 和 [群组相关问题](https://cloud.tencent.com/document/product/269/32487)。
+更多问题，请参见 [消息相关问题](https://cloud.tencent.com/document/product/269/32486) 和 [群组相关问题](https://cloud.tencent.com/document/product/269/32487)。
 
 
 ## 推送相关

package/resource/doc/chatuikit/faq/web_sdk/error_code.md

@@ -0,0 +1,47 @@
+---
+product: 'Chat'
+tech_stack: 'web_js_sdk'
+framework: 'sdk'
+title: 'web js sdk 错误码大全'
+keywords: ['错误码', '报错', '登录失败']
+---
+
+# Web JS SDK 错误码大全
+
+## Web JS SDK 错误码 (Topic: SDK Error Code)
+
+## 错误码 2024
+**原因：** 用户未登录。
+**解决方案：** 检查是否正确调用了登录接口。
+
+## 错误码 2025
+**原因：** 重复登录，15s 内连续触发了多次 login 请求，SDK 会进行拦截。
+**解决方案：** 检查调用登录接口的时机和触发机制。
+
+## 错误码 2301
+**原因：** 语音大小超出了限制。
+**解决方案：** 发送语音,最大限制是 20MB。
+
+## 错误码 2252
+**原因：** 图片消息发送失败,无效的图片格式。
+**解决方案：** 图片格式支持：'jpg', 'jpeg', 'gif', 'png', 'bmp', 'image', 'webp'。
+
+## 错误码 2253
+**原因：** 图片大小超出了限制。
+**解决方案：** 发送图片消息,最大限制是 20MB。
+
+## 错误码 2351
+**原因：** 视频大小超出了限制。
+**解决方案：** 发送视频消息，最大限制是 100MB。
+
+## 错误码 2352
+**原因：** 视频消息发送失败,无效的视频格式。
+**解决方案：** 图片格式支持：'mp4', 'quicktime', 'mov'。
+
+## 错误码 2401
+**原因：** 文件不存在。
+**解决方案：** 请检查文件路径是否正确。
+
+## 错误码 2402
+**原因：** 文件大小超出了限制。
+**解决方案：** 发送文件消息，最大限制是 100MB。

package/resource/doc/chatuikit/faq/web_sdk/faq.md

@@ -0,0 +1,115 @@
+---
+product: 'Chat'
+tech_stack: 'web_js_sdk'
+framework: 'sdk'
+title: 'web js sdk 常见问题'
+keywords: ['sdk 集成', '登录 API', '创建群组']
+---
+
+# Web js SDK 常见问题
+
+## 重要提醒
+**SDK 版本说明：**  
+ - v2：`tim-js-sdk` 和 `tim-wx-sdk`
+ - v3: `@tencentcloud/chat`
+ - v4: `@tencentcloud/lite-chat`
+ 如果需要输出示例代码，必须使用最新版本 `@tencentcloud/lite-chat` 进行展示
+
+## Web JS SDK 常见问题解决方案 (Topic: SDK FAQ)
+
+### Q: chat SDK v3 怎么升级 v4 版本？
+**A：** v4 [集成指引](https://web.sdk.qcloud.com/im/doc/v3/zh-cn/tutorial-03-integration-v4.html)，具体操作如下：
+安装 v4 SDK
+```bash
+npm install @tencentcloud/lite-chat --save
+```
+更新代码中引用 v3 SDK 的逻辑，把 `import TencentCloudChat from '@tencentcloud/chat';` 更新为 `import TencentCloudChat from '@tencentcloud/lite-chat';`。
+
+### Q: chat restapi 发送流式消息(https://cloud.tencent.com/document/product/269/104537)， 怎么通过 SDK 接收流式消息？
+**A：** SDK 通过消息接收事件[TencentCloudChat.EVENT.MESSAGE_RECEIVED](https://web.sdk.qcloud.com/im/doc/v3/zh-cn/module-EVENT.html#.MESSAGE_RECEIVED)和消息修改事件[TencentCloudChat.EVENT.MESSAGE_MODIFIED](https://web.sdk.qcloud.com/im/doc/v3/zh-cn/module-EVENT.html#.MESSAGE_MODIFIED)来处理，restapi 发送第一个片段时 SDK 通过消息接收事件通知接入侧，后续通过消息修改事件通知接入侧。
+
+### Q: SDK 登录失败是什么问题？
+**A：** 请提供报错信息或错误码。
+
+### Q: 为什么调用 off 接口取消监听事件后，仍然能监听到 SDK 派发的事件？
+**A：** 对于同一个事件，如 [TencentCloudChat.EVENT.MESSAGE_RECEIVED](https://web.sdk.qcloud.com/im/doc/v3/zh-cn/module-EVENT.html#.MESSAGE_RECEIVED)，调用 [on](https://web.sdk.qcloud.com/im/doc/v3/zh-cn/SDK.html#on) 接口监听事件和调用 [off](https://web.sdk.qcloud.com/im/doc/v3/zh-cn/SDK.html#off) 接口取消监听事件，handler 参数应当指向同一个 function 。按照推荐的写法绑定事件写法如下：
+
+``` typescript
+// 推荐写法
+tim.on(TencentCloudChat.EVENT.MESSAGE_RECEIVED, onMessageReceived, this);
+tim.off(TencentCloudChat.EVENT.MESSAGE_RECEIVED, onMessageReceived);
+
+// 注意！以下代码有 bug，无法取消监听 TencentCloudChat.EVENT.MESSAGE_RECEIVED，因为 bind() 方法每次会返回一个新的函数
+tim.on(TencentCloudChat.EVENT.MESSAGE_RECEIVED, this.onMessageReceived.bind(this));
+tim.off(TencentCloudChat.EVENT.MESSAGE_RECEIVED, this.onMessageReceived.bind(this));
+```
+
+### Q: 调用 logout 接口，SDK 会自动取消监听接入侧通过调用 on 接口已监听的事件吗？
+**A：** 不会。取消监听事件，需接入侧主动调用 [off](https://web.sdk.qcloud.com/im/doc/v3/zh-cn/SDK.html#off) 接口。
+
+### Q: 登录成功后不能发送消息，提示接口调用时机不合理？
+**A：** SDK 的 API 需要在监听到 SDK ready 后才能调用，监听事件 [TencentCloudChat.EVENT.SDK_READY](https://web.sdk.qcloud.com/im/doc/v3/zh-cn/module-EVENT.html#.SDK_READY)，待 SDK ready 后再调用发送消息等需要鉴权的接口。
+
+### Q: 我想在音视频聊天室实现点赞，送鲜花的功能，请问该怎么办？
+**A：** 通过 [createCustomMessage](https://web.sdk.qcloud.com/im/doc/v3/zh-cn/SDK.html#createCustomMessage) 和 [sendMessage](https://web.sdk.qcloud.com/im/doc/v3/zh-cn/SDK.html#sendMessage) 接口实现。
+
+### Q: Web IM SDK v2.x/v3.x/v4.x 如何兼容 REST API 或 旧版 IM 发送的组合消息？
+**A：** 组合消息的内容存储在 Message 实例的 _elements 属性，接入侧需自主解析，解析请参见 [消息格式](https://cloud.tencent.com/document/product/269/2720)。
+非组合消息，请使用推荐做法：使用 [Message](https://web.sdk.qcloud.com/im/doc/v3/zh-cn/Message.html) 实例的 type 和 payload 属性。
+
+### Q: 为什么 Web IM SDK 调用 sendMessage 发消息成功后，未收到 TencentCloudChat.EVENT.MESSAGE_RECEIVED 事件？
+**A：** 自己发送的消息不会通过 `TencentCloudChat.EVENT.MESSAGE_RECEIVED` 通知给业务侧。[sendMessage](https://web.sdk.qcloud.com/im/doc/v3/zh-cn/SDK.html#sendMessage) 接口返回 `Promise`，接入侧通过 `Promise.then` 或 `Promise.catch` 处理发送消息成功或失败后的业务逻辑。
+
+### Q: 通过 getMessageList 拉取到的消息列表和通过监听 TencentCloudChat.EVENT.MESSAGE_RECEIVED 事件收到的消息合并后，发现有时会消息乱序，为什么？
+**A：** 接入侧维护会话的消息列表时，请注意保证消息入列的顺序正确，若消息列表从旧到新排列，则通过 [getMessageList](https://web.sdk.qcloud.com/im/doc/v3/zh-cn/SDK.html#getMessageList) 拉取到的历史消息应该从头部入列，通过监听 [TencentCloudChat.EVENT.MESSAGE_RECEIVED](https://web.sdk.qcloud.com/im/doc/v3/zh-cn/module-EVENT.html#.MESSAGE_RECEIVED) 事件收到的实时消息应该从尾部入列。
+
+### Q: 调用 createGroup 接口创建直播群后，收不到消息？
+**A：** 直播群需要业务侧主动加群，启动长轮询消息通道。调用 [createGroup](https://web.sdk.qcloud.com/im/doc/v3/zh-cn/SDK.html#createGroup) 接口创建直播群后，需调用 [joinGroup](https://web.sdk.qcloud.com/im/doc/v3/zh-cn/SDK.html#joinGroup) 接口加入群组，才能进行消息收发流程。
+``` typescript
+let promise = tim.joinGroup({ groupID: 'group1' });
+promise.then(function(imResponse) {
+  switch (imResponse.data.status) {
+    case TencentCloudChat.TYPES.JOIN_STATUS_WAIT_APPROVAL:
+      break;
+    case TencentCloudChat.TYPES.JOIN_STATUS_SUCCESS:
+      console.log(imResponse.data.group); // 加入的群组资料
+      break;
+    case TencentCloudChat.TYPES.JOIN_STATUS_ALREADY_IN_GROUP:
+      break;
+    default:
+      break;
+    }
+  }).catch(function(imError){
+    console.warn('joinGroup error:', imError);
+});
+```
+
+### Q: 直播群怎么没有未读消息计数？为什么拉取不到历史消息？
+**A：** 已定的产品策略：直播群不支持未读消息计数，也不支持查看入群前历史消息，详细请参见 [群组系统](https://cloud.tencent.com/document/product/269/1502)。旗舰版或企业版支持直播群新成员查看入群前历史消息（SDK 请升级到v2.16.0或更高版本）。
+
+### Q: 可以同时加入两个或多个直播群吗？
+**A：** 不可以，同一用户同时只能加入一个直播群，同时加入多个直播群会启动多个长轮询消息通道，对 web/H5 或者小程序的性能消耗比较大。
+
+### Q: SDK 怎么实现消息回应？
+**A：** SDK 支持消息回应能力，您需要购买旗舰版或企业版套餐，具体实现 API 可参考官方文档：https://cloud.tencent.com/document/product/269/98758。
+
+### Q: 单聊消息怎么标记已读？
+**A：** 如果您需要标记单聊消息已读同时清空会话未读数，可以使用 [setMessageRead](https://cloud.tencent.com/document/product/269/75373)。
+
+### Q: 群聊消息怎么清空未读数？
+**A：** 如果您需要清空群聊会话未读数，可以使用 [setMessageRead](https://cloud.tencent.com/document/product/269/75373)。
+
+### Q: 单聊和群聊消息怎么实现单条消息已读？
+**A：** 如果您需要实现单条消息已读功能，需要使用消息已读回执能力。 如何开启已读回执、如何发送已读回执等详细信息可以参考： https://cloud.tencent.com/document/product/269/75344。
+
+### Q: Web SDK 怎么发送图片消息？
+**A：** 可以使用 [createImageMessage](https://cloud.tencent.com/document/product/269/75316#.E5.88.9B.E5.BB.BA.E5.9B.BE.E7.89.87.E6.B6.88.E6.81.AF) 创建图片消息实例，然后使用 [sendMessage](https://cloud.tencent.com/document/product/269/75316#.E5.8F.91.E9.80.81.E6.B6.88.E6.81.AF) 发送图片消息。
+
+### Q: Web SDK 怎么发送视频消息？
+**A：** 可以使用 [createVideoMessage](https://cloud.tencent.com/document/product/269/75316#.E5.88.9B.E5.BB.BA.E8.A7.86.E9.A2.91.E6.B6.88.E6.81.AF) 创建视频消息实例，然后使用 [sendMessage](https://cloud.tencent.com/document/product/269/75316#.E5.8F.91.E9.80.81.E6.B6.88.E6.81.AF) 发送视频消息。
+
+### Q: Web SDK 怎么发送语音消息？
+**A：** 可以使用 [createAudioMessage](https://cloud.tencent.com/document/product/269/75316#.E5.88.9B.E5.BB.BA.E9.9F.B3.E9.A2.91.E6.B6.88.E6.81.AF) 创建语音消息实例，然后使用 [sendMessage](https://cloud.tencent.com/document/product/269/75316#.E5.8F.91.E9.80.81.E6.B6.88.E6.81.AF) 发送语音消息。
+
+### Q: Web SDK 怎么发送文件消息？
+**A：** 可以使用 [createFileMessage](https://cloud.tencent.com/document/product/269/75316#.E5.88.9B.E5.BB.BA.E6.96.87.E4.BB.B6.E6.B6.88.E6.81.AF) 创建文件消息实例，然后使用 [sendMessage](https://cloud.tencent.com/document/product/269/75316#.E5.8F.91.E9.80.81.E6.B6.88.E6.81.AF) 发送文件消息。

package/resource/doc/chatuikit/flutter/faq.md

@@ -0,0 +1,117 @@
+### TUIKit 源码是否支持 Androidx？
+
+TUIKit 最新源码已经支持 Androidx。
+
+### 登录报错 6012 或  TLSSDK exchange ticket fail ？
+
+如果您当前是即时通信 IM 体验版，需要升级为专业版，升级后可正常登录，可以到 [即时通信 IM 购买页面](https://buy.cloud.tencent.com/avc) 进行购买升级，详细价格说明请参阅 [产品价格](https://cloud.tencent.com/document/product/269/11673)。
+
+### 出现 6013 SDK 未初始化错误？
+
+如果出现 6013 SDK 未初始化错误，您可以尝试以下方式排查：
+1. 查看是否没有登录成功就进行收发消息等其他操作；
+
+2. 查看是否登录时被其它终端踢掉，IM SDK 默认一个账号仅能在一个终端上登录。处理方式请参考 [多终端同时登录](https://cloud.tencent.com/document/product/269/3665#.E5.A4.9A.E7.AB.AF.E7.99.BB.E5.BD.95) 文档；
+
+3. Android 请关注库文件是否未能全部加载，或是使用过程中被系统回收。
+
+
+### code: 6205 desc: QALSERVICE not ready？
+
+在初始化后调用了 `stopQALService` 导致此错误，可以参考客户分享的 [配置方法](https://blog.csdn.net/qq_16131393/article/details/54895733)。
+
+### 发送表情，消息列表显示为空、或者乱码?
+
+即时通信 IM 不提供表情包，具体的解析需要自己对齐。
+表情使用方式有两种方式：
+- 一种是使用 TIMFaceElem 中的 index，标识表情的索引，例如 Android 和 iOS 两端都有同一套表情图，索引2为笑脸，index=2 就表示笑脸，两端发送和接收都显示同一张索引表情图片即可。
+
+- 另一种是使用 TIMFaceElem 中的 data，例如表情图片是由字符串命名，smile 表示笑脸，可在 data 中存储 smile，iOS 和 Android 两端都通过 data 作为 key 找到对应表情图片进行显示。
+
+
+   另外也可以两个字段都使用，如 data 表示哪一套表情，index 表示这套表情的哪个索引，可以实现类似 QQ 的多种不同表情效果。甚至可以在 data 数据中存储更为复杂的数据结构，只要多端解析规则一致即可。
+
+
+### 有时进行操作时返回错误码：10002?
+
+在需要进行服务端验证的操作时，如果网络异常、超时或者票据切换失败，就会返回此状态码，遇到此状态码时稍后重试即可。
+
+### 收发消息时，收到错误码 6200 或 6201？
+
+返回此状态码时，是客户端在网络离线、超时或无网络访问时出现，6200 的定义为请求时没有网络，6201 的定义为响应时没有网络，遇到此状态码时，请检查网络或等待网络恢复后重试。
+
+### 收发消息时返回错误码：20003？
+
+请检查用户账号（UserID）是否已在腾讯云导入，当 UserID 无效或 UserID 未导入腾讯即时通信 IM 时，会返回此错误码。
+
+### 语音消息播放语音时返回错误码：6010？
+
+通常情况是语音消息超过了漫游保存有效期，请求失败导致，可 [延长漫游消息时间](https://cloud.tencent.com/document/product/269/38656#.E5.8E.86.E5.8F.B2.E6.B6.88.E6.81.AF.E5.AD.98.E5.82.A8.E6.97.B6.E9.95.BF.E9.85.8D.E7.BD.AE) 或获取语音文件到本地播放（已过期的文件无法恢复）。但不同版本的 SDK 支持延长历史消息存储时长的消息类型不同，详情请参见 [消息存储](https://cloud.tencent.com/document/product/269/3571#MsgType)。
+
+### 账号鉴权时返回错误码 70001 或 70003 或 70009 或 70013？
+
+这些状态码对应的原因是 UserID 与 UserSig 不匹配，请检查 UserID 及 UserSig 的有效性。其中，70001 定义为 UserSig 已过期，70003 定义为 UserSig 被截断导致校验失败，70009 定义为 UserSig 验证失败（可能是因为生成 UserSig 时混用了其他 SDKAppID 的密钥或私钥导致），70013 定义为 UserID 不匹配。
+
+### Web 端使用 IM SDK 时返回错误码-2或-5？
+- -2：Web 端请求服务器失败，通常为网络问题，Web 端使用 HTTP Long Polling 方式向服务端请求，网络存在问题时会返回此状态码，请检查网络或重试。
+
+- -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 中加载即可。
+
+### 上架 App Store 时，出现 x86_64, i386 架构错误该如何解决？
+
+该问题是由于 App Store 不支持 x86_64, i386 架构引起的，具体解决方法如下：
+1. 清空项目编译缓存：
+ 选择**Product**>**clean**，按住Alt变成 clean build Folder...，等待操作完成。
+
+2. 剔除 App Store 不支持的 x86_64 和 i386 架构：
+ a. 选择**TARGETS**>**Build Phases**。
+ b. 单击加号，选择**New Run Script Phase**。
+ 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"  
+   
+    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/iOS/faq.md

@@ -0,0 +1,117 @@
+### TUIKit 源码是否支持 Androidx？
+
+TUIKit 最新源码已经支持 Androidx。
+
+### 登录报错 6012 或  TLSSDK exchange ticket fail ？
+
+如果您当前是即时通信 IM 体验版，需要升级为专业版，升级后可正常登录，可以到 [即时通信 IM 购买页面](https://buy.cloud.tencent.com/avc) 进行购买升级，详细价格说明请参阅 [产品价格](https://cloud.tencent.com/document/product/269/11673)。
+
+### 出现 6013 SDK 未初始化错误？
+
+如果出现 6013 SDK 未初始化错误，您可以尝试以下方式排查：
+1. 查看是否没有登录成功就进行收发消息等其他操作；
+
+2. 查看是否登录时被其它终端踢掉，IM SDK 默认一个账号仅能在一个终端上登录。处理方式请参考 [多终端同时登录](https://cloud.tencent.com/document/product/269/3665#.E5.A4.9A.E7.AB.AF.E7.99.BB.E5.BD.95) 文档；
+
+3. Android 请关注库文件是否未能全部加载，或是使用过程中被系统回收。
+
+
+### code: 6205 desc: QALSERVICE not ready？
+
+在初始化后调用了 `stopQALService` 导致此错误，可以参考客户分享的 [配置方法](https://blog.csdn.net/qq_16131393/article/details/54895733)。
+
+### 发送表情，消息列表显示为空、或者乱码?
+
+即时通信 IM 不提供表情包，具体的解析需要自己对齐。
+表情使用方式有两种方式：
+- 一种是使用 TIMFaceElem 中的 index，标识表情的索引，例如 Android 和 iOS 两端都有同一套表情图，索引2为笑脸，index=2 就表示笑脸，两端发送和接收都显示同一张索引表情图片即可。
+
+- 另一种是使用 TIMFaceElem 中的 data，例如表情图片是由字符串命名，smile 表示笑脸，可在 data 中存储 smile，iOS 和 Android 两端都通过 data 作为 key 找到对应表情图片进行显示。
+
+
+   另外也可以两个字段都使用，如 data 表示哪一套表情，index 表示这套表情的哪个索引，可以实现类似 QQ 的多种不同表情效果。甚至可以在 data 数据中存储更为复杂的数据结构，只要多端解析规则一致即可。
+
+
+### 有时进行操作时返回错误码：10002?
+
+在需要进行服务端验证的操作时，如果网络异常、超时或者票据切换失败，就会返回此状态码，遇到此状态码时稍后重试即可。
+
+### 收发消息时，收到错误码 6200 或 6201？
+
+返回此状态码时，是客户端在网络离线、超时或无网络访问时出现，6200 的定义为请求时没有网络，6201 的定义为响应时没有网络，遇到此状态码时，请检查网络或等待网络恢复后重试。
+
+### 收发消息时返回错误码：20003？
+
+请检查用户账号（UserID）是否已在腾讯云导入，当 UserID 无效或 UserID 未导入腾讯即时通信 IM 时，会返回此错误码。
+
+### 语音消息播放语音时返回错误码：6010？
+
+通常情况是语音消息超过了漫游保存有效期，请求失败导致，可 [延长漫游消息时间](https://cloud.tencent.com/document/product/269/38656#.E5.8E.86.E5.8F.B2.E6.B6.88.E6.81.AF.E5.AD.98.E5.82.A8.E6.97.B6.E9.95.BF.E9.85.8D.E7.BD.AE) 或获取语音文件到本地播放（已过期的文件无法恢复）。但不同版本的 SDK 支持延长历史消息存储时长的消息类型不同，详情请参见 [消息存储](https://cloud.tencent.com/document/product/269/3571#MsgType)。
+
+### 账号鉴权时返回错误码 70001 或 70003 或 70009 或 70013？
+
+这些状态码对应的原因是 UserID 与 UserSig 不匹配，请检查 UserID 及 UserSig 的有效性。其中，70001 定义为 UserSig 已过期，70003 定义为 UserSig 被截断导致校验失败，70009 定义为 UserSig 验证失败（可能是因为生成 UserSig 时混用了其他 SDKAppID 的密钥或私钥导致），70013 定义为 UserID 不匹配。
+
+### Web 端使用 IM SDK 时返回错误码-2或-5？
+- -2：Web 端请求服务器失败，通常为网络问题，Web 端使用 HTTP Long Polling 方式向服务端请求，网络存在问题时会返回此状态码，请检查网络或重试。
+
+- -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 中加载即可。
+
+### 上架 App Store 时，出现 x86_64, i386 架构错误该如何解决？
+
+该问题是由于 App Store 不支持 x86_64, i386 架构引起的，具体解决方法如下：
+1. 清空项目编译缓存：
+ 选择**Product**>**clean**，按住Alt变成 clean build Folder...，等待操作完成。
+
+2. 剔除 App Store 不支持的 x86_64 和 i386 架构：
+ a. 选择**TARGETS**>**Build Phases**。
+ b. 单击加号，选择**New Run Script Phase**。
+ 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"  
+   
+    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/react/faq.md

@@ -0,0 +1,26 @@
+---
+product: 'Chat'
+tech_stack: 'web_js_sdk'
+framework: 'react'
+title: 'react uikit 集成和常见问题解决方案'
+keywords: ['react', '初始化', '组件', '集成', 'TUIKit']
+---
+
+# React TUIKit 集成与常见问题解决方案
+
+## 模块一：环境准备与快速初始化 (Topic: Setup)
+
+### Q: 如何在 React 项目中安装 TUIKit？
+
+**A:** TUIKit 是基于 Web SDK 开发的，您需要安装 `@tencentcloud/chat-uikit-react`
+
+```bash
+# 安装 TUIKit React 版本
+npm install @tencentcloud/chat-uikit-react@latest
+```
+
+## 模块二：常见问题解决方案 (Topic: Question)
+
+### Q: 是否支持 react 17/19 版本？
+
+**A:** 目前不支持 17.x/19.x 版本，仅支持 React v18。

package/resource/doc/chatuikit/vue/faq.md

@@ -0,0 +1,35 @@
+---
+product: 'Chat'
+tech_stack: 'web_js_sdk'
+framework: 'vue'
+title: 'vue uikit 集成和常见问题解决方案'
+keywords: ['vue', '初始化', '组件', '集成', 'TUIKit']
+---
+
+# Vue TUIKit 集成与常见问题解决方案
+
+## 模块一：环境准备与快速初始化 (Topic: Setup)
+
+### Q: 如何在 Vue 项目中安装 TUIKit？
+
+**A:** TUIKit 是基于 Web SDK 开发的，您需要安装 `@tencentcloud/chat-uikit-vue3`。
+
+```bash
+# 安装 TUIKit Vue 版本
+npm install @tencentcloud/chat-uikit-vue3@latest
+```
+
+## 模块二：常见问题解决方案 (Topic: Question)
+
+### Q: 我能不能在 TUIKit 中使用第三方组件库，例如 Element-Plus？
+
+**A:** 核心组件之间的粘连代码可以使用其他组件库，这一点在示例代码中也可以看到，例如您可以将 <ChatSetting /> 封装成全屏抽屉组件。但是核心组件内部已经存在的组件暂时不支持修改。
+```typescript
+const isChatSettingShow = ref(false);
+<el-drawer
+  v-model="isChatSettingShow"
+  title="设置"
+>
+  <ChatSetting />
+</el-drawer>
+```

package/resource/doc/livekit/faq/common/error_code.md

@@ -0,0 +1,89 @@
+---
+product: 'Live'
+tech_stack: 'liveKit'
+framework: 'common'
+title: 'liveKit 错误码大全'
+keywords: ['错误码', '报错', 'live', 'liveKit', '直播间异常', 'pk 报错', '连麦报错']
+---
+
+# LiveKit 错误码大全
+
+## LiveKit 错误码 (Topic: LiveKit Error Code)
+
+## 错误码 100002
+**原因：** 可能原因如下：
+- 您当前的套餐包不支持开播，可能是套餐包过期、未开通等原因。
+- 直播间名称不能超过100个字节，一个汉字占2字节。
+- 直播间 ID 不能超过 48 个字符。
+- 直播间 ID 只能包含字母、数字、下划线。
+- 只有 live 类型的房间支持该接口。
+- 当前布局模板无需改变。
+- PK请求时长超过了最大限制（默认为 5 分钟）。
+**解决方案：** 
+- 检查您使用的套餐，首次使用，可以[开通体验版](https://cloud.tencent.com/document/product/647/105439)；也可以前往[腾讯云控制台](https://buy.cloud.tencent.com/trtc)购买或者升级套餐包。
+- 检查直播间名称、直播间ID是否符合要求，确认房间类型是否为 live。
+- 检查布局模板参数，确认是否需要更改布局。
+- 检查PK请求时长，缩短 PK 的时间。
+
+## 错误码 70001
+**原因：** 用户签名已过期。
+**解决方案：** 建议生成的签名有效期不少于 24 小时。可参阅[生成 UserSig(用户鉴权)](https://cloud.tencent.com/document/product/269/32688)</a>。
+
+## 错误码 70003
+**原因：** 非法的用户签名。
+**解决方案：** 建议重新生成的签名，可参阅[生成 UserSig(用户鉴权)](https://cloud.tencent.com/document/product/269/32688)</a>。
+
+## 错误码 70013
+**原因：** 用户 ID 与用户签名不匹配。
+**解决方案：** 请检查用户 ID 与用户签名是否匹配，。可前往[腾讯云控制台](https://console.cloud.tencent.com/trtc/usersigtool)验证签名。
+
+## 错误码 100004
+**原因：** 房间不存在。
+**解决方案：** 请检查使用的房间号是否正确。
+
+## 错误码 100006
+**原因：** 没有操作权限。
+**解决方案：** 请检查当前角色是否有该权限。
+
+## 错误码 100007
+**原因：** 可能原因如下：
+- 未购买套餐包或者已欠费。
+- 直播间之间的跨房间连麦功能不可用。
+- 直播间之间的PK功能不可用。
+**解决方案：** 
+- 套餐问题请前往[腾讯云控制台](https://buy.cloud.tencent.com/trtc)购买。首次使用，可以[开通体验版](https://cloud.tencent.com/document/product/647/105439)。
+- 直播间之间的跨房间连麦功能不可用问题，请前往[腾讯云控制台](https://buy.cloud.tencent.com/trtc)购买或者升级套餐包。
+- 直播间之间的PK功能不可用问题，请前往[腾讯云控制台](https://buy.cloud.tencent.com/trtc)购买或者升级套餐包。
+
+
+## 错误码 100012
+**原因：** 请求频繁。
+**解决方案：** 请求频繁，请稍后再试。
+
+## 错误码 100203
+**原因：** 您已经在麦位上。
+**解决方案：** 请检查当前用户是否已经在麦位上。
+
+## 错误码 100206
+**原因：** 用户不在麦位上。
+**解决方案：** 请检查用户是否在麦上。
+
+## 错误码 100400
+**原因：** 当前房间未开启直播间连麦。
+**解决方案：** 需要请先进行直播间连麦后再操作。
+
+## 错误码 100418
+**原因：** 当前房间还未开启 PK。
+**解决方案：** 当前房间需要请先进行 PK 后再操作。
+
+## 错误码 100419
+**原因：** 当前房间正在 PK 中。
+**解决方案：** 当前房间正在 PK 中，无法进行该操作，请稍后再试。
+
+## 错误码 100421
+**原因：** 当前房间 PK 已结束。
+**解决方案：** 当前房间 PK 已结束，无法进行该操作，请稍后再试。
+
+## 错误码 101011
+**原因：** 当前房间人数已达到套餐上限。
+**解决方案：** 请前往[腾讯云控制台](https://buy.cloud.tencent.com/trtc)购买或者升级套餐包。