@xmov/avatar 2.0.0-alpha.38

package/dist/baseRender/AvatarRenderer.d.ts

@@ -0,0 +1,226 @@
+/**
+ * 3D 渲染（身体+表情）
+ */
+import ResourceManager from "../modules/ResourceManager";
+import { DataCacheQueue, IBodyFrame } from "../control/DataCacheQueue";
+import { GLDevice } from "../utils/GLDevice";
+import { GLPipeline, GLPipelineCharData } from "../utils/GLPipeline";
+import { EErrorCode } from "../types/error";
+import { Layout, RenderState, WalkConfig } from "../types";
+import SaveAndDownload from "../control/SaveAndDownload";
+import { IRawFaceFrameData } from "types/frame-data";
+type Option = {
+    dataCacheQueue: DataCacheQueue;
+    resourceManager: ResourceManager;
+    saveAndDownload: SaveAndDownload;
+    forceSyncDecoder: () => void;
+    reportMessage: (message: {
+        code: EErrorCode;
+        message: string;
+        e?: object;
+    }) => void;
+    onDownloadProgress: (progress: number) => void;
+    onStateChange: (state: string) => void;
+    onRenderChange: (state: RenderState) => void;
+    sendVideoInfo: (info: {
+        name: string;
+        body_id: number;
+        id: number;
+    }) => void;
+    onError: (error: any) => void;
+    sendSdkPoint: (point: string, data: any) => void;
+};
+export default class AvatarRender {
+    private TAG;
+    options: Option;
+    canvas: HTMLCanvasElement;
+    device: GLDevice | null;
+    pipeline: GLPipeline | null;
+    currentBodyFrame: IBodyFrame | null;
+    lastFaceFrame: IRawFaceFrameData | null;
+    private isInit;
+    private isFirstRender;
+    private lastFrameState;
+    private lastRenderState;
+    private onDownloadProgress;
+    private onStateChange?;
+    private onRenderChange?;
+    private sendVideoInfo;
+    private lostHandler;
+    private restoreHandler;
+    private avatarCanvasVisible;
+    private lastRealFaceFrameData;
+    private lastRealFaceFrame;
+    private lastWeight;
+    private lastFrameIndex;
+    private saveAndDownload;
+    private canvasOffsetX;
+    private baseWalkOffset;
+    private lastBodyOffset;
+    private pendingCharData;
+    private interrupt;
+    private walkConfig;
+    layout: Layout | null;
+    private allLostFrameCount;
+    private allLostFaceFrameCount;
+    private maxLostFrameCount;
+    private forceSyncDecoder;
+    private createPipelineLock;
+    private restoreTimeout;
+    private isRecovering;
+    private recoverStartTime;
+    private recoveryStage;
+    private readonly recoveryMaxAttempts;
+    private readonly recoveryBaseDelays;
+    private readonly recoveryMaxDelay;
+    private currentStageAttempts;
+    private isUsingReducedResolution;
+    private resolutionRestoreTimer;
+    private readonly RESOLUTION_RESTORE_DELAY;
+    private scale;
+    private sendSdkPoint;
+    private copyCanvas;
+    private copyCtx;
+    constructor(options: Option);
+    /**
+     * 重置表情相关状态（用于从隐身模式恢复渲染时）
+     */
+    resetFaceFrameState(): void;
+    /**
+     * 创建 pipeline 并设置字符数据
+     */
+    createPipeline(): void;
+    _lostHandler(event: Event): void;
+    _restoreHandler(event: Event): void;
+    /**
+     * 根据当前阶段分发到对应的恢复方法
+     */
+    private _recoverContext;
+    /**
+     * 阶段 1 — 轻量恢复
+     * 复用现有 canvas，仅重建 GLDevice + GLPipeline
+     * 适用于：上下文偶发丢失、浏览器后台恢复
+     */
+    private _tryLightRecovery;
+    /**
+     * 阶段 2 — 中等恢复
+     * 创建新 canvas 替换 DOM 节点，重建 GLDevice + GLPipeline
+     * 适用于：canvas 节点本身出现异常（如全屏切换导致的 DOM 重建）
+     */
+    private _tryMediumRecovery;
+    /**
+     * 阶段 3 — 完全恢复（降级分辨率）
+     * 在全量重建基础上降低渲染分辨率，减少 GPU 压力
+     * 适用于：GPU 资源受限设备（笔记本集成显卡）连续上下文丢失
+     */
+    private _tryFullRecovery;
+    /**
+     * 恢复成功后的统一收尾处理
+     */
+    private _onRecoverySuccess;
+    /**
+     * 安排恢复原始分辨率
+     * 在降级分辨率稳定运行一段时间后尝试恢复
+     */
+    private _scheduleResolutionRestore;
+    /**
+     * 恢复原始分辨率
+     * 尝试将 canvas 恢复到原始分辨率，如果再次丢失上下文则保持降级
+     */
+    private _restoreOriginalResolution;
+    /**
+     * 升级恢复阶段：light → medium → full → 放弃
+     */
+    private _advanceStage;
+    /**
+     * 按指数退避延迟安排下一次恢复尝试
+     * 延迟计算：baseDelay * 2^attempt，受 maxDelay 上限约束
+     */
+    private _scheduleNextAttempt;
+    /**
+     * 上报单次恢复失败事件
+     */
+    private _reportRecoveryFailure;
+    init(data: GLPipelineCharData | null): void;
+    private style;
+    /**
+     * 设置画布样式（修复transform失效 + 优化对齐逻辑 + 优雅拼接样式）
+     * @param avatar 布局配置
+     */
+    setCanvasStyle(layout: Layout): void;
+    setWalkConfig(walkConfig: WalkConfig): void;
+    setCharacterCanvasAnchor(layout?: Layout): void;
+    computeWeight(frameIndex: any): number;
+    render(frameIndex: number): {
+        canvas: HTMLCanvasElement;
+        rendered: boolean;
+    };
+    renderBackground(): void;
+    _setCurrentBodyFrame(bodyFrame?: IBodyFrame): void;
+    _getCurrentBodyFrameInfo(frameIndex: number): {
+        client_frame: number;
+        current_ani: string;
+        current_ani_frame: number;
+        next_state: string;
+    };
+    /**
+     * 获取当前帧的 body 和 face 原始数据（用于回调）
+     * 不包含渲染数据，只返回帧号、body_id 等元数据
+     */
+    _getCurrentFrameData(frameIndex: number): {
+        body: {
+            body_id: number;
+            name: string;
+            video_frame: number;
+            sf: number;
+            state: string;
+        } | null;
+        face: {
+            body_id: number;
+            sf: number;
+            ef: number;
+            state: string;
+            face_frame_type: number;
+        } | null;
+    };
+    /**
+     * 设置canvas的显隐状态
+     * @param visible 是否可见
+     */
+    setCanvasVisibility(visible: boolean): void;
+    /**
+     * 获取canvas的显隐状态
+     */
+    getCanvasVisibility(): boolean;
+    destroy(): void;
+    setInterrupt(interrupt: boolean): void;
+    /**
+     * [测试用] 模拟 WebGL 上下文丢失
+     * 用于测试分阶段恢复策略是否正常工作
+     * @param restoreAfterMs 自动恢复上下文的延迟时间（毫秒），设置为 0 则不自动恢复
+     * @param forceFail 强制恢复失败（用于测试 medium/full 阶段的升级逻辑）
+     */
+    simulateContextLoss(restoreAfterMs?: number, forceFail?: boolean): void;
+    /**
+     * [测试用] 获取当前恢复状态信息
+     */
+    getRecoveryStatus(): {
+        isRecovering: boolean;
+        stage: string;
+        attempts: number;
+        maxAttempts: number;
+        isUsingReducedResolution: boolean;
+    };
+    /**
+     * [测试用] 批量测试分阶段恢复
+     * 依次触发多次上下文丢失，观察各阶段的恢复情况
+     */
+    testStagedRecovery(): Promise<void>;
+    /**
+     * 手动重启 WebGL：创建新 canvas + 新 GLDevice + 新 GLPipeline
+     * 用于分阶段恢复全部失败后的手动恢复
+     * @returns 是否成功
+     */
+    restartWebGL(): boolean;
+}
+export {};

