call-live-sdk 1.0.0

package/dist/components/RightSidebar/components/CallComponent/features/meeting/hooks/useOnlineUsers.d.ts

@@ -0,0 +1,9 @@
+/**
+ * 在线用户管理Hook
+ * 负责用户列表的获取和分组逻辑
+ */
+export declare const useOnlineUsers: () => {
+    isLoading: boolean;
+    activeUsers: import("@/stores/callStore").CallUser[];
+    waitingUsers: import("@/stores/callStore").CallUser[];
+};

package/dist/components/RightSidebar/components/CallComponent/features/meeting/hooks/useUserActions.d.ts

@@ -0,0 +1,6 @@
+import type { UserActionCallbacks } from '../../../types';
+/**
+ * 用户操作管理Hook
+ * 负责用户相关的操作逻辑
+ */
+export declare const useUserActions: () => UserActionCallbacks;

package/dist/components/RightSidebar/components/CallComponent/features/waiting/components/WaitingUserList.d.ts

@@ -0,0 +1,11 @@
+import { FC } from 'react';
+interface WaitingUserListProps {
+    /** 等候中用户列表 */
+    waitingUsers: any[];
+}
+/**
+ * 等候中用户列表组件
+ * 负责渲染等候中的用户列表
+ */
+declare const WaitingUserList: FC<WaitingUserListProps>;
+export default WaitingUserList;

package/dist/components/RightSidebar/components/CallComponent/index.d.ts

@@ -0,0 +1,3 @@
+import CallComponent from './CallComponent';
+export default CallComponent;
+export type * from './types';

package/dist/components/RightSidebar/components/CallComponent/shared/ui/CallUser.d.ts

@@ -0,0 +1,14 @@
+import { CallUser as ICallUser } from '@/stores/callStore';
+import { FC } from 'react';
+/**
+ * 通话用户组件属性接口
+ */
+interface CallUserProps {
+    /** 用户数据 */
+    user: ICallUser;
+}
+/**
+ * 通话用户组件 - 管理单个用户的状态和交互
+ */
+declare const CallUser: FC<CallUserProps>;
+export default CallUser;

package/dist/components/RightSidebar/components/CallComponent/shared/ui/ErrorBoundary.d.ts

@@ -0,0 +1,22 @@
+import React, { Component, ReactNode } from 'react';
+interface ErrorBoundaryProps {
+    children: ReactNode;
+    fallback?: ReactNode;
+}
+interface ErrorBoundaryState {
+    hasError: boolean;
+    error?: Error;
+    errorInfo?: React.ErrorInfo;
+}
+/**
+ * 错误边界组件
+ * 捕获子组件中的JavaScript错误，并显示友好的错误界面
+ */
+declare class ErrorBoundary extends Component<ErrorBoundaryProps, ErrorBoundaryState> {
+    constructor(props: ErrorBoundaryProps);
+    static getDerivedStateFromError(error: Error): ErrorBoundaryState;
+    componentDidCatch(error: Error, errorInfo: React.ErrorInfo): void;
+    handleRetry: () => void;
+    render(): string | number | boolean | Iterable<React.ReactNode> | import("react/jsx-runtime").JSX.Element;
+}
+export default ErrorBoundary;

package/dist/components/RightSidebar/components/CallComponent/shared/ui/LoadingSpinner.d.ts

@@ -0,0 +1,19 @@
+import { FC } from 'react';
+interface LoadingSpinnerProps {
+    /** 加载提示文本 */
+    tip?: string;
+    /** 是否显示加载状态 */
+    spinning?: boolean;
+    /** 子组件 */
+    children?: React.ReactNode;
+    /** 大小 */
+    size?: 'small' | 'default' | 'large';
+    /** 自定义样式类名 */
+    className?: string;
+}
+/**
+ * 统一的加载组件
+ * 提供一致的加载体验
+ */
+declare const LoadingSpinner: FC<LoadingSpinnerProps>;
+export default LoadingSpinner;

package/dist/components/RightSidebar/components/CallComponent/types/index.d.ts

