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

package/dist/index.es5.umd.js

@@ -12194,6 +12194,8 @@
 	  ResourceErrorCode[ResourceErrorCode["NOT_FOUND"] = 3003] = "NOT_FOUND";
 	  /** 资源格式不支持 */
 	  ResourceErrorCode[ResourceErrorCode["UNSUPPORTED_FORMAT"] = 3004] = "UNSUPPORTED_FORMAT";
+	  /** 资源版本不兼容 */
+	  ResourceErrorCode[ResourceErrorCode["VERSION_INCOMPATIBLE"] = 3005] = "VERSION_INCOMPATIBLE";
 	})(exports.ResourceErrorCode || (exports.ResourceErrorCode = {}));
 	/**
 	 * 系统错误码 (4xxx)
@@ -12286,6 +12288,9 @@
 	}, _a[exports.ResourceErrorCode.UNSUPPORTED_FORMAT] = {
 	  category: exports.ErrorCategory.RESOURCE,
 	  message: '资源格式不支持'
+	}, _a[exports.ResourceErrorCode.VERSION_INCOMPATIBLE] = {
+	  category: exports.ErrorCategory.RESOURCE,
+	  message: '资源版本不兼容'
 	},
 	// 系统错误
 	_a[exports.SystemErrorCode.OUT_OF_MEMORY] = {
@@ -12471,6 +12476,48 @@
 	  return SDKError;
 	}(Error);
 
+	/**
+	 * Unity服务日志级别枚举
+	 * @enum {string}
+	 * @description 定义日志记录的级别
+	 */
+	var LogLevel;
+	(function (LogLevel) {
+	  LogLevel["DEBUG"] = "debug";
+	  LogLevel["INFO"] = "info";
+	  LogLevel["WARN"] = "warn";
+	  LogLevel["ERROR"] = "error";
+	})(LogLevel || (LogLevel = {}));
+	/**
+	 * 简单日志记录器实现
+	 * @class SimpleLogger
+	 * @implements {ISimpleLogger}
+	 * @description 提供基础的日志记录功能
+	 */
+	var SimpleLogger = /** @class */function () {
+	  function SimpleLogger(enableDebug) {
+	    if (enableDebug === void 0) {
+	      enableDebug = false;
+	    }
+	    this.enableDebug = enableDebug;
+	  }
+	  SimpleLogger.prototype.debug = function (message, data) {
+	    if (this.enableDebug) {
+	      console.debug("[SDK DEBUG] ".concat(message), data);
+	    }
+	  };
+	  SimpleLogger.prototype.info = function (message, data) {
+	    console.info("[SDK INFO] ".concat(message), data);
+	  };
+	  SimpleLogger.prototype.warn = function (message, data) {
+	    console.warn("[SDK WARN] ".concat(message), data);
+	  };
+	  SimpleLogger.prototype.error = function (message, error, data) {
+	    console.error("[SDK ERROR] ".concat(message), error, error instanceof SDKError ? error.code : null, data);
+	  };
+	  return SimpleLogger;
+	}();
+
 	/**
 	 * @fileoverview Unity服务基础类型定义
 	 * @description 定义Unity服务的通用接口和类型，为所有Unity服务提供统一的基础类型
@@ -12491,18 +12538,6 @@
 	  /** 操作取消 */
 	  UnityOperationStatus[UnityOperationStatus["CANCELLED"] = 3] = "CANCELLED";
 	})(exports.UnityOperationStatus || (exports.UnityOperationStatus = {}));