package/dist/baseRender/MSEAudioPlayer.d.ts

@@ -0,0 +1,51 @@
+export default class MediaSourceAudioPlayer {
+    private mediaSource;
+    private audioElement;
+    private sourceBuffer;
+    isInitialized: boolean;
+    isPlaying: boolean;
+    private volume;
+    private readonly MIME_TYPE;
+    private queue;
+    private isUpdating;
+    private currentObjectURL;
+    private isDestroyed;
+    private playbackRate;
+    firstFrameIndex: number;
+    private static instance;
+    static getInstance(sdk: any): MediaSourceAudioPlayer;
+    private constructor();
+    /**
+     * 只复用 audio 标签！！！
+     */
+    private createAudioElement;
+    /**
+     * 每次都创建 NEW MediaSource
+     * 不复用！不复用！不复用！
+     */
+    private createNewMediaSource;
+    /**
+     * 销毁当前 MediaSource 所有资源
+     * stop 时调用
+     */
+    private destroyCurrentMediaSource;
+    stop(callback: () => void): void;
+    addAudioSegment(audioData: ArrayBuffer): Promise<void>;
+    private processQueue;
+    start(): Promise<void>;
+    getStats(): {
+        isPlaying: boolean;
+        isInitialized: boolean;
+        queueLength: number;
+        bufferedRanges: string;
+        mediaSourceReadyState: string;
+    };
+    setSpeed(speed: number): void;
+    /**
+     * 获取缓冲范围
+     */
+    private getBufferedRanges;
+    setVolume(volume: number): void;
+    setPlaybackRate(rate: number): void;
+    destroy(): void;
+}

