@tencent-rtc/mcp 1.7.3 → 1.7.4

package/resource/knowledge/rtcengine/web/plugin/23-advanced-support-detection.md

@@ -23,7 +23,7 @@ TRTC.isSupported().then(checkResult => {
 
 ### Option 1: Use Device Detector Plugin (including default UI)
 
-The device detector plugin is used to test the user's media device(camera, microphone, speaker) and network which is recommended to be used before the user enters the room.
+The device detector plugin is used to test the user's media device(camera, microphone, speaker) and network which is recommended to be used before the user enters the room. 
 
 > - Support TRTC Web SDK version >= v5.8.0
 > - The plugin includes a default UI. If the UI does not meet your product design requirements, you can refer to Option 2 for a custom UI implementation.
@@ -38,7 +38,7 @@ const trtc = TRTC.create({ plugins: [DeviceDetector] });
 const result = await trtc.startPlugin('DeviceDetector');
 
 // 2. Test Media Device & Network Quality
-const options = {
+const options = { 
     networkDetect: { sdkAppId, userId, userSig }
 }
 const resultWithNetwork = await trtc.startPlugin('DeviceDetector', options);
@@ -70,11 +70,11 @@ Enable the mirror checkbox during camera detection
 
 | Name            | Type   | Attributes | Description                                                                                                                                                           |
 | --------------- | ------ | ---------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| sdkAppId        | string | required   | Your sdkAppId                                                                                                                                                         |
+| sdkAppId        | number | required   | Your sdkAppId                                                                                                                                                         |
 | userId          | string | required   | The userId for testing uplink network quality. It should be different from downlinkUserId.                                                                            |
 | userSig         | string | required   | The [UserSig](https://trtc.io/document/35166) of the userId.                                                                                                          |
-| downlinkUserId  | string | required   | The userId for testing downlink network quality. It should be different from userId. Fill in downlinkUserId and downlinkUserSig will perform a downlink network test. |
-| downlinkUserSig | string | required   | The [UserSig](https://trtc.io/document/35166) of the downlinkUserId.                                                                                                  |
+| downlinkUserId  | string | optional   | The userId for testing downlink network quality. It should be different from userId. Fill in downlinkUserId and downlinkUserSig will perform a downlink network test. |
+| downlinkUserSig | string | optional   | The [UserSig](https://trtc.io/document/35166) of the downlinkUserId.                                                                                                  |
 | roomId          | number | optional   | Optional. The default value is 8080. The value must be an integer of [1, 4294967294]                                                                                  |
 
 ##### trtc.stopPlugin('DeviceDetector')
@@ -125,7 +125,7 @@ The device connection checks if the user's device has a camera, microphone, and
 
   ```javascript
   import TRTC from 'trtc-sdk-v5';
-
+  
   const cameraList = await TRTC.getCameraList();
   const micList = await TRTC.getMicrophoneList();
   const hasCameraDevice = cameraList.some(camera => camera.deviceId !== '');

package/resource/knowledge/rtcengine/web/plugin/31-advanced-plugins-overview.md

@@ -28,6 +28,7 @@ TRTC Web SDK v5 provides a plugin system that supports on-demand loading of vari
 | **AIDenoiser** | AI noise reduction with support for far-field cancellation mode | - | Exclusive Edition | Required | {@tutorial 35-advanced-ai-denoiser} |
 | **VoiceChanger** | Voice effects with 11 voice types (child, loli, uncle, etc.) | ≥ 5.10.0 | Premium Edition | - | {@tutorial 37-advanced-voice-changer} |
 | **RealtimeTranscriber** | Real-time speech transcription and translation, converting audio to text with multi-language translation | ≥ 5.15.0 | None | - | {@tutorial 42-advanced-realtime-transcriber} |
+| **Chorus** | KTV chorus with lead/backup singer roles, lyrics sync
 
 ### Streaming & Mixing
 
@@ -42,6 +43,7 @@ TRTC Web SDK v5 provides a plugin system that supports on-demand loading of vari
 |---------|---------|---------|---------|---------|---------|
 | **DeviceDetector** | Device detection for camera, microphone, speaker, and network with default UI | ≥ 5.8.0 | None | - | {@tutorial 23-advanced-support-detection} |
 | **Debug** | Debug mode with full log upload/export and audio/video dump | ≥ 5.8.0 | None | - | {@tutorial 18-basic-debug} |
+| **TRTCVideoDecoder** | Video decoder fallback to software decoding on failure | ≥ 5.9
 | **SmallStreamAutoSwitcher** | Automatic dual-stream switching for smooth streaming in poor network | ≥ 5.11.0 | None | - | {@tutorial 41-advanced-small-stream-auto-switcher} |
 <!-- | **CustomEncryption** | Custom encryption for end-to-end audio/video encryption with built-in or custom algorithms | - | Contact us | - | - | -->
 
@@ -61,7 +63,7 @@ import TRTC from 'trtc-sdk-v5';
 import { VirtualBackground } from 'trtc-sdk-v5/plugins/video-effect/virtual-background';
 import { AIDenoiser } from 'trtc-sdk-v5/plugins/ai-denoiser';
 
-const trtc = TRTC.create({
+const trtc = TRTC.create({ 
   plugins: [VirtualBackground, AIDenoiser],
   assetsPath: 'https://your-cdn/assets' // If plugins require static assets
 });
@@ -89,7 +91,7 @@ Use `trtc.updatePlugin(pluginName, options)` to dynamically update plugin parame
 ```javascript
 await trtc.updatePlugin('VirtualBackground', {
   type: 'image',
-  imageUrl: 'https://example.com/background.jpg'
+  src: 'https://example.com/background.jpg'
 });
 ```
 
@@ -164,8 +166,8 @@ await trtc.updatePlugin('VideoMixer', {
 });
 
 // Publish mixed track
-await trtc.startLocalVideo({
-  option: {
+await trtc.startLocalVideo({ 
+  option: { 
     videoTrack: track,
     profile: { width: 1920, height: 1080, bitrate: 2000 }
   }
@@ -185,7 +187,7 @@ TRTCVideoDecoder automatically starts fallback logic on decode failure after reg
 ```javascript
 import TRTCVideoDecoder from 'trtc-sdk-v5/plugins/video-decoder';
 
-const trtc = TRTC.create({
+const trtc = TRTC.create({ 
   plugins: [TRTCVideoDecoder],
   assetsPath: 'https://your-cdn/assets'
 });
@@ -309,7 +311,7 @@ cp -r node_modules/trtc-sdk-v5/assets ./public/assets
 Pass the asset path when creating TRTC instance:
 
 ```javascript
-const trtc = TRTC.create({
+const trtc = TRTC.create({ 
   plugins: [VirtualBackground, AIDenoiser],
   assetsPath: 'https://your-cdn.com/assets'
 });

package/resource/knowledge/rtcengine/web/plugin/42-advanced-realtime-transcriber.md

@@ -90,7 +90,7 @@ const robotId = await trtc.startPlugin('RealtimeTranscriber', {
 trtc.on(TRTC.EVENT.REALTIME_TRANSCRIBER_MESSAGE, (data) => {
   console.log(`👤 ${data.speakerUserId}:`);
   console.log(`  Original: ${data.sourceText}`);
-
+  
   if (data.translationTexts) {
     Object.entries(data.translationTexts).forEach(([lang, text]) => {
       console.log(`  ${lang.toUpperCase()}: ${text}`);
@@ -119,7 +119,7 @@ Starts a real-time transcription task.
 
 | Name | Type | Required | Description |
 |------|------|----------|-------------|
-| sourceLanguage | `string` | Required | Source language code, currently supports only `'zh'` and `'en'` |
+| sourceLanguage | `string` | Required | Source language code. Specifies the language of the source audio. Use a standard language code (for example, `'zh'`). For the list of supported languages, see [Supported Languages](#supported-languages) |
 | translationLanguages | `string` \| `string[]` | Optional | Target translation language(s), supports single language or array, e.g., `'en'` or `['en', 'ja']` |
 | userIdsToTranscribe | `string` \| `string[]` | Optional | User ID(s) to transcribe, defaults to `'all'` for all users, can also specify single or multiple user IDs |
 | transcriberRobotId | `string` | Optional | Custom transcriber robot ID, auto-generated if not provided |
@@ -183,6 +183,30 @@ trtc.on(TRTC.EVENT.REALTIME_TRANSCRIBER_STATE_CHANGED, (event) => {
 });
 ```
 
+#### Backend Resource Limitation Notification
+
+When the backend AI service (ASR/translation) resources are limited, the SDK proactively notifies through the `TRTC.EVENT.ERROR` event (the backend sends this notification at most once per minute, and stops sending it once resources recover). In this case:
+
+- `error.code` is always `5400` (SERVER_ERROR, indicating the server failed to process the request)
+- `error.extraCode` is the downgrade event code, see the table below
+- `error.data` carries `{ roomId, transcriberRobotId, taskId, resourceType }` to identify the affected transcription task
+
+You should degrade or disable the relevant AI capabilities in time to avoid affecting your online business.
+
+| Event Code (extraCode) | Description | Suggested Action |
+|------------|-------------|------------------|
+
+```javascript
+trtc.on(TRTC.EVENT.ERROR, (error) => {
+  if (error.code === 5400 && error.extraCode === 5001) {
+    // e.g. error.message: 'The ASR/Translate concurrent usage has exceeded the limit. ...'
+    // error.data: { roomId, transcriberRobotId, taskId, resourceType }
+    console.warn(`Transcription service resources are limited, robotId: ${error.data.transcriberRobotId}, ${error.message}`);
+    // Degrade or disable the relevant AI capabilities as needed
+  }
+});
+```
+
 ### TRTC.EVENT.REALTIME_TRANSCRIBER_MESSAGE
 
 Transcription message event, triggered when new transcription results are available.
@@ -204,10 +228,10 @@ Transcription message event, triggered when new transcription results are availa
 ```javascript
 trtc.on(TRTC.EVENT.REALTIME_TRANSCRIBER_MESSAGE, (event) => {
   const { speakerUserId, sourceText, translationTexts, isCompleted } = event;
-
+  
   // Display real-time transcription result
   console.log(`[${isCompleted ? 'Completed' : 'In Progress'}] ${speakerUserId}: ${sourceText}`);
-
+  
   // Display translation results
   if (translationTexts) {
     translationTexts.forEach(({ language, text }) => {
@@ -228,10 +252,6 @@ trtc.off(TRTC.EVENT.REALTIME_TRANSCRIBER_MESSAGE, handler);
 |----------|------|
 | Chinese | `zh` |
 | English | `en` |
-
-<!--
-| Traditional Chinese | `zh-tw` |
-| Chinese Dialects | `zh-dialect` |
 | Cantonese | `zh-yue` |
 | Vietnamese | `vi` |
 | Japanese | `ja` |
@@ -252,7 +272,7 @@ trtc.off(TRTC.EVENT.REALTIME_TRANSCRIBER_MESSAGE, handler);
 | Swedish | `sv` |
 | Danish | `da` |
 | Norwegian | `no` |
--->
+| For more languages
 
 ### Translation Target Languages
 
@@ -301,7 +321,7 @@ const subtitleMap = new Map();
 
 trtc.on(TRTC.EVENT.REALTIME_TRANSCRIBER_MESSAGE, (event) => {
   subtitleMap.set(event.segmentId, event);
-
+  
   if (event.isCompleted) {
     // Speech segment completed, can be archived
     archiveSubtitle(subtitleMap.get(event.segmentId));

package/server.js

@@ -41,7 +41,7 @@ User-visible output rules (MUST):
 export function createServer() {
     const server = new McpServer({
         name: "Tencent RTC MCP Server",
-        version: "1.7.3",
+        version: "1.7.4",
     }, {
         instructions: SERVER_INSTRUCTIONS,
     });

package/utils/report-cls-client.js

@@ -28,7 +28,7 @@ function sendCLSReport(reportData) {
     const time = Date.now();
     const data = {
         platform: 'mcp',
-        verison: '1.7.3',
+        verison: '1.7.4',
         sdkappid: `${SDKAppID}`,
         method: method,
         userid: queryID || userID,

package/utils/report-es-client.js

@@ -7,7 +7,7 @@ function reportESClient(reportData) {
         report: [
             {
                 platform: 'mcp',
-                version: '1.7.3',
+                version: '1.7.4',
                 sdkappid: `${SDKAppID}`,
                 method: method,
                 userID: `${userID}`,