call-live-sdk 1.0.0

package/dist/stores/callStore.d.ts

@@ -0,0 +1,225 @@
+import * as fabric from 'fabric';
+import { LoginResponseData, RTCMasterConfigResponse } from '@/api';
+/**
+ * 视频类型枚举
+ * 用于区分不同类型的视频流
+ */
+export declare enum VideoType {
+    /** 摄像头视频 */
+    CAMERA = "video",
+    /** 屏幕共享 */
+    SCREEN = "screen",
+    /** 主画面 */
+    MAIN = "main",
+    /** 屏幕共享主画面 */
+    SCREEN_MAIN = "screenmain",
+    /** 自视频 */
+    SELF = "self"
+}
+/**
+ * 用户状态枚举
+ * 用于标识用户在等候模式下的状态
+ */
+export declare enum WaitingModeState {
+    /** 未开启等候模式 */
+    NOT_ENABLED = 0,
+    /** 等候中 */
+    WAITING = 1,
+    /** 已准入 */
+    ADMITTED = 2
+}
+export interface CallUser extends LoginResponseData {
+    device: string;
+    isVideoDisabled?: boolean;
+    isAudioDisabled?: boolean;
+    isVideoEnabled?: boolean;
+    isAudioEnabled?: boolean;
+    isScreenEnabled?: boolean;
+    joinTime?: number;
+    waiting_mode_state: WaitingModeState;
+    videoList: [id: string, screenId: string, mainId: string];
+    isPublishStream?: boolean;
+    isVideoCapture?: boolean;
+    isSubscribeAudio?: boolean;
+}
+export declare enum LayoutMode {
+    MAIN_PLUS_LIST = "main_plus_list",// 主画布+连麦列表
+    GRID = "grid"
+}
+export interface StreamAreaConfig {
+    width: number;
+    height: number;
+    aspectRatio: number;
+}
+export interface LayoutCalculation {
+    mainArea: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    } | null;
+    callAreas: Array<{
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+        userId: string;
+        domId?: string;
+        nickname?: string;
+        device: string;
+        isVideoEnabled?: boolean;
+        isAudioEnabled?: boolean;
+        isScreenEnabled?: boolean;
+    }>;
+}
+export type RuleType = '' | 'main' | 'sub';
+interface Scene {
+    fabricObject: fabric.Object[];
+    documentInfo: any;
+    audioStates: Map<any, any>;
+    documentIndex: number;
+    documentScrollLeft: number;
+}
+interface Scenes {
+    [key: string]: Scene;
+}
+export interface CallConfig extends RTCMasterConfigResponse, LoginResponseData {
+    rule: RuleType;
+    isCall: boolean;
+    isAudioEnabled: boolean;
+    isScreenEnabled: boolean;
+    isVideoEnabled: boolean;
+    micConnectPermission: 0 | 1;
+    backgroundImg: string;
+    media_devices: {
+        cameraId: string;
+        microphoneId: string;
+        mirrorEnabled: boolean;
+    } | null;
+}
+export interface CallStoreState {
+    getter: () => Partial<CallStoreState>;
+    getInitialScenes: () => Scenes;
+    fabricObjects: fabric.Object[];
+    setFabricObjects: (objects: fabric.Object[] | ((prev: fabric.Object[]) => fabric.Object[])) => void;
+    documentInfo: any;
+    setDocumentInfo: (info: any) => void;
+    currentScene: string;
+    setCurrentScene: (scene: string) => void;
+    documentScrollLeft: number;
+    setDocumentScrollLeft: (value: number) => void;
+    documentIndex: number;
+    setDocumentIndex: (value: number) => void;
+    scenes: Scenes;
+    setScenes: (scenes: Scenes | ((prev: Scenes) => Scenes)) => void;
+    updateScene: (sceneKey: string, scene: Partial<Scene> | ((prev: Scene) => Partial<Scene>)) => void;
+    callConfig: CallConfig;
+    callCurrentUser: CallUser | undefined;
+    mainCanvasId: string;
+    currentMainVideoType: Exclude<VideoType, VideoType.CAMERA>;
+    isVoiceChatOpen: boolean;
+    isRightSidebarCollapsed: boolean;
+    callUsers: CallUser[];
+    layoutMode: LayoutMode;
+    rtc: any;
+    fabricInstance: any;
+    compositeCanvasRef: HTMLCanvasElement | null;
+    compositeContextRef: CanvasRenderingContext2D | null;
+    callAudioStreamsRef: MediaStream[];
+    videoList: (CallUser & {
+        domId: string;
+    })[];
+    callUsersCurrentPageRef: number;
+    offscreenCanvasRef: HTMLCanvasElement | null;
+    offscreenContextRef: CanvasRenderingContext2D | null;
+    backgroundImageRef: HTMLImageElement | null;
+    lastBackgroundImgUrlRef: string;
+    toggleRightSidebar: (collapsed?: boolean) => void;
+    removeCallUser: (userId: string) => void;
+    kickRoomUser: (userId: string, forbiddenInterval?: number) => Promise<void>;
+    updateCallConfig: (updates: Partial<CallConfig>) => void;
+    updateCallUser: (userId: string, updates: Partial<CallUser>) => CallUser | undefined;
+    activeUsers: CallUser[];
+    waitingUsers: CallUser[];
+    joinCallUser: (remoteUser?: CallUser) => CallUser | false;
+    addRemoteUser: (remoteUser: CallUser) => CallUser | false;
+    addLocalUser: () => CallUser | false;
+    isUserExists: (rtc_userid: string) => boolean;
+    validateCallConfig: () => {
+        isValid: boolean;
+        errors: string[];
+    };
+    leave: (liveId?: number, agentId?: number) => void;
+    leaveRemoteUser: (userId: string) => void;
+    switchLayoutMode: (mode: LayoutMode) => void;
+    calculateLayout: () => LayoutCalculation;
+    calculateMainPlusListLayout: (width: number, height: number) => LayoutCalculation;
+    calculateGridLayout: (width: number, height: number) => LayoutCalculation;
+    calculateMainOnlyLayout: (width: number, height: number) => LayoutCalculation;
+    initCompositeCanvas: () => HTMLCanvasElement | null;
+    renderCompositeFrameSmooth: () => void;
+    setMainCanvasId: (mainCanvasId: string) => void;
+    setCallUsers: (callUsers: CallUser[]) => void;
+    setCallConfig: (callConfig: CallConfig) => void;
+    setIsVoiceChatOpen: (isVoiceChatOpen: boolean) => void;
+    setCallCurrentUser: (callCurrentUser: CallUser | undefined) => void;
+    setCurrentMainVideoType: (currentMainVideoType: Exclude<VideoType, VideoType.CAMERA>) => void;
+    getCallConfig: () => CallConfig;
+    setRtc: (rtc: any) => void;
+    setFabricInstance: (fabricInstance: any) => void;
+    setCompositeCanvasRef: (compositeCanvasRef: HTMLCanvasElement | null) => void;
+    setCompositeContextRef: (compositeContextRef: CanvasRenderingContext2D | null) => void;
+    setCallAudioStreamsRef: (callAudioStreamsRef: MediaStream[]) => void;
+    setVideoList: (videoList: (CallUser & {
+        domId: string;
+    })[]) => void;
+    setCallUsersCurrentPageRef: (callUsersCurrentPageRef: number) => void;
+    setOffscreenCanvasRef: (offscreenCanvasRef: HTMLCanvasElement | null) => void;
+    setOffscreenContextRef: (offscreenContextRef: CanvasRenderingContext2D | null) => void;
+    setBackgroundImageRef: (backgroundImageRef: HTMLImageElement | null) => void;
+    setLastBackgroundImgUrlRef: (lastBackgroundImgUrlRef: string) => void;
+    filterCallUsers: (a: Partial<CallUser>) => CallUser[];
+    drawUserVideoContent: (context: CanvasRenderingContext2D, videoElement: HTMLVideoElement, user: any, x: number, y: number, width: number, height: number) => void;
+    drawUserInfo: (context: CanvasRenderingContext2D, user: any, x: number, y: number, width: number, height: number) => void;
+    drawStatusIndicators: (context: CanvasRenderingContext2D, user: any, x: number, y: number, width: number) => void;
+    drawStatusIndicator: (context: CanvasRenderingContext2D, x: number, y: number, width: number, statusY: number, offset: number, type: 'audio' | 'video') => void;
+    renderEmptyUserArea: (context: CanvasRenderingContext2D, user: any, x: number, y: number, width: number, height: number) => void;
+    canvasRequestRenderAll: () => void;
+    findCallUserById: (id: string) => CallUser | undefined;
+    changeAudioState: (id: string, isAudio: boolean) => void;
+    changeVideoState: (id: string, isVideo: boolean) => void;
+    toggleAudio: (isAudio?: boolean) => Promise<{
+        success: boolean;
+        message: string;
+        isEnabled?: boolean;
+        error?: any;
+    }>;
+    toggleVideo: (isVideo?: boolean) => Promise<{
+        success: boolean;
+        message: string;
+        isEnabled?: boolean;
+        error?: any;
+    }>;
+    toggleScreenShare: (isScreen?: boolean) => Promise<{
+        success: boolean;
+        message: string;
+        isEnabled?: boolean;
+        error?: any;
+    }>;
+    callAudioMixing: () => void;
+    handleRemoteUserPublishScreen: (userId: string, isPublishing: boolean) => void;
+    handleRemoteUserUnpublishScreen: (event: {
+        userId: string;
+        mediaType: any;
+    }) => Promise<void>;
+}
+export declare const useCallStore: import("zustand").UseBoundStore<Omit<import("zustand").StoreApi<CallStoreState>, "subscribe"> & {
+    subscribe: {
+        (listener: (selectedState: CallStoreState, previousSelectedState: CallStoreState) => void): () => void;
+        <U>(selector: (state: CallStoreState) => U, listener: (selectedState: U, previousSelectedState: U) => void, options?: {
+            equalityFn?: (a: U, b: U) => boolean;
+            fireImmediately?: boolean;
+        }): () => void;
+    };
+}>;
+export {};