-	/**
-	 * Unity服务日志级别枚举
-	 * @enum {string}
-	 * @description 定义日志记录的级别
-	 */
-	exports.LogLevel = void 0;
-	(function (LogLevel) {
-	  LogLevel["DEBUG"] = "debug";
-	  LogLevel["INFO"] = "info";
-	  LogLevel["WARN"] = "warn";
-	  LogLevel["ERROR"] = "error";
-	})(exports.LogLevel || (exports.LogLevel = {}));
 
 	/**
 	 * 默认Unity服务配置
@@ -12844,35 +12879,6 @@
 	  };
 	  return UnityBaseService;
 	}();
-	/**
-	 * 简单日志记录器实现
-	 * @class SimpleLogger
-	 * @implements {IUnityLogger}
-	 * @description 提供基础的日志记录功能
-	 */
-	var SimpleLogger = /** @class */function () {
-	  function SimpleLogger(enableDebug) {
-	    if (enableDebug === void 0) {
-	      enableDebug = false;
-	    }
-	    this.enableDebug = enableDebug;
-	  }
-	  SimpleLogger.prototype.debug = function (message, data) {
-	    if (this.enableDebug) {
-	      console.debug("[Unity Debug] ".concat(message), data);
-	    }
-	  };
-	  SimpleLogger.prototype.info = function (message, data) {
-	    console.info("[Unity Info] ".concat(message), data);
-	  };
-	  SimpleLogger.prototype.warn = function (message, data) {
-	    console.warn("[Unity Warning] ".concat(message), data);
-	  };
-	  SimpleLogger.prototype.error = function (message, error, data) {
-	    console.error("[Unity Error] ".concat(message), error, error instanceof SDKError ? error.code : null, data);
-	  };
-	  return SimpleLogger;
-	}();
 
 	/**
 	 * @fileoverview Avatar API接口定义
@@ -12987,6 +12993,9 @@
 	      });
 	    });
 	  };
+	  AvatarService.prototype.handleCallback = function (operation, code, message, data) {
+	    _super.prototype.handleCallback.call(this, operation, code, message, data);
+	  };
 	  /**
 	   * 播放数字人动作
 	   * @param clipCode - 动作编码
@@ -13316,6 +13325,16 @@
 	      containerId: config.containerId || 'unity-container'
 	    });
 	  };
+	  /**
+	   * 更新SDK配置
+	   * @param config - SDK配置对象
+	   * @description 更新全局SDK配置
+	   */
+	  ConfigManager.prototype.updateConfig = function (config) {
+	    if (this.config) {
+	      this.config = __assign(__assign({}, this.config), config);
+	    }
+	  };
 	  /**
 	   * 获取SDK配置
 	   * @returns IAvatarSDKConfig | null SDK配置对象或null
@@ -13324,24 +13343,6 @@
 	  ConfigManager.prototype.getConfig = function () {
 	    return this.config;
 	  };
-	  /**
-	   * 获取认证token
-	   * @returns string 认证token
-	   * @description 获取当前配置的认证token
-	   */
-	  ConfigManager.prototype.getToken = function () {
-	    var _a;
-	    return ((_a = this.config) === null || _a === void 0 ? void 0 : _a.token) || '';
-	  };
-	  /**
-	   * 获取环境类型
-	   * @returns string 环境类型
-	   * @description 获取当前配置的环境类型
-	   */
-	  ConfigManager.prototype.getEnv = function () {
-	    var _a;
-	    return ((_a = this.config) === null || _a === void 0 ? void 0 : _a.env) || 'prod';
-	  };
 	  /**
 	   * 获取API基础URL
 	   * @param withApiModule 是否包含模块路径
@@ -13359,15 +13360,6 @@
 	    }
 	    return ((_d = getEnvConfig(((_c = this.config) === null || _c === void 0 ? void 0 : _c.env) || 'prod', withApiModule)) === null || _d === void 0 ? void 0 : _d.apiBaseUrl) || '';
 	  };
-	  /**
-	   * 获取自定义API URL
-	   * @returns string | undefined 自定义API URL
-	   * @description 获取自定义API URL配置
-	   */
-	  ConfigManager.prototype.getCustomApiUrl = function () {
-	    var _a;
-	    return (_a = this.config) === null || _a === void 0 ? void 0 : _a.apiUrl;
-	  };
 	  /**
 	   * 重置配置
 	   * @description 清空当前配置
@@ -14221,9 +14213,10 @@
 	   */
 	  BroadcastService.prototype.startTaskRequest = function (task) {
 	    return __awaiter(this, void 0, void 0, function () {
-	      var apiUrl, requestBody;
+	      var apiUrl, requestBody, sdkError;
 	      var _this = this;
-	      return __generator(this, function (_a) {
+	      var _a;
+	      return __generator(this, function (_b) {
 	        task.status = BroadcastTaskStatus.REQUESTING;
 	        this.logger.debug('Starting task request', {
 	          taskId: task.id
@@ -14234,7 +14227,8 @@
 	            humanCode: task.params.humanCode,
 	            speed: task.params.speed,
 	            volume: task.params.volume >= 0 ? task.params.volume * 100 : undefined,
-	            isSubtitle: task.params.isSubtitle
+	            isSubtitle: task.params.isSubtitle,
+	            audioDrivenVersion: ConfigManager.getInstance().getConfig().audioDrivenVersion
 	          };
 	          // 根据播报类型设置特定参数
 	          if (task.params.type === exports.BroadcastType.TEXT) {
@@ -14249,11 +14243,30 @@
 	            method: 'POST',
 	            headers: {
 	              'Content-Type': 'application/json',
-	              'x_auth_token': ConfigManager.getInstance().getToken()
+	              'x_auth_token': ((_a = ConfigManager.getInstance().getConfig()) === null || _a === void 0 ? void 0 : _a.token) || ''
 	            },
 	            body: JSON.stringify(requestBody),
 	            signal: task.controller.signal,
 	            openWhenHidden: true,
+	            /**
+	             * 连接建立时的回调，用于检查 HTTP 状态码
+	             * @param response - HTTP 响应对象
+	             * @throws {SDKError} 当 HTTP 状态码异常时抛出对应的 SDKError
+	             */
+	            onopen: function onopen(response) {
+	              return __awaiter(_this, void 0, void 0, function () {
+	                var error;
+	                return __generator(this, function (_a) {
+	                  // 检查 HTTP 状态码，处理 401 token 过期等异常
+	                  if (!response.ok) {
+	                    error = this.createHttpError(response.status, response.statusText, task.id);
+	                    this.handleTaskError(task, error);
+	                    throw error;
+	                  }
+	                  return [2 /*return*/];
+	                });
+	              });
+	            },
 	            onmessage: function onmessage(event) {
 	              _this.handleTaskResponse(task, event.data);
 	            },
@@ -14261,12 +14274,15 @@
 	              _this.handleTaskClose(task);
 	            },
 	            onerror: function onerror(error) {
-	              _this.handleTaskError(task, error);
-	              throw new Error("Task ".concat(task.id, " request failed: ").concat(error));
+	              // 将所有异常统一转换为 SDKError
+	              var sdkError = _this.convertToSDKError(error, task.id);
+	              _this.handleTaskError(task, sdkError);
+	              throw sdkError;
 	            }
 	          });
 	        } catch (error) {
-	          this.handleTaskError(task, error);
+	          sdkError = this.convertToSDKError(error, task.id);
+	          this.handleTaskError(task, sdkError);
 	        }
 	        return [2 /*return*/];
 	      });
@@ -14365,15 +14381,19 @@
 	   * 处理任务错误
 	   * @param task - 播报任务
 	   * @param error - 错误对象
-	   * @description 处理任务执行过程中的错误
+	   * @description 处理任务执行过程中的错误，防止重复触发错误回调
 	   * @private
 	   */
 	  BroadcastService.prototype.handleTaskError = function (task, error) {
 	    var _a, _b;
+	    // 如果任务已经是失败或取消状态，不再重复处理，防止回调被多次触发
+	    if (task.status === BroadcastTaskStatus.FAILED || task.status === BroadcastTaskStatus.CANCELLED) {
+	      return;
+	    }
 	    task.status = BroadcastTaskStatus.FAILED;
 	    task.error = error;
 	    this.logger.error("Task failed - ".concat(task.id), error);
-	    // 触发错误回调
+	    // 触发错误回调（只触发一次）
 	    (_b = (_a = this.callbacks).onError) === null || _b === void 0 ? void 0 : _b.call(_a, error);
 	  };
 	  /**
@@ -14442,7 +14462,6 @@
 	   * @private
 	   */
 	  BroadcastService.prototype.getBroadcastApiPath = function (type) {
-	    ConfigManager.getInstance().getEnv();
 	    switch (type) {
 	      case exports.BroadcastType.TEXT:
 	        return '/aiep-openapi/avatar-interaction/v1/broadcast/text';
@@ -14518,6 +14537,74 @@
 	      this.queueProcessTimer = null;
 	    }
 	  };
+	  /**
+	   * 根据 HTTP 状态码创建对应的 SDKError
+	   * @param status - HTTP 状态码
+	   * @param statusText - HTTP 状态文本
+	   * @param taskId - 任务 ID（用于日志记录）
+	   * @returns SDKError 实例
+	   * @description 将 HTTP 错误状态码映射为对应的 SDKError
+	   * @private
+	   */
+	  BroadcastService.prototype.createHttpError = function (status, statusText, taskId) {
+	    this.logger.warn("HTTP error occurred - Task: ".concat(taskId, ", Status: ").concat(status), {
+	      status: status,
+	      statusText: statusText
+	    });
+	    switch (status) {
+	      case 401:
+	        // Token 过期或未授权
+	        return new SDKError(exports.NetworkErrorCode.UNAUTHORIZED, "Token \u5DF2\u8FC7\u671F\u6216\u65E0\u6548\uFF0C\u8BF7\u91CD\u65B0\u6388\u6743 (HTTP ".concat(status, ")"));
+	      case 403:
+	        // 禁止访问
+	        return new SDKError(exports.NetworkErrorCode.UNAUTHORIZED, "\u65E0\u6743\u9650\u8BBF\u95EE\u8BE5\u8D44\u6E90 (HTTP ".concat(status, ")"));
+	      case 404:
+	        // 资源不存在
+	        return new SDKError(exports.NetworkErrorCode.SERVER_ERROR, "\u8BF7\u6C42\u7684\u8D44\u6E90\u4E0D\u5B58\u5728 (HTTP ".concat(status, ")"));
+	      case 500:
+	      case 502:
+	      case 503:
+	      case 504:
+	        // 服务器错误
+	        return new SDKError(exports.NetworkErrorCode.SERVER_ERROR, "\u670D\u52A1\u5668\u9519\u8BEF\uFF0C\u8BF7\u7A0D\u540E\u91CD\u8BD5 (HTTP ".concat(status, ")"));
+	      default:
+	        // 其他 HTTP 错误
+	        return new SDKError(exports.NetworkErrorCode.CONNECTION_FAILED, "\u7F51\u7EDC\u8BF7\u6C42\u5931\u8D25: ".concat(statusText || 'Unknown Error', " (HTTP ").concat(status, ")"));
+	    }
+	  };
+	  /**
+	   * 将任意错误转换为 SDKError
+	   * @param error - 原始错误对象
+	   * @param taskId - 任务 ID（用于日志记录）
+	   * @returns SDKError 实例
+	   * @description 统一将各种类型的错误转换为 SDKError，便于上层统一处理
+	   * @private
+	   */
+	  BroadcastService.prototype.convertToSDKError = function (error, taskId) {
+	    // 如果已经是 SDKError，直接返回
+	    if (error instanceof SDKError) {
+	      return error;
+	    }
+	    // 如果是普通 Error 对象
+	    if (error instanceof Error) {
+	      // 检查是否是网络相关的错误
+	      var errorMessage_1 = error.message.toLowerCase();
+	      if (errorMessage_1.includes('timeout') || errorMessage_1.includes('timed out')) {
+	        return new SDKError(exports.NetworkErrorCode.REQUEST_TIMEOUT, "\u8BF7\u6C42\u8D85\u65F6 - Task: ".concat(taskId), error);
+	      }
+	      if (errorMessage_1.includes('network') || errorMessage_1.includes('fetch') || errorMessage_1.includes('connection')) {
+	        return new SDKError(exports.NetworkErrorCode.CONNECTION_FAILED, "\u7F51\u7EDC\u8FDE\u63A5\u5931\u8D25 - Task: ".concat(taskId, ": ").concat(error.message), error);
+	      }
+	      if (errorMessage_1.includes('abort') || errorMessage_1.includes('cancel')) {
+	        return new SDKError(exports.OperationErrorCode.OPERATION_CANCELLED, "\u64CD\u4F5C\u5DF2\u53D6\u6D88 - Task: ".concat(taskId), error);
+	      }
+	      // 默认作为操作失败处理
+	      return new SDKError(exports.OperationErrorCode.OPERATION_FAILED, "\u64AD\u62A5\u4EFB\u52A1\u6267\u884C\u5931\u8D25 - Task: ".concat(taskId, ": ").concat(error.message), error);
+	    }
+	    // 如果是字符串或其他类型
+	    var errorMessage = String(error);
+	    return new SDKError(exports.OperationErrorCode.OPERATION_FAILED, "\u64AD\u62A5\u4EFB\u52A1\u6267\u884C\u5931\u8D25 - Task: ".concat(taskId, ": ").concat(errorMessage));
+	  };
 	  return BroadcastService;
 	}(UnityBaseService);
 
@@ -14536,13 +14623,11 @@
 	   * @param config - Unity配置对象
 	   * @description 初始化数字人加载器，创建Unity加载器实例
 	   */
-	  function ZEEAvatarLoader(config) {
+	  function ZEEAvatarLoader() {
 	    /** Avatar API实例 */
 	    this.apiService = null;
 	    /** Unity实例 */
 	    this.unityInstance = null;
-	    // 同时设置到配置管理器中
-	    ConfigManager.getInstance().setConfig(config);
 	    this.loader = new UnityLoader();
 	  }
 	  /**
@@ -14656,14 +14741,22 @@
 	   * @protected
 	   */
 	  ZEEAvatarLoader.prototype.initGlobalConfig = function () {
-	    var params = {
-	      token: ConfigManager.getInstance().getToken(),
+	    var config = ConfigManager.getInstance().getConfig();
+	    var globalParams = {
+	      token: config === null || config === void 0 ? void 0 : config.token,
 	      apiBaseUrl: ConfigManager.getInstance().getApiBaseUrl(false),
-	      idleMotionList: ConfigManager.getInstance().getConfig().idleMotionList,
-	      assetsUrl: ConfigManager.getInstance().getConfig().assetsUrl
+	      idleMotionList: config === null || config === void 0 ? void 0 : config.idleMotionList
+	      // 純AB包方案在SDK 2.1.0 中已弃用
+	      // assetsUrl: config?.assetsUrl
+	    };
+	    var assetModuleParams = {
+	      isZip: true,
+	      assetBundlePath: config === null || config === void 0 ? void 0 : config.assetsUrl
 	    };
-	    console.warn('[ Send Unity message ]: AvatarSDK.InitializeConfig', params);
-	    this.unityInstance.SendMessage('AvatarSDK', 'InitializeConfig', JSON.stringify(params));
+	    this.unityInstance.SendMessage('AvatarSDK', 'InitializeConfig', JSON.stringify(globalParams));
+	    this.unityInstance.SendMessage('AvatarSDK', 'InitAssetBundleModule', JSON.stringify(assetModuleParams));
+	    console.warn('[ Send Unity message ]: AvatarSDK.InitializeConfig', globalParams);
+	    console.warn('[ Send Unity message ]: AvatarSDK.InitAssetBundleModule', assetModuleParams);
 	  };
 	  return ZEEAvatarLoader;
 	}();