@@ -0,0 +1,55 @@
+/**
+ * CallComponent 相关类型定义
+ */
+import type { CallUser } from '@/stores/callStore';
+export type { CallUser };
+/**
+ * 用户操作回调接口
+ * 定义用户相关操作的回调函数类型，与CallUser组件期望的签名保持一致
+ */
+export interface UserActionCallbacks {
+    /** 更新用户名称 */
+    handleUpdateName: (userId: string, name: string) => void;
+    /** 移除用户 */
+    handleRemoveUser: (userId: string) => void;
+    /** 移至等候 */
+    handleMoveToWaiting: (userId: string) => void;
+    /** 处理麦克风封禁/解封 */
+    handleMicrophoneBan: (userId: string, isBanned: boolean) => void;
+    /** 处理麦克风开关 */
+    handleMicrophoneToggle: (userId: string, enabled: boolean) => void;
+    /** 处理摄像头封禁/解封 */
+    handleCameraBan: (userId: string, isBanned: boolean) => void;
+    /** 处理摄像头开关 */
+    handleCameraToggle: (userId: string, enabled: boolean) => void;
+    /** 邀请用户开启麦克风 */
+    handleInviteEnableMicrophone: (userId: string) => void;
+    /** 邀请用户开启摄像头 */
+    handleInviteEnableCamera: (userId: string) => void;
+}
+/**
+ * RTC配置接口
+ * 定义连麦相关的配置信息
+ */
+export interface RTCConfig {
+    /** 连麦是否开启 */
+    isCall: boolean;
+    /** 其他配置项... */
+    [key: string]: any;
+}
+export interface CallComponentState {
+    editingUserId: string | null;
+    isLoading: boolean;
+    isRTCConfigLoading: boolean;
+}
+export interface ConfigUpdateParams {
+    allow_guests_cancel_muted?: number;
+    enter_muted?: number;
+    lock_mode?: number;
+    waiting_mode?: number;
+}
+export interface BanOptions {
+    audio?: boolean;
+    video?: boolean;
+    isDisabled?: boolean;
+}

package/dist/components/RightSidebar/components/ChatComponent.d.ts

@@ -0,0 +1,2 @@
+declare const ChatComponent: () => import("react/jsx-runtime").JSX.Element;
+export default ChatComponent;

package/dist/components/RightSidebar/components/Prohibition.d.ts

@@ -0,0 +1,2 @@
+declare const Prohibition: ({ activityConfigChange }: any) => import("react/jsx-runtime").JSX.Element;
+export default Prohibition;

package/dist/components/RightSidebar/components/TeamComponent.d.ts

@@ -0,0 +1,2 @@
+declare const TeamComponent: () => import("react/jsx-runtime").JSX.Element;
+export default TeamComponent;

package/dist/components/RightSidebar/index.d.ts

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

package/dist/components/RtcJoomRoom/RtcJoomRoom.d.ts

@@ -0,0 +1,4 @@
+declare const _default: import("react").MemoExoticComponent<({ access }: {
+    access?: () => void;
+}) => import("react/jsx-runtime").JSX.Element>;
+export default _default;

package/dist/components/RtcJoomRoom/components/InviteConfirmModal.d.ts

@@ -0,0 +1,28 @@
+import React from 'react';
+/**
+ * 邀请确认弹窗的 Props 接口
+ */
+export interface InviteConfirmModalProps {
+    /** 弹窗是否可见 */
+    visible: boolean;
+    /** 邀请类型：麦克风或摄像头 */
+    inviteType: 'microphone' | 'camera';
+    /** 邀请发起人的昵称 */
+    inviterName: string;
+    /** 确认回调 - 用户点击同意 */
+    onConfirm: () => void;
+    /** 拒绝回调 - 用户点击拒绝 */
+    onReject: () => void;
+    /** 加载状态 - 处理用户选择时显示 */
+    loading?: boolean;
+    /** 是否为移动端 - 用于适配移动端展示（全屏/按钮布局等） */
+    isMobile?: boolean;
+}
+/**
+ * 邀请确认弹窗组件
+ *
+ * 当主持人邀请嘉宾开启麦克风或摄像头时显示，
+ * 提供同意/拒绝选项供嘉宾选择
+ */
+declare const InviteConfirmModal: React.FC<InviteConfirmModalProps>;
+export default InviteConfirmModal;

package/dist/components/RtcJoomRoom/hooks/useInviteConfirm.d.ts

