@zeewain/3d-avatar-sdk 2.1.2 → 2.1.3

package/dist/index.d.ts

@@ -115,226 +115,6 @@ interface IUnityMessageSender<T extends string> {
     sendAsyncMessage(methodName: string, operation: T, parameter?: any): Promise<IUnityCallbackResponse>;
 }
 
-/**
- * @fileoverview 流式播报服务接口定义
- * @description 定义流式播报服务相关的类型、接口和枚举
- */
-
-/**
- * 播报操作类型枚举
- * @enum {string}
- * @description 定义播报服务支持的操作类型
- */
-declare enum BroadcastOperationType {
-    START_BROADCAST = "startBroadcast",
-    PAUSE_BROADCAST = "pauseBroadcast",
-    RESUME_BROADCAST = "resumeBroadcast",
-    STOP_BROADCAST = "stopBroadcast",
-    APPEND_BROADCAST = "appendBroadcast"
-}
-/**
- * 播报类型枚举
- * @enum {string}
- * @description 定义播报的类型，支持文本转语音和自定义音频播报
- */
-declare enum BroadcastType {
-    /** 文本智能体播报 */
-    TEXT = "text",
-    /** 自定义音频智能体播报 */
-    AUDIO = "audio"
-}
-/**
- * 播报服务配置接口
- * @interface IBroadcastServiceConfig
- * @extends {IUnityServiceConfig}
- * @description 播报服务的配置选项
- */
-interface IBroadcastServiceConfig extends IUnityServiceConfig {
-    /** 事件回调函数集合 */
-    callbacks?: IBroadcastCallbacks;
-}
-/**
- * 播报参数接口
- * @interface IBroadcastParams
- * @description 定义播报操作所需的参数
- */
-interface IBroadcastParams {
-    /** 播报类型 */
-    type: BroadcastType;
-    /** 数字人编码 */
-    humanCode: string;
-    /** 播报文本内容（文本播报时必填） */
-    text?: string;
-    /** 自定义音频URL（音频播报时必填） */
-    audioUrl?: string;
-    /** 音色编码（文本播报时必填） */
-    voiceCode?: string;
-    /** 播报速度，可选 */
-    speed?: number;
-    /** 播报音量（0-1） */
-    volume: number;
-    /** 是否显示字幕 */
-    isSubtitle: boolean;
-    /** 播报过程中才播放的动作集合，每个动作间隔2-3秒循环播放，播报顺序根据`motionPlayMode`参数处理，默认为`随机`，可选 */
-    motionList?: string[];
-    /** 动作播放模式，随机、顺序，随机=`random`，顺序=`sequence` */
-    motionPlayMode?: 'random' | 'sequence';
-}
-/**
- * 流式响应接口
- * @interface IBroadcastResponse
- * @description 定义流式播报API的响应格式
- */
-interface IBroadcastResponse {
-    /** 响应状态码，0表示成功 */
-    code: number;
-    /** 错误信息，可选 */
-    message?: string;
-    /** 响应数据 */
-    data: {
-        /** 音频文件URL，可选 */
-        voiceUrl?: string;
-        /** 任务ID，可选 */
-        taskId?: string;
-        /** 是否完成，可选 */
-        done?: boolean;
-        /** 口型数据URL，可选 */
-        mouthShapeUrl?: string;
-        /** 原始文本，可选 */
-        originalText?: string;
-        /** 字幕信息，可选 */
-        subtitleInfo?: {
-            /** 字幕列表 */
-            subtitleList: Array<{
-                /** 字幕索引 */
-                index: number;
-                /** 字幕文本 */
-                text: string;
-                /** 开始时间（毫秒） */
-                startTime: number;
-                /** 结束时间（毫秒） */
-                endTime: number;
-            }>;
-        };
-    };
-}
-/**
- * 播报回调接口
- * @interface IBroadcastCallbacks
- * @description 定义播报过程中的事件回调函数
- */
-interface IBroadcastCallbacks {
-    /** 播报开始时触发 */
-    onStart?: () => void;
-    /** 播报完成时触发 */
-    onFinish?: () => void;
-    /** 播报出错时触发 */
-    onError?: (error: Error) => void;
-    /** 播报暂停时触发 */
-    onPause?: () => void;
-    /** 播报恢复时触发 */
-    onResume?: () => void;
-    /** 播报停止时触发 */
-    onStop?: () => void;
-    /** 播报中断时触发 */
-    onAbort?: () => void;
-}
-/**
- * 播报API接口
- * @interface IBroadcastAPI
- * @description 定义播报服务的核心API接口
- */
-interface IBroadcastAPI {
-    /**
-     * 开始播报
-     * @param params - 播报参数
-     * @returns Promise<void> 播报操作的Promise
-     */
-    startBroadcast(params: IBroadcastParams): Promise<void>;
-    /**
-     * 暂停播报
-     * @returns Promise<void> 暂停操作的Promise
-     */
-    pauseBroadcast(resetIdle?: boolean): Promise<void>;
-    /**
-     * 恢复播报
-     * @returns Promise<void> 恢复操作的Promise
-     */
-    resumeBroadcast(): Promise<void>;
-    /**
-     * 停止播报
-     * @returns Promise<void> 停止操作的Promise
-     */
-    stopBroadcast(): Promise<void>;
-    /**
-     * 更新回调函数
-     * @param callbacks - 新的回调函数集合
-     */
-    updateCallbacks(callbacks: IBroadcastCallbacks): void;
-    /**
-     * 获取当前播报状态
-     * @returns object 返回当前播报状态信息
-     */
-    getStatus(): {
-        isActive: boolean;
-        isGeneratingAudio: boolean;
-        hasReceivedAudio: boolean;
-        queueInfo?: {
-            totalTasks: number;
-            requestingTasks: number;
-            completedTasks: number;
-            failedTasks: number;
-            totalPendingResponses: number;
-            currentSendingSequence: number;
-        };
-    };
-    /**
-     * 销毁播报服务
-     */
-    destroy(): void;
-}
-
-/**
- * @fileoverview SDK配置接口定义
- * @description 定义SDK实例初始化所需的配置参数
- */
-
-/**
- * SDK配置接口
- * @interface IAvatarSDKConfig
- * @description 定义SDK实例初始化所需的配置参数
- */
-interface IAvatarSDKConfig {
-    /** 全局用户认证令牌 */
-    token?: string;
-    /** 运行环境 */
-    env?: 'dev' | 'test' | 'prod' | 'custom';
-    /** api接口地址，仅当env为custom时有效 */
-    apiUrl?: string;
-    /** 资源文件地址（父级路径），从平台下载的资源文件所解压出来的目录 */
-    assetsUrl: string;
-    /** Unity加载器脚本URL */
-    loaderUrl: string;
-    /** Unity数据文件URL */
-    dataUrl: string;
-    /** Unity框架文件URL */
-    frameworkUrl: string;
-    /** Unity代码文件URL */
-    codeUrl: string;
-    /** 容器DOM元素ID，可选，默认为'unity-container' */
-    containerId?: string;
-    /** 待机动作编码列表，随机播放（排重方式）可选 */
-    idleMotionList?: string[];
-    /** 3D渲染引擎加载进度回调函数，可选 */
-    onProgress?: (progress: number) => void;
-    /** 播报回调函数，可选 */
-    broadcastCallbacks?: IBroadcastCallbacks;
-    /** 是否启用调试日志，默认为false */
-    enableDebugLog?: boolean;
-    /** 内部 WEBGL 版本 */
-    audioDrivenVersion?: string;
-}
-
 /**
  * @fileoverview Avatar API接口定义
  * @description 定义数字人控制API的核心接口、类型和枚举
@@ -426,178 +206,24 @@ interface IAvatarAPI {
 }
 
 /**
- * @fileoverview 统一的3D数字人SDK入口类
- * @description 提供统一的SDK接口，内部通过组合模式调用各个服务模块
+ * Unity服务日志记录器接口
+ * @interface ISimpleLogger
+ * @description 统一的日志记录接口
  */
