@trtc/calls-uikit-react 4.4.0 → 4.4.3-beta.1

package/README-zh_CN.md

@@ -54,6 +54,12 @@ TUICallKit 支持市面上主流浏览器，详情参考：[浏览器支持情
 | 56+ | 80+ | 56+ | 11+ | 11+ | 46+ |
 
 
+## 推荐使用更高效的 AI 集成助手
+我们为您提供了全新的 AI 集成方式，如果您不需要完整的 Demo 工程, 只想快速开始集成，推荐您使用更高效的 AI 集成助手，只需要简单描述您的需求，即可自动生成集成代码，大幅提升开发效率。
+
+点击这里，立即体验 [AI 集成](https://cloud.tencent.com/document/product/647/125504)。
+
+
 ## 安装
 使用 npm:
 ```

package/README.md

@@ -56,6 +56,12 @@ Please be sure to use HTTPS protocol or localhost to deploy your Web App, otherw
 | 56+ | 80+ | 56+ | 11+ | 11+ | 46+ |
 
 
+## Recommend Using the More Efficient AI Integration Assistant
+
+We offer you a brand new method for AI integration. If you don't need the complete demo project and just want to get started with integration quickly, we recommend using the more efficient AI Integration Assistant. Simply describe your requirements, and it will automatically generate the integration code, significantly boosting development efficiency.
+
+Click here to experience [AI integration]((https://cloud.tencent.com/document/product/647/125504)) now!
+
 
 ## Install
 npm:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@trtc/calls-uikit-react",
-  "version": "4.4.0",
+  "version": "4.4.3-beta.1",
   "main": "./tuicall-uikit-react.umd.js",
   "module": "./tuicall-uikit-react.es.js",
   "types": "./types/index.d.ts",
@@ -14,9 +14,8 @@
   },
   "dependencies": {
     "@tencentcloud/tui-core-lite": "1.0.0",
-    "@trtc/call-engine-lite-js": "~3.5.0",
-    "@tencentcloud/lite-chat": "^1.6.3",
-    "@trtc/call-engine-lite-wx": "~3.4.7"
+    "@trtc/call-engine-lite-js": "3.5.3-beta.1",
+    "@tencentcloud/lite-chat": "^1.6.3"
 },
   "bugs": {
     "url": "https://github.com/tencentyun/TUICallKit/issues"

package/src/TUICallService/CallService/UIKitModal.ts

@@ -0,0 +1,76 @@
+import TuiStore from '../TUIStore/tuiStore';
+import { StoreName } from '../const/call';
+import { NAME } from '../const/index';
+import { t } from '../locales'
+const TUIStore = TuiStore.getInstance();
+
+const MODAL_ERROR_CODES = [
+    -1001,
+    -1002,
+    -1101,
+    60003,
+    60004,
+    60006,
+    -1201,
+    30000,
+    20007,
+];
+
+const MODAL_ERROR_MAP = {
+    '-1001': {
+        id: 10001,
+        key: 'error.10001'
+    },
+    '-1002': {
+        id: 10002,
+        key: 'error.10002'
+    },
+    '-1101': {
+        id: 10004,
+        key: 'error.10004'
+    },
+    '60003': {
+        id: 10005,
+        key: 'error.10005'
+    },
+    '60004': {
+        id: 10006,
+        key: 'error.10006'
+    },
+    '60006': {
+        id: 10007,
+        key: 'error.10007'
+    },
+    '-1201': {
+        id: 10008,
+        key: 'error.10008'
+    },
+    '30000': {
+        id: 10012,
+        key: 'error.10012'
+    },
+    '20007': {
+        id: 10013,
+        key: 'error.10013'
+    }
+};
+
+export function handleModalError(error) {
+    if (!error || !error?.code) {
+        return;
+    }
+
+    if (!MODAL_ERROR_CODES.includes(error.code)) {
+        return;
+    }
+
+    const errorInfo = MODAL_ERROR_MAP[error.code.toString()];
+    if (errorInfo) {
+        let content = t(errorInfo.key);
+        TUIStore.update(StoreName.CALL, NAME.MODAL_ERROR, {
+            id: errorInfo.id,
+            content: content,
+            title: t('error')
+        });
+    }
+}

package/src/TUICallService/CallService/index.ts

@@ -9,6 +9,7 @@ import {
 // @ts-ignore
 import { TUICallEngine } from '@trtc/call-engine-lite-js';
 import { checkLocalMP3FileExists } from '../utils/index';
+import { handleModalError } from './UIKitModal';
 import { CallTips, t } from '../locales/index';
 import { BellContext } from './bellContext';
 import { avoidRepeatedCall } from '../utils/validate/index';
@@ -28,7 +29,7 @@ const TUIStore: ITUIStore = TuiStore.getInstance();
 const uiDesign = UIDesign.getInstance();
 uiDesign.setTUIStore(TUIStore);
 const aiAssistant = AIAssistant.getInstance();
-const version = '4.4.0';
+const version = '4.4.3-beta.1';
 const frameWork = 'react';
 export { TUIGlobal, TUIStore, uiDesign };
 
@@ -195,6 +196,7 @@ export default class TUICallService {
       const response = await this._tuiCallEngine.calls(callsParams);
       await this._updateCallStoreAfterCall(userIDList, response);
     } catch (error: any) {
+      handleModalError(error);
       this._handleCallError(error, 'calls');
     }
   }
@@ -229,6 +231,7 @@ export default class TUICallService {
       //   setLocalUserInfoAudioVideoAvailable(true, NAME.VIDEO);
       // }
     } catch (error) {
+      handleModalError(error);
       this._handleCallError(error, 'join');
     }
   }
@@ -360,6 +363,7 @@ export default class TUICallService {
         error,
       });
       if (handleRepeatedCallError(error)) return;
+      handleModalError(error);
       noDevicePermissionToast(error, CallMediaType.AUDIO, this._tuiCallEngine);
       this._resetCallStore();
     }
@@ -375,6 +379,7 @@ export default class TUICallService {
         }
       });
     } catch (error) {
+      handleModalError(error);
       console.debug(error);
     }
     this._resetCallStore();
@@ -388,6 +393,7 @@ export default class TUICallService {
         this._chatCombine?.callTUIService({ message: response?.data?.message });
       }
     } catch (error) {
+      handleModalError(error);
       console.debug(error);
     }
     this._resetCallStore();

package/src/TUICallService/const/index.ts

@@ -38,6 +38,7 @@ export const CALL_DATA_KEY: any = {
   GROUP_CALL_MEMBERS: 'groupCallMembers',
   PUSHER_ID: 'pusherId',
   IS_FORCE_USE_V2_API: 'isForceUseV2API',
+  MODAL_ERROR: 'modalError',
 };
 
 export const CHAT_DATA_KEY: any = {

package/src/TUICallService/locales/en.ts

@@ -134,4 +134,15 @@ export const en = {
   'accept-error': 'Accept failed',
   'accept-device-error': 'Accept failed, unable to auth calling device',
   'call-error': 'Start call failed',
+  // 错误提示
+  'error.10001': "Your application has not enabled audio/video call (TUICallKit) capability. You can go to the <a href='https://console.cloud.tencent.com/im/detail'>console</a> to apply for a free trial or purchase call capability packages: <a href='https://buy.cloud.tencent.com/avc?addRavLicense=1&position=1600110000&ravLicenseType=1&regionId=1'>Purchase Page</a>",
+  'error.10002': "You do not currently support using this capability. Please go to the <a href='https://buy.cloud.tencent.com/avc?addRavLicense=1&position=1600110000&ravLicenseType=1&regionId=1'>purchase page</a> to buy and activate it",
+  'error.10004': "Camera/microphone permission was denied. Please check browser settings to ensure camera and microphone access is allowed. If you have confirmed permission is granted, please go to <a href='https://web.sdk.qcloud.com/trtc/webrtc/demo/detect/index.html'>Audio/Video Capability Detection</a> to check if your device and environment support calls",
+  'error.10005': "No microphone device detected. Please ensure your device has a microphone connected and check if the microphone is available in system or browser settings.",
+  'error.10006': "No camera device detected. Please ensure your camera is connected and check if the camera is available in system or browser settings.",
+  'error.10007': "Current browser environment does not support WebRTC functionality. Please go to <a href='https://web.sdk.qcloud.com/trtc/webrtc/demo/detect/index.html'>Audio/Video Capability Detection</a> to check your device and environment compatibility",
+  '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': 'Error',
 };

package/src/TUICallService/locales/ja_JP.ts

@@ -133,4 +133,15 @@ export const ja_JP = {
   'accept-error': '接続できませんでした',
   'accept-device-error': '接続できませんでした。発信側デバイスを認証できません',
   'call-error': '通話が開始できませんでした',
+  // 错误提示
+  'error.10001': "あなたのアプリケーションは音声・ビデオ通話（TUICallKit）機能を有効にしていません。<a href='https://console.cloud.tencent.com/im/detail'>コンソール</a>で無料体験を申請するか、通話機能パッケージを購入してください：<a href='https://buy.cloud.tencent.com/avc?addRavLicense=1&position=1600110000&ravLicenseType=1&regionId=1'>購入ページ</a>",
+  'error.10002': "現在この機能を使用することはできません。<a href='https://buy.cloud.tencent.com/avc?addRavLicense=1&position=1600110000&ravLicenseType=1&regionId=1'>購入ページ</a>で購入して有効にしてください",
+  'error.10004': "カメラ/マイクのアクセス許可が拒否されました。ブラウザ設定を確認し、カメラとマイクの使用が許可されていることを確認してください。許可されている場合は、<a href='https://web.sdk.qcloud.com/trtc/webrtc/demo/detect/index.html'>音声・ビデオ機能検出</a>にアクセスして、お使いのデバイスと環境が通話をサポートしているか確認してください",
+  'error.10005': "マイクデバイスが検出されませんでした。デバイスにマイクが接続されていることを確認し、システムまたはブラウザ設定でマイクが利用可能かどうかを確認してください。",
+  'error.10006': "カメラデバイスが検出されませんでした。カメラが接続されていることを確認し、システムまたはブラウザ設定でカメラが利用可能かどうかを確認してください。",
+  'error.10007': "現在のブラウザ環境はWebRTC機能をサポートしていません。<a href='https://web.sdk.qcloud.com/trtc/webrtc/demo/detect/index.html'>音声・ビデオ機能検出</a>にアクセスして、お使いのデバイスと環境の互換性を確認してください",
+  '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': 'エラー',
 };

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

@@ -129,4 +129,15 @@ export const zh = {
   'accept-error': '接通失败',
   'accept-device-error': '接通失败，通话设备获取失败',
   'call-error': '发起通话失败',
+  // 错误提示
+  'error.10001': "您的应用还未开通音视频通话（TUICallKit）能力，您可以去<a href='https://console.cloud.tencent.com/im/detail'>控制台</a>申请免费体验，或购买通话能力套餐包：<a href='https://buy.cloud.tencent.com/avc?addRavLicense=1&position=1600110000&ravLicenseType=1&regionId=1'>购买页面</a>",
+  'error.10002': "您暂不支持使用该能力，请前往<a href='https://buy.cloud.tencent.com/avc?addRavLicense=1&position=1600110000&ravLicenseType=1&regionId=1'>购买页</a>购买开通",
+  'error.10004': "摄像头/麦克风权限被拒绝，请检查浏览器设置，确保已允许使用您的摄像头和麦克风。如果您确认已授予权限，请前往<a href='https://web.sdk.qcloud.com/trtc/webrtc/demo/detect/index.html'>音视频能力检测</a>检查您的设备和环境是否支持通话",
+  'error.10005': "未检测到麦克风设备。请确保您的设备已连接麦克风，并检查系统或浏览器设置中麦克风是否可用。",
+  'error.10006': "未检测到摄像头设备。请确保您的摄像头已连接，并检查系统或浏览器设置中摄像头是否可用。",
+  'error.10007': "当前浏览器环境不支持 WebRTC 功能。请前往<a href='https://web.sdk.qcloud.com/trtc/webrtc/demo/detect/index.html'>音视频能力检测</a>检查您的设备和环境兼容性",
+  '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': '错误',
 };

package/src/TUICallService/utils/validate/validateStatus.ts

@@ -0,0 +1,26 @@
+import { NAME } from "../../const/index";
+import { t } from '../../locales/index';
+
+interface IStatusValidateParams {
+  engineInstance?: boolean;
+}
+
+export function statusValidate (config: IStatusValidateParams) {
+	return function (target, propertyName: string, descriptor: PropertyDescriptor) {
+    let method = descriptor.value;
+    descriptor.value = function (...args: Array<any>) {
+      doValidate.call(this, config, args, propertyName);
+      return method.apply(this, args);
+		};
+    return descriptor;
+  };
+}
+
+function doValidate(config) {
+  if (config?.engineInstance && !this._tuiCallEngine) {
+    const error = `${NAME.PREFIX} ${t('TUICallKit init is not complete')}`;
+    console.error(error);
+    throw error;
+  }
+}
+

package/src/index.ts

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