package/dist/baseRender/UIRenderer.d.ts

@@ -0,0 +1,39 @@
+/**
+ * UI 控件渲染，所有轨道的元素
+ */
+import { DataCacheQueue } from "../control/DataCacheQueue";
+import TrackerRenderer from "../modules/TrackRenderer/index";
+import ResourceManager from "../modules/ResourceManager";
+import XmovAvatar from "../index";
+type Option = {
+    sdk: XmovAvatar;
+    dataCacheQueue: DataCacheQueue;
+    resourceManager: ResourceManager;
+    enableClientInterrupt: boolean;
+    onVoiceEnd: (client_speak_id: number | string, speech_id: number) => void;
+    onVoiceStart: (duration: number, client_speak_id: number | string) => void;
+    onWalkStateChange: (state: string) => void;
+    sendSdkPoint: (type: string, data: any, extra?: any) => void;
+    onSpeakStateChange: (state: string, client_speak_id: number | string, speech_id: number) => void;
+};
+export default class UIRenderer {
+    private TAG;
+    options: Option;
+    trackerRenderer: TrackerRenderer[];
+    root: HTMLDivElement;
+    lastFrameIndex: number;
+    onVoiceEnd: (client_speak_id: number | string, speech_id: number) => void;
+    onVoiceStart: (duration: number, client_speak_id: number | string) => void;
+    onWalkStateChange: (state: string) => void;
+    initEventsRendered: boolean;
+    lastSpeechId: number;
+    interruptSpeechId: number;
+    enableClientInterrupt: boolean;
+    onSpeakStateChange: (state: string, client_speak_id: number | string, speech_id: number) => void;
+    constructor(options: Option);
+    render(frame: number): TrackerRenderer[] | undefined;
+    clearTrackerRenderer(): void;
+    setInterrupt(speech_id: number): void;
+    destroy(): void;
+}
+export {};

package/dist/baseRender/pcm-audio-processor.d.ts

@@ -0,0 +1,63 @@
+declare class PCMAudioProcessor {
+    static get parameterDescriptors(): {
+        name: string;
+        defaultValue: number;
+        minValue: number;
+        maxValue: number;
+        automationRate: string;
+    }[];
+    config: {
+        sampleRate: number;
+        bytesPerSample: number;
+    };
+    pcmCache: Uint8Array;
+    isActive: boolean;
+    isDestroyed: boolean;
+    fadeState: {
+        phase: string;
+        currentGain: number;
+        fadeTime: number;
+        fadeSamples: number;
+    };
+    currentSegment: Float32Array | null;
+    segmentOffset: number;
+    /**
+     * 处理主线程发来的消息（PCM数据/状态控制等）
+     * @param {Object} data - 消息数据
+     * @param {string} data.type - 消息类型：'pcm'/'start'/'pause'/'stop'/'config'/'destroy'/'volume'
+     * @param {Uint8Array} [data.pcmData] - PCM数据（仅type='pcm'时存在）
+     * @param {Object} [data.config] - 配置更新（仅type='config'时存在）
+     * @param {number} [data.volume] - 音量值（仅type='volume'时存在）
+     */
+    handleMainThreadMessage(data: {
+        type: string;
+        pcmData?: Uint8Array | undefined;
+        config?: any;
+        volume?: number | undefined;
+    }): void;
+    volume: number | undefined;
+    /**
+     * 重置当前音频段状态（暂停/停止时调用）
+     */
+    resetSegmentState(): void;
+    /**
+     * S16LE Uint8Array 转 Float32Array（-1~1范围）
+     * @param {Uint8Array} pcmData - PCM数据
+     * @returns {Float32Array} 转换后的音频样本
+     */
+    pcmToFloat32(pcmData: Uint8Array): Float32Array;
+    /**
+     * 计算当前样本的增益（淡入淡出）
+     * @param {number} segmentLength - 当前音频段的总样本数
+     * @returns {number} 增益值（0~1）
+     */
+    calculateGain(segmentLength: number): number;
+    /**
+     * AudioWorklet核心方法：实时生成音频样本（音频线程调用）
+     * @param {Float32Array[][]} inputs - 输入样本
+     * @param {Float32Array[][]} outputs - 输出样本（单声道）
+     * @param {Object} parameters - 音频参数
+     * @returns {boolean} 是否继续运行
+     */
+    process(inputs: Float32Array[][], outputs: Float32Array[][], parameters: any): boolean;
+}

