@tencentcloud/sdk-mcp 1.7.3 → 1.7.4

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

@@ -119,7 +119,7 @@ const robotId = await trtc.startPlugin('RealtimeTranscriber', {
 
 | Name | Type | Required | Description |
 |------|------|----------|-------------|
-| sourceLanguage | `string` | 必填 | 源语言代码，目前仅支持 `'zh'`、`'en'` |
+| sourceLanguage | `string` | 必填 | 源语言代码。指定源音频的语言种类，请填写标准的语言代码（例如 `'zh'`），支持的语言列表见下方 [支持的语言](#支持的语言) |
 | translationLanguages | `string` \| `string[]` | 选填 | 翻译目标语言，支持单个语言或语言数组，如 `'en'` 或 `['en', 'ja']` |
 | userIdsToTranscribe | `string` \| `string[]` | 选填 | 要转录的用户 ID，默认为 `'all'` 转录所有用户，也可指定单个或多个用户 ID |
 | transcriberRobotId | `string` | 选填 | 自定义转录机器人 ID，不传则自动生成 |
@@ -183,6 +183,30 @@ trtc.on(TRTC.EVENT.REALTIME_TRANSCRIBER_STATE_CHANGED, (event) => {
 });
 ```
 
+#### 后台资源受限通知
+
+当后台 AI 服务（ASR/翻译）资源受限时，SDK 会通过 `TRTC.EVENT.ERROR` 事件主动通知（后台限频每分钟下发一次，资源恢复正常后停止下发）。此时：
+
+- `error.code` 固定为 `5400`（SERVER_ERROR，表示服务器处理请求失败）
+- `error.extraCode` 为降级事件码，见下表
+- `error.data` 携带 `{ roomId, transcriberRobotId, taskId, resourceType }`，用于定位受影响的转录任务
+
+业务侧收到后应及时回退或降级相关 AI 能力，避免影响线上业务。
+
+| 事件码（extraCode） | 含义 | 建议处理 |
+|--------|------|----------|
+
+```javascript
+trtc.on(TRTC.EVENT.ERROR, (error) => {
+  if (error.code === 5400 && error.extraCode === 5001) {
+    // 例如 error.message: 'The ASR/Translate concurrent usage has exceeded the limit. ...'
+    // error.data: { roomId, transcriberRobotId, taskId, resourceType }
+    console.warn(`转录服务资源受限，robotId: ${error.data.transcriberRobotId}, ${error.message}`);
+    // 业务侧自行决定降级或关闭相关 AI 能力
+  }
+});
+```
+
 ### TRTC.EVENT.REALTIME_TRANSCRIBER_MESSAGE
 
 转录消息事件，当有新的转录结果时触发。
@@ -228,10 +252,6 @@ trtc.off(TRTC.EVENT.REALTIME_TRANSCRIBER_MESSAGE, handler);
 |------|------|
 | 中文 | `zh` |
 | 英语 | `en` |
-
-<!--
-| 中文繁体 | `zh-tw` |
-| 中国方言 | `zh-dialect` |
 | 中国粤语 | `zh-yue` |
 | 越南语 | `vi` |
 | 日语 | `ja` |
@@ -252,7 +272,6 @@ trtc.off(TRTC.EVENT.REALTIME_TRANSCRIBER_MESSAGE, handler);
 | 瑞典语 | `sv` |
 | 丹麦语 | `da` |
 | 挪威语 | `no` |
--->
 
 ### 翻译目标语言
 

package/server.js

@@ -41,7 +41,7 @@ User-visible output rule (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

@@ -32,7 +32,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}`,