pcm-agents 1.0.2 → 1.0.3

package/dist/types/components/components-oem-virtual-chat-modal/components-oem-virtual-chat-modal.d.ts

@@ -0,0 +1,290 @@
+import { EventEmitter } from '../../stencil-public-runtime';
+import { ChatMessage } from '../../interfaces/chat';
+import { StreamCompleteEventData, ConversationStartEventData, InterviewCompleteEventData, RecordingErrorEventData, RecordingStatusChangeEventData } from '../../interfaces/events';
+export declare class ComponentsOemVirtualChatModal {
+    /**
+     * SDK鉴权密钥
+     */
+    token?: string;
+    /**
+     * 是否显示聊天模态框
+     */
+    isOpen: boolean;
+    /**
+     * 聊天消息历史
+     */
+    messages: ChatMessage[];
+    /**
+     * 聊天框的页面层级
+     */
+    zIndex?: number;
+    /**
+     * 会话ID，传入继续对话，否则创建新会话
+     */
+    conversationId?: string;
+    /**
+     * 是否正在加载回复
+     */
+    isLoading: boolean;
+    /**
+     * 当前正在流式输出的消息
+     */
+    currentStreamingMessage: ChatMessage | null;
+    isLoadingHistory: boolean;
+    hostElement: HTMLElement;
+    /**
+     * 一轮对话结束时的回调
+     */
+    streamComplete: EventEmitter<StreamCompleteEventData>;
+    /**
+     * 新会话开始的回调，只会在一轮对话开始时触发一次
+     */
+    conversationStart: EventEmitter<ConversationStartEventData>;
+    /**
+     * 默认发送文本
+     */
+    defaultQuery: string;
+    /**
+     * 视频录制最大时长（秒）
+     */
+    maxRecordingTime: number;
+    /**
+     * 录制倒计时提醒时间（秒）
+     * 当剩余时间小于此值时，显示倒计时警告
+     */
+    countdownWarningTime: number;
+    isRecording: boolean;
+    recordingStream: MediaStream | null;
+    recordedBlob: Blob | null;
+    mediaRecorder: MediaRecorder | null;
+    recordingTimeLeft: number;
+    showRecordingUI: boolean;
+    recordingTimer: any;
+    recordingStartTime: number;
+    waitingToRecord: boolean;
+    waitingTimer: any;
+    private _visibilityChangeHandler;
+    waitingTimeLeft: number;
+    private videoRef;
+    /**
+     * 当前轮数
+     */
+    currentQuestionNumber: number;
+    /**
+     * 当聊天完成时触发
+     */
+    interviewComplete: EventEmitter<InterviewCompleteEventData>;
+    showCountdownWarning: boolean;
+    /**
+     * 是否以全屏模式打开，移动端建议设置为true
+     */
+    fullscreen: boolean;
+    isUploadingVideo: boolean;
+    /**
+     * 数字人视频相关状态
+     */
+    digitalHumanVideoUrl: string;
+    digitalHumanDefaultVideoUrl: string;
+    virtualmanKey: string;
+    isPlayingDigitalHumanVideo: boolean;
+    digitalHumanVideoReady: boolean;
+    digitalHumanOpeningContents: Array<{
+        text: string;
+        video_url: string;
+    }>;
+    isPlayingWelcomeVideo: boolean;
+    isGeneratingDigitalHumanVideo: boolean;
+    /**
+     * 待播放的生成视频URL（当开场白视频播放时，暂存生成的视频URL）
+     */
+    pendingGeneratedVideoUrl: string;
+    private preloadedVideos;
+    private preloadingVideos;
+    /**
+     * 是否正在等待数字人视频播放完成
+     */
+    waitingForDigitalHuman: boolean;
+    /**
+     * 虚拟数字人ID，指定则开启虚拟数字人功能
+     */
+    digitalId?: string;
+    /**
+     * 数字人开场白索引，用于选择开场白和开场视频（可选：0, 1, 2）
+     * 0、您好，我是聘才猫 AI 面试助手。很高兴为你主持这场面试！在开始前，请确保：身处安静、光线充足的环境。网络顺畅，摄像头和麦克风工作正常。现在我正在查看本次面试的相关信息，为您生成专属面试题，马上就好，请稍等片刻。</br>
+     * 1、您好，我是您的 AI 面试助手。欢迎参加本次AI面试！为了获得最佳效果，请确认：您在安静、明亮的环境中。您的网络稳定，摄像头和麦克风已开启。我们正在后台为您准备本次专属面试内容，很快开始，请稍候。<br>
+     * 2、您好，我是您的 AI 面试助手。面试马上开始。趁此片刻，请快速确认：周围安静吗？光线足够吗？网络没问题？摄像头和麦克风准备好了吗？我们正在为您加载个性化的面试环节，稍等就好！
+     */
+    openingIndex: number;
+    /**
+     * 等待录制时间（秒）默认10
+     */
+    waitingTime: number;
+    /**
+     * 数字人视频播放速率（0.5-2.0之间），默认1.0
+     */
+    playbackRate: number;
+    /**
+     * 是否显示结束面试按钮
+     */
+    showEndInterviewButton: boolean;
+    /**
+     * 录制错误事件
+     */
+    recordingError: EventEmitter<RecordingErrorEventData>;
+    /**
+     * 录制状态变化事件
+     */
+    recordingStatusChange: EventEmitter<RecordingStatusChangeEventData>;
+    /**
+     * SDK密钥验证失败事件
+     */
+    tokenInvalid: EventEmitter<void>;
+    /**
+     * 当点击模态框关闭时触发
+     */
+    modalClosed: EventEmitter<void>;
+    /**
+     * 自定义智能体inputs输入参数
+     */
+    customInputs: Record<string, any>;
+    /**
+     * 机器人ID
+     */
+    botId?: string;
+    /**
+     * 智能体头像URL（从后端获取）
+     */
+    agentLogo: string;
+    isTaskCompleted: boolean;
+    private tokenInvalidListener;
+    deviceError: string | null;
+    /**
+     * 面试流程状态管理说明：
+     *
+     * 核心状态：
+     * - isTaskCompleted: 任务是否已完成（面试正常结束）
+     * - isEndingInterview: 是否正在执行结束面试流程（用户主动结束）
+     * - isRecording: 是否正在录制视频
+     * - waitingToRecord: 是否正在等待开始录制
+     * - waitingForDigitalHuman: 是否正在等待数字人视频播放完成
+     * - isLoading: 是否正在等待AI回复
+     * - isUploadingVideo: 是否正在上传视频
+     * - isGeneratingDigitalHumanVideo: 是否正在生成数字人视频
+     *
+     * 流程控制原则：
+     * 1. 一旦 isTaskCompleted 或 isEndingInterview 为 true，所有录制和等待流程都应停止
+     * 2. isEndingInterview 设置为 true 后，只允许发送结束面试消息
+     * 3. 结束面试按钮在 isTaskCompleted 或 isEndingInterview 为 true 时置灰禁用
+     * 4. 所有可能触发新录制的地方都需要检查这两个状态
+     */
+    showConfirmModal: boolean;
+    skipConfirmThisInterview: boolean;
+    showCloseConfirmModal: boolean;
+    showEndInterviewConfirmModal: boolean;
+    /**
+     * 标记是否正在执行结束面试流程
+     */
+    isEndingInterview: boolean;
+    private isComponentActive;
+    handleTokenChange(newToken: string): void;
+    /**
+     * 公共方法：设置组件活动状态
+     * 可被外部调用来控制组件是否继续执行异步操作
+     */
+    setComponentActive(active: boolean): Promise<void>;
+    componentWillLoad(): void;
+    private fetchAgentLogo;
+    private sendMessageToAPI;
+    private loadHistoryMessages;
+    private startWaitingToRecord;
+    private startRecording;
+    private setupVideoPreview;
+    private stopRecording;
+    private handleStopRecording;
+    private handleSkipConfirmChange;
+    private handleConfirmModalCancel;
+    private handleConfirmModalOk;
+    private handleConfirmModalCancelEvent;
+    private uploadRecordedVideo;
+    private handleCloseClick;
+    private handleCloseConfirmOk;
+    private handleCloseConfirmCancel;
+    disconnectedCallback(): void;
+    /**
+     * 预创建数字人视频
+     */
+    private precreateDigitalHumanVideos;
+    /**
+     * 初始化数字人功能
+     */
+    private initializeDigitalHuman;
+    /**
+     * 生成数字人视频
+     */
+    private generateDigitalHumanVideo;
+    /**
+     * 轮询查询视频生成进度
+     */
+    private pollVideoProgress;
+    /**
+     * 播放数字人视频
+     */
+    private playDigitalHumanVideo;
+    /**
+     * 智能视频预加载管理器
+     * 确保每个视频只预加载一次，避免重复请求
+     */
+    private preloadVideo;
+    /**
+     * 执行实际的视频预加载操作
+     */
+    private executeVideoPreload;
+    /**
+     * 顺序预加载多个视频
+     * 上一个视频加载完毕后立刻加载下一个视频
+     */
+    private sequentialPreloadVideos;
+    /**
+     * 顺序视频URL处理器
+     * 一旦获得视频URL，按顺序预加载
+     */
+    private handleVideoUrlReceivedSequential;
+    /**
+     * 处理页面从后台恢复（关屏/切后台回来）
+     * 检测并恢复可能卡住的流程
+     */
+    private handlePageResume;
+    /**
+     * 跳过当前数字人视频播放，直接进入录制流程
+     */
+    private skipDigitalHumanVideo;
+    /**
+     * 处理数字人视频播放结束
+     */
+    private handleVideoElementEnded;
+    /**
+     * 处理面试结束按钮点击 - 显示二次确认模态框
+     */
+    private handleInterviewEnd;
+    /**
+     * 确认结束面试
+     */
+    private handleConfirmEndInterview;
+    /**
+     * 发送结束面试消息
+     */
+    private sendEndInterviewMessage;
+    /**
+     * 取消结束面试
+     */
+    private handleCancelEndInterview;
+    /**
+     * 计算已回答的题数
+     */
+    private getAnsweredQuestionCount;
+    private renderChatHistory;
+    render(): any;
+    private renderVideoPreview;
+    private renderRecordingStatusBar;
+    private renderStatusIndicator;
+}