@@ -0,0 +1,40 @@
+/**
+ * 邀请确认数据接口
+ */
+export interface InviteConfirmData {
+    /** 邀请类型 */
+    type: 'microphone' | 'camera';
+    /** 邀请发起人用户ID */
+    fromUserId: string;
+    /** 邀请发起人昵称 */
+    fromUserName: string;
+    /** 邀请动作 */
+    action: 'enable_microphone' | 'enable_camera';
+    /** 邀请时间戳 */
+    timestamp: number;
+}
+/**
+ * 邀请确认 Hook 返回值接口
+ */
+export interface UseInviteConfirmReturn {
+    /** 当前邀请数据 */
+    inviteData: InviteConfirmData | null;
+    /** 弹窗是否可见 */
+    visible: boolean;
+    /** 是否正在处理用户选择 */
+    loading: boolean;
+    /** 显示邀请确认弹窗 */
+    showInviteConfirm: (data: InviteConfirmData) => void;
+    /** 隐藏邀请确认弹窗 */
+    hideInviteConfirm: () => void;
+    /** 设置加载状态 */
+    setLoading: (loading: boolean) => void;
+    /** 清除邀请数据 */
+    clearInviteData: () => void;
+}
+/**
+ * 邀请确认管理 Hook
+ *
+ * 用于管理邀请确认弹窗的显示状态和相关数据
+ */
+export declare const useInviteConfirm: () => UseInviteConfirmReturn;

package/dist/components/RtcJoomRoom/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * RtcJoomRoom 模块统一导出
+ *
+ * 该模块提供 RTC 房间相关的组件和 Hooks
+ */
+import RtcJoomRoom from './RtcJoomRoom';
+export default RtcJoomRoom;
+export { default as useMessageReceiver } from './useMessageReceiver';
+export { default as useMessageSender } from './useMessageSender';
+export { default as useRoomMessageHandler } from './useRoomMessageHandler';
+export type { BaseMessage, CallUser, ChangeUserMessageData, MediaMessageData, MessageHandler, MessageQueueItem, MessageReceiverOptions, MessageSendOptions, MessageSendResult, MuteMessageData, PeerToPeerMessage, RoomBroadcastMessage, RoomMessageData, RoomMessageDataHandler, RoomMessageDataUnion, RoomMessageEvent, RoomMessageHandler, UnifiedMessageEvent, UseMessageReceiverReturn, UseRoomMessageHandlerReturn, UserMessageEvent, UserMessageHandler, UsersMessageData, WaitingModeMessageData, WaitingModeState, } from './types';
+export { MessagePriority, MessageSource, MessageType, RoomMessageType, } from './types';

package/dist/components/RtcJoomRoom/types.d.ts