package/dist/control/APIForwarder.d.ts

@@ -0,0 +1,23 @@
+/**
+ * APIForwarder - 薄客户端模式下的 API 代理转发器
+ * 将客户端的 speak/idle/listen 等 API 调用封装为 api_call 消息，
+ * 通过 StreamingClient 发送给 Server 端 SDK 执行。
+ */
+import { StreamingClient } from './StreamingClient';
+export declare class APIForwarder {
+    private client;
+    constructor(client: StreamingClient);
+    speak(ssml: string, is_start?: boolean, is_end?: boolean, extra?: any): void;
+    idle(): void;
+    listen(): void;
+    think(): void;
+    interactiveidle(): void;
+    interrupt(type: string): void;
+    changeLayout(layout: any): void;
+    changeWalkConfig(walkConfig: any): void;
+    setVolume(volume: number): void;
+    changeAvatarVisible(visible: boolean): void;
+    switchInvisibleMode(): void;
+    destroy(reason?: string): void;
+    init(config?: any): void;
+}

package/dist/control/DataCacheQueue.d.ts

@@ -0,0 +1,69 @@
+import { IRawAudioFrameData, IRawFaceFrameData, IRawEventFrameData, IRawFrameData, StateChangeInfo } from "../types/frame-data";
+export interface IBodyFrame {
+    frame: any;
+    frameIndex: number;
+    frameState: string;
+    id: number;
+    name: string;
+    body_id: number;
+    hfd: boolean;
+    sf: number;
+    offset: number;
+}
+export declare class DataCacheQueue {
+    private TAG;
+    private _bodyQueue;
+    private _facialQueue;
+    private _realFacialQueue;
+    private audioQueue;
+    private eventQueue;
+    private videoIdList;
+    private _currentPlayState;
+    private _currentTtsaState;
+    constructor();
+    set currentPlayState(state: string);
+    get currentPlayState(): string;
+    set currentTtsaState(state: StateChangeInfo | null);
+    get currentTtsaState(): StateChangeInfo | null;
+    get bodyQueue(): IBodyFrame[];
+    _updateBodyImageBitmap(data: IBodyFrame): void;
+    clearOldFrames(sf: number): void;
+    clearOldFaceData(frameNumber: number): void;
+    setVideoIdList(videoId: string): void;
+    getVideoIdList(): string[];
+    /**
+     * 获取指定帧并从Map中删除
+     * @param frameIndex 要获取的帧索引
+     * @returns 找到的帧数据（未找到则返回undefined）
+     */
+    _getBodyImageBitmap(frameIndex: number): IBodyFrame | undefined;
+    getBodyVideoNameListLength(): number;
+    _getFaceImageBitmap(frameIndex: number, body_id: number): IRawFaceFrameData | null;
+    _updateFacial(data: Array<IRawFaceFrameData>): void;
+    get facialQueue(): IRawFaceFrameData[];
+    _getRealFaceImageBitmap(frameIndex: number, body_id: number): IRawFaceFrameData | null;
+    _updateRealFacial(data: Array<IRawFaceFrameData>): void;
+    get realFacialQueue(): IRawFaceFrameData[];
+    /**
+     * 清空所有表情数据（用于切换隐身模式时）
+     */
+    clearAllFaceData(): void;
+    _updateAudio(data: Array<IRawAudioFrameData>): void;
+    _clearAudio(speech_id: number): void;
+    _getAudio(frameIndex: number): IRawAudioFrameData | undefined;
+    _getAudioInterval(startFrame: number, endFrame: number): IRawAudioFrameData | undefined;
+    _updateUiEvent(data: Array<IRawEventFrameData>): void;
+    clearOldEvent(frame: number): void;
+    clearSubtitleOn(speech_id: number): void;
+    _clearEvent(): void;
+    _getEvent(frame: number): any;
+    _getEventInterval(startFrame: number, endFrame: number): any;
+    _mergeEventsBySf(events: any[]): any;
+    /**
+     * 检查数据是否因seek等原因失效，并清理缓存。
+     * @param data 新的数据帧数组
+     * @param type 数据类型
+     */
+    checkValidData(data: Array<IRawFrameData>, type: string): void;
+    destroy(): void;
+}