+interface ISimpleLogger {
+    /** 记录调试信息 */
+    debug(message: string, data?: any): void;
+    /** 记录一般信息 */
+    info(message: string, data?: any): void;
+    /** 记录警告信息 */
+    warn(message: string, data?: any): void;
+    /** 记录错误信息 */
+    error(message: string, error?: Error, data?: any): void;
+}
 
 /**
- * 统一的3D数字人SDK类
- * @class ZEEAvatarSDK
- * @description 提供统一的SDK接口，简化用户使用体验，支持多实例
- */
-declare class ZEEAvatarSDK {
-    /** SDK唯一标识符 */
-    private readonly instanceId;
-    /** Unity加载器实例 */
-    private loader;
-    /** Avatar服务实例 */
-    private avatarService;
-    /** 播报服务实例 */
-    private broadcastService;
-    /** Unity实例 */
-    private unityInstance;
-    /** SDK初始化状态 */
-    private isInitialized;
-    /** SDK日志 */
-    private readonly logger;
-    /**
-     * 构造函数
-     * @param config SDK配置对象
-     */
-    constructor(config: IAvatarSDKConfig);
-    /**
-     * 初始化数字人
-     * @param avatarCode 数字人编码
-     * @param cameraType 摄像机类型
-     * @returns Promise<IAvatarCallbackResponse> 初始化结果
-     * @description 统一的初始化方法，包含Unity实例初始化和数字人加载
-     */
-    initializeAvatar(avatarCode: string, cameraType?: AvatarCameraType): Promise<IAvatarCallbackResponse>;
-    /**
-     * 更新Token
-     * @param token 新的认证Token
-     * @description 更新全局Token配置
-     */
-    updateToken(token: string): void;
-    /**
-     * 播放数字人动作
-     * @param clipCode 动作编码
-     * @returns Promise<IAvatarCallbackResponse> 播放结果
-     */
-    playMotion(clipCode: string): Promise<IAvatarCallbackResponse>;
-    /**
-     * 获取当前播放的动作信息
-     * @param getRemainingTime 是否获取剩余时间
-     * @returns Promise<IAvatarCallbackResponse> 动作信息
-     */
-    getCurrentMotion(getRemainingTime?: boolean): Promise<IAvatarCallbackResponse>;
-    /**
-     * 卸载数字人
-     * @returns Promise<IAvatarCallbackResponse> 卸载结果
-     */
-    unloadAvatar(): Promise<IAvatarCallbackResponse>;
-    /**
-     * 设置摄像机类型
-     * @param cameraType 摄像机类型
-     * @returns Promise<IAvatarCallbackResponse> 设置结果
-     */
-    setCamera(cameraType: AvatarCameraType): Promise<IAvatarCallbackResponse>;
-    /**
-     * 开始播报
-     * @param params 播报参数
-     * @param isAppend 是否追加播报
-     * @returns Promise<void> 播报操作的Promise
-     */
-    startBroadcast(params: IBroadcastParams, isAppend?: boolean): Promise<void>;
-    /**
-     * 暂停播报
-     * @param resetIdle 是否重置空闲状态
-     * @returns Promise<void> 暂停操作的Promise
-     */
-    pauseBroadcast(resetIdle?: boolean): Promise<void>;
-    /**
-     * 恢复播报
-     * @returns Promise<void> 恢复操作的Promise
-     */
-    resumeBroadcast(): Promise<void>;
-    /**
-     * 停止播报
-     * @returns Promise<void> 停止操作的Promise
-     */
-    stopBroadcast(): Promise<void>;
-    /**
-     * 更新播报回调函数
-     * @param callbacks 新的回调函数集合
-     */
-    updateBroadcastCallbacks(callbacks: IBroadcastCallbacks): void;
-    /**
-     * 获取播报状态
-     * @returns 播报状态信息
-     */
-    getBroadcastStatus(): {
-        isActive: boolean;
-        isGeneratingAudio: boolean;
-        hasReceivedAudio: boolean;
-        queueInfo?: {
-            totalTasks: number;
-            requestingTasks: number;
-            completedTasks: number;
-            failedTasks: number;
-            totalPendingResponses: number;
-            currentSendingSequence: number;
-        };
-    };
-    /**
-     * 销毁SDK实例
-     * @description 清理所有资源，包括Unity实例和服务
-     */
-    destroy(): void;
-    /**
-     * 获取SDK实例唯一标识符
-     * @returns string 实例ID
-     */
-    getInstanceId(): string;
-    /**
-     * 获取SDK初始化状态
-     * @returns boolean 是否已初始化
-     */
-    isSDKInitialized(): boolean;
-    /**
-     * 获取Avatar加载状态
-     * @returns boolean 是否已加载Avatar
-     */
-    isAvatarInitialized(): boolean;
-    /**
-     * 获取SDK配置
-     * @returns IAvatarSDKConfig 当前配置
-     */
-    getConfig(): IAvatarSDKConfig | null;
-    /**
-     * 确保SDK已初始化
-     * @private
-     */
-    private ensureInitialized;
-}
-
-/**
- * @fileoverview SDK 版本号常量
- * @description 此文件由构建脚本自动生成，请勿手动修改
- */
-/**
- * SDK 版本号
- * @const {string} SDK_VERSION
- */
-declare const SDK_VERSION = "2.1.2";
-
-/**
- * Unity服务日志记录器接口
- * @interface ISimpleLogger
- * @description 统一的日志记录接口
- */
-interface ISimpleLogger {
-    /** 记录调试信息 */
-    debug(message: string, data?: any): void;
-    /** 记录一般信息 */
-    info(message: string, data?: any): void;
-    /** 记录警告信息 */
-    warn(message: string, data?: any): void;
-    /** 记录错误信息 */
-    error(message: string, error?: Error, data?: any): void;
-}
-
-/**
- * @fileoverview Unity服务抽象基类
- * @description 提供Unity服务的通用基础实现，包括回调管理、消息发送、错误处理等功能
+ * @fileoverview Unity服务抽象基类
+ * @description 提供Unity服务的通用基础实现，包括回调管理、消息发送、错误处理等功能
  */
 
 /**
@@ -976,6 +602,7 @@ declare class BroadcastService extends UnityBaseService<BroadcastOperationType>
         hasReceivedAudio: boolean;
         queueInfo?: {
             totalTasks: number;
+            pendingTasks: number;
             requestingTasks: number;
             completedTasks: number;
             failedTasks: number;
@@ -999,22 +626,22 @@ declare class BroadcastService extends UnityBaseService<BroadcastOperationType>
     /**
      * 添加任务到队列
      * @param task - 播报任务
-     * @description 将任务添加到队列并立即开始请求
+     * @description 将任务添加到队列，只有当没有正在请求的任务时才开始请求（串行请求模式）
      * @private
      */
     private addTaskToQueue;
     /**
      * 处理队列
-     * @description 处理队列中的任务，发起请求生成音频
+     * @description 处理队列中的任务响应，按序号发送给unity播放
      * @private
      */
