@zeewain/3d-avatar-sdk 1.2.4 → 2.1.1

package/dist/index.d.ts

@@ -114,32 +114,6 @@ interface IUnityMessageSender<T extends string> {
     /** 发送异步消息到Unity并等待回调 */
     sendAsyncMessage(methodName: string, operation: T, parameter?: any): Promise<IUnityCallbackResponse>;
 }
-/**
- * Unity服务日志级别枚举
- * @enum {string}
- * @description 定义日志记录的级别
- */
-declare enum LogLevel {
-    DEBUG = "debug",
-    INFO = "info",
-    WARN = "warn",
-    ERROR = "error"
-}
-/**
- * Unity服务日志记录器接口
- * @interface IUnityLogger
- * @description 统一的日志记录接口
- */
-interface IUnityLogger {
-    /** 记录调试信息 */
-    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 流式播报服务接口定义
@@ -305,8 +279,14 @@ interface IBroadcastAPI {
         isActive: boolean;
         isGeneratingAudio: boolean;
         hasReceivedAudio: boolean;
-        pendingCallbacks: number;
-        hasController: boolean;
+        queueInfo?: {
+            totalTasks: number;
+            requestingTasks: number;
+            completedTasks: number;
+            failedTasks: number;
+            totalPendingResponses: number;
+            currentSendingSequence: number;
+        };
     };
     /**
      * 销毁播报服务
@@ -331,10 +311,8 @@ interface IAvatarSDKConfig {
     env?: 'dev' | 'test' | 'prod' | 'custom';
     /** api接口地址，仅当env为custom时有效 */
     apiUrl?: string;
-    /** 资源文件地址，仅当env为custom时有效 */
-    assetsUrl?: string;
-    /** AB资源文件地址 */
-    resourcesUrl?: string;
+    /** 资源文件地址（父级路径），从平台下载的资源文件所解压出来的目录 */
+    assetsUrl: string;
     /** Unity加载器脚本URL */
     loaderUrl: string;
     /** Unity数据文件URL */
@@ -353,6 +331,8 @@ interface IAvatarSDKConfig {
     broadcastCallbacks?: IBroadcastCallbacks;
     /** 是否启用调试日志，默认为false */
     enableDebugLog?: boolean;
+    /** 内部 WEBGL 版本 */
+    audioDrivenVersion?: string;
 }
 
 /**
@@ -394,6 +374,8 @@ interface IAvatarCallbackResponse extends IUnityCallbackResponse {
         motionId?: string;
         /** 动作剩余时间，可选 */
         motionRemainingTime?: number;
+        /** 内部 WEBGL 版本 */
+        audioDrivenVersion?: string;
     };
 }
 /**
@@ -454,8 +436,6 @@ interface IAvatarAPI {
  * @description 提供统一的SDK接口，简化用户使用体验，支持多实例
  */
 declare class ZEEAvatarSDK {
-    /** SDK配置 */
-    private config;
     /** SDK唯一标识符 */
     private readonly instanceId;
     /** Unity加载器实例 */
@@ -468,6 +448,8 @@ declare class ZEEAvatarSDK {
     private unityInstance;
     /** SDK初始化状态 */
     private isInitialized;
+    /** SDK日志 */
+    private readonly logger;
     /**
      * 构造函数
      * @param config SDK配置对象
@@ -546,8 +528,14 @@ declare class ZEEAvatarSDK {
         isActive: boolean;
         isGeneratingAudio: boolean;
         hasReceivedAudio: boolean;
-        pendingCallbacks: number;
-        hasController: boolean;
+        queueInfo?: {
+            totalTasks: number;
+            requestingTasks: number;
+            completedTasks: number;
+            failedTasks: number;
+            totalPendingResponses: number;
+            currentSendingSequence: number;
+        };
     };
     /**
      * 销毁SDK实例
@@ -573,7 +561,7 @@ declare class ZEEAvatarSDK {
      * 获取SDK配置
      * @returns IAvatarSDKConfig 当前配置
      */
-    getConfig(): IAvatarSDKConfig;
+    getConfig(): IAvatarSDKConfig | null;
     /**
      * 确保SDK已初始化
      * @private
@@ -581,6 +569,32 @@ declare class ZEEAvatarSDK {
     private ensureInitialized;
 }
 
+/**
+ * @fileoverview SDK 版本号常量
+ * @description 此文件由构建脚本自动生成，请勿手动修改
+ */
+/**
+ * SDK 版本号
+ * @const {string} SDK_VERSION
+ */
+declare const SDK_VERSION = "2.1.1";
+
+/**
+ * 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服务的通用基础实现，包括回调管理、消息发送、错误处理等功能
@@ -601,7 +615,7 @@ declare abstract class UnityBaseService<T extends string> implements IUnityCallb
     /** 操作超时时间 */
     protected readonly timeout: number;
     /** 日志记录器 */
-    protected readonly logger: IUnityLogger;
+    protected readonly logger: ISimpleLogger;
     /** 最大重试次数 */
     protected readonly maxRetries: number;
     /** SDK实例唯一标识符 */
@@ -751,6 +765,7 @@ declare class AvatarService extends UnityBaseService<AvatarOperationType> implem
      * ```
      */
     initializeAvatar(avatarCode: string, cameraType?: AvatarCameraType): Promise<IAvatarCallbackResponse>;
+    handleCallback(operation: AvatarOperationType, code: number, message: string, data?: string): void;
     /**
      * 播放数字人动作
      * @param clipCode - 动作编码
@@ -845,14 +860,14 @@ declare class BroadcastService extends UnityBaseService<BroadcastOperationType>
     private taskSequence;
     /** 当前发送任务的序号 */
     private currentSendingSequence;
-    /** 是否正在生成音频 */
-    private isGeneratingAudio;
+    /** 是否正在播报音频 */
+    private isBroadcastingAudio;
     /** 是否已经收到音频 */
     private hasReceivedAudio;
     /** 队列处理定时器 */
     private queueProcessTimer;
-    /** 主请求控制器（兼容性保留） */
-    private activeController;
+    /** 播报完成次数 */
+    private broadcastCompletedCount;
     /**
      * 构造函数
      * @param config - 播报服务配置
@@ -959,8 +974,6 @@ declare class BroadcastService extends UnityBaseService<BroadcastOperationType>
         isActive: boolean;
         isGeneratingAudio: boolean;
         hasReceivedAudio: boolean;
-        pendingCallbacks: number;
-        hasController: boolean;
         queueInfo?: {
             totalTasks: number;
             requestingTasks: number;
@@ -1084,6 +1097,12 @@ declare class BroadcastService extends UnityBaseService<BroadcastOperationType>
      * @private
      */
     private handleBroadcastError;
+    /**
+     * 清理队列处理定时器
+     * @description 清理队列处理定时器
+     * @private
+     */
+    private clearQueueProcessTimer;
 }
 
 /**
@@ -1158,7 +1177,9 @@ declare enum ResourceErrorCode {
     /** 资源不存在 */
     NOT_FOUND = 3003,
     /** 资源格式不支持 */
-    UNSUPPORTED_FORMAT = 3004
+    UNSUPPORTED_FORMAT = 3004,
+    /** 资源版本不兼容 */
+    VERSION_INCOMPATIBLE = 3005
 }
 /**
  * 系统错误码 (4xxx)
@@ -1322,7 +1343,7 @@ declare class ZEEAvatarLoader {
      * @param config - Unity配置对象
      * @description 初始化数字人加载器，创建Unity加载器实例
      */
-    constructor(config: IAvatarSDKConfig);
+    constructor();
     /**
      * 初始化数字人SDK
      * @returns Promise<IAvatarAPI> 返回Avatar API的Promise
@@ -1383,5 +1404,5 @@ declare class ZEEAvatarLoader {
     protected initGlobalConfig(): void;
 }
 
-export { AvatarCameraType, AvatarOperationType, AvatarService, BroadcastOperationType, BroadcastService, BroadcastType, ConfigErrorCode, ERROR_CODE_MAP, ErrorCategory, LogLevel, NetworkErrorCode, OperationErrorCode, ResourceErrorCode, SDKError, SystemErrorCode, UnityOperationStatus, ZEEAvatarLoader, ZEEAvatarSDK, getErrorInfo };
-export type { IAvatarAPI, IAvatarCallbackResponse, IAvatarSDKConfig, IBroadcastAPI, IBroadcastCallbacks, IBroadcastParams, IBroadcastResponse, IBroadcastServiceConfig, IUnityCallbackManager, IUnityCallbackResponse, IUnityInstance, IUnityLogger, IUnityMessageSender, IUnityServiceConfig, SDKErrorCode, TOperationType };
+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 };