@@ -0,0 +1,333 @@
+/**
+ * RTC 消息系统统一类型定义
+ *
+ * 本文件整合了所有与 RTC 消息相关的类型定义，包括：
+ * - 消息来源和类型枚举
+ * - 消息事件接口
+ * - 消息处理器类型
+ * - 消息发送相关类型
+ * - Hook 返回值接口
+ *
+ * 遵循 AIGC React/TS 智能开发规范，提供类型安全的消息处理能力
+ */
+import { CallUser, WaitingModeState } from '@/stores/callStore';
+/**
+ * 消息来源类型枚举
+ *
+ * 区分消息的来源，便于统一处理和路由
+ */
+export declare enum MessageSource {
+    /** 房间广播消息 - 来自房间的广播消息 */
+    ROOM = "room",
+    /** 用户点对点消息 - 来自特定用户的私聊消息 */
+    USER = "user"
+}
+/**
+ * 房间消息类型枚举
+ *
+ * 定义了所有支持的房间消息类型，便于类型检查和扩展
+ */
+export declare enum RoomMessageType {
+    /** 静音控制消息 - 主持人控制全体静音/取消静音 */
+    MUTE = "mute",
+    /** 离开房间消息 - 主持人解散房间 */
+    LEAVE = "leave",
+    /** 等候模式消息 - 用户准入或移至等候状态 */
+    WAITING_MODE = "waiting_mode",
+    /** 等待消息 - 通用等待状态消息 */
+    WAIT = "wait",
+    /** 用户变更消息 - 用户信息变更通知 */
+    CHANGE_USER = "change_user",
+    /** 媒体消息 - 音频/视频状态变更 */
+    MEDIA = "media",
+    /** 配置变更消息 - 主持人变更房间配置 */
+    CHANGE_CONFIG = "change_config",
+    /** 用户列表消息 - 主持人下发所有用户列表 */
+    USERS = "users"
+}
+/**
+ * 消息发送类型枚举
+ */
+export declare enum MessageType {
+    /** 房间广播消息 */
+    ROOM_BROADCAST = "room_broadcast",
+    /** 点对点消息 */
+    PEER_TO_PEER = "peer_to_peer"
+}
+/**
+ * 消息优先级枚举
+ */
+export declare enum MessagePriority {
+    LOW = 0,
+    NORMAL = 1,
+    HIGH = 2,
+    URGENT = 3
+}
+/**
+ * 静音消息数据接口
+ *
+ * 定义静音操作相关的数据结构
+ */
+export interface MuteMessageData {
+    /** 是否静音 - true: 静音, false: 取消静音 */
+    is_muted?: boolean;
+}
+/**
+ * 媒体消息数据接口
+ *
+ * 定义媒体状态变更相关的数据结构
+ */
+export interface MediaMessageData {
+    /** 媒体类型 - 音频或视频 */
+    media_type?: 'audio' | 'video';
+    /** 媒体状态 - 0: 关闭, 1: 开启 */
+    media_state?: 0 | 1;
+}
+/**
+ * 用户列表消息数据接口
+ *
+ * 定义主持人下发所有用户列表相关的数据结构
+ */
+export interface UsersMessageData {
+    users: CallUser[];
+    rtc_userid: string;
+}
+/**
+ * 等候模式消息数据接口
+ *
+ * 定义用户等候状态变更相关的数据结构
+ */
+export interface WaitingModeMessageData {
+    /** RTC 用户 ID - 目标用户的唯一标识 */
+    rtc_userid?: string;
+    /** 等候模式状态 - 用户的当前等候状态 */
+    waiting_mode_state?: WaitingModeState;
+    /** 用户列表 */
+    users: CallUser[];
+}
+/**
+ * 用户变更消息数据接口
+ *
+ * 定义用户信息变更相关的数据结构
+ */
+export interface ChangeUserMessageData {
+    /** 用户信息 - CallUser 的部分字段，具体包含哪些字段取决于消息类型 */
+    user?: Partial<CallUser>;
+    users?: Partial<CallUser>[];
+    /** 变更类型 - 指示具体的变更操作类型 */
+    change_type?: RoomMessageType;
+    /** 操作类型 - 具体的用户操作动作（如 name_change） */
+    action?: string;
+    /** 用户ID - 发生变更的用户标识 */
+    user_id?: string;
+    /** 旧名称 - 用户变更前的昵称 */
+    old_name?: string;
+    /** 新名称 - 用户变更后的昵称 */
+    new_name?: string;
+    /** 时间戳 - 消息发送时间 */
+    timestamp?: number;
+}
+/**
+ * 房间消息数据联合类型
+ */
+export type RoomMessageDataUnion = MuteMessageData | MediaMessageData | WaitingModeMessageData | ChangeUserMessageData | UsersMessageData | Record<string, unknown>;
+/**
+ * 统一消息事件接口
+ *
+ * 标准化不同来源消息的数据结构
+ */
+export interface UnifiedMessageEvent {
+    /** 消息来源类型 */
+    source: MessageSource;
+    /** 发送者用户ID */
+    userId: string;
+    /** 消息内容（JSON字符串或普通字符串） */
+    message: string;
+    /** 接收时间戳 */
+    timestamp: number;
+    /** 原始事件数据（用于调试和扩展） */
+    rawEvent?: any;
+}
+/**
+ * 房间消息事件接口
+ *
+ * 房间广播消息的标准格式，匹配火山引擎 RTC SDK 官方定义
+ * @see {@link https://www.volcengine.com/docs/6348/104479#onroommessagereceived}
+ */
+export interface RoomMessageEvent {
+    /** 发送者用户ID */
+    userId: string;
+    /** 消息内容 - 支持任意类型数据 */
+    message: any;
+}
+/**
+ * 用户消息事件接口
+ *
+ * 用户点对点消息的标准格式，匹配火山引擎 RTC SDK 官方定义
+ * @see {@link https://www.volcengine.com/docs/6348/104479#onusermessagereceived}
+ */
+export interface UserMessageEvent {
+    /** 发送者用户ID */
+    userId: string;
+    /** 消息内容 - 点对点文本消息 */
+    message: string;
+}
+/**
+ * 房间消息数据接口
+ */
+export interface RoomMessageData {
+    /** 消息类型 */
+    type: RoomMessageType;
+    /** 消息数据 */
+    data?: RoomMessageDataUnion;
+}
+/**
+ * 基础消息接口
+ */
+export interface BaseMessage {
+    /** 消息唯一标识 */
+    id?: string;
+    /** 消息类型 */
+    type: string;
+    /** 消息数据 */
+    data: Record<string, any>;
+    /** 时间戳 */
+    timestamp?: number;
+    /** 消息优先级 */
+    priority?: MessagePriority;
+    /** 是否支持重试 */
+    retry?: boolean;
+    /** 最大重试次数 */
+    maxRetries?: number;
+}
+/**
+ * 房间广播消息接口
+ */
+export interface RoomBroadcastMessage extends BaseMessage {
+    messageType: MessageType.ROOM_BROADCAST;
+}
+/**
+ * 点对点消息接口
+ */
+export interface PeerToPeerMessage extends BaseMessage {
+    messageType: MessageType.PEER_TO_PEER;
+    /** 目标用户ID */
+    targetUserId: string;
+    /** 是否为二进制消息 */
+    isBinary?: boolean;
+}
+/**
+ * 消息发送结果接口
+ */
+export interface MessageSendResult {
+    success: boolean;
+    messageId?: string;
+    error?: {
+        code: string;
+        message: string;
+        retryable?: boolean;
+    };
+    timestamp: number;
+}
+/**
+ * 消息发送选项接口
+ *
+ * 配置消息发送的各种选项，包括超时、重试等
+ */
+export interface MessageSendOptions {
+    /** 发送超时时间(ms) */
+    timeout?: number;
+    /** 重试次数 */
+    retryCount?: number;
+    /** 重试延迟(ms) */
+    retryDelay?: number;
+    /** 发送进度回调 */
+    onProgress?: (progress: number) => void;
+    /** 重试回调 */
+    onRetry?: (attempt: number) => void;
+}
+/**
+ * 消息队列项接口
+ *
+ * 内部使用的消息队列项，包含消息、选项和回调
+ */
+export interface MessageQueueItem {
+    message: RoomBroadcastMessage | PeerToPeerMessage;
+    options?: MessageSendOptions;
+    resolve: (result: MessageSendResult) => void;
+    reject: (error: Error) => void;
+    attempts: number;
+    maxAttempts: number;
+}
+/**
+ * 统一消息处理器类型
+ */
+export type MessageHandler = (event: UnifiedMessageEvent) => void;
+/**
+ * 房间消息处理器类型
+ */
+export type RoomMessageHandler = (event: RoomMessageEvent) => void;
+/**
+ * 用户消息处理器类型
+ */
+export type UserMessageHandler = (event: UserMessageEvent) => void;
+/**
+ * 房间消息数据处理器类型
+ */
+export type RoomMessageDataHandler = (data: RoomMessageData, userId: string) => void;
+/**
+ * 消息接收器配置选项
+ */
+export interface MessageReceiverOptions {
+    /** 是否启用房间消息接收 */
+    enableRoomMessages?: boolean;
+    /** 是否启用用户消息接收 */
+    enableUserMessages?: boolean;
+    /** 是否启用消息去重 */
+    enableDeduplication?: boolean;
+    /** 去重时间窗口(ms) */
+    deduplicationWindow?: number;
+    /** 是否启用调试日志 */
+    enableDebugLog?: boolean;
+}
+/**
+ * 消息接收器返回值接口
+ */
+export interface UseMessageReceiverReturn {
+    /** 统一消息处理器 */
+    handleMessage: MessageHandler;
+    /** 房间消息处理器 */
+    handleRoomMessageReceived: RoomMessageHandler;
+    /** 用户消息处理器 */
+    handleUserMessageReceived: UserMessageHandler;
+    /** 房间消息处理器实例 */
+    roomMessageHandler: UseRoomMessageHandlerReturn;
+    /** 消息统计信息 */
+    stats: {
+        /** 接收的房间消息数量 */
+        roomMessagesReceived: number;
+        /** 接收的用户消息数量 */
+        userMessagesReceived: number;
+        /** 过滤的重复消息数量 */
+        duplicateMessagesFiltered: number;
+    };
+}
+/**
+ * 房间消息处理器返回值接口
+ */
+export interface UseRoomMessageHandlerReturn {
+    /** 房间消息接收处理器 */
+    handleRoomMessageReceived: (event: RoomMessageEvent) => void;
+    /** 具体消息处理器集合 */
+    handlers: {
+        /** 静音消息处理器 */
+        handleMuteMessage: (data: RoomMessageData, userId: string) => void;
+        /** 离开房间消息处理器 */
+        handleLeaveMessage: (data: RoomMessageData, userId: string) => void;
+        /** 等候模式消息处理器 */
+        handleWaitingModeMessage: (data: RoomMessageData, userId: string) => void;
+        /** 用户变更消息处理器 */
+        handleChangeUserMessage: (data: RoomMessageData, userId: string) => void;
+    };
+}
+export type { CallUser, WaitingModeState, };