-    private processQueue;
+    private processTaskQueue;
     /**
      * 队列处理步骤
-     * @description 处理队列中的单个步骤，包括发起请求和发送音频
+     * @description 处理队列中的单个步骤，按序号发送给unity播放
      * @private
      */
-    private processQueueStep;
+    private processTaskQueueStep;
     /**
      * 开始任务请求
      * @param task - 播报任务
@@ -1031,16 +658,16 @@ declare class BroadcastService extends UnityBaseService<BroadcastOperationType>
      */
     private handleTaskResponse;
     /**
-     * 发送下一个响应
+     * 发送下一个响应给unity播放
      * @param task - 播报任务
-     * @description 发送任务中的第一个待发送响应到Unity，发送后立即删除
+     * @description 发送任务的响应数组中的第一个待发送响应到Unity（按顺序发送），发送后立即删除
      * @private
      */
     private sendNextResponse;
     /**
      * 处理任务关闭
      * @param task - 播报任务
-     * @description 处理任务的流式连接关闭
+     * @description 处理任务的流式连接关闭，并启动下一个待处理任务的请求
      * @private
      */
     private handleTaskClose;
@@ -1048,7 +675,7 @@ declare class BroadcastService extends UnityBaseService<BroadcastOperationType>
      * 处理任务错误
      * @param task - 播报任务
      * @param error - 错误对象