package/dist/types/components.d.ts

@@ -249,6 +249,72 @@ export namespace Components {
          */
         "uploadText": string;
     }
+    interface ComponentsOemVirtualChatModal {
+        /**
+          * 机器人ID
+         */
+        "botId"?: string;
+        /**
+          * 会话ID，传入继续对话，否则创建新会话
+         */
+        "conversationId"?: string;
+        /**
+          * 录制倒计时提醒时间（秒） 当剩余时间小于此值时，显示倒计时警告
+         */
+        "countdownWarningTime": number;
+        /**
+          * 自定义智能体inputs输入参数
+         */
+        "customInputs": Record<string, any>;
+        /**
+          * 默认发送文本
+         */
+        "defaultQuery": string;
+        /**
+          * 虚拟数字人ID，指定则开启虚拟数字人功能
+         */
+        "digitalId"?: string;
+        /**
+          * 是否以全屏模式打开，移动端建议设置为true
+         */
+        "fullscreen": boolean;
+        /**
+          * 是否显示聊天模态框
+         */
+        "isOpen": boolean;
+        /**
+          * 视频录制最大时长（秒）
+         */
+        "maxRecordingTime": number;
+        /**
+          * 数字人开场白索引，用于选择开场白和开场视频（可选：0, 1, 2） 0、您好，我是聘才猫 AI 面试助手。很高兴为你主持这场面试！在开始前，请确保：身处安静、光线充足的环境。网络顺畅，摄像头和麦克风工作正常。现在我正在查看本次面试的相关信息，为您生成专属面试题，马上就好，请稍等片刻。</br> 1、您好，我是您的 AI 面试助手。欢迎参加本次AI面试！为了获得最佳效果，请确认：您在安静、明亮的环境中。您的网络稳定，摄像头和麦克风已开启。我们正在后台为您准备本次专属面试内容，很快开始，请稍候。<br> 2、您好，我是您的 AI 面试助手。面试马上开始。趁此片刻，请快速确认：周围安静吗？光线足够吗？网络没问题？摄像头和麦克风准备好了吗？我们正在为您加载个性化的面试环节，稍等就好！
+         */
+        "openingIndex": number;
+        /**
+          * 数字人视频播放速率（0.5-2.0之间），默认1.0
+         */
+        "playbackRate": number;
+        /**
+          * 公共方法：设置组件活动状态 可被外部调用来控制组件是否继续执行异步操作
+         */
+        "setComponentActive": (active: boolean) => Promise<void>;
+        /**
+          * 是否显示结束面试按钮
+         */
+        "showEndInterviewButton": boolean;
+        /**
+          * SDK鉴权密钥
+         */
+        "token"?: string;
+        /**
+          * 等待录制时间（秒）默认10
+         */
+        "waitingTime": number;
+        /**
+          * 聊天框的页面层级
+         */
+        "zIndex"?: number;
+    }
     /**
      * 职位选择器组件
      * 支持单选和多选模式
@@ -2560,6 +2626,10 @@ export interface ComponentsMobileUploadBtnCustomEvent<T> extends CustomEvent<T>
     detail: T;
     target: HTMLComponentsMobileUploadBtnElement;
 }
+export interface ComponentsOemVirtualChatModalCustomEvent<T> extends CustomEvent<T> {
+    detail: T;
+    target: HTMLComponentsOemVirtualChatModalElement;
+}
 export interface ComponentsPositionSelectorCustomEvent<T> extends CustomEvent<T> {
     detail: T;
     target: HTMLComponentsPositionSelectorElement;
@@ -2852,6 +2922,29 @@ declare global {
         prototype: HTMLComponentsMobileUploadBtnElement;
         new (): HTMLComponentsMobileUploadBtnElement;
     };
+    interface HTMLComponentsOemVirtualChatModalElementEventMap {
+        "streamComplete": StreamCompleteEventData;
+        "conversationStart": ConversationStartEventData;
+        "interviewComplete": InterviewCompleteEventData;
+        "recordingError": RecordingErrorEventData;
+        "recordingStatusChange": RecordingStatusChangeEventData;
+        "tokenInvalid": void;
+        "modalClosed": void;
+    }
+    interface HTMLComponentsOemVirtualChatModalElement extends Components.ComponentsOemVirtualChatModal, HTMLStencilElement {
+        addEventListener<K extends keyof HTMLComponentsOemVirtualChatModalElementEventMap>(type: K, listener: (this: HTMLComponentsOemVirtualChatModalElement, ev: ComponentsOemVirtualChatModalCustomEvent<HTMLComponentsOemVirtualChatModalElementEventMap[K]>) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener<K extends keyof DocumentEventMap>(type: K, listener: (this: Document, ev: DocumentEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: HTMLElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | AddEventListenerOptions): void;
+        removeEventListener<K extends keyof HTMLComponentsOemVirtualChatModalElementEventMap>(type: K, listener: (this: HTMLComponentsOemVirtualChatModalElement, ev: ComponentsOemVirtualChatModalCustomEvent<HTMLComponentsOemVirtualChatModalElementEventMap[K]>) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener<K extends keyof DocumentEventMap>(type: K, listener: (this: Document, ev: DocumentEventMap[K]) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: HTMLElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | EventListenerOptions): void;
+    }
+    var HTMLComponentsOemVirtualChatModalElement: {
+        prototype: HTMLComponentsOemVirtualChatModalElement;
+        new (): HTMLComponentsOemVirtualChatModalElement;
+    };
     interface HTMLComponentsPositionSelectorElementEventMap {
         "positionSelected": Position;
         "positionSelectionChange": { action: 'add' | 'remove'; positions: Position[] };
@@ -3721,6 +3814,7 @@ declare global {
         "components-message": HTMLComponentsMessageElement;
         "components-mobile-input-btn": HTMLComponentsMobileInputBtnElement;
         "components-mobile-upload-btn": HTMLComponentsMobileUploadBtnElement;
+        "components-oem-virtual-chat-modal": HTMLComponentsOemVirtualChatModalElement;
         "components-position-selector": HTMLComponentsPositionSelectorElement;
         "components-thousand-resume-wrapper": HTMLComponentsThousandResumeWrapperElement;
         "components-upload": HTMLComponentsUploadElement;
@@ -4033,6 +4127,96 @@ declare namespace LocalJSX {
          */
         "uploadText"?: string;
     }