package/dist/control/EventDispatcher.d.ts

@@ -0,0 +1,35 @@
+/**
+ * EventDispatcher - 薄客户端模式下的事件分发器
+ * 接收来自 Streaming Server 转发的 event_proxy 消息，
+ * 分发到用户注册的回调函数。
+ */
+import { AvatarStatus, RenderState, IFrameDataUpdate } from '../types/index';
+import type { IRawWidgetData } from '../types/frame-data';
+import { FPSStats } from '../utils/fpsTracker';
+export interface EventDispatcherCallbacks {
+    onStateChange?: (state: string) => void;
+    onSpeakStateChange?: (state: string, client_speak_id: string | number) => void;
+    onVoiceStateChange?: (state: string, duration?: number, client_speak_id?: string | number) => void;
+    onStatusChange?: (status: AvatarStatus) => void;
+    onRenderChange?: (state: RenderState) => void;
+    onWalkStateChange?: (state: string) => void;
+    onWidgetEvent?: (data: IRawWidgetData) => void;
+    onMessage?: (error: any) => void;
+    onNetworkInfo?: (info: any) => void;
+    onFPSUpdate?: (stats: FPSStats) => void;
+    onDownloadProgress?: (progress: number) => void;
+    onSessionId?: (sessionId: string) => void;
+    onFrameDataUpdate?: (data: IFrameDataUpdate) => void;
+}
+export declare class EventDispatcher {
+    private callbacks;
+    private subtitleText;
+    private subtitleVisible;
+    constructor(callbacks: EventDispatcherCallbacks);
+    /**
+     * 处理来自 Streaming Server 的 event_proxy 消息
+     */
+    dispatch(eventType: string, data: any, _serverFrame?: number): void;
+    getSubtitleText(): string;
+    isSubtitleVisible(): boolean;
+}

package/dist/control/RenderScheduler.d.ts

