@easemob-community/callkit-vue3 2.0.1

package/dist/services/RtcService.d.ts

@@ -0,0 +1,187 @@
+import { IAgoraRTCClient, IAgoraRTCRemoteUser, ICameraVideoTrack, IMicrophoneAudioTrack, IRemoteAudioTrack, IRemoteVideoTrack, VideoEncoderConfigurationPreset } from 'agora-rtc-sdk-ng';
+export interface RtcServiceConfig {
+    appId: string;
+    client?: IAgoraRTCClient;
+    encoderConfig?: VideoEncoderConfigurationPreset;
+    onNetworkQualityChange?: (quality: any) => void;
+    onUserJoined?: (userId: string) => void;
+    onUserLeft?: (userId: string) => void;
+    onUserPublished?: (user: IAgoraRTCRemoteUser, mediaType: 'audio' | 'video') => void;
+    onUserUnpublished?: (user: IAgoraRTCRemoteUser, mediaType: 'audio' | 'video') => void;
+    onVolumeIndicator?: (volumes: any[]) => void;
+    chatClient?: any;
+    onAudioEnabledChange?: (enabled: boolean) => void;
+    onVideoEnabledChange?: (enabled: boolean) => void;
+    onLocalStreamChange?: (stream: MediaStream | null) => void;
+}
+export declare class RtcService {
+    private client;
+    private appId;
+    private agoraUid;
+    private localVideoTrack;
+    private localAudioTrack;
+    private remoteVideoTracks;
+    private remoteAudioTracks;
+    private localVideoStream;
+    private currentCameraDeviceId;
+    private encoderConfig;
+    private isAudioEnabled;
+    private isVideoEnabled;
+    private chatClient;
+    private autoSubscribe;
+    private isActive;
+    private uidToUserIdMap;
+    private joinedRtcUsers;
+    private leftUsers;
+    private pendingUserIds;
+    private onNetworkQualityChange?;
+    private onUserJoined?;
+    private onUserLeft?;
+    private onUserPublished?;
+    private onUserUnpublished?;
+    private onVolumeIndicator?;
+    private onAudioEnabledChange?;
+    private onVideoEnabledChange?;
+    private onLocalStreamChange?;
+    constructor(config: RtcServiceConfig);
+    /**
+     * 初始化RTC客户端
+     */
+    initialize(): Promise<void>;
+    /**
+     * 更新 appId（支持动态更新）
+     */
+    setAppId(appId: string): void;
+    /**
+     * 设置是否自动订阅远程用户
+     */
+    setAutoSubscribe(enabled: boolean): void;
+    /**
+     * 加入频道
+     */
+    joinChannel(channelName: string, token: string | null, uid: number | string, appId?: string): Promise<number | string>;
+    /**
+     * 离开频道
+     */
+    leaveChannel(): Promise<void>;
+    /**
+     * 创建本地音频轨道
+     */
+    createAudioTrack(): Promise<IMicrophoneAudioTrack>;
+    /**
+     * 创建本地视频轨道
+     */
+    createVideoTrack(): Promise<ICameraVideoTrack>;
+    /**
+     * 发布本地轨道
+     */
+    publishTracks(tracks: any[]): Promise<void>;
+    /**
+     * 切换音频状态
+     */
+    toggleAudio(enabled: boolean): Promise<boolean>;
+    /**
+     * 切换视频状态
+     */
+    toggleVideo(enabled: boolean): Promise<boolean>;
+    /**
+     * 切换摄像头设备
+     */
+    switchCamera(deviceId: string): Promise<boolean>;
+    /**
+     * 切换麦克风设备
+     */
+    switchMicrophone(deviceId: string): Promise<boolean>;
+    /**
+     * 订阅远程用户
+     * 支持传入 IAgoraRTCRemoteUser 对象或 uid（number/string）
+     * 当传入 uid 时，SDK 内部会通过 remoteUsers 查找对应的 RemoteUser 实例，
+     * 避免事件回调中的 user 对象与 SDK 内部实例引用不一致导致 INVALID_REMOTE_USER
+     */
+    subscribeRemoteUser(userOrUid: IAgoraRTCRemoteUser | number | string, mediaType: 'audio' | 'video'): Promise<void>;
+    /**
+     * 获取本地视频流
+     */
+    getLocalVideoStream(): MediaStream | null;
+    /**
+     * 获取远程视频轨道（通过userId）
+     */
+    getRemoteVideoTrack(userId: string): IRemoteVideoTrack | null;
+    /**
+     * 获取远程音频轨道（通过userId）
+     */
+    getRemoteAudioTrack(userId: string): IRemoteAudioTrack | null;
+    /**
+     * 获取本地视频轨道
+     */
+    getLocalVideoTrack(): ICameraVideoTrack | null;
+    getLocalAudioTrack(): IMicrophoneAudioTrack | null;
+    /**
+     * 检查音频是否静音
+     */
+    isMuted(): boolean;
+    /**
+     * 检查摄像头是否开启
+     */
+    isCameraEnabled(): boolean;
+    /**
+     * 获取RTC客户端
+     */
+    getClient(): IAgoraRTCClient | null;
+    /**
+     * 关闭本地轨道
+     */
+    private closeLocalTracks;
+    /**
+     * 添加事件监听
+     */
+    private addEventListeners;
+    /**
+     * 取消发布本地轨道
+     */
+    unpublishTracks(tracks: any[]): Promise<void>;
+    /**
+     * 取消订阅远程用户
+     */
+    unsubscribeRemoteUser(userOrUid: IAgoraRTCRemoteUser | number | string, mediaType: 'audio' | 'video'): Promise<void>;
+    /**
+     * 添加 UID 到 userId 的映射
+     */
+    setUidToUserIdMapping(uid: string, userId: string): void;
+    /**
+     * 根据 UID 获取 userId
+     */
+    getUserIdByUid(uid: string): string | null;
+    /**
+     * 标记用户已加入 RTC 频道
+     */
+    markUserJoinedRtc(userId: string): void;
+    /**
+     * 标记用户离开 RTC 频道
+     */
+    markUserLeftRtc(userId: string): void;
+    /**
+     * 检查用户是否已加入 RTC 频道
+     */
+    isUserInRtc(userId: string): boolean;
+    /**
+     * 检查用户是否已明确离开
+     */
+    hasUserLeft(userId: string): boolean;
+    /**
+     * 添加待加入 RTC 的 userId
+     */
+    addPendingUserId(userId: string): void;
+    /**
+     * 获取第一个待加入的 userId 并移除
+     */
+    popPendingUserId(): string | null;
+    /**
+     * 重置所有用户状态
+     */
+    resetUserState(): void;
+    /**
+     * 销毁RTC服务
+     */
+    destroy(): Promise<void>;
+}