package/dist/stores/commentChatUrl.d.ts

@@ -0,0 +1,6 @@
+interface CommentChatUrlState {
+    webTransportUrl: string;
+    fetChatUrl: (params: any) => Promise<void>;
+}
+declare const useCommentChatUrlStore: import("zustand").UseBoundStore<import("zustand").StoreApi<CommentChatUrlState>>;
+export default useCommentChatUrlStore;

package/dist/stores/commentRtmpStats.d.ts

@@ -0,0 +1,6 @@
+interface CommentRtmpStatsState {
+    rtmpStats: any;
+    setRtmpStats: (stats: any) => void;
+}
+declare const useCommentRtmpStatsStore: import("zustand").UseBoundStore<import("zustand").StoreApi<CommentRtmpStatsState>>;
+export default useCommentRtmpStatsStore;

package/dist/stores/commentSocket.d.ts

@@ -0,0 +1,26 @@
+interface MessageData {
+    type: 'comment_delete' | 'chat_forward' | 'activity_config_change' | string;
+    data: Record<string, any>;
+}
+interface WebSocketMessage {
+    data: string;
+}
+interface CommentSocketState {
+    chat_url: string;
+    commentItem: Record<string, any>;
+    commentDeleteItem: Record<string, any>;
+    activityConfigChange: Record<string, any>;
+    rtmUrl: string;
+    webTransportUrl: string;
+    readyState: number;
+    latestMessage: WebSocketMessage | undefined;
+    sendMessage: ((message: string) => void) | undefined;
+    disconnect: (() => void) | undefined;
+    fetChatUrl: (id: number) => Promise<void>;
+    setCallback: (callback: (message: MessageData['data']) => void) => void;
+}
+declare const useCommentSocketStore: import("zustand").UseBoundStore<import("zustand").StoreApi<CommentSocketState>>;
+export declare function useCommentSocket(): CommentSocketState;
+export declare const getCommentSocketState: () => CommentSocketState;
+export declare const setCommentSocketState: (partial: CommentSocketState | Partial<CommentSocketState> | ((state: CommentSocketState) => CommentSocketState | Partial<CommentSocketState>), replace?: boolean | undefined) => void;
+export default useCommentSocketStore;