@@ -0,0 +1,162 @@
+import ResourceManager from "../modules/ResourceManager";
+import { EFrameDataType, IRawFrameData, IRawFaceFrameData, ITtsFaceFrameData, StateChangeInfo, SYNC_FRAME_DATA } from "../types/frame-data";
+import { EErrorCode } from "../types/error";
+import AudioRenderer from "../baseRender/AudioRenderer";
+import type XmovAvatar from "../index";
+import { RenderState, WalkConfig, IFrameDataUpdate } from "../types/index";
+import { Layout } from "../types";
+import { FPSStats } from "../utils/fpsTracker";
+interface CONFIG {
+    sdkInstance: XmovAvatar;
+    container: Element;
+    hardwareAcceleration: string;
+    resourceManager: ResourceManager;
+    enableDebugger?: boolean;
+    enableClientInterrupt?: boolean;
+    audioOnlyMode?: boolean;
+    onDownloadProgress: (progress: number) => void;
+    onStateChange: (state: string) => void;
+    onSpeakStateChange: (state: string, client_speak_id: number | string) => void;
+    onRenderChange: (state: RenderState, oldState?: RenderState) => void;
+    onVoiceStateChange: (state: string, duration?: number, client_speak_id?: string | number) => void;
+    onWalkStateChange: (state: string) => void;
+    sendVideoInfo: (info: {
+        name: string;
+        body_id: number;
+        id: number;
+    }) => void;
+    sendMessage: (type: string, payload: any) => void;
+    setAudioInfo: (info: {
+        sf: number;
+        ef: number;
+        ad: Uint8Array;
+    }) => void;
+    setEventData: (info: {
+        sf: number;
+        ef: number;
+        event: Array<any>;
+    }) => void;
+    renderFrameCallback: (frame: number) => void;
+    reportMessage: (message: {
+        code: EErrorCode;
+        message: string;
+        e?: object;
+    }) => void;
+    sendSdkPoint: (type: string, data: any, extra?: any) => void;
+    onFPSUpdate: (stats: FPSStats) => void;
+    onFrameDataUpdate?: (data: IFrameDataUpdate) => void;
+}
+export default class RenderScheduler {
+    private TAG;
+    private dataCacheQueue;
+    private sdk;
+    private config;
+    private avatarRenderer;
+    private audioRenderer;
+    private uiRenderer;
+    private composition;
+    private currentSpeechId;
+    private resourceManager;
+    private frameAnimationController;
+    private isStartPlay;
+    private renderState;
+    private onDownloadProgress;
+    private onRenderChange;
+    private decoder;
+    private saveAndDownload;
+    lastSpeechId: number;
+    private enableClientInterrupt;
+    private audioOnlyMode;
+    private _speedResetTimer;
+    private offsetFrame;
+    private hasSendTimeJson;
+    private onFPSUpdate;
+    private setAudioInfo;
+    private setEventData;
+    private reportMessage;
+    private sendSdkPoint;
+    private sendMessage;
+    constructor(config: CONFIG);
+    init(): void;
+    /**
+     * 处理数据：拆解并添加到缓存队列中
+     * @param data TTSA 下发的数据
+     */
+    handleData(type: EFrameDataType, data: IRawFrameData[] | SYNC_FRAME_DATA): Promise<void>;
+    setOffsetFrame(offsetFrame: number): void;
+    setVolume(volume: number): void;
+    runStartFrameIndex(): void;
+    stateChangeHandle(e: any): void;
+    stopAudio(speech_id: number): void;
+    render(): void;
+    stop(): void;
+    /**
+     * 暂停渲染（停止渲染循环和音频播放）
+     * 但继续接收和处理后端推送的数据并放入缓存队列，避免切换到在线时丢失数据导致丢帧
+     */
+    pauseRender(): void;
+    /**
+     * 恢复渲染
+     */
+    resumeRender(): void;
+    /**
+     * 切换隐身模式（暂停/恢复渲染）
+     */
+    switchInvisibleMode(): void;
+    /**
+     * 获取渲染状态
+     */
+    getRenderState(): RenderState;
+    destroy(): void;
+    handleFaceData(data: ITtsFaceFrameData[]): IRawFaceFrameData[];
+    forceSyncDecoder(): void;
+    _reload(): void;
+    _getResumeInfo(): {
+        client_frame: number;
+        current_ani: string;
+        current_ani_frame: number;
+        next_state: string;
+    };
+    sendVoiceEnd(): void;
+    _offlineMode(): void;
+    _offlineRun(): void;
+    ttsaStateChangeHandle(state: StateChangeInfo): void;
+    resume(): void;
+    /**
+     * 设置数字人canvas的显隐状态
+     * @param visible 是否可见
+     */
+    setAvatarCanvasVisible(visible: boolean): void;
+    setCharacterCanvasLayout(layout?: Layout): void;
+    setWalkConfig(walkConfig: WalkConfig): void;
+    interrupt(type?: string): number;
+    seekToFrame(frame: number): void;
+    getCurrentFrameIndex(): number;
+    getSpeechId(): number;
+    getAudioRenderer(): AudioRenderer;
+    /**
+     * [测试用] 模拟 WebGL 上下文丢失
+     */
+    simulateContextLoss(restoreAfterMs?: number, forceFail?: boolean): void;
+    /**
+     * [测试用] 获取当前恢复状态信息
+     */
+    getRecoveryStatus(): {
+        isRecovering: boolean;
+        stage: string;
+        attempts: number;
+        maxAttempts: number;
+        isUsingReducedResolution: boolean;
+    };
+    /**
+     * [测试用] 批量测试分阶段恢复
+     */
+    testStagedRecovery(): Promise<void>;
+    /**
+     * 手动重启 WebGL：创建新 canvas + 新 GLDevice + 新 GLPipeline
+     * 用于分阶段恢复全部失败后的手动恢复
+     * @returns 是否成功
+     */
+    restartWebGL(): boolean;
+}
+export {};

package/dist/control/SaveAndDownload.d.ts

@@ -0,0 +1,14 @@
+export default SaveAndDownload;
+declare class SaveAndDownload {
+    constructor(fileName?: string, enabled?: boolean);
+    fileName: string;
+    enabled: boolean;
+    data: {};
+    downloadButton: HTMLAnchorElement | null;
+    initDownloadButton(): void;
+    writeFields(fields: any): void;
+    appendMultipleToArray(fieldName: any, items: any): void;
+    download(): void;
+    generateJSONContent(): string;
+    downloadFile(content: any, fileName: any, contentType: any): void;
+}