easemob-chat-uikit 2.3.2-beta.2 → 2.4.0

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "easemob-chat-uikit",
-  "version": "2.3.2-beta.2",
-  "description": "",
+  "version": "2.4.0",
+  "description": "Easemob UIKit for React - A comprehensive React UI component library for building instant messaging applications with chat, voice/video calling, and group management features",
   "main": "ChatUI.umd.js",
   "type": "module",
   "module": "ChatUI.esm.js",

package/types/component/icon/const.d.ts

@@ -113,6 +113,7 @@ declare enum ICON_TYPES {
     BAR_SQUARE_FILL = "BAR_SQUARE_FILL",
     DOC_LOCK = "DOC_LOCK",
     BOX_UP_ARROW = "BOX_UP_ARROW",
-    SHIELD_STAR = "SHIELD_STAR"
+    SHIELD_STAR = "SHIELD_STAR",
+    CAMERA_FILL_ARROWS = "CAMERA_FILL_ARROWS"
 }
 export { ICON_TYPES };

package/types/module/callkit/components/CallControls.d.ts

@@ -18,6 +18,7 @@ export interface CallControlsProps {
     onCameraToggle?: (enabled: boolean) => void;
     onSpeakerToggle?: (enabled: boolean) => void;
     onScreenShareToggle?: (sharing: boolean) => void;
+    onCameraFlip?: (deviceId: string) => void;
     onHangup?: () => void;
     onPreviewAccept?: () => void;
     onPreviewReject?: () => void;

package/types/module/callkit/hooks/useCameraDevices.d.ts

@@ -0,0 +1,27 @@
+export interface CameraDevice {
+    deviceId: string;
+    label: string;
+    facingMode?: 'user' | 'environment';
+}
+export interface UseCameraDevicesResult {
+    /** 摄像头设备列表（只包含前后主摄像头） */
+    cameras: CameraDevice[];
+    /** 当前选中的摄像头索引 */
+    currentCameraIndex: number;
+    /** 是否有多个摄像头（>=2）*/
+    hasMultipleCameras: boolean;
+    /** 是否已获得摄像头权限（deviceId 不为空）*/
+    hasPermission: boolean;
+    /** 是否正在加载设备列表 */
+    isLoading: boolean;
+    /** 切换到下一个摄像头，返回新的 deviceId */
+    flipCamera: () => string | null;
+}
+/**
+ * 获取摄像头设备列表的 hook
+ * - 只返回前后两个主摄像头（过滤掉广角、超广角等）
+ * - 使用 enumerateDevices + label 分析，不调用 getUserMedia，避免与 RTC SDK 冲突
+ * - 使用 localStorage 缓存
+ * - 提供翻转摄像头功能
+ */
+export declare const useCameraDevices: () => UseCameraDevicesResult;

package/types/module/callkit/services/CallService.d.ts

@@ -106,6 +106,7 @@ export declare class CallService {
     private invitedMembers;
     private userInfos;
     private localVideoStream;
+    private currentCameraDeviceId;
     private hasEnteredPreview;
     private isAnswering;
     private remoteVideoTracks;
@@ -202,6 +203,7 @@ export declare class CallService {
     setSpeakerVolume(volume: number): void;
     isMuted(): boolean;
     isCameraEnabled(): boolean;
+    flipCamera(deviceId: string): Promise<boolean>;
     getJoinedMembers(): any[];
     refreshLocalVideoStatus(): void;
     playLocalVideoManually(): void;

package/types/module/callkit/types/index.d.ts

@@ -210,6 +210,7 @@ export interface CallKitProps {
     onMuteToggle?: (muted: boolean) => void;
     onCameraToggle?: (enabled: boolean) => void;
     onSpeakerToggle?: (enabled: boolean) => void;
+    onCameraFlip?: (deviceId: string, success: boolean) => void;
     onScreenShareToggle?: (sharing: boolean) => void;
     onHangup?: () => void;
     onAddParticipant?: (event: React.MouseEvent) => void;
@@ -248,6 +249,7 @@ export interface CallControlsIconMap {
     micOff?: CustomIconComponent;
     cameraOn?: CustomIconComponent;
     cameraOff?: CustomIconComponent;
+    cameraFlip?: CustomIconComponent;
     speakerOn?: CustomIconComponent;
     speakerOff?: CustomIconComponent;
     hangup?: CustomIconComponent;

package/types/module/callkit/types/layout.d.ts

@@ -40,6 +40,7 @@ export interface FullLayoutProps extends BaseLayoutProps {
     onMuteToggle?: (muted: boolean) => void;
     onCameraToggle?: (enabled: boolean) => void;
     onSpeakerToggle?: (enabled: boolean) => void;
+    onCameraFlip?: (deviceId: string) => void;
     onScreenShareToggle?: (sharing: boolean) => void;
     onHangup?: () => void;
     onAddParticipant?: (event: React.MouseEvent) => void;

package/types/module/store/Provider.d.ts

@@ -15,6 +15,7 @@ export interface ProviderProps {
         maxMessages?: number;
         isFixedDeviceId?: boolean;
         useOwnUploadFun?: boolean;
+        countMemberJoinToUnread?: boolean;
     };
     local?: {
         fallbackLng?: string;