package/dist/stores/counterStore.d.ts

@@ -0,0 +1,9 @@
+interface CounterState {
+    count: number;
+    increment: () => void;
+    decrement: () => void;
+    reset: () => void;
+    incrementBy: (amount: number) => void;
+}
+export declare const useCounterStore: import("zustand").UseBoundStore<import("zustand").StoreApi<CounterState>>;
+export {};

package/dist/stores/currentUser.d.ts

@@ -0,0 +1,6 @@
+interface CurrentUserState {
+    currentUser: any | null;
+    setCurrentUser: (user: any | null) => void;
+}
+export declare const useCurrentUserStore: import("zustand").UseBoundStore<import("zustand").StoreApi<CurrentUserState>>;
+export {};

package/dist/stores/drawingToolsStore.d.ts

@@ -0,0 +1,62 @@
+interface DrawingToolsState {
+    selectedTool: number;
+    setSelectedTool: (tool: number) => void;
+    penSize: number;
+    setPenSize: (size: number | ((prev: number) => number)) => void;
+    penColor: string;
+    setPenColor: (color: string | ((prev: string) => string)) => void;
+    penSizeRef: {
+        current: number;
+    };
+    penColorRef: {
+        current: string;
+    };
+    laserPenSize: number;
+    setLaserPenSize: (size: number | ((prev: number) => number)) => void;
+    laserPenColor: string;
+    setLaserPenColor: (color: string | ((prev: string) => string)) => void;
+    laserPenSizeRef: {
+        current: number;
+    };
+    laserPenColorRef: {
+        current: string;
+    };
+    shapeSize: number;
+    setShapeSize: (size: number | ((prev: number) => number)) => void;
+    shapeType: string;
+    setShapeType: (type: string | ((prev: string) => string)) => void;
+    shapeColor: string;
+    setShapeColor: (color: string | ((prev: string) => string)) => void;
+    shapeSizeRef: {
+        current: number;
+    };
+    shapeTypeRef: {
+        current: string;
+    };
+    shapeColorRef: {
+        current: string;
+    };
+    textSize: number;
+    setTextSize: (size: number | ((prev: number) => number)) => void;
+    textColor: string;
+    setTextColor: (color: string | ((prev: string) => string)) => void;
+    textSizeRef: {
+        current: number;
+    };
+    textColorRef: {
+        current: string;
+    };
+    isPreviewModalVisible: boolean;
+    setIsPreviewModalVisible: (visible: boolean) => void;
+    downPoint: {
+        current: any;
+    };
+    upPoint: {
+        current: any;
+    };
+    currentShape: {
+        current: any;
+    };
+}
+declare const useDrawingToolsStore: import("zustand").UseBoundStore<import("zustand").StoreApi<DrawingToolsState>>;
+export default useDrawingToolsStore;