package/dist/services/UserProfileService.d.ts

@@ -0,0 +1,38 @@
+export interface UserProfile {
+    userId: string;
+    nickname?: string;
+    avatarUrl?: string;
+}
+export interface GroupProfile {
+    groupId: string;
+    groupName?: string;
+    groupAvatar?: string;
+}
+export type UserInfoProvider = (userIds: string[]) => Promise<UserProfile[]>;
+export type GroupInfoProvider = (groupIds: string[]) => Promise<GroupProfile[]>;
+/**
+ * 注册用户信息查询 Provider
+ * 由 EasemobChatCallKitProvider.vue 在初始化时调用
+ */
+export declare function registerUserInfoProvider(provider: UserInfoProvider | undefined): void;
+export declare function getUserInfoProvider(): UserInfoProvider | undefined;
+/**
+ * 注册群组信息查询 Provider
+ */
+export declare function registerGroupInfoProvider(provider: GroupInfoProvider | undefined): void;
+export declare function getGroupInfoProvider(): GroupInfoProvider | undefined;
+/**
+ * 通过 Provider 批量解析用户信息
+ * 优先读取 GlobalCallStore 缓存，未命中部分调用 Provider，获取后写入缓存
+ * @returns 解析后的用户信息，失败时返回 userId 兜底
+ */
+export declare function resolveUserProfiles(userIds: string[]): Promise<UserProfile[]>;
+/**
+ * 通过 Provider 批量解析群组信息
+ * @returns 解析后的群组信息，失败时返回 groupId 兜底
+ */
+export declare function resolveGroupProfiles(groupIds: string[]): Promise<GroupProfile[]>;
+/**
+ * 清理已注册的 Provider（Provider 卸载时调用）
+ */
+export declare function clearProfileProviders(): void;

package/dist/store/callTimer.d.ts

@@ -0,0 +1,33 @@
+export interface CallTimerState {
+    callDuration: number;
+    callStartTime: number;
+    _timer: any;
+}
+/**
+ * CallTimerStore
+ * 通话计时器状态（单聊域）
+ * 职责：管理一对一通话的时长计时
+ */
+export declare const useCallTimerStore: import('pinia').StoreDefinition<"callTimer", CallTimerState, {
+    /**
+     * 获取格式化的通话时长
+     */
+    formattedCallDuration(): string;
+}, {
+    /**
+     * 开始通话计时
+     */
+    startCallTimer(): void;
+    /**
+     * 更新通话时长（内部调用）
+     */
+    updateCallDuration(): void;
+    /**
+     * 停止通话计时
+     */
+    stopCallTimer(): void;
+    /**
+     * 重置计时器状态
+     */
+    reset(): void;
+}>;