@trtc/calls-uikit-react 4.5.11 → 4.6.0

package/types/Components/components/common/PermissionDialog/DevicePermissionBanner.d.ts

@@ -0,0 +1 @@
+export default function DevicePermissionBanner(): import("react/jsx-runtime").JSX.Element;

package/types/Components/components/common/PermissionDialog/index.d.ts

@@ -0,0 +1,2 @@
+import DevicePermissionBanner from './DevicePermissionBanner';
+export default DevicePermissionBanner;

package/types/TUICallService/CallService/index.d.ts

@@ -18,6 +18,7 @@ export default class TUICallService {
     private _currentGroupId;
     private _offlinePushInfo;
     private _permissionCheckTimer;
+    private _deviceErrorCodes;
     private _chatCombine;
     private _engineEventHandler;
     private _wasmReadyPromise;
@@ -51,6 +52,7 @@ export default class TUICallService {
     setCameraDefaultState(isOpen: boolean): void;
     callExperimentalAPI(jsonStr: string): void;
     accept(): Promise<void>;
+    _doAccept(): Promise<void>;
     private _handleAcceptResponse;
     hangup(): Promise<void>;
     reject(): Promise<void>;
@@ -84,6 +86,34 @@ export default class TUICallService {
     setVideoDisplayMode(displayMode: VideoDisplayMode): void;
     setVideoResolution(resolution: VideoResolution): Promise<void>;
     startTimer(): void;
+    /**
+     * Check device permissions after call/accept succeeds.
+     * 1. Show an error toast summarizing unavailable devices.
+     * 2. Store the unavailable-device reasons so the banner bar and button badges
+     *    can render accordingly (aligned with interaction design).
+     */
+    private _updateDeviceUnavailableHints;
+    /**
+     * Resolve the classified reasons for currently unavailable devices from the engine's
+     * cached permission. Returns null when all required devices are available; otherwise
+     * returns the per-device reason. Derived values (whether it is a permission issue,
+     * device-name text) are computed by the UI from these reasons.
+     */
+    private _resolveUnavailableDevices;
+    private _classifyDeviceErrorReason;
+    /**
+     * Probe device permission by reusing engine's device permission check, which
+     * triggers getUserMedia and classifies the failure (incl. iOS repeated-call and
+     * http protocol handling). The thrown error's code is cached per device so the
+     * service layer can decide device availability without engine-side errorName.
+     * Audio and video are probed separately because engine aborts on the first failure.
+     */
+    probeDevicePermission(opts: {
+        audio?: boolean;
+        video?: boolean;
+    }): Promise<void>;
+    resetDeviceError(type: 'audio' | 'video'): void;
+    isDeviceKnownUnavailable(type: 'audio' | 'video'): boolean;
     private _handleCallError;
     private _updateCallStoreBeforeCall;
     private _updateCallStoreAfterCall;

package/types/TUICallService/const/index.d.ts

@@ -8,6 +8,19 @@ export declare const PUSHER_ID: {
     NEW_PUSHER: string;
 };
 export declare const NAME: any;
+export type DeviceErrorReason = 'no-permission' | 'no-device' | 'device-occupied' | 'unknown' | null;
+export interface DeviceUnavailableReasons {
+    microphone: DeviceErrorReason;
+    camera: DeviceErrorReason;
+}
+export declare const DEVICE_ERROR_CODE: {
+    NONE: number;
+    PERMISSION_DENIED: number;
+    NO_MICROPHONE: number;
+    NO_CAMERA: number;
+    MICROPHONE_NOT_READABLE: number;
+    CAMERA_NOT_READABLE: number;
+};
 export declare const AudioCallIcon = "https://web.sdk.qcloud.com/component/TUIKit/assets/call.png";
 export declare const VideoCallIcon = "https://web.sdk.qcloud.com/component/TUIKit/assets/call-video-reverse.svg";
 export declare const MAX_NUMBER_ROOM_ID = 2147483647;

package/types/TUICallService/index.d.ts

@@ -1,5 +1,5 @@
 import TUICallService, { TUIGlobal, TUIStore, uiDesign } from './CallService/index';
 import { StoreName, NAME, CallRole, CallMediaType, CallStatus, StatusChange, VideoResolution, VideoDisplayMode, AudioPlayBackDevice, FeatureButton, LayoutMode, CloudRecordPolicy } from './const/index';
-import { t } from './locales/index';
+import { t, buildDeviceUnavailableText } from './locales/index';
 declare const TUICallKitAPI: TUICallService;
-export { TUIGlobal, TUIStore, StoreName, TUICallKitAPI, NAME, CallStatus, CallRole, CallMediaType, StatusChange, VideoResolution, VideoDisplayMode, AudioPlayBackDevice, t, uiDesign, FeatureButton, LayoutMode, CloudRecordPolicy, };
+export { TUIGlobal, TUIStore, StoreName, TUICallKitAPI, NAME, CallStatus, CallRole, CallMediaType, StatusChange, VideoResolution, VideoDisplayMode, AudioPlayBackDevice, t, buildDeviceUnavailableText, uiDesign, FeatureButton, LayoutMode, CloudRecordPolicy, };

package/types/TUICallService/interface/ICallStore.d.ts

@@ -1,4 +1,4 @@
-import { CallStatus, CallRole, CallMediaType, VideoDisplayMode, VideoResolution, TDeviceList, CameraPosition, ICustomUIConfig } from '../const/index';
+import { CallStatus, CallRole, CallMediaType, VideoDisplayMode, VideoResolution, TDeviceList, CameraPosition, ICustomUIConfig, DeviceUnavailableReasons } from '../const/index';
 import { IUserInfo, INetWorkQuality } from './index';
 export interface IToastInfo {
     text: string;
@@ -49,4 +49,5 @@ export interface ICallStore {
     realtimeMessageList: [];
     isAITranscriberEnabled: boolean;
     isAITranscriberRunning: boolean;
+    deviceUnavailableReasons: DeviceUnavailableReasons | null;
 }

package/types/TUICallService/locales/en.d.ts

@@ -44,6 +44,10 @@ export declare const en: {
     'camera disabled': string;
     'microphone enabled': string;
     'microphone disabled': string;
+    'no mic permission': string;
+    'no mic device': string;
+    'no cam permission': string;
+    'no cam device': string;
     'speaker enabled': string;
     'speaker disabled': string;
     'open speaker': string;
@@ -144,6 +148,27 @@ export declare const en: {
     'error.10017': string;
     'error.10018': string;
     error: string;
+    'permission-device-separator': string;
+    'permission-phrase-separator': string;
+    'permission-sentence-separator': string;
+    'permission-phrase-perm': string;
+    'permission-phrase-no-device': string;
+    'permission-phrase-occupied': string;
+    'permission-phrase-unknown': string;
+    'permission-toast-suffix': string;
+    'permission-toast-raw': string;
+    'permission-banner-guide-perm': string;
+    'permission-banner-guide-perm-h5': string;
+    'permission-banner-guide-no-device': string;
+    'permission-banner-guide-no-device-h5': string;
+    'permission-btn-mic-no-perm': string;
+    'permission-btn-mic-no-device': string;
+    'permission-btn-mic-occupied': string;
+    'permission-btn-cam-no-perm': string;
+    'permission-btn-cam-no-device': string;
+    'permission-btn-cam-occupied': string;
+    'permission-btn-mic-no-perm-h5': string;
+    'permission-btn-cam-no-perm-h5': string;
     'ai-subtitle': string;
     'ai-subtitle-settings': string;
     'recognition-language': string;

package/types/TUICallService/locales/index.d.ts

@@ -7,4 +7,18 @@ interface languageItemType {
 interface languageDataType {
     [key: string]: languageItemType;
 }
+/**
+ * Build a device-unavailability message by grouping devices by their error reason,
+ * so each reason is described accurately. For example, when the microphone has no
+ * permission and the camera has no device, it produces
+ * "麦克风权限未开启，未检测到摄像头" instead of wrongly saying both lack permission.
+ *
+ * @param audioReason classified reason for the microphone, or null if available
+ * @param videoReason classified reason for the camera, or null if available
+ * @param scene 'plain' returns the grouped description only; 'toast' appends the
+ *        in-call suffix; 'banner' appends the guidance sentence
+ * @param isMobile selects PC vs H5 guidance text (banner only)
+ * @returns the composed localized text, or '' when no device is unavailable
+ */
+export declare function buildDeviceUnavailableText(audioReason: string | null, videoReason: string | null, scene: 'plain' | 'toast' | 'banner', isMobile?: boolean): string;
 export {};

package/types/TUICallService/locales/ja_JP.d.ts

@@ -54,6 +54,10 @@ export declare const ja_JP: {
     'camera disabled': string;
     'microphone enabled': string;
     'microphone disabled': string;
+    'no mic permission': string;
+    'no mic device': string;
+    'no cam permission': string;
+    'no cam device': string;
     'speaker enabled': string;
     'speaker disabled': string;
     'open speaker': string;
@@ -142,6 +146,27 @@ export declare const ja_JP: {
     'error.10017': string;
     'error.10018': string;
     error: string;
+    'permission-device-separator': string;
+    'permission-phrase-separator': string;
+    'permission-sentence-separator': string;
+    'permission-phrase-perm': string;
+    'permission-phrase-no-device': string;
+    'permission-phrase-occupied': string;
+    'permission-phrase-unknown': string;
+    'permission-toast-suffix': string;
+    'permission-toast-raw': string;
+    'permission-banner-guide-perm': string;
+    'permission-banner-guide-perm-h5': string;
+    'permission-banner-guide-no-device': string;
+    'permission-banner-guide-no-device-h5': string;
+    'permission-btn-mic-no-perm': string;
+    'permission-btn-mic-no-device': string;
+    'permission-btn-mic-occupied': string;
+    'permission-btn-cam-no-perm': string;
+    'permission-btn-cam-no-device': string;
+    'permission-btn-cam-occupied': string;
+    'permission-btn-mic-no-perm-h5': string;
+    'permission-btn-cam-no-perm-h5': string;
     'ai-subtitle': string;
     'ai-subtitle-settings': string;
     'recognition-language': string;

package/types/TUICallService/locales/zh-cn.d.ts

@@ -44,6 +44,10 @@ export declare const zh: {
     'camera disabled': string;
     'microphone enabled': string;
     'microphone disabled': string;
+    'no mic permission': string;
+    'no mic device': string;
+    'no cam permission': string;
+    'no cam device': string;
     'speaker enabled': string;
     'speaker disabled': string;
     'open speaker': string;
@@ -139,6 +143,27 @@ export declare const zh: {
     'error.10017': string;
     'error.10018': string;
     error: string;
+    'permission-device-separator': string;
+    'permission-phrase-separator': string;
+    'permission-sentence-separator': string;
+    'permission-phrase-perm': string;
+    'permission-phrase-no-device': string;
+    'permission-phrase-occupied': string;
+    'permission-phrase-unknown': string;
+    'permission-toast-suffix': string;
+    'permission-toast-raw': string;
+    'permission-banner-guide-perm': string;
+    'permission-banner-guide-perm-h5': string;
+    'permission-banner-guide-no-device': string;
+    'permission-banner-guide-no-device-h5': string;
+    'permission-btn-mic-no-perm': string;
+    'permission-btn-mic-no-device': string;
+    'permission-btn-mic-occupied': string;
+    'permission-btn-cam-no-perm': string;
+    'permission-btn-cam-no-device': string;
+    'permission-btn-cam-occupied': string;
+    'permission-btn-mic-no-perm-h5': string;
+    'permission-btn-cam-no-perm-h5': string;
     'ai-subtitle': string;
     'ai-subtitle-settings': string;
     'recognition-language': string;