package/dist/stores/guest.d.ts

@@ -0,0 +1,8 @@
+interface GuestStateType {
+    status: 0 | 1;
+    deviceType: 'pc' | 'mobile';
+    setDeviceType: (deviceType: 'pc' | 'mobile') => void;
+    setStatus: (status: 0 | 1) => void;
+}
+export declare const useGuestStore: import("zustand").UseBoundStore<import("zustand").StoreApi<GuestStateType>>;
+export {};

package/dist/stores/liveInfo.d.ts

@@ -0,0 +1,21 @@
+interface LiveInfoState {
+    data: any;
+    loading: boolean;
+    error: Error | undefined;
+    run: (live_id: string | number) => void;
+    cancel: () => void;
+    refresh: () => void;
+}
+export declare const useLiveInfoStore: import("zustand").UseBoundStore<import("zustand").StoreApi<LiveInfoState>>;
+export declare function useLiveInfo(): {
+    requestResult: import("ahooks/lib/useRequest/src/types").Result<import("@/api/request").ResponseData<any>, [live_id: any]>;
+    data: any;
+    loading: boolean;
+    error: Error | undefined;
+    run: (live_id: string | number) => void;
+    cancel: () => void;
+    refresh: () => void;
+};
+export declare const getLiveInfoState: () => LiveInfoState;
+export declare const setLiveInfoState: (partial: LiveInfoState | Partial<LiveInfoState> | ((state: LiveInfoState) => LiveInfoState | Partial<LiveInfoState>), replace?: boolean | undefined) => void;
+export {};

