@tencent-rtc/mcp 1.2.6 → 1.2.7

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tencent-rtc/mcp",
-  "version": "1.2.6",
+  "version": "1.2.7",
   "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: 'Server Error Code Reference'
+keywords: ['error code', 'error', 'login failure', '70001']
+---
+
+# Server Error Code Reference
+
+## Server Error Codes (Topic: Server)
+
+## Error Code 70001
+**Cause:** UserSig has expired.
+**Solution:** Please regenerate the UserSig. It is recommended to set the UserSig validity period to no less than 24 hours.
+
+## Error Code 70003
+**Cause:** Invalid UserSig.
+**Solution:** Please regenerate the UserSig. Refer to the official documentation for generation methods: https://trtc.io/document/34385?platform=android&product=chat&menulabel=core%20sdk.
+
+## Error Code 70009
+**Cause:** UserSig verification failed. The UserSig may have been generated using a key or private key from a different SDKAppID.
+**Solution:** Please verify that the requested SDKAppID matches the key or private key used to generate the UserSig.
+
+## Error Code 70013
+**Cause:** The userID in the request does not match the userID used when generating the UserSig.
+**Solution:** Please check if the userID used to login to IM matches the userID used to generate the UserSig.
+
+## Error Code 70014
+**Cause:** The SDKAppID in the request does not match the SDKAppID used when generating the UserSig.
+**Solution:** You can verify the UserSig using the IM Console > Development Tools > UserSig Generation & Verification tool: https://console.trtc.io/usersig.
+
+## Error Code 20003
+**Cause:** Invalid or non-existent userID for message sender or receiver.
+**Solution:** Please confirm that the userID has been logged into IM under your SDKAppID.
+
+## Error Code 20009
+**Cause:** Sender and receiver are not friends, sending is prohibited.
+**Solution:** The sender and receiver are not friends. Sending is prohibited when friend relationship verification is configured for one-to-one messages. To send messages to non-friends, you need to configure this in the console or add them as friends first.
+
+## Error Code 20010
+**Cause:** Sender is not in the receiver's friend list, sending is prohibited.
+**Solution:** When sending one-to-one messages, the sender is not in the receiver's friend list (one-way relationship), sending is prohibited.
+
+## Error Code 3122
+**Cause:** Your current package does not support this feature.
+**Solution:** You can upgrade to the Ultimate Edition package: https://console.trtc.io/subscription/buy/chat?packType=pro.
+
+## Error Code 60020
+**Cause:** Cloud search feature is not enabled for your current package.
+**Solution:** You can enable Cloud Search: https://console.trtc.io/chat/plugin/TUICloudSearch.
+
+## Error Code 60018
+**Cause:** Cloud search request exceeded backend rate limit. Each user is allowed 2 search requests per second.
+**Solution:** Please adjust the request frequency and try again later.
+
+## Error Code 80004
+**Cause:** Sensitive content detected in message or profile text.
+**Solution:** Please check if the message or profile contains sensitive information.
+
+## Error Code 10021
+**Cause:** Group ID is already in use.
+**Solution:** Please choose a different group ID.
+
+## Error Code 10007
+**Cause:** Common reasons include:
+- The group type does not support this operation by default. Please check the current group type.
+- The operation account lacks sufficient permissions (e.g., in mute operations, an admin can mute regular members but not the group owner).
+- The account calling the REST API is not an admin account for the SDKAppID.
+**Solution:** Please check the group type or group member role. If the error occurs when calling REST API, verify that the account is an admin account for the corresponding SDKAppID.
+
+## Error Code 60010
+**Cause:** Request requires App admin privileges.
+**Solution:** Please verify that the requesting account is an admin for the SDKAppID.

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 Error Code Reference'
+keywords: ['error code', 'error', 'login failure']
+---
+
+# Web JS SDK Error Code Reference
+
+## Web JS SDK Error Codes (Topic: SDK Error Code)
+
+## Error Code 2024
+**Cause:** User not logged in.
+**Solution:** Check if the login interface was called correctly.
+
+## Error Code 2025
+**Cause:** Duplicate login. Multiple login requests were triggered within 15 seconds, and the SDK blocked them.
+**Solution:** Check the timing and trigger mechanism of the login interface calls.
+
+## Error Code 2301
+**Cause:** Audio file size exceeds the limit.
+**Solution:** Maximum audio message size is 20MB.
+
+## Error Code 2252
+**Cause:** Image message sending failed due to invalid image format.
+**Solution:** Supported image formats: 'jpg', 'jpeg', 'gif', 'png', 'bmp', 'image', 'webp'.
+
+## Error Code 2253
+**Cause:** Image size exceeds the limit.
+**Solution:** Maximum image message size is 20MB.
+
+## Error Code 2351
+**Cause:** Video size exceeds the limit.
+**Solution:** Maximum video message size is 100MB.
+
+## Error Code 2352
+**Cause:** Video message sending failed due to invalid video format.
+**Solution:** Supported video formats: 'mp4', 'quicktime', 'mov'.
+
+## Error Code 2401
+**Cause:** File does not exist.
+**Solution:** Please check if the file path is correct.
+
+## Error Code 2402
+**Cause:** File size exceeds the limit.
+**Solution:** Maximum file message size is 100MB.

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