package/dist/components/RtcJoomRoom/useMessageReceiver.d.ts

@@ -0,0 +1,38 @@
+import { MessageHandler, MessageReceiverOptions, UseMessageReceiverReturn } from './types';
+/**
+ * 统一消息接收器 Hook
+ *
+ * 提供统一的消息接收和处理能力，整合房间消息和用户消息
+ *
+ * @param messageHandler - 统一消息处理器
+ * @param options - 配置选项
+ * @returns 消息接收器实例
+ *
+ * @example
+ * ```typescript
+ * const messageReceiver = useMessageReceiver(
+ *   (event) => {
+ *     console.log(`收到${event.source}消息:`, event.message);
+ *     if (event.source === MessageSource.ROOM) {
+ *       // 处理房间消息
+ *     } else if (event.source === MessageSource.USER) {
+ *       // 处理用户消息
+ *     }
+ *   },
+ *   {
+ *     enableRoomMessages: true,
+ *     enableUserMessages: true,
+ *     enableDeduplication: true,
+ *   }
+ * );
+ *
+ * // 在 RTC 客户端中使用
+ * const rtcClient = new RtcClient({
+ *   handleRoomMessageReceived: messageReceiver.handleRoomMessageReceived,
+ *   handleUserMessgeReceived: messageReceiver.handleUserMessageReceived,
+ *   // ... 其他配置
+ * });
+ * ```
+ */
+export declare const useMessageReceiver: (messageHandler?: MessageHandler, options?: MessageReceiverOptions) => UseMessageReceiverReturn;
+export default useMessageReceiver;