package/dist/stores/livepushcode.d.ts

@@ -0,0 +1,37 @@
+interface LivePushCode {
+    [key: string]: any;
+}
+interface LivePushCodeStore {
+    livePushCode: LivePushCode | null;
+    isLoading: boolean;
+    error: string | null;
+    fetchLivePush: (live_id: number) => Promise<LivePushCode | undefined>;
+    setLivePushCode: (code: LivePushCode) => void;
+    clearLivePushCode: () => void;
+}
+/**
+ * 直播推流码状态存储
+ * 用于管理直播推流码的获取和状态
+ */
+export declare const useLivePushCodeStore: import("zustand").UseBoundStore<import("zustand").StoreApi<LivePushCodeStore>>;
+/**
+ * 获取直播推流码的Hook
+ * @returns 直播推流码数据或null
+ */
+export declare const useLivePushCode: () => LivePushCode;
+/**
+ * 获取直播推流码加载状态的Hook
+ * @returns 加载状态
+ */
+export declare const useLivePushCodeLoading: () => boolean;
+/**
+ * 获取直播推流码错误信息的Hook
+ * @returns 错误信息或null
+ */
+export declare const useLivePushCodeError: () => string;
+/**
+ * 获取直播推流码获取方法的Hook
+ * @returns 获取推流码的方法
+ */
+export declare const useFetchLivePushCode: () => (live_id: number) => Promise<LivePushCode | undefined>;
+export {};

package/dist/stores/sdkStore.d.ts

@@ -0,0 +1,44 @@
+import { CallSDKConfig, GuestSDKConfig } from '../types/sdk';
+export declare enum GlobalErrorType {
+    /** 接口报错 */
+    API_ERROR = "api_error",
+    /** Token过期 */
+    TOKEN_EXPIRED = "token_expired",
+    /** SDK参数校验错误 */
+    PARAM_VALIDATION_ERROR = "param_validation_error",
+    /** 其他错误 */
+    OTHER_ERROR = "other_error"
+}
+export interface GlobalError {
+    type: GlobalErrorType;
+    code: number;
+    message: string;
+    details?: any;
+}
+interface SdkStore {
+    callConfig: CallSDKConfig | null;
+    setCallConfig: (config: CallSDKConfig) => void;
+    getLiveId: () => number | undefined;
+    updateCallConfig: (partialConfig: Partial<CallSDKConfig>) => void;
+    guestConfig: GuestSDKConfig | null;
+    setGuestConfig: (config: GuestSDKConfig) => void;
+    globalError: GlobalError | null;
+    setGlobalError: (error: GlobalError | null) => void;
+    clearGlobalError: () => void;
+}
+/**
+ * SDK配置状态存储
+ * 用于管理SDK的全局配置，包括直播ID等关键信息
+ */
+export declare const useSdkStore: import("zustand").UseBoundStore<import("zustand").StoreApi<SdkStore>>;
+/**
+ * 获取SDK配置的Hook
+ * @returns SDK配置对象或null
+ */
+export declare const useSdkConfig: () => CallSDKConfig;
+/**
+ * 获取直播ID的Hook
+ * @returns 直播ID字符串或undefined
+ */
+export declare const useLiveId: () => number;
+export {};

package/dist/types/sdk.d.ts

@@ -0,0 +1,42 @@
+export interface LiveConfig {
+    /** 直播ID */
+    id: number;
+    /** 直播标题 */
+    title: string;
+}
+export interface ComponentsConfig {
+    /** 是否启用聊天功能 */
+    chat: {
+        enabled: boolean;
+    };
+    /** 是否启用团队功能 */
+    team: {
+        enabled: boolean;
+    };
+    /** 是否启用连麦功能 */
+    call: {
+        enabled: boolean;
+        inviteLink: string;
+        agent_id: number;
+    };
+}
+export interface CallSDKConfig {
+    /** 挂载元素 */
+    el: HTMLElement | string;
+    /** 直播配置 */
+    live: LiveConfig;
+    /** 签名信息 */
+    sign: string;
+    /** 组件配置 */
+    components: ComponentsConfig;
+}
+export interface GuestSDKConfig {
+    /** 挂载元素 */
+    el: HTMLElement | string;
+    /** 直播ID */
+    liveId: number;
+    /** 访问令牌 */
+    sign: string;
+    /** 客服ID */
+    agentId: number;
+}