@@ -0,0 +1,105 @@
+---
+product: 'Chat'
+tech_stack: 'web_js_sdk'
+framework: 'sdk'
+title: 'Web JS SDK Frequently Asked Questions'
+keywords: ['sdk integration', 'login API', 'create group']
+---
+
+# Web JS SDK FAQ
+
+## Important Notice
+**SDK Version Information:**  
+ - v3: `@tencentcloud/chat`
+ When providing code examples, always use the latest version `@tencentcloud/chat` for demonstration.
+
+## Web JS SDK Frequently Asked Questions (Topic: SDK FAQ)
+
+### Q: How to receive streaming messages sent via Chat REST API (https://trtc.io/document/71131?product=chat&menulabel=core%20sdk&platform=javascript) through the SDK?
+**A:** The SDK handles streaming messages through the message received event [TencentCloudChat.EVENT.MESSAGE_RECEIVED](https://trtc.io/document/47996?product=chat&menulabel=core%20sdk&platform=javascript) and message modified event [TencentCloudChat.EVENT.MESSAGE_MODIFIED](https://trtc.io/document/48005?product=chat&menulabel=core%20sdk&platform=javascript). When REST API sends the first fragment, the SDK notifies the application through the message received event. Subsequent fragments are notified through the message modified event.
+
+### Q: Why does SDK login fail?
+**A:** Please provide the error message or error code.
+
+### Q: Why can I still receive SDK events after calling the off interface to unregister event listeners?
+**A:** For the same event, such as [TencentCloudChat.EVENT.MESSAGE_RECEIVED](https://trtc.io/document/47996?product=chat&menulabel=core%20sdk&platform=javascript), when calling the [on](https://trtc.io/document/47967?platform=javascript&product=chat&menulabel=sdk#d39fb50f-f0f2-4b67-9b15-acd7e8608105) interface to listen for events and the [off](https://trtc.io/document/47967?platform=javascript&product=chat&menulabel=sdk#c4cb09c5-142a-4d8c-8c03-ea7f446aa844) interface to unregister event listeners, the handler parameter should point to the same function. Recommended approach:
+
+```typescript
+// Recommended approach
+tim.on(TencentCloudChat.EVENT.MESSAGE_RECEIVED, onMessageReceived, this);
+tim.off(TencentCloudChat.EVENT.MESSAGE_RECEIVED, onMessageReceived);
+
+// Note: The following code has a bug and cannot unregister TencentCloudChat.EVENT.MESSAGE_RECEIVED because bind() returns a new function each time
+tim.on(TencentCloudChat.EVENT.MESSAGE_RECEIVED, this.onMessageReceived.bind(this));
+tim.off(TencentCloudChat.EVENT.MESSAGE_RECEIVED, this.onMessageReceived.bind(this));
+```
+
+### Q: Does the SDK automatically unregister events that were registered via the on interface when logout is called?
+**A:** No. To unregister event listeners, you must actively call the [off](https://trtc.io/document/47967?platform=javascript&product=chat&menulabel=sdk#c4cb09c5-142a-4d8c-8c03-ea7f446aa844) interface.
+
+### Q: After successful login, I cannot send messages and receive a prompt about improper API call timing?
+**A:** SDK APIs can only be called after the SDK is ready. Listen for the [TencentCloudChat.EVENT.SDK_READY](https://trtc.io/document/47967?product=chat&menulabel=core%20sdk&platform=javascript#b7ca8a5b-e020-4c43-a442-71125e55da2d) event and only call authenticated interfaces like sending messages after the SDK is ready.
+
+### Q: I want to implement like and flower-sending features in an audio-video chatroom. How do I do this?
+**A:** Use the [createCustomMessage](https://trtc.io/document/47993?product=chat&menulabel=core%20sdk&platform=javascript#creating-a-custom-message) and [sendMessage](https://trtc.io/document/47993?product=chat&menulabel=core%20sdk&platform=javascript#sending-a-message) interfaces to implement this.
+
+### Q: How does Web IM SDK v2.x/v3.x/v4.x handle combined messages sent via REST API or legacy IM?
+**A:** The content of combined messages is stored in the _elements property of the Message instance. You need to parse it yourself. Refer to [Message Format](https://trtc.io/document/47990?product=chat&menulabel=core%20sdk&platform=javascript) for parsing.
+For non-combined messages, use the recommended approach: use the type and payload properties of the [Message](https://trtc.io/document/47990?product=chat&menulabel=core%20sdk&platform=javascript) instance.
+
+### Q: Why don't I receive the TencentCloudChat.EVENT.MESSAGE_RECEIVED event after successfully sending a message via Web IM SDK's sendMessage?
+**A:** Messages sent by yourself are not notified to the application through `TencentCloudChat.EVENT.MESSAGE_RECEIVED`. The [sendMessage](https://trtc.io/document/47993?product=chat&menulabel=core%20sdk&platform=javascript#sending-a-message) interface returns a `Promise`. Handle success or failure business logic through `Promise.then` or `Promise.catch`.
+
+### Q: After merging messages retrieved via getMessageList with messages received through TencentCloudChat.EVENT.MESSAGE_RECEIVED event listener, I sometimes notice messages are out of order. Why?
+**A:** When maintaining the conversation message list, ensure messages are enqueued in the correct order. If the message list is sorted from oldest to newest, historical messages retrieved via [getMessageList](https://trtc.io/document/47999?product=chat&menulabel=core%20sdk&platform=javascript) should be added to the head of the list, while real-time messages received via [TencentCloudChat.EVENT.MESSAGE_RECEIVED](https://trtc.io/document/47996?product=chat&menulabel=core%20sdk&platform=javascript) should be added to the tail.
+
+### Q: After creating a live streaming group via the createGroup interface, I cannot receive messages?
+**A:** For live streaming groups, you need to actively join the group to start the long-polling message channel. After creating a live streaming group using the [createGroup](https://trtc.io/document/48465?product=chat&menulabel=core%20sdk&platform=javascript#creating-a-group) interface, you must call the [joinGroup](https://trtc.io/document/48465?product=chat&menulabel=core%20sdk&platform=javascript#joining-a-group) interface to join the group before you can send and receive messages.
+```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); // Joined group profile
+      break;
+    case TencentCloudChat.TYPES.JOIN_STATUS_ALREADY_IN_GROUP:
+      break;
+    default:
+      break;
+    }
+  }).catch(function(imError){
+    console.warn('joinGroup error:', imError);
+});
+```
+
+### Q: Why don't live streaming groups have unread message counts? Why can't I retrieve message history?
+**A:** By design: live streaming groups do not support unread message counts, and new members cannot view message history before joining. See [Group System](https://trtc.io/document/33529?product=chat&menulabel=core%20sdk&platform=javascript) for details. Ultimate or Enterprise editions support new members viewing message history before joining live streaming groups (SDK v2.16.0 or higher required).
+
+### Q: Can I join two or more live streaming groups simultaneously?
+**A:** No, a user can only join one live streaming group at a time. Joining multiple live streaming groups simultaneously would start multiple long-polling message channels, which can significantly impact web/H5 or mini-program performance.
+
+### Q: How does the SDK implement message reactions?
+**A:** The SDK supports message reaction capability. You need to purchase the Ultimate or Enterprise edition package. For API implementation, refer to the official documentation: https://trtc.io/document/60749?product=chat&menulabel=core%20sdk&platform=javascript.
+
+### Q: How to mark one-to-one messages as read?
+**A:** To mark one-to-one messages as read and clear the conversation unread count, use [setMessageRead](https://trtc.io/document/48319?product=chat&menulabel=core%20sdk&platform=javascript#clearing-the-conversation-unread-count).
+
+### Q: How to clear unread count for group messages?
+**A:** To clear the unread count for group conversations, use [setMessageRead](https://trtc.io/document/48319?product=chat&menulabel=core%20sdk&platform=javascript#clearing-the-conversation-unread-count).
+
+### Q: How to implement single message read status for one-to-one and group messages?
+**A:** To implement single message read status, use the message read receipt feature. For details on how to enable read receipts, send read receipts, etc., refer to: https://trtc.io/document/48021?product=chat&menulabel=core%20sdk&platform=javascript.
+
+### Q: How to send image messages with Web SDK?
+**A:** Use [createImageMessage](https://trtc.io/document/47993?product=chat&menulabel=core%20sdk&platform=javascript#creating-an-image-message) to create an image message instance, then use [sendMessage](https://trtc.io/document/47993?product=chat&menulabel=core%20sdk&platform=javascript#sending-a-message) to send the image message.
+
+### Q: How to send video messages with Web SDK?
+**A:** Use [createVideoMessage](https://trtc.io/document/47993?product=chat&menulabel=core%20sdk&platform=javascript#creating-a-video-message) to create a video message instance, then use [sendMessage](https://trtc.io/document/47993?product=chat&menulabel=core%20sdk&platform=javascript#sending-a-message) to send the video message.
+
+### Q: How to send audio messages with Web SDK?
+**A:** Use [createAudioMessage](https://trtc.io/document/47993?product=chat&menulabel=core%20sdk&platform=javascript#creating-an-audio-message) to create an audio message instance, then use [sendMessage](https://trtc.io/document/47993?product=chat&menulabel=core%20sdk&platform=javascript#sending-a-message) to send the audio message.
+
+### Q: How to send file messages with Web SDK?
+**A:** Use [createFileMessage](https://trtc.io/document/47993?product=chat&menulabel=core%20sdk&platform=javascript#creating-a-file-message) to create a file message instance, then use [sendMessage](https://trtc.io/document/47993?product=chat&menulabel=core%20sdk&platform=javascript#sending-a-message) to send the file message.

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

@@ -0,0 +1,120 @@
+### Does TUIKit source code support Androidx?
+
+Yes.
+
+### Why do I encounter a 6012 error or "TLSSDK exchange ticket fail" upon login?
+- The initialization API and the login API must be called separately and cannot be called successively because there are asynchronous operations in the initialization method.
+
+- If you are using Chat Free edition and upgrade to Chat Pro Edition, after the upgrade, you can configure your SDKAppID in the console to ensure proper login. For pricing details, see [Pricing](https://intl.cloud.tencent.com/document/product/1047/34350).
+
+
+### Why do I encounter a 6013 "SDK Not Initialized" error?
+
+If the 6013 "SDK Not Initialized" error occurs, try the following troubleshooting methods:
+1. Check whether you performed other operations such as receiving and sending messages before logging in successfully.
+
+2. Check whether you were forced offline when logging in by an account already logged in on another device. By default, the Chat SDK allows one account to log in on one device at a time. For more information, see [Multi-Device Login](https://intl.cloud.tencent.com/document/product/1047/33518).
+
+3. For Android, verify that all library files have been loaded or repossessed by the system during use.
+
+
+### Why do I encounter "code: 6205 desc: QALSERVICE not ready" error?
+
+This error is caused by calling `stopQALService` after initialization. To fix it, refer to the [configuration method](https://blog.csdn.net/qq_16131393/article/details/54895733) shared by one of our customers.
+
+### Why do not emojis appear or appear as gibberish in messages?
+
+Chat does not provide emoji packs. You must align the actual parsing by yourself.
+
+There are two ways to use emojis:
+- Use index in TIMFaceElem to identify the index of the emojis. For example, an Android device and an iOS device have the same set of emojis and index 2 represents the smile emoji. When index=2, both devices send and receive the same indexed emoji.
+
+- Use data in TIMFaceElem. For example, the names of emoji images are string-type. Use the word "smile" to represent the smile emoji, and store "smile" in data. Then, both iOS and Android devices use data as the key to retrieve and display the corresponding emoji.
+
+
+   You can also use the two fields at the same time. For example, use data to specify the emoji set and index to indicate the specific index in this emoji set. This way, you can implement many different emoji effects as in QQ. It is possible to store more complex data structures in data as long as the devices follow the same parsing rules.
+
+
+### Why do I encounter error 10002 during operations?
+
+This status code is returned when a network exception, timeout, or ticket switching failure occurs during server-side authentication. If you see this status code, wait a moment and try again.
+
+### Why do I encounter error 6200 or 6201 when receiving or sending messages?
+
+This status code is returned when the client is offline, times out, or is disconnected. Error 6200 is defined as no network connection during request sending, whereas error 6201 is defined as no network connection during response sending. When you encounter this status code, check the network condition or wait for the network to restore and try again.
+
+### Why do I encounter error 20003 when receiving and sending messages?
+
+This error code is returned when UserID is invalid or UserID has not been imported to Chat. To fix it, check whether UserID has been imported to Tencent Cloud.
+
+### Why do I encounter error 6010 when playing audio messages?
+
+This error code is returned when audio messages that are no longer retained by the roaming server are requested. To fix it, you can [increase the message roaming duration](https://intl.cloud.tencent.com/document/product/1047/34419) or download audio files to local storage and play them. However, expired files cannot be restored. Different SDK versions allow you to increase the retention duration for different message types. For more information, see [Message Storage](https://intl.cloud.tencent.com/document/product/1047/33524).
+
+### Why do I encounter errors 70001, 70003, 70009, and 70013 during account authentication?
+
+These errors occur because UserID and UserSig do not match. To fix it, check the validity of UserID and UserSig. Among them, error 70001 means UserSig has expired, error 70003 means a verification failure due to a truncated UserSig, error 70009 means UserSig verification failed (possibly due to mixing the keys or private keys of other SDKAppIDs when generating UserSig), and error 70013 means UserID does not match.
+
+### Why do I encounter the error code -2 or -5 when the web client app is using the Chat SDK?
+- -2: Indicates that a web app request to the server failed, usually due to network problems. Web apps send requests to the server by using the HTTP Long Polling method, and this status code is returned when a network problem occurs. To fix it, check your network or try again.
+
+- -5: When the login attempt is not completed and the SDK has not received the a2key and tinyID returned by the server, directly calling other APIs returns the "tinyid or a2 is empty" error message and -5 error code.
+
+
+### What should I do when the SDK on the armeabi platform reports "java.lang.UnsatisfiedLinkError: No implementation found for"?
+
+Copy jni/armeabi-v7a/libImSDK.so in the Chat SDK’s aar file to the src/main/jniLibs/armeabi directory in your source code project and load it in build.gradle.
+
+### How can I resolve x86_64 and i386 architecture errors when the app has been launched in App Store?
+
+This error occurs because App Store does not support the x86_64 and i386 architecture. The solution is as follows:
+1. Clear the project compilation cache:
+ Select **Product** > **clean**, press Alt until "clean build Folder..." appears and wait for the operation to complete.
+
+2. Remove the x86_64 and i386 architecture not supported by App Store:
+ a. Select **TARGETS** > **Build Phases**.
+ b. Click the plus sign and select **New Run Script Phase**.
+ c. Add the following code:
+
+   ``` 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/100031390357/ac95ba51e28011eeb1eb525400b5f95f.png)
+
+3. Package the app and upload it again.
+
+
+### Can developers directly utilize the emoticon packs demonstrated in the Chat various client demos/TUIKit projects?
+
+To respect the copyright of emoji designs, the Chat Demo/TUIKit project does not include cutouts of large emoji elements. Please replace them with your own designs or other emoji packs for which you hold the copyright before officially launching for commercial use. **The default smiley face emoji pack shown below is copyrighted by Tencent RTC** and is available for licensed use for a fee. If you need to obtain a license, please [contact us](https://trtc.io/contact).
+
+![](https://write-document-release-1258344699.cos.ap-guangzhou.tencentcos.cn/100027202808/a44543c197f611ef820f525400d5f8ef.png)

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

@@ -0,0 +1,120 @@
+### Does TUIKit source code support Androidx?
+
+Yes.
+
+### Why do I encounter a 6012 error or "TLSSDK exchange ticket fail" upon login?
+- The initialization API and the login API must be called separately and cannot be called successively because there are asynchronous operations in the initialization method.
+
+- If you are using Chat Free edition and upgrade to Chat Pro Edition, after the upgrade, you can configure your SDKAppID in the console to ensure proper login. For pricing details, see [Pricing](https://intl.cloud.tencent.com/document/product/1047/34350).
+
+
+### Why do I encounter a 6013 "SDK Not Initialized" error?
+
+If the 6013 "SDK Not Initialized" error occurs, try the following troubleshooting methods:
+1. Check whether you performed other operations such as receiving and sending messages before logging in successfully.
+
+2. Check whether you were forced offline when logging in by an account already logged in on another device. By default, the Chat SDK allows one account to log in on one device at a time. For more information, see [Multi-Device Login](https://intl.cloud.tencent.com/document/product/1047/33518).
+
+3. For Android, verify that all library files have been loaded or repossessed by the system during use.
+
+
+### Why do I encounter "code: 6205 desc: QALSERVICE not ready" error?
+
+This error is caused by calling `stopQALService` after initialization. To fix it, refer to the [configuration method](https://blog.csdn.net/qq_16131393/article/details/54895733) shared by one of our customers.
+
+### Why do not emojis appear or appear as gibberish in messages?
+
+Chat does not provide emoji packs. You must align the actual parsing by yourself.
+
+There are two ways to use emojis:
+- Use index in TIMFaceElem to identify the index of the emojis. For example, an Android device and an iOS device have the same set of emojis and index 2 represents the smile emoji. When index=2, both devices send and receive the same indexed emoji.
+
+- Use data in TIMFaceElem. For example, the names of emoji images are string-type. Use the word "smile" to represent the smile emoji, and store "smile" in data. Then, both iOS and Android devices use data as the key to retrieve and display the corresponding emoji.
+
+
+   You can also use the two fields at the same time. For example, use data to specify the emoji set and index to indicate the specific index in this emoji set. This way, you can implement many different emoji effects as in QQ. It is possible to store more complex data structures in data as long as the devices follow the same parsing rules.
+
+
+### Why do I encounter error 10002 during operations?
+
+This status code is returned when a network exception, timeout, or ticket switching failure occurs during server-side authentication. If you see this status code, wait a moment and try again.
+
+### Why do I encounter error 6200 or 6201 when receiving or sending messages?
+
+This status code is returned when the client is offline, times out, or is disconnected. Error 6200 is defined as no network connection during request sending, whereas error 6201 is defined as no network connection during response sending. When you encounter this status code, check the network condition or wait for the network to restore and try again.
+
+### Why do I encounter error 20003 when receiving and sending messages?
+
+This error code is returned when UserID is invalid or UserID has not been imported to Chat. To fix it, check whether UserID has been imported to Tencent Cloud.
+
+### Why do I encounter error 6010 when playing audio messages?
+
+This error code is returned when audio messages that are no longer retained by the roaming server are requested. To fix it, you can [increase the message roaming duration](https://intl.cloud.tencent.com/document/product/1047/34419) or download audio files to local storage and play them. However, expired files cannot be restored. Different SDK versions allow you to increase the retention duration for different message types. For more information, see [Message Storage](https://intl.cloud.tencent.com/document/product/1047/33524).
+
+### Why do I encounter errors 70001, 70003, 70009, and 70013 during account authentication?
+
+These errors occur because UserID and UserSig do not match. To fix it, check the validity of UserID and UserSig. Among them, error 70001 means UserSig has expired, error 70003 means a verification failure due to a truncated UserSig, error 70009 means UserSig verification failed (possibly due to mixing the keys or private keys of other SDKAppIDs when generating UserSig), and error 70013 means UserID does not match.
+
+### Why do I encounter the error code -2 or -5 when the web client app is using the Chat SDK?
+- -2: Indicates that a web app request to the server failed, usually due to network problems. Web apps send requests to the server by using the HTTP Long Polling method, and this status code is returned when a network problem occurs. To fix it, check your network or try again.
+
+- -5: When the login attempt is not completed and the SDK has not received the a2key and tinyID returned by the server, directly calling other APIs returns the "tinyid or a2 is empty" error message and -5 error code.
+
+
+### What should I do when the SDK on the armeabi platform reports "java.lang.UnsatisfiedLinkError: No implementation found for"?
+
+Copy jni/armeabi-v7a/libImSDK.so in the Chat SDK’s aar file to the src/main/jniLibs/armeabi directory in your source code project and load it in build.gradle.
+
+### How can I resolve x86_64 and i386 architecture errors when the app has been launched in App Store?
+
+This error occurs because App Store does not support the x86_64 and i386 architecture. The solution is as follows:
+1. Clear the project compilation cache:
+ Select **Product** > **clean**, press Alt until "clean build Folder..." appears and wait for the operation to complete.
+
+2. Remove the x86_64 and i386 architecture not supported by App Store:
+ a. Select **TARGETS** > **Build Phases**.
+ b. Click the plus sign and select **New Run Script Phase**.
+ c. Add the following code:
+
+   ``` 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/100031390357/ac95ba51e28011eeb1eb525400b5f95f.png)
+
+3. Package the app and upload it again.
+
+
+### Can developers directly utilize the emoticon packs demonstrated in the Chat various client demos/TUIKit projects?
+
+To respect the copyright of emoji designs, the Chat Demo/TUIKit project does not include cutouts of large emoji elements. Please replace them with your own designs or other emoji packs for which you hold the copyright before officially launching for commercial use. **The default smiley face emoji pack shown below is copyrighted by Tencent RTC** and is available for licensed use for a fee. If you need to obtain a license, please [contact us](https://trtc.io/contact).
+
+![](https://write-document-release-1258344699.cos.ap-guangzhou.tencentcos.cn/100027202808/a44543c197f611ef820f525400d5f8ef.png)

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

@@ -0,0 +1,26 @@
+---
+product: 'Chat'
+tech_stack: 'web_js_sdk'
+framework: 'react'
+title: 'React UIKit Integration and Frequently Asked Questions'
+keywords: ['react', 'initialization', 'components', 'integration', 'TUIKit']
+---
+
+# React TUIKit Integration and FAQ
+
+## Module 1: Environment Setup and Quick Initialization (Topic: Setup)
+
+### Q: How do I install TUIKit in a React project?
+
+**A:** TUIKit is built on top of the Web SDK. You need to install `@tencentcloud/chat-uikit-react`
+
+```bash
+# Install TUIKit React version
+npm install @tencentcloud/chat-uikit-react@latest
+```
+
+## Module 2: Frequently Asked Questions (Topic: Question)
+
+### Q: Does TUIKit support React 17/19 versions?
+
+**A:** Currently, React versions 17.x and 19.x are not supported. Only React v18 is supported.

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

@@ -0,0 +1,36 @@
+---
+product: 'Chat'
+tech_stack: 'web_js_sdk'
+framework: 'vue'
+title: 'Vue TUIKit Integration and FAQ Solutions'
+keywords: ['vue', 'Initialization', 'Component', 'Integration', 'TUIKit']
+---
+
+Vue TUIKit Integration and Common Problem Solutions (FAQ)
+
+Module 1: Environment Setup and Quick Initialization (Topic: Setup)
+
+Q: How to install TUIKit in a Vue project?
+
+A: TUIKit is developed based on the Web SDK. You need to install @tencentcloud/chat-uikit-vue3.
+
+```bash
+# Install TUIKit Vue version
+npm install @tencentcloud/chat-uikit-vue3@latest
+```
+
+Module 2: Common Problem Solutions (Topic: Question)
+
+Q: Can I use third-party component libraries, such as Element-Plus, within TUIKit?
+
+A: Glue code between the core components can use other component libraries, which can be seen in the example code. For instance, you can encapsulate <ChatSetting /> into a full-screen drawer component. However, components already existing inside the core components are not supported for modification at this time.
+```typescript
+const isChatSettingShow = ref(false);
+<el-drawer
+  v-model="isChatSettingShow"
+  title="Settings"
+>
+  <ChatSetting />
+</el-drawer>
+
+```

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

@@ -0,0 +1,88 @@
+---
+product: 'Live'
+tech_stack: 'liveKit'
+framework: 'common'
+title: 'LiveKit Error Code Reference'
+keywords: ['error code', 'error', 'live', 'liveKit', 'live room error', 'pk error', 'co-hosting error']
+---
+
+# LiveKit Error Code Reference
+
+## LiveKit Error Codes (Topic: LiveKit Error Code)
+
+## Error Code 100002
+**Cause:** Possible reasons include:
+- Your current package does not support live streaming, possibly due to package expiration or not being activated.
+- Live room name cannot exceed 100 bytes. One Chinese character occupies 2 bytes.
+- Live room ID cannot exceed 48 characters.
+- Live room ID can only contain letters, numbers, and underscores.
+- Only live-type rooms support this interface.
+- Current layout template does not need to be changed.
+- PK request duration exceeded the maximum limit (default is 5 minutes).
+**Solution:** 
+- Check your package. For first-time use, you can [activate the trial version](https://trtc.io/document/60033?product=live&menulabel=uikit&platform=web) or visit the [Tencent Cloud Console](https://console.trtc.io/subscription/buy/live) to purchase or upgrade your package.
+- Verify that the live room name and live room ID meet requirements, and confirm that the room type is live.
+- Check the layout template parameters to confirm if layout changes are needed.
+- Check the PK request duration and reduce the PK time.
+
+## Error Code 70001
+**Cause:** User signature has expired.
+**Solution:** It is recommended to set the signature validity period to no less than 24 hours. Refer to [Generate UserSig (User Authentication)](https://trtc.io/document/35166?product=live&menulabel=uikit&platform=web).
+
+## Error Code 70003
+**Cause:** Invalid user signature.
+**Solution:** Regenerate the signature. Refer to [Generate UserSig (User Authentication)](https://trtc.io/document/35166?product=live&menulabel=uikit&platform=web).
+
+## Error Code 70013
+**Cause:** User ID does not match the user signature.
+**Solution:** Please verify that the user ID matches the user signature. You can verify the signature at the [Tencent Cloud Console](https://console.trtc.io/usersig).
+
+## Error Code 100004
+**Cause:** Room does not exist.
+**Solution:** Please verify that the room ID being used is correct.
+
+## Error Code 100006
+**Cause:** No operation permission.
+**Solution:** Please check if the current role has the required permission.
+
+## Error Code 100007
+**Cause:** Possible reasons include:
+- No package purchased or account is in arrears.
+- Cross-room co-hosting feature is not available between live rooms.
+- PK feature is not available between live rooms.
+**Solution:** 
+- For package issues, visit the [Tencent Cloud Console](https://console.trtc.io/subscription/buy/live) to purchase. For first-time use, you can [activate the trial version](https://trtc.io/document/60033?product=live&menulabel=uikit&platform=web).
+- For cross-room co-hosting unavailability, visit the [Tencent Cloud Console](https://console.trtc.io/subscription/buy/live) to purchase or upgrade your package.
+- For PK feature unavailability, visit the [Tencent Cloud Console](https://console.trtc.io/subscription/buy/live) to purchase or upgrade your package.
+
+## Error Code 100012
+**Cause:** Request too frequent.
+**Solution:** Requests are too frequent, please try again later.
+
+## Error Code 100203
+**Cause:** You are already on the microphone seat.
+**Solution:** Please check if the current user is already on the microphone seat.
+
+## Error Code 100206
+**Cause:** User is not on the microphone seat.
+**Solution:** Please check if the user is on the microphone seat.
+
+## Error Code 100400
+**Cause:** Current room has not enabled live room co-hosting.
+**Solution:** Please enable live room co-hosting before performing this operation.
+
+## Error Code 100418
+**Cause:** Current room has not started PK yet.
+**Solution:** Please start PK in the current room before performing this operation.
+
+## Error Code 100419
+**Cause:** Current room is currently in PK.
+**Solution:** The current room is in PK mode and cannot perform this operation. Please try again later.
+
+## Error Code 100421
+**Cause:** Current room PK has ended.
+**Solution:** The current room PK has ended and cannot perform this operation. Please try again later.
+
+## Error Code 101011
+**Cause:** Current room has reached the package participant limit.
+**Solution:** Visit the [Tencent Cloud Console](https://console.trtc.io/subscription/buy/live) to purchase or upgrade your package.