@trtc/calls-uikit-react 4.5.8 → 4.5.9

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@trtc/calls-uikit-react",
-  "version": "4.5.8",
+  "version": "4.5.9",
   "main": "./tuicall-uikit-react.umd.js",
   "module": "./tuicall-uikit-react.es.js",
   "types": "./types/index.d.ts",
@@ -14,7 +14,7 @@
   },
   "dependencies": {
     "@tencentcloud/tui-core-lite": "~1.0.1",
-    "@trtc/call-engine-lite-js": "~4.0.9",
+    "@trtc/call-engine-lite-js": "~4.0.10",
     "@tencentcloud/lite-chat": "^1.6.3",
     "@trtc/call-engine-lite-wx": "~5.0.6"
 },

package/src/TUICallService/CallService/UIKitModal.ts

@@ -22,6 +22,7 @@ const WEB_MODAL_ERROR_CODES = [
     60004,
     60006,
     -1201,
+    -1202,
     30000,
     20007,
     101002,
@@ -58,6 +59,12 @@ const WEB_MODAL_ERROR_MAP = {
         id: 10008,
         key: 'error.10008'
     },
+    // -1202 + native message 'invitee_list cannot be null': the caller tried to
+    // call themselves, so the invitee list ends up empty after filtering.
+    '-1202': {
+        id: 10017,
+        key: 'error.10017'
+    },
     '30000': {
         id: 10012,
         key: 'error.10012'
@@ -70,6 +77,12 @@ const WEB_MODAL_ERROR_MAP = {
         id: 10014,
         key: 'error.10014'
     },
+    // Same native code 101002 is reused for the "invalid callee list length" scenario,
+    // distinguished by message. See handleWebModalError for the message-based selection.
+    '101002_CALLEE_LIST': {
+        id: 10018,
+        key: 'error.10018'
+    },
     // 101011: package ability not supported, needs an upgrade on the console.
     // Message references the engine's ERROR_PACKAGE_NOT_SUPPORTED wording.
     '101011': {
@@ -89,6 +102,7 @@ const WEB_MODAL_ERROR_MAP = {
 const MINI_MODAL_ERROR_CODES = [
     -1001,
     -1002,
+    -1202,
     101002,
     101011,
     -3301,
@@ -103,9 +117,21 @@ const MINI_MODAL_ERROR_MAP = {
         id: 10002,
         content: '您暂不支持使用该能力，请前往购买页购买开通'
     },
+    // -1202 + native message 'invitee_list cannot be null': the caller tried to
+    // call themselves, so the invitee list ends up empty after filtering.
+    '-1202': {
+        id: 10017,
+        content: '发起通话失败：被叫 userID 不能是当前登录用户自己，请检查传入的被叫 userID'
+    },
     '101002': {
         id: 10014,
-        content: '发起通话失败，用户 ID 无效，请确认该用户已注册'
+        content: '发起通话失败：被叫 userID 无效，请确认该 userID 已注册并登录过 TUICallKit'
+    },
+    // Same native code 101002 is reused for the "invalid callee list length" scenario,
+    // distinguished by message. See handleMiniModalError for the message-based selection.
+    '101002_CALLEE_LIST': {
+        id: 10018,
+        content: '发起通话失败：单次呼叫的被叫用户数量需在 1 到 8 之间，请检查传入的 userIDList'
     },
     // 101011: package ability not supported, needs an upgrade on the console.
     // Content references the engine's ERROR_PACKAGE_NOT_SUPPORTED wording.
@@ -122,6 +148,21 @@ const MINI_MODAL_ERROR_MAP = {
 }
 // @endif
 
+// Resolve the modal map key for an error. Code 101002 is reused by two scenarios
+// (invalid userId / invalid callee list length), so it is disambiguated by message.
+// Matches both the raw native message and the marker appended by the engine, so it
+// works whether or not the engine has already localized the message.
+function resolveModalErrorKey(error) {
+    if (error.code === 101002) {
+        const message = error?.message || '';
+        if (message.includes('CalleeList_Account length must be between 1 and 8')
+            || message.includes('ERROR_INVALID_CALLEE_LIST')) {
+            return '101002_CALLEE_LIST';
+        }
+    }
+    return error.code.toString();
+}
+
 // `isFromChat` marks whether the current call is initiated from the Chat + TUICallKit
 // integrated scenario (true) or from standalone TUICallKit (false), so the modal can
 // show source-specific guidance for package errors such as -1001 / -1002.
@@ -145,7 +186,7 @@ function handleWebModalError(error, isFromChat = false) {
         return;
     }
 
-    const errorInfo = WEB_MODAL_ERROR_MAP[error.code.toString()];
+    const errorInfo = WEB_MODAL_ERROR_MAP[resolveModalErrorKey(error)];
     if (errorInfo) {
         // Prefer the Chat-integrated message when available and the call comes from Chat.
         const messageKey = isFromChat && errorInfo.chatKey ? errorInfo.chatKey : errorInfo.key;
@@ -165,7 +206,7 @@ function handleMiniModalError(error, isFromChat = false) {
         return;
     }
 
-    const errorInfo = MINI_MODAL_ERROR_MAP[error.code.toString()];
+    const errorInfo = MINI_MODAL_ERROR_MAP[resolveModalErrorKey(error)];
     if (errorInfo) {
         // Prefer the Chat-integrated content when available and the call comes from Chat.
         const content = isFromChat && errorInfo.chatContent ? errorInfo.chatContent : errorInfo.content;

package/src/TUICallService/CallService/chatCombine.ts

@@ -275,6 +275,14 @@ export default class ChatCombine {
    */
   private async _handleTUICoreOnClick(options, type: CallMediaType) {
     try {
+      // Guard: block starting a new call while already busy. `calls()` returns
+      // silently when the status is not IDLE, so we surface a toast here to let
+      // the user know a call is already in progress.
+      if (TUIStore.getData(StoreName.CALL, NAME.CALL_STATUS) !== CallStatus.IDLE) {
+        TUIStore.update(StoreName.CALL, NAME.TOAST_INFO, { content: 'in-calling-cannot-start-new', type: 'info' });
+        return;
+      }
+
       const { groupID, userIDList = [], version = '', ...rest } = options;
 
       await this._callService?.calls({ chatGroupID: groupID, userIDList, type, ...rest });

package/src/TUICallService/CallService/index.ts

@@ -27,7 +27,7 @@ const TUIGlobal: ITUIGlobal = TuiGlobal.getInstance();
 const TUIStore: ITUIStore = TuiStore.getInstance();
 const uiDesign = UIDesign.getInstance();
 uiDesign.setTUIStore(TUIStore);
-const version = '4.5.8';
+const version = '4.5.9';
 import AIAssistant from './AIAssistant'; // 仅 web 支持 AI 实时字幕
 const frameWork = 'react';
 export { TUIGlobal, TUIStore, uiDesign };

package/src/TUICallService/const/index.ts

@@ -106,4 +106,9 @@ export enum ROOM_ID_TYPE {
   NUMBER_ROOM_ID = 1,
   // eslint-disable-next-line no-unused-vars
   STRING_ROOM_ID = 2,
+};
+export enum CloudRecordPolicy {
+  FollowConsoleConfig = 0,
+  Enable = 1,
+  Disable = 2,
 };

package/src/TUICallService/index.ts

@@ -11,6 +11,7 @@ import {
   AudioPlayBackDevice,
   FeatureButton,
   LayoutMode,
+  CloudRecordPolicy,
 } from './const/index';
 import { t } from './locales/index';
 
@@ -34,4 +35,5 @@ export {
   uiDesign,
   FeatureButton,
   LayoutMode,
+  CloudRecordPolicy,
 };

package/src/TUICallService/interface/ICallService.ts

@@ -1,4 +1,4 @@
-import { CallStatus, CallRole } from '../const/index';
+import { CallStatus, CallRole, CloudRecordPolicy } from '../const/index';
 
 type SDKAppID = { SDKAppID: number; } | { sdkAppID: number; };
 export interface IInitParamsBase {
@@ -19,6 +19,7 @@ export interface ICallsParams {
   userData?: string;
   timeout?: number;
   offlinePushInfo?: IOfflinePushInfo;
+  cloudRecordPolicy?: CloudRecordPolicy;
 }
 // userInfo interface
 export interface IUserInfo {

package/src/TUICallService/locales/en.ts

@@ -126,6 +126,7 @@ export const en = {
   'not-supported-webrtc': 'Your current environment does not support WebRTC',
   'blacklist-user-tips': 'The identifier is in blacklist. Failed to send this message!',
   'is-already-calling': 'TUICallKit is already on a call',
+  'in-calling-cannot-start-new': 'A call is in progress. You cannot start a new call.',
   'need-init': 'Before initiating a call with TUICallKit, ensure that the TUICallKitAPI.init() method has executed successfully. ',
   "can't call yourself": "Can't call yourself", // eslint-disable-line
   'Use-phone-and-computer': 'Use your mobile phone and computer to experience video calls',
@@ -144,10 +145,12 @@ export const en = {
   'error.10008': "TUICallEngine has not completed initialization or login. Please ensure you have successfully executed init or login operations before calling this function. Solution: <a href='https://cloud.tencent.com/document/product/647/78769#3a61f42b-e06f-49af-88bf-362d40025887'>View Documentation</a>",
   'error.10012': "Detected that the current page is under HTTP protocol. To ensure smooth access and full functionality of TUICallEngine SDK for production environment users, please use HTTPS protocol (or localhost) to access the audio/video application page. For details, please visit: <a href='https://web.sdk.qcloud.com/trtc/webrtc/v5/doc/zh-cn/tutorial-05-info-browser.html#h2-3'>View Documentation</a>",
   'error.10013': "Call failed: You have been blocked by the other party or you have blocked the other party",
-  'error.10014': "Call initiation failed. User ID is invalid. Please confirm that the user is registered.",
+  'error.10014': "Failed to start the call: the callee userID is invalid. Please make sure the userID is registered and has logged in to TUICallKit.",
   'error.10015': "Failed to enter the room because the TRTC service is not activated. Please go to the <a href='https://console.cloud.tencent.com/trtc'>console</a> to activate the TRTC service for your application",
   'error.10015.chat': "You are currently in the Chat + TUICallKit integrated scenario. Failed to enter the room because the TRTC service is not activated. Please go to the <a href='https://console.cloud.tencent.com/im/rtc-config'>IM console</a> to activate the TRTC service for your application",
   'error.10016': "Your application has not enabled the audio and video call (TUICallKit) capability. You can apply for a free trial in the <a href='https://console.cloud.tencent.com/im/detail'>console</a>, or purchase the <a href='https://buy.cloud.tencent.com/avc'>call capability package</a>. If you have any questions, please refer to the <a href='https://cloud.tencent.com/document/product/647/104662'>documentation</a>",
+  'error.10017': "Failed to start the call: the callee userID cannot be the current logged-in user. Please check the callee userID you passed in.",
+  'error.10018': "Failed to start the call: the number of callees in a single call must be between 1 and 8. Please check the userIDList you passed in.",
   'error': 'Error',
   // AI Subtitle Settings
   'ai-subtitle': 'AI Subtitle',

package/src/TUICallService/locales/ja_JP.ts

@@ -128,6 +128,7 @@ export const ja_JP = {
   'not-supported-webrtc': '現在の環境はWebRTCをサポートしていません',
   'blacklist-user-tips': 'ユーザーはブラックリストに登録され、通話が開始できませんでした',
   'is-already-calling': 'TUICallKit はすでに通話中です',
+  'in-calling-cannot-start-new': '通話中のため、新しい通話を開始できません',
   'need-init': 'TUICallKitで通話を開始する前に、TUICallKitAPI.init() メソッドが正常に実行されたことを確認してください。',
   "can't call yourself": '自分に電話をかけることができません',
   'accept-error': '接続できませんでした',
@@ -143,9 +144,11 @@ export const ja_JP = {
   'error.10008': "TUICallEngineが初期化またはログインを完了していません。この機能を呼び出す前に、initまたはlogin操作が正常に実行されていることを確認してください。解決策：<a href='https://cloud.tencent.com/document/product/647/78769#3a61f42b-e06f-49af-88bf-362d40025887'>ドキュメントを確認</a>",
   'error.10012': "現在のページがHTTPプロトコル下にあることが検出されました。本番環境のユーザーがTUICallEngine SDKの全機能をスムーズに利用できるようにするため、音声・ビデオアプリケーションページにはHTTPSプロトコル（またはlocalhost）を使用してアクセスしてください。詳細については、<a href='https://web.sdk.qcloud.com/trtc/webrtc/v5/doc/zh-cn/tutorial-05-info-browser.html#h2-3'>ドキュメントを確認</a>してください",
   'error.10013': "通話失敗：相手にブロックされているか、または相手をブロックしています",
-  'error.10014': "通話の開始に失敗しました。ユーザーIDが無効です。ユーザーが登録されていることを確認してください。",
+  'error.10014': "通話の発信に失敗しました：着信側 userID が無効です。該当 userID が登録済みで、TUICallKit にログインしたことがあることを確認してください。",
   'error.10015.chat': "現在は Chat と TUICallKit の統合シナリオです。TRTC サービスが有効化されていないため、ルームへの入室に失敗しました。<a href='https://console.cloud.tencent.com/im/rtc-config'>IM コンソール</a>でアプリケーションの TRTC サービスを有効化してください",
   'error.10016': "あなたのアプリケーションは音声・ビデオ通話（TUICallKit）機能を有効にしていません。<a href='https://console.cloud.tencent.com/im/detail'>コンソール</a>で無料体験を申請するか、<a href='https://buy.cloud.tencent.com/avc'>通話機能パッケージ</a>を購入してください。ご不明な点がある場合は、<a href='https://cloud.tencent.com/document/product/647/104662'>ドキュメント</a>をご参照ください",
+  'error.10017': "通話の発信に失敗しました：着信側 userID を現在ログイン中のユーザー自身に指定することはできません。渡した着信側 userID を確認してください。",
+  'error.10018': "通話の発信に失敗しました：1 回の通話で指定できる着信側ユーザー数は 1〜8 人である必要があります。渡した userIDList を確認してください。",
   'error': 'エラー',
   // AI Subtitle Settings
   'ai-subtitle': 'AI字幕',

package/src/TUICallService/locales/zh-cn.ts

@@ -124,6 +124,7 @@ export const zh = {
   'not-supported-webrtc': '当前环境不支持 WebRTC',
   'blacklist-user-tips': '发起通话失败，被对方拉入黑名单，禁止发起！',
   'is-already-calling': 'TUICallKit 已在通话状态',
+  'in-calling-cannot-start-new': '正在通话中，无法发起新的通话',
   'need-init': 'TUICallKit 发起通话前需保证 TUICallKitAPI.init() 方法执行成功',
   "can't call yourself": '不能呼叫自己', // eslint-disable-line
   'accept-error': '接通失败',
@@ -139,10 +140,12 @@ export const zh = {
   'error.10008': "TUICallEngine 尚未完成初始化或登录。请确保在调用此功能前，已成功执行 init 或 login 操作。解决方案：<a href='https://cloud.tencent.com/document/product/647/78769#3a61f42b-e06f-49af-88bf-362d40025887'>查看文档</a>",
   'error.10012': "检测到当前页面正处于 http 协议下，为确保生产环境用户顺畅接入和体验 TUICallEngine SDK 的全部功能，请使用 https 协议(或 localhost)访问音视频应用页面。详情请前往：<a href='https://web.sdk.qcloud.com/trtc/webrtc/v5/doc/zh-cn/tutorial-05-info-browser.html#h2-3'>查看文档</a>",
   'error.10013': "呼叫失败：您已被对方拉黑或您拉黑了对方",
-  'error.10014': "发起通话失败，用户 ID 无效，请确认该用户已注册。",
+  'error.10014': "发起通话失败：被叫 userID 无效，请确认该 userID 已注册并登录过 TUICallKit。",
   'error.10015': "未开通 TRTC 服务导致进房失败，请前往<a href='https://console.cloud.tencent.com/trtc'>控制台</a>为您的应用开通 TRTC 服务",
   'error.10015.chat': "当前为 Chat 与 TUICallKit 融合场景，未开通 TRTC 服务导致进房失败，请前往 <a href='https://console.cloud.tencent.com/im/rtc-config'>IM 控制台</a>为您的应用开通 TRTC 服务",
   'error.10016': "您的应用还未开通音视频通话（TUICallKit）能力，您可以去<a href='https://console.cloud.tencent.com/im/detail'>控制台</a>申请免费体验，或购买<a href='https://buy.cloud.tencent.com/avc'>通话能力套餐包</a>，有疑问请参考<a href='https://cloud.tencent.com/document/product/647/104662'>相关文档</a>",
+  'error.10017': "发起通话失败：被叫 userID 不能是当前登录用户自己，请检查传入的被叫 userID。",
+  'error.10018': "发起通话失败：单次呼叫的被叫用户数量需在 1 到 8 之间，请检查传入的 userIDList。",
   'error': '错误',
   // AI Subtitle Settings
   'ai-subtitle': 'AI 字幕',

package/src/index.ts

@@ -35,7 +35,7 @@ const TUICallType = {
   AUDIO_CALL: 1,
   VIDEO_CALL: 2,
 };
-const Version = '4.5.8'; // basic-demo 原来上报使用
+const Version = '4.5.9'; // basic-demo 原来上报使用
 
 // 输出产物
 export {