-     * @description 处理任务执行过程中的错误，防止重复触发错误回调
+     * @description 处理任务执行过程中的错误，防止重复触发错误回调，并启动下一个待处理任务
      * @private
      */
     private handleTaskError;
@@ -1093,10 +720,17 @@ declare class BroadcastService extends UnityBaseService<BroadcastOperationType>
     /**
      * 处理播报错误
      * @param errorCode - 错误码
+     * @param errorMessage - 错误消息
      * @description 处理播报过程中的错误
      * @private
      */
     private handleBroadcastError;
+    /**
+     * 启动下一个待处理任务的请求
+     * @description 在当前任务请求完成或失败后，检查并启动下一个待处理任务
+     * @private
+     */
+    private startNextPendingTask;
     /**
      * 清理队列处理定时器
      * @description 清理队列处理定时器
@@ -1423,5 +1057,382 @@ declare class ZEEAvatarLoader {
     protected initGlobalConfig(): void;
 }
 
+/**
+ * @fileoverview 流式播报服务接口定义
+ * @description 定义流式播报服务相关的类型、接口和枚举
+ */
+
+/**
+ * 播报操作类型枚举
+ * @enum {string}
+ * @description 定义播报服务支持的操作类型
+ */
+declare enum BroadcastOperationType {
+    START_BROADCAST = "startBroadcast",
+    PAUSE_BROADCAST = "pauseBroadcast",
+    RESUME_BROADCAST = "resumeBroadcast",
+    STOP_BROADCAST = "stopBroadcast",
+    APPEND_BROADCAST = "appendBroadcast"
+}
+/**
+ * 播报类型枚举
+ * @enum {string}
+ * @description 定义播报的类型，支持文本转语音和自定义音频播报
+ */
+declare enum BroadcastType {
+    /** 文本智能体播报 */
+    TEXT = "text",
+    /** 自定义音频智能体播报 */
+    AUDIO = "audio"
+}
+/**
+ * 播报服务配置接口
+ * @interface IBroadcastServiceConfig
+ * @extends {IUnityServiceConfig}
+ * @description 播报服务的配置选项
+ */
+interface IBroadcastServiceConfig extends IUnityServiceConfig {
+    /** 事件回调函数集合 */
+    callbacks?: IBroadcastCallbacks;
+}
+/**
+ * 播报参数接口
+ * @interface IBroadcastParams
+ * @description 定义播报操作所需的参数
+ */
+interface IBroadcastParams {
+    /** 播报类型 */
+    type: BroadcastType;
+    /** 数字人编码 */
+    humanCode: string;
+    /** 播报文本内容（文本播报时必填） */
+    text?: string;
+    /** 自定义音频URL（音频播报时必填） */
+    audioUrl?: string;
+    /** 音色编码（文本播报时必填） */
+    voiceCode?: string;
+    /** 播报速度，可选 */
+    speed?: number;
+    /** 播报音量（0-1） */
+    volume: number;
+    /** 是否显示字幕 */
+    isSubtitle: boolean;
+    /** 播报过程中才播放的动作集合，每个动作间隔2-3秒循环播放，播报顺序根据`motionPlayMode`参数处理，默认为`随机`，可选 */
+    motionList?: string[];
+    /** 动作播放模式，随机、顺序，随机=`random`，顺序=`sequence` */
+    motionPlayMode?: 'random' | 'sequence';
+}
+/**
+ * 流式响应接口
+ * @interface IBroadcastResponse
+ * @description 定义流式播报API的响应格式
+ */
+interface IBroadcastResponse {
+    /** 响应状态码，0表示成功 */
+    code: number;
+    /** 错误信息，可选 */
+    message?: string;
+    /** 响应数据 */
+    data: {
+        /** 音频文件URL，可选 */
+        voiceUrl?: string;
+        /** 任务ID，可选 */
+        taskId?: string;
+        /** 是否完成，可选 */
+        done?: boolean;
+        /** 口型数据URL，可选 */
+        mouthShapeUrl?: string;
+        /** 原始文本，可选 */
+        originalText?: string;
+        /** 字幕信息，可选 */
+        subtitleInfo?: {
+            /** 字幕列表 */
+            subtitleList: Array<{
+                /** 字幕索引 */
+                index: number;
+                /** 字幕文本 */
+                text: string;
+                /** 开始时间（毫秒） */
+                startTime: number;
+                /** 结束时间（毫秒） */
+                endTime: number;
+            }>;
+        };
+    };
+}
+/**
+ * 播报回调接口
+ * @interface IBroadcastCallbacks
+ * @description 定义播报过程中的事件回调函数
+ */
+interface IBroadcastCallbacks {
+    /** 播报开始时触发 */
+    onStart?: () => void;
+    /** 播报完成时触发 */
+    onFinish?: () => void;
+    /** 播报出错时触发 */
+    onError?: (error: SDKError) => void;
+    /** 播报暂停时触发 */
+    onPause?: () => void;
+    /** 播报恢复时触发 */
+    onResume?: () => void;
+    /** 播报停止时触发 */
+    onStop?: () => void;
+    /** 播报中断时触发 */
+    onAbort?: () => void;
+}
+/**
+ * 播报API接口
+ * @interface IBroadcastAPI
+ * @description 定义播报服务的核心API接口
+ */
+interface IBroadcastAPI {
+    /**
+     * 开始播报
+     * @param params - 播报参数
+     * @returns Promise<void> 播报操作的Promise
+     */
+    startBroadcast(params: IBroadcastParams): Promise<void>;
+    /**
+     * 暂停播报
+     * @returns Promise<void> 暂停操作的Promise
+     */
+    pauseBroadcast(resetIdle?: boolean): Promise<void>;
+    /**
+     * 恢复播报
+     * @returns Promise<void> 恢复操作的Promise
+     */
+    resumeBroadcast(): Promise<void>;
+    /**
+     * 停止播报
+     * @returns Promise<void> 停止操作的Promise
+     */
+    stopBroadcast(): Promise<void>;
+    /**
+     * 更新回调函数
+     * @param callbacks - 新的回调函数集合
+     */
+    updateCallbacks(callbacks: IBroadcastCallbacks): void;
+    /**
+     * 获取当前播报状态
+     * @returns object 返回当前播报状态信息
+     */
+    getStatus(): {
+        isActive: boolean;
+        isGeneratingAudio: boolean;
+        hasReceivedAudio: boolean;
+        queueInfo?: {
+            totalTasks: number;
+            requestingTasks: number;
+            completedTasks: number;
+            failedTasks: number;
+            totalPendingResponses: number;
+            currentSendingSequence: number;
+        };
+    };
+    /**
+     * 销毁播报服务
+     */
+    destroy(): void;
+}
+
+/**
+ * @fileoverview SDK配置接口定义
+ * @description 定义SDK实例初始化所需的配置参数
+ */
+
+/**
+ * SDK配置接口
+ * @interface IAvatarSDKConfig
+ * @description 定义SDK实例初始化所需的配置参数
+ */
+interface IAvatarSDKConfig {
+    /** 全局用户认证令牌 */
+    token?: string;
+    /** 运行环境 */
+    env?: 'dev' | 'test' | 'prod' | 'custom';
+    /** api接口地址，仅当env为custom时有效 */
+    apiUrl?: string;
+    /** 资源文件地址（父级路径），从平台下载的资源文件所解压出来的目录 */
+    assetsUrl: string;
+    /** Unity加载器脚本URL */
+    loaderUrl: string;
+    /** Unity数据文件URL */
+    dataUrl: string;
+    /** Unity框架文件URL */
+    frameworkUrl: string;
+    /** Unity代码文件URL */
+    codeUrl: string;
+    /** 容器DOM元素ID，可选，默认为'unity-container' */
+    containerId?: string;
+    /** 待机动作编码列表，随机播放（排重方式）可选 */
+    idleMotionList?: string[];
+    /** 3D渲染引擎加载进度回调函数，可选 */
+    onProgress?: (progress: number) => void;
+    /** 播报回调函数，可选 */
+    broadcastCallbacks?: IBroadcastCallbacks;
+    /** 是否启用调试日志，默认为false */
+    enableDebugLog?: boolean;
+    /** 内部 WEBGL 版本 */
+    audioDrivenVersion?: string;
+    /** 操作超时时间（毫秒），默认为30000 */
+    operationTimeout?: number;
+}
+
+/**
+ * @fileoverview 统一的3D数字人SDK入口类
+ * @description 提供统一的SDK接口，内部通过组合模式调用各个服务模块
+ */
+
+/**
+ * 统一的3D数字人SDK类
+ * @class ZEEAvatarSDK
+ * @description 提供统一的SDK接口，简化用户使用体验，支持多实例
+ */
+declare class ZEEAvatarSDK {
+    /** SDK唯一标识符 */
+    private readonly instanceId;
+    /** Unity加载器实例 */
+    private loader;
+    /** Avatar服务实例 */
+    private avatarService;
+    /** 播报服务实例 */
+    private broadcastService;
+    /** Unity实例 */
+    private unityInstance;
+    /** SDK初始化状态 */
+    private isInitialized;
+    /** SDK日志 */
+    private readonly logger;
+    /**
+     * 构造函数
+     * @param config SDK配置对象
+     */
+    constructor(config: IAvatarSDKConfig);
+    /**
+     * 初始化数字人
+     * @param avatarCode 数字人编码
+     * @param cameraType 摄像机类型
+     * @returns Promise<IAvatarCallbackResponse> 初始化结果
+     * @description 统一的初始化方法，包含Unity实例初始化和数字人加载
+     */
+    initializeAvatar(avatarCode: string, cameraType?: AvatarCameraType): Promise<IAvatarCallbackResponse>;
+    /**
+     * 更新Token
+     * @param token 新的认证Token
+     * @description 更新全局Token配置
+     */
+    updateToken(token: string): void;
+    /**
+     * 播放数字人动作
+     * @param clipCode 动作编码
+     * @returns Promise<IAvatarCallbackResponse> 播放结果
+     */
+    playMotion(clipCode: string): Promise<IAvatarCallbackResponse>;
+    /**
+     * 获取当前播放的动作信息
+     * @param getRemainingTime 是否获取剩余时间
+     * @returns Promise<IAvatarCallbackResponse> 动作信息
+     */
+    getCurrentMotion(getRemainingTime?: boolean): Promise<IAvatarCallbackResponse>;
+    /**
+     * 卸载数字人
+     * @returns Promise<IAvatarCallbackResponse> 卸载结果
+     */
+    unloadAvatar(): Promise<IAvatarCallbackResponse>;
+    /**
+     * 设置摄像机类型
+     * @param cameraType 摄像机类型
+     * @returns Promise<IAvatarCallbackResponse> 设置结果
+     */
+    setCamera(cameraType: AvatarCameraType): Promise<IAvatarCallbackResponse>;
+    /**
+     * 开始播报
+     * @param params 播报参数
+     * @param isAppend 是否追加播报
+     * @returns Promise<void> 播报操作的Promise
+     */
+    startBroadcast(params: IBroadcastParams, isAppend?: boolean): Promise<void>;
+    /**
+     * 暂停播报
+     * @param resetIdle 是否重置空闲状态
+     * @returns Promise<void> 暂停操作的Promise
+     */
+    pauseBroadcast(resetIdle?: boolean): Promise<void>;
+    /**
+     * 恢复播报
+     * @returns Promise<void> 恢复操作的Promise
+     */
+    resumeBroadcast(): Promise<void>;
+    /**
+     * 停止播报
+     * @returns Promise<void> 停止操作的Promise
+     */
+    stopBroadcast(): Promise<void>;
+    /**
+     * 更新播报回调函数
+     * @param callbacks 新的回调函数集合
+     */
+    updateBroadcastCallbacks(callbacks: IBroadcastCallbacks): void;
+    /**
+     * 获取播报状态
+     * @returns 播报状态信息
+     */
+    getBroadcastStatus(): {
+        isActive: boolean;
+        isGeneratingAudio: boolean;
+        hasReceivedAudio: boolean;
+        queueInfo?: {
+            totalTasks: number;
+            pendingTasks: number;
+            requestingTasks: number;
+            completedTasks: number;
+            failedTasks: number;
+            totalPendingResponses: number;
+            currentSendingSequence: number;
+        };
+    };
+    /**
+     * 销毁SDK实例
+     * @description 清理所有资源，包括Unity实例和服务
+     */
+    destroy(): void;
+    /**
+     * 获取SDK实例唯一标识符
+     * @returns string 实例ID
+     */
+    getInstanceId(): string;
+    /**
+     * 获取SDK初始化状态
+     * @returns boolean 是否已初始化
+     */
+    isSDKInitialized(): boolean;
+    /**
+     * 获取Avatar加载状态
+     * @returns boolean 是否已加载Avatar
+     */
+    isAvatarInitialized(): boolean;
+    /**
+     * 获取SDK配置
+     * @returns IAvatarSDKConfig 当前配置
+     */
+    getConfig(): IAvatarSDKConfig | null;
+    /**
+     * 确保SDK已初始化
+     * @private
+     */
+    private ensureInitialized;
+}
+
+/**
+ * @fileoverview SDK 版本号常量
+ * @description 此文件由构建脚本自动生成，请勿手动修改
+ */
+/**
+ * SDK 版本号
+ * @const {string} SDK_VERSION
+ */
+declare const SDK_VERSION = "2.1.3";
+
 export { AvatarCameraType, AvatarOperationType, AvatarService, BroadcastOperationType, BroadcastService, BroadcastType, ConfigErrorCode, ERROR_CODE_MAP, ErrorCategory, NetworkErrorCode, OperationErrorCode, ResourceErrorCode, SDKError, SDK_VERSION, SystemErrorCode, UnityOperationStatus, ZEEAvatarLoader, ZEEAvatarSDK, getErrorInfo };
 export type { IAvatarAPI, IAvatarCallbackResponse, IAvatarSDKConfig, IBroadcastAPI, IBroadcastCallbacks, IBroadcastParams, IBroadcastResponse, IBroadcastServiceConfig, IUnityCallbackManager, IUnityCallbackResponse, IUnityInstance, IUnityMessageSender, IUnityServiceConfig, SDKErrorCode, TOperationType };