package/dist/components/RtcJoomRoom/useMessageSender.d.ts

@@ -0,0 +1,28 @@
+import { MessageType, MessagePriority, MessageSendResult, MessageSendOptions } from './types';
+/**
+ * 消息发送Hook - 统一管理RTC消息发送
+ * 支持房间广播和点对点两种消息发送模式
+ * 提供重试机制、错误处理、消息队列等高级功能
+ */
+export declare const useMessageSender: () => {
+    sendRoomBroadcast: (type: string, data: Record<string, any>, options?: MessageSendOptions) => Promise<MessageSendResult>;
+    sendPeerToPeer: (targetUserId: string, type: string, data: Record<string, any>, options?: MessageSendOptions & {
+        isBinary?: boolean;
+    }) => Promise<MessageSendResult>;
+    sendBatch: (messages: Array<{
+        messageType: MessageType;
+        targetUserId?: string;
+        type: string;
+        data: Record<string, any>;
+        options?: MessageSendOptions;
+    }>) => Promise<MessageSendResult[]>;
+    clearQueue: () => void;
+    getQueueStatus: () => {
+        queueLength: number;
+        isProcessing: boolean;
+    };
+    generateMessageId: () => string;
+    MessageType: typeof MessageType;
+    MessagePriority: typeof MessagePriority;
+};
+export default useMessageSender;