+    interface ComponentsOemVirtualChatModal {
+        /**
+          * 机器人ID
+         */
+        "botId"?: string;
+        /**
+          * 会话ID，传入继续对话，否则创建新会话
+         */
+        "conversationId"?: string;
+        /**
+          * 录制倒计时提醒时间（秒） 当剩余时间小于此值时，显示倒计时警告
+         */
+        "countdownWarningTime"?: number;
+        /**
+          * 自定义智能体inputs输入参数
+         */
+        "customInputs"?: Record<string, any>;
+        /**
+          * 默认发送文本
+         */
+        "defaultQuery"?: string;
+        /**
+          * 虚拟数字人ID，指定则开启虚拟数字人功能
+         */
+        "digitalId"?: string;
+        /**
+          * 是否以全屏模式打开，移动端建议设置为true
+         */
+        "fullscreen"?: boolean;
+        /**
+          * 是否显示聊天模态框
+         */
+        "isOpen"?: boolean;
+        /**
+          * 视频录制最大时长（秒）
+         */
+        "maxRecordingTime"?: number;
+        /**
+          * 新会话开始的回调，只会在一轮对话开始时触发一次
+         */
+        "onConversationStart"?: (event: ComponentsOemVirtualChatModalCustomEvent<ConversationStartEventData>) => void;
+        /**
+          * 当聊天完成时触发
+         */
+        "onInterviewComplete"?: (event: ComponentsOemVirtualChatModalCustomEvent<InterviewCompleteEventData>) => void;
+        /**
+          * 当点击模态框关闭时触发
+         */
+        "onModalClosed"?: (event: ComponentsOemVirtualChatModalCustomEvent<void>) => void;
+        /**
+          * 录制错误事件
+         */
+        "onRecordingError"?: (event: ComponentsOemVirtualChatModalCustomEvent<RecordingErrorEventData>) => void;
+        /**
+          * 录制状态变化事件
+         */
+        "onRecordingStatusChange"?: (event: ComponentsOemVirtualChatModalCustomEvent<RecordingStatusChangeEventData>) => void;
+        /**
+          * 一轮对话结束时的回调
+         */
+        "onStreamComplete"?: (event: ComponentsOemVirtualChatModalCustomEvent<StreamCompleteEventData>) => void;
+        /**
+          * SDK密钥验证失败事件
+         */
+        "onTokenInvalid"?: (event: ComponentsOemVirtualChatModalCustomEvent<void>) => void;
+        /**
+          * 数字人开场白索引，用于选择开场白和开场视频（可选：0, 1, 2） 0、您好，我是聘才猫 AI 面试助手。很高兴为你主持这场面试！在开始前，请确保：身处安静、光线充足的环境。网络顺畅，摄像头和麦克风工作正常。现在我正在查看本次面试的相关信息，为您生成专属面试题，马上就好，请稍等片刻。</br> 1、您好，我是您的 AI 面试助手。欢迎参加本次AI面试！为了获得最佳效果，请确认：您在安静、明亮的环境中。您的网络稳定，摄像头和麦克风已开启。我们正在后台为您准备本次专属面试内容，很快开始，请稍候。<br> 2、您好，我是您的 AI 面试助手。面试马上开始。趁此片刻，请快速确认：周围安静吗？光线足够吗？网络没问题？摄像头和麦克风准备好了吗？我们正在为您加载个性化的面试环节，稍等就好！
+         */
+        "openingIndex"?: number;
+        /**
+          * 数字人视频播放速率（0.5-2.0之间），默认1.0
+         */
+        "playbackRate"?: number;
+        /**
+          * 是否显示结束面试按钮
+         */
+        "showEndInterviewButton"?: boolean;
+        /**
+          * SDK鉴权密钥
+         */
+        "token"?: string;
+        /**
+          * 等待录制时间（秒）默认10
+         */
+        "waitingTime"?: number;
+        /**
+          * 聊天框的页面层级
+         */
+        "zIndex"?: number;
+    }
     /**
      * 职位选择器组件
      * 支持单选和多选模式
@@ -7241,6 +7425,7 @@ declare namespace LocalJSX {
         "components-message": ComponentsMessage;
         "components-mobile-input-btn": ComponentsMobileInputBtn;
         "components-mobile-upload-btn": ComponentsMobileUploadBtn;
+        "components-oem-virtual-chat-modal": ComponentsOemVirtualChatModal;
         "components-position-selector": ComponentsPositionSelector;
         "components-thousand-resume-wrapper": ComponentsThousandResumeWrapper;
         "components-upload": ComponentsUpload;
@@ -7297,6 +7482,7 @@ declare module "@stencil/core" {
             "components-message": LocalJSX.ComponentsMessage & JSXBase.HTMLAttributes<HTMLComponentsMessageElement>;
             "components-mobile-input-btn": LocalJSX.ComponentsMobileInputBtn & JSXBase.HTMLAttributes<HTMLComponentsMobileInputBtnElement>;
             "components-mobile-upload-btn": LocalJSX.ComponentsMobileUploadBtn & JSXBase.HTMLAttributes<HTMLComponentsMobileUploadBtnElement>;
+            "components-oem-virtual-chat-modal": LocalJSX.ComponentsOemVirtualChatModal & JSXBase.HTMLAttributes<HTMLComponentsOemVirtualChatModalElement>;
             /**
              * 职位选择器组件
              * 支持单选和多选模式

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pcm-agents",
-  "version": "1.0.2",
+  "version": "1.0.3",
   "description": "Components of pcm-agents",
   "main": "dist/index.cjs.js",
   "module": "dist/index.js",