package/dist/utils/common.d.ts

@@ -0,0 +1,10 @@
+export declare const generateGID: (expire?: number) => string;
+export declare function toFixed(value: number, maxFractionDigits?: number): string;
+export declare function withResolvers<T, E = any>(): {
+    promise: Promise<T>;
+    resolve: (value: T | PromiseLike<T>) => void;
+    reject: (reason?: E) => void;
+};
+export declare function excludeNull<T extends Object>(obj: T): T;
+export declare function formatDuration(duration: number, limitMinutes?: boolean): string;
+export declare function formatReqData(data: object | object[]): any;

package/dist/utils/env.d.ts

@@ -0,0 +1,35 @@
+/**
+ * 环境变量工具函数
+ * 用于安全地访问环境变量，并提供默认值
+ */
+/**
+ * 获取环境变量
+ * @param key 环境变量键名
+ * @param defaultValue 默认值
+ * @returns 环境变量值或默认值
+ */
+export declare const getEnv: <T = string>(key: string, defaultValue: T) => T;
+/**
+ * 应用配置
+ * 统一管理应用的配置参数，从环境变量中获取
+ */
+export declare const appConfig: {
+    api: {
+        baseUrl: string;
+    };
+    app: {
+        name: string;
+        version: string;
+        env: string;
+    };
+    debug: boolean;
+};
+/**
+ * 日志工具，根据环境变量控制日志输出
+ */
+export declare const logger: {
+    log: (...args: any[]) => void;
+    error: (...args: any[]) => void;
+    warn: (...args: any[]) => void;
+    info: (...args: any[]) => void;
+};

package/dist/utils/eventbus.d.ts

@@ -0,0 +1,2 @@
+import EventEmitter from 'events';
+export declare const eventBus: EventEmitter<[never]>;

package/dist/utils/resource.d.ts

@@ -0,0 +1,9 @@
+export declare function canvasToBlob(canvas: HTMLCanvasElement | OffscreenCanvas): Promise<Blob>;
+export declare function scaleImage({ max, ratio, blob, }: {
+    max?: number;
+    ratio?: number;
+    blob: Blob;
+}): Promise<Blob> | {
+    new (blobParts?: BlobPart[], options?: BlobPropertyBag): Blob;
+    prototype: Blob;
+};

package/dist/utils/utiles.d.ts

@@ -0,0 +1,19 @@
+export declare const isMobile: boolean;
+/**
+ * 检测麦克风设备权限
+ * @returns {Promise<boolean>} 返回一个Promise，解析为布尔值，表示是否有麦克风权限
+ */
+export declare const checkMicrophonePermission: () => Promise<boolean>;
+/**
+ * 检测摄像头设备权限
+ * @returns {Promise<boolean>} 返回一个Promise，解析为布尔值，表示是否有摄像头权限
+ */
+export declare const checkCameraPermission: () => Promise<boolean>;
+/**
+ * 检测麦克风和摄像头设备权限
+ * @returns {Promise<{microphone: boolean, camera: boolean}>} 返回一个Promise，解析为包含麦克风和摄像头权限状态的对象
+ */
+export declare const checkMediaPermissions: () => Promise<{
+    microphone: boolean;
+    camera: boolean;
+}>;

package/dist/utils/variable.d.ts

@@ -0,0 +1,25 @@
+/**
+ * 环境变量配置文件
+ * 统一管理所有环境变量，提供类型安全的访问方式
+ */
+export interface EnvConfig {
+    env: string;
+    amapKey: string;
+    amapCode: string;
+    queenSdkKey: string;
+    liveProxyUrl: string;
+    tvProxyUrl: string;
+    callProxyUrl: string;
+    wxAppId: string;
+}
+declare const _default: {
+    env: any;
+    amapKey: any;
+    amapCode: any;
+    queenSdkKey: any;
+    liveProxyUrl: any;
+    tvProxyUrl: any;
+    callProxyUrl: any;
+    wxAppId: any;
+};
+export default _default;