@zeewain/3d-avatar-sdk 1.2.0 → 1.2.1

package/README.md

@@ -441,10 +441,12 @@ interface IAvatarSDKConfig {
   token?: string;             // 用户认证令牌
   env?: 'dev' | 'test' | 'prod' | 'custom';  // 运行环境，默认'prod'
   apiUrl?: string;            // 自定义API地址（env='custom'时需要）
+  assetsUrl?:string;          // 自定义资源文件地址（env='custom'时有效）
   resourcesUrl?: string;      // AB资源文件地址
   idleMotionList?:string[];   // 待机动作编码列表，随机播放（排重方式），可选
   // 回调函数
-  onProgress?: (progress: number) => void;  // 加载进度回调
+  onProgress?: (progress: number) => void;  // 加载进度回调，可选
+  broadcastCallbacks?:IBroadcastCallbacks; // 播报回调函数，可选
 }
 ```
 

package/dist/index.d.ts

@@ -27,40 +27,6 @@ interface IUnityInstance {
     SetFullscreen?(fullscreen: boolean): void;
 }
 
-/**
- * @fileoverview SDK配置接口定义
- * @description 定义SDK实例初始化所需的配置参数
- */
-/**
- * SDK配置接口
- * @interface IAvatarSDKConfig
- * @description 定义SDK实例初始化所需的配置参数
- */
-interface IAvatarSDKConfig {
-    /** 全局用户认证令牌 */
-    token?: string;
-    /** 运行环境 */
-    env?: 'dev' | 'test' | 'prod' | 'custom';
-    /** api接口地址，仅当env为custom时有效 */
-    apiUrl?: string;
-    /** AB资源文件地址 */
-    resourcesUrl?: 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;
-}
-
 /**
  * @fileoverview Unity服务基础类型定义
  * @description 定义Unity服务的通用接口和类型，为所有Unity服务提供统一的基础类型
@@ -175,94 +141,6 @@ interface IUnityLogger {
     error(message: string, error?: Error, data?: any): void;
 }
 
-/**
- * @fileoverview Avatar API接口定义
- * @description 定义数字人控制API的核心接口、类型和枚举
- */
-
-/**
- * Avatar操作类型枚举
- * @enum {string}
- * @description 定义Avatar服务支持的操作类型
- */
-declare enum AvatarOperationType {
-    INITIALIZE_AVATAR = "initializeAvatar",
-    PLAY_MOTION = "playMotion",
-    GET_CURRENT_MOTION = "getCurrentMotion",
-    UNLOAD_AVATAR = "unloadAvatar",
-    SET_CAMERA = "setCamera"
-}
-/**
- * Avatar摄像机类型枚举
- * @enum {string}
- * @description 定义Avatar支持的摄像机类型
- */
-declare enum AvatarCameraType {
-    WHOLE = "whole",
-    HALF = "half",
-    FACE = "face"
-}
-/**
- * Avatar回调响应接口
- * @interface IAvatarCallbackResponse
- * @extends {IUnityCallbackResponse}
- * @description 定义Avatar操作的回调响应格式，扩展基础响应接口
- */
-interface IAvatarCallbackResponse extends IUnityCallbackResponse {
-    data?: {
-        /** 动作ID，可选 */
-        motionId?: string;
-        /** 动作剩余时间，可选 */
-        motionRemainingTime?: number;
-    };
-}
-/**
- * Avatar API接口
- * @interface IAvatarAPI
- * @description 定义数字人控制API的核心接口，包含数字人初始化、动作控制、摄像机设置等功能
- */
-interface IAvatarAPI {
-    /**
-     * 初始化数字人
-     * @param avatarCode - 数字人编码
-     * @param cameraType - 摄像机类型，默认为'whole'
-     * @returns Promise<IAvatarCallbackResponse> 初始化操作的Promise
-     */
-    initializeAvatar(avatarCode: string, cameraType?: AvatarCameraType): Promise<IAvatarCallbackResponse>;
-    /**
-     * 播放数字人动作
-     * @param clipCode - 动作编码
-     * @returns Promise<IAvatarCallbackResponse> 播放操作的Promise
-     */
-    playMotion(clipCode: string): Promise<IAvatarCallbackResponse>;
-    /**
-     * 获取当前播放的动作信息
-     * @param getRemainingTime - 是否获取剩余时间
-     * @returns Promise<IAvatarCallbackResponse> 获取操作的Promise
-     */
-    getCurrentMotion(getRemainingTime: boolean): Promise<IAvatarCallbackResponse>;
-    /**
-     * 卸载数字人
-     * @returns Promise<IAvatarCallbackResponse> 卸载操作的Promise
-     */
-    unloadAvatar(): Promise<IAvatarCallbackResponse>;
-    /**
-     * 设置摄像机类型
-     * @param cameraType - 摄像机类型
-     * @returns Promise<IAvatarCallbackResponse> 设置操作的Promise
-     */
-    setCamera(cameraType: AvatarCameraType): Promise<IAvatarCallbackResponse>;
-    /**
-     * 批量执行Avatar操作
-     * @param operations - 操作数组
-     * @returns Promise<IAvatarCallbackResponse[]> 返回所有操作的结果
-     */
-    batchExecute(operations: Array<{
-        method: keyof IAvatarAPI;
-        params: any[];
-    }>): Promise<IAvatarCallbackResponse[]>;
-}
-
 /**
  * @fileoverview 流式播报服务接口定义
  * @description 定义流式播报服务相关的类型、接口和枚举
@@ -436,6 +314,133 @@ interface IBroadcastAPI {
     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;
+    /** 资源文件地址，仅当env为custom时有效 */
+    assetsUrl?: string;
+    /** AB资源文件地址 */
+    resourcesUrl?: 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;
+}
+
+/**
+ * @fileoverview Avatar API接口定义
+ * @description 定义数字人控制API的核心接口、类型和枚举
+ */
+
+/**
+ * Avatar操作类型枚举
+ * @enum {string}
+ * @description 定义Avatar服务支持的操作类型
+ */
+declare enum AvatarOperationType {
+    INITIALIZE_AVATAR = "initializeAvatar",
+    PLAY_MOTION = "playMotion",
+    GET_CURRENT_MOTION = "getCurrentMotion",
+    UNLOAD_AVATAR = "unloadAvatar",
+    SET_CAMERA = "setCamera"
+}
+/**
+ * Avatar摄像机类型枚举
+ * @enum {string}
+ * @description 定义Avatar支持的摄像机类型
+ */
+declare enum AvatarCameraType {
+    WHOLE = "whole",
+    HALF = "half",
+    FACE = "face"
+}
+/**
+ * Avatar回调响应接口
+ * @interface IAvatarCallbackResponse
+ * @extends {IUnityCallbackResponse}
+ * @description 定义Avatar操作的回调响应格式，扩展基础响应接口
+ */
+interface IAvatarCallbackResponse extends IUnityCallbackResponse {
+    data?: {
+        /** 动作ID，可选 */
+        motionId?: string;
+        /** 动作剩余时间，可选 */
+        motionRemainingTime?: number;
+    };
+}
+/**
+ * Avatar API接口
+ * @interface IAvatarAPI
+ * @description 定义数字人控制API的核心接口，包含数字人初始化、动作控制、摄像机设置等功能
+ */
+interface IAvatarAPI {
+    /**
+     * 初始化数字人
+     * @param avatarCode - 数字人编码
+     * @param cameraType - 摄像机类型，默认为'whole'
+     * @returns Promise<IAvatarCallbackResponse> 初始化操作的Promise
+     */
+    initializeAvatar(avatarCode: string, cameraType?: AvatarCameraType): Promise<IAvatarCallbackResponse>;
+    /**
+     * 播放数字人动作
+     * @param clipCode - 动作编码
+     * @returns Promise<IAvatarCallbackResponse> 播放操作的Promise
+     */
+    playMotion(clipCode: string): Promise<IAvatarCallbackResponse>;
+    /**
+     * 获取当前播放的动作信息
+     * @param getRemainingTime - 是否获取剩余时间
+     * @returns Promise<IAvatarCallbackResponse> 获取操作的Promise
+     */
+    getCurrentMotion(getRemainingTime: boolean): Promise<IAvatarCallbackResponse>;
+    /**
+     * 卸载数字人
+     * @returns Promise<IAvatarCallbackResponse> 卸载操作的Promise
+     */
+    unloadAvatar(): Promise<IAvatarCallbackResponse>;
+    /**
+     * 设置摄像机类型
+     * @param cameraType - 摄像机类型
+     * @returns Promise<IAvatarCallbackResponse> 设置操作的Promise
+     */
+    setCamera(cameraType: AvatarCameraType): Promise<IAvatarCallbackResponse>;
+    /**
+     * 批量执行Avatar操作
+     * @param operations - 操作数组
+     * @returns Promise<IAvatarCallbackResponse[]> 返回所有操作的结果
+     */
+    batchExecute(operations: Array<{
+        method: keyof IAvatarAPI;
+        params: any[];
+    }>): Promise<IAvatarCallbackResponse[]>;
+}
+
 /**
  * @fileoverview 统一的3D数字人SDK入口类
  * @description 提供统一的SDK接口，内部通过组合模式调用各个服务模块
@@ -716,7 +721,6 @@ declare class AvatarService extends UnityBaseService<AvatarOperationType> implem
     protected get callbackFunctionName(): string;
     /**
      * 构造函数
-     * @param unityInstance - Unity实例对象
      * @param config - 可选的服务配置，用于覆盖默认配置
      * @description 初始化Avatar API，设置Unity实例和配置
      * @example

package/dist/index.es5.js

@@ -12550,7 +12550,8 @@ var ZEEAvatarSDKLib = (function (exports) {
 	      operation: operation,
 	      code: code,
 	      message: message,
-	      data: dataObj
+	      data: dataObj,
+	      originalData: data
 	    });
 	    var callback = this.pendingCallbacks.get(operation);
 	    if (!callback) {
@@ -12899,7 +12900,6 @@ var ZEEAvatarSDKLib = (function (exports) {
 	  __extends(AvatarService, _super);
 	  /**
 	   * 构造函数
-	   * @param unityInstance - Unity实例对象
 	   * @param config - 可选的服务配置，用于覆盖默认配置
 	   * @description 初始化Avatar API，设置Unity实例和配置
 	   * @example
@@ -13413,16 +13413,11 @@ var ZEEAvatarSDKLib = (function (exports) {
 	  UnityLoader.prototype.createContainer = function () {
 	    var container = document.getElementById(this.config.containerId);
 	    if (!container) {
-	      throw new Error("Container element with ID \"".concat(this.config.containerId, "\" not found"));
+	      throw new TypeError("Avatar container element with ID \"".concat(this.config.containerId, "\" not found"));
+	    } else if (!(container instanceof HTMLDivElement)) {
+	      throw new TypeError('Avatar container element must be a div element');
 	    }
-	    container.style.width = '100%';
-	    container.style.height = '100%';
 	    container.style.position = 'relative';
-	    // 移除容器提示元素
-	    var containerTip = document.getElementById('unity-container-tip');
-	    if (containerTip) {
-	      containerTip.remove();
-	    }
 	    return container;
 	  };
 	  /**
@@ -13476,11 +13471,15 @@ var ZEEAvatarSDKLib = (function (exports) {
 	      return __generator(this, function (_a) {
 	        switch (_a.label) {
 	          case 0:
-	            canvas = document.createElement('canvas');
-	            canvas.id = 'unity-canvas';
-	            canvas.style.width = '100%';
-	            canvas.style.height = '100%';
-	            container.appendChild(canvas);
+	            canvas = container.querySelector('#unity-canvas');
+	            // 避免重复创建
+	            if (!canvas) {
+	              canvas = document.createElement('canvas');
+	              canvas.id = 'unity-canvas';
+	              canvas.style.width = '100%';
+	              canvas.style.height = '100%';
+	              container.appendChild(canvas);
+	            }
 	            // 移动设备适配
 	            if (/iPhone|iPad|iPod|Android/i.test(navigator.userAgent)) {
 	              meta = document.createElement('meta');
@@ -13810,19 +13809,21 @@ var ZEEAvatarSDKLib = (function (exports) {
 	    // 触发对应的事件回调（仅在成功时）
 	    if (code === 0) {
 	      switch (operation) {
+	        case exports.BroadcastOperationType.START_BROADCAST:
+	          if (isBroadcastCompleted) {
+	            (_b = (_a = this.callbacks).onFinish) === null || _b === void 0 ? void 0 : _b.call(_a);
+	          }
+	          break;
 	        case exports.BroadcastOperationType.PAUSE_BROADCAST:
-	          (_b = (_a = this.callbacks).onPause) === null || _b === void 0 ? void 0 : _b.call(_a);
+	          (_d = (_c = this.callbacks).onPause) === null || _d === void 0 ? void 0 : _d.call(_c);
 	          this.logger.debug('Broadcast paused callback triggered');
 	          break;
 	        case exports.BroadcastOperationType.RESUME_BROADCAST:
-	          (_d = (_c = this.callbacks).onResume) === null || _d === void 0 ? void 0 : _d.call(_c);
+	          (_f = (_e = this.callbacks).onResume) === null || _f === void 0 ? void 0 : _f.call(_e);
 	          this.logger.debug('Broadcast resumed callback triggered');
 	          break;
 	        case exports.BroadcastOperationType.STOP_BROADCAST:
-	          (_f = (_e = this.callbacks).onStop) === null || _f === void 0 ? void 0 : _f.call(_e);
-	          if (isBroadcastCompleted) {
-	            (_h = (_g = this.callbacks).onFinish) === null || _h === void 0 ? void 0 : _h.call(_g);
-	          }
+	          (_h = (_g = this.callbacks).onStop) === null || _h === void 0 ? void 0 : _h.call(_g);
 	          this.logger.debug('Broadcast stopped callback triggered');
 	          break;
 	      }
@@ -14323,10 +14324,13 @@ var ZEEAvatarSDKLib = (function (exports) {
 	   */
 	  ZEEAvatarLoader.prototype.destroy = function () {
 	    if (this.unityInstance) {
-	      // 移除DOM容器
+	      // 移除DOM容器下的canvas元素
 	      var container = document.getElementById(this.getContainerId());
 	      if (container) {
-	        container.remove();
+	        var canvas = container.querySelector('#unity-canvas');
+	        if (canvas) {
+	          canvas.remove();
+	        }
 	      }
 	      // 退出Unity实例
 	      if (typeof this.unityInstance.Quit === 'function') {
@@ -14347,7 +14351,8 @@ var ZEEAvatarSDKLib = (function (exports) {
 	  ZEEAvatarLoader.prototype.initGlobalConfig = function () {
 	    var params = __assign(__assign({}, ConfigManager.getInstance().getConfig()), {
 	      token: ConfigManager.getInstance().getToken(),
-	      apiBaseUrl: ConfigManager.getInstance().getApiBaseUrl(false)
+	      apiBaseUrl: ConfigManager.getInstance().getApiBaseUrl(false),
+	      assetsUrl: ConfigManager.getInstance().getConfig().assetsUrl
 	    });
 	    console.warn('[ Send Unity message ]: AvatarSDK.InitializeConfig', params);
 	    this.unityInstance.SendMessage('AvatarSDK', 'InitializeConfig', JSON.stringify(params));

package/dist/index.es5.umd.js

@@ -12553,7 +12553,8 @@
 	      operation: operation,
 	      code: code,
 	      message: message,
-	      data: dataObj
+	      data: dataObj,
+	      originalData: data
 	    });
 	    var callback = this.pendingCallbacks.get(operation);
 	    if (!callback) {
@@ -12902,7 +12903,6 @@
 	  __extends(AvatarService, _super);
 	  /**
 	   * 构造函数
-	   * @param unityInstance - Unity实例对象
 	   * @param config - 可选的服务配置，用于覆盖默认配置
 	   * @description 初始化Avatar API，设置Unity实例和配置
 	   * @example
@@ -13416,16 +13416,11 @@
 	  UnityLoader.prototype.createContainer = function () {
 	    var container = document.getElementById(this.config.containerId);
 	    if (!container) {
-	      throw new Error("Container element with ID \"".concat(this.config.containerId, "\" not found"));
+	      throw new TypeError("Avatar container element with ID \"".concat(this.config.containerId, "\" not found"));
+	    } else if (!(container instanceof HTMLDivElement)) {
+	      throw new TypeError('Avatar container element must be a div element');
 	    }
-	    container.style.width = '100%';
-	    container.style.height = '100%';
 	    container.style.position = 'relative';
-	    // 移除容器提示元素
-	    var containerTip = document.getElementById('unity-container-tip');
-	    if (containerTip) {
-	      containerTip.remove();
-	    }
 	    return container;
 	  };
 	  /**
@@ -13479,11 +13474,15 @@
 	      return __generator(this, function (_a) {
 	        switch (_a.label) {
 	          case 0:
-	            canvas = document.createElement('canvas');
-	            canvas.id = 'unity-canvas';
-	            canvas.style.width = '100%';
-	            canvas.style.height = '100%';
-	            container.appendChild(canvas);
+	            canvas = container.querySelector('#unity-canvas');
+	            // 避免重复创建
+	            if (!canvas) {
+	              canvas = document.createElement('canvas');
+	              canvas.id = 'unity-canvas';
+	              canvas.style.width = '100%';
+	              canvas.style.height = '100%';
+	              container.appendChild(canvas);
+	            }
 	            // 移动设备适配
 	            if (/iPhone|iPad|iPod|Android/i.test(navigator.userAgent)) {
 	              meta = document.createElement('meta');
@@ -13813,19 +13812,21 @@
 	    // 触发对应的事件回调（仅在成功时）
 	    if (code === 0) {
 	      switch (operation) {
+	        case exports.BroadcastOperationType.START_BROADCAST:
+	          if (isBroadcastCompleted) {
+	            (_b = (_a = this.callbacks).onFinish) === null || _b === void 0 ? void 0 : _b.call(_a);
+	          }
+	          break;
 	        case exports.BroadcastOperationType.PAUSE_BROADCAST:
-	          (_b = (_a = this.callbacks).onPause) === null || _b === void 0 ? void 0 : _b.call(_a);
+	          (_d = (_c = this.callbacks).onPause) === null || _d === void 0 ? void 0 : _d.call(_c);
 	          this.logger.debug('Broadcast paused callback triggered');
 	          break;
 	        case exports.BroadcastOperationType.RESUME_BROADCAST:
-	          (_d = (_c = this.callbacks).onResume) === null || _d === void 0 ? void 0 : _d.call(_c);
+	          (_f = (_e = this.callbacks).onResume) === null || _f === void 0 ? void 0 : _f.call(_e);
 	          this.logger.debug('Broadcast resumed callback triggered');
 	          break;
 	        case exports.BroadcastOperationType.STOP_BROADCAST:
-	          (_f = (_e = this.callbacks).onStop) === null || _f === void 0 ? void 0 : _f.call(_e);
-	          if (isBroadcastCompleted) {
-	            (_h = (_g = this.callbacks).onFinish) === null || _h === void 0 ? void 0 : _h.call(_g);
-	          }
+	          (_h = (_g = this.callbacks).onStop) === null || _h === void 0 ? void 0 : _h.call(_g);
 	          this.logger.debug('Broadcast stopped callback triggered');
 	          break;
 	      }
@@ -14326,10 +14327,13 @@
 	   */
 	  ZEEAvatarLoader.prototype.destroy = function () {
 	    if (this.unityInstance) {
-	      // 移除DOM容器
+	      // 移除DOM容器下的canvas元素
 	      var container = document.getElementById(this.getContainerId());
 	      if (container) {
-	        container.remove();
+	        var canvas = container.querySelector('#unity-canvas');
+	        if (canvas) {
+	          canvas.remove();
+	        }
 	      }
 	      // 退出Unity实例
 	      if (typeof this.unityInstance.Quit === 'function') {
@@ -14350,7 +14354,8 @@
 	  ZEEAvatarLoader.prototype.initGlobalConfig = function () {
 	    var params = __assign(__assign({}, ConfigManager.getInstance().getConfig()), {
 	      token: ConfigManager.getInstance().getToken(),
-	      apiBaseUrl: ConfigManager.getInstance().getApiBaseUrl(false)
+	      apiBaseUrl: ConfigManager.getInstance().getApiBaseUrl(false),
+	      assetsUrl: ConfigManager.getInstance().getConfig().assetsUrl
 	    });
 	    console.warn('[ Send Unity message ]: AvatarSDK.InitializeConfig', params);
 	    this.unityInstance.SendMessage('AvatarSDK', 'InitializeConfig', JSON.stringify(params));

package/dist/index.esm.js

@@ -474,7 +474,7 @@ class UnityBaseService {
      */
     handleCallback(operation, code, message, data) {
         const dataObj = data ? JSON.parse(data) : undefined;
-        this.logger.warn('[ Received Unity callback ]', { operation, code, message, data: dataObj });
+        this.logger.warn('[ Received Unity callback ]', { operation, code, message, data: dataObj, originalData: data });
         const callback = this.pendingCallbacks.get(operation);
         if (!callback) {
             this.logger.warn(`No pending callback for operation: ${operation}`);
@@ -772,7 +772,6 @@ class AvatarService extends UnityBaseService {
     }
     /**
      * 构造函数
-     * @param unityInstance - Unity实例对象
      * @param config - 可选的服务配置，用于覆盖默认配置
      * @description 初始化Avatar API，设置Unity实例和配置
      * @example
@@ -1157,16 +1156,12 @@ class UnityLoader {
     createContainer() {
         const container = document.getElementById(this.config.containerId);
         if (!container) {
-            throw new Error(`Container element with ID "${this.config.containerId}" not found`);
+            throw new TypeError(`Avatar container element with ID "${this.config.containerId}" not found`);
         }
-        container.style.width = '100%';
-        container.style.height = '100%';
-        container.style.position = 'relative';
-        // 移除容器提示元素
-        const containerTip = document.getElementById('unity-container-tip');
-        if (containerTip) {
-            containerTip.remove();
+        else if (!(container instanceof HTMLDivElement)) {
+            throw new TypeError('Avatar container element must be a div element');
         }
+        container.style.position = 'relative';
         return container;
     }
     /**
@@ -1215,12 +1210,15 @@ class UnityLoader {
      */
     createUnityInstance(container) {
         return __awaiter(this, void 0, void 0, function* () {
-            // 创建Canvas元素
-            const canvas = document.createElement('canvas');
-            canvas.id = 'unity-canvas';
-            canvas.style.width = '100%';
-            canvas.style.height = '100%';
-            container.appendChild(canvas);
+            let canvas = container.querySelector('#unity-canvas');
+            // 避免重复创建
+            if (!canvas) {
+                canvas = document.createElement('canvas');
+                canvas.id = 'unity-canvas';
+                canvas.style.width = '100%';
+                canvas.style.height = '100%';
+                container.appendChild(canvas);
+            }
             // 移动设备适配
             if (/iPhone|iPad|iPod|Android/i.test(navigator.userAgent)) {
                 // 添加移动设备viewport元标签
@@ -1545,19 +1543,21 @@ class BroadcastService extends UnityBaseService {
         // 触发对应的事件回调（仅在成功时）
         if (code === 0) {
             switch (operation) {
+                case BroadcastOperationType.START_BROADCAST:
+                    if (isBroadcastCompleted) {
+                        (_b = (_a = this.callbacks).onFinish) === null || _b === void 0 ? void 0 : _b.call(_a);
+                    }
+                    break;
                 case BroadcastOperationType.PAUSE_BROADCAST:
-                    (_b = (_a = this.callbacks).onPause) === null || _b === void 0 ? void 0 : _b.call(_a);
+                    (_d = (_c = this.callbacks).onPause) === null || _d === void 0 ? void 0 : _d.call(_c);
                     this.logger.debug('Broadcast paused callback triggered');
                     break;
                 case BroadcastOperationType.RESUME_BROADCAST:
-                    (_d = (_c = this.callbacks).onResume) === null || _d === void 0 ? void 0 : _d.call(_c);
+                    (_f = (_e = this.callbacks).onResume) === null || _f === void 0 ? void 0 : _f.call(_e);
                     this.logger.debug('Broadcast resumed callback triggered');
                     break;
                 case BroadcastOperationType.STOP_BROADCAST:
-                    (_f = (_e = this.callbacks).onStop) === null || _f === void 0 ? void 0 : _f.call(_e);
-                    if (isBroadcastCompleted) {
-                        (_h = (_g = this.callbacks).onFinish) === null || _h === void 0 ? void 0 : _h.call(_g);
-                    }
+                    (_h = (_g = this.callbacks).onStop) === null || _h === void 0 ? void 0 : _h.call(_g);
                     this.logger.debug('Broadcast stopped callback triggered');
                     break;
             }
@@ -1984,10 +1984,13 @@ class ZEEAvatarLoader {
      */
     destroy() {
         if (this.unityInstance) {
-            // 移除DOM容器
+            // 移除DOM容器下的canvas元素
             const container = document.getElementById(this.getContainerId());
             if (container) {
-                container.remove();
+                const canvas = container.querySelector('#unity-canvas');
+                if (canvas) {
+                    canvas.remove();
+                }
             }
             // 退出Unity实例
             if (typeof this.unityInstance.Quit === 'function') {
@@ -2006,7 +2009,7 @@ class ZEEAvatarLoader {
      * @protected
      */
     initGlobalConfig() {
-        const params = Object.assign(Object.assign({}, ConfigManager.getInstance().getConfig()), { token: ConfigManager.getInstance().getToken(), apiBaseUrl: ConfigManager.getInstance().getApiBaseUrl(false) });
+        const params = Object.assign(Object.assign({}, ConfigManager.getInstance().getConfig()), { token: ConfigManager.getInstance().getToken(), apiBaseUrl: ConfigManager.getInstance().getApiBaseUrl(false), assetsUrl: ConfigManager.getInstance().getConfig().assetsUrl });
         console.warn('[ Send Unity message ]: AvatarSDK.InitializeConfig', params);
         this.unityInstance.SendMessage('AvatarSDK', 'InitializeConfig', JSON.stringify(params));
     }
@@ -2076,7 +2079,8 @@ class ZEEAvatarSDK {
                 // 5. 创建带有唯一标识符的播报服务
                 this.broadcastService = new BroadcastService({
                     unityInstance: this.unityInstance,
-                    instanceId: this.instanceId
+                    instanceId: this.instanceId,
+                    callbacks: this.config.broadcastCallbacks
                 });
                 // 6. 初始化数字人
                 const result = yield this.avatarService.initializeAvatar(avatarCode, cameraType);
@@ -2291,7 +2295,7 @@ class ZEEAvatarSDK {
      */
     ensureInitialized() {
         if (!this.isInitialized) {
-            throw new SDKError(OperationErrorCode.UNITY_NOT_INITIALIZED, 'SDK未初始化，请先调用initializeAvatar()方法');
+            throw new SDKError(OperationErrorCode.UNITY_NOT_INITIALIZED, 'Avatar尚未初始化，请先调用initializeAvatar()方法');
         }
     }
 }

package/dist/index.umd.cjs

@@ -480,7 +480,7 @@
          */
         handleCallback(operation, code, message, data) {
             const dataObj = data ? JSON.parse(data) : undefined;
-            this.logger.warn('[ Received Unity callback ]', { operation, code, message, data: dataObj });
+            this.logger.warn('[ Received Unity callback ]', { operation, code, message, data: dataObj, originalData: data });
             const callback = this.pendingCallbacks.get(operation);
             if (!callback) {
                 this.logger.warn(`No pending callback for operation: ${operation}`);
@@ -778,7 +778,6 @@
         }
         /**
          * 构造函数
-         * @param unityInstance - Unity实例对象
          * @param config - 可选的服务配置，用于覆盖默认配置
          * @description 初始化Avatar API，设置Unity实例和配置
          * @example
@@ -1163,16 +1162,12 @@
         createContainer() {
             const container = document.getElementById(this.config.containerId);
             if (!container) {
-                throw new Error(`Container element with ID "${this.config.containerId}" not found`);
+                throw new TypeError(`Avatar container element with ID "${this.config.containerId}" not found`);
             }
-            container.style.width = '100%';
-            container.style.height = '100%';
-            container.style.position = 'relative';
-            // 移除容器提示元素
-            const containerTip = document.getElementById('unity-container-tip');
-            if (containerTip) {
-                containerTip.remove();
+            else if (!(container instanceof HTMLDivElement)) {
+                throw new TypeError('Avatar container element must be a div element');
             }
+            container.style.position = 'relative';
             return container;
         }
         /**
@@ -1221,12 +1216,15 @@
          */
         createUnityInstance(container) {
             return __awaiter(this, void 0, void 0, function* () {
-                // 创建Canvas元素
-                const canvas = document.createElement('canvas');
-                canvas.id = 'unity-canvas';
-                canvas.style.width = '100%';
-                canvas.style.height = '100%';
-                container.appendChild(canvas);
+                let canvas = container.querySelector('#unity-canvas');
+                // 避免重复创建
+                if (!canvas) {
+                    canvas = document.createElement('canvas');
+                    canvas.id = 'unity-canvas';
+                    canvas.style.width = '100%';
+                    canvas.style.height = '100%';
+                    container.appendChild(canvas);
+                }
                 // 移动设备适配
                 if (/iPhone|iPad|iPod|Android/i.test(navigator.userAgent)) {
                     // 添加移动设备viewport元标签
@@ -1551,19 +1549,21 @@
             // 触发对应的事件回调（仅在成功时）
             if (code === 0) {
                 switch (operation) {
+                    case exports.BroadcastOperationType.START_BROADCAST:
+                        if (isBroadcastCompleted) {
+                            (_b = (_a = this.callbacks).onFinish) === null || _b === void 0 ? void 0 : _b.call(_a);
+                        }
+                        break;
                     case exports.BroadcastOperationType.PAUSE_BROADCAST:
-                        (_b = (_a = this.callbacks).onPause) === null || _b === void 0 ? void 0 : _b.call(_a);
+                        (_d = (_c = this.callbacks).onPause) === null || _d === void 0 ? void 0 : _d.call(_c);
                         this.logger.debug('Broadcast paused callback triggered');
                         break;
                     case exports.BroadcastOperationType.RESUME_BROADCAST:
-                        (_d = (_c = this.callbacks).onResume) === null || _d === void 0 ? void 0 : _d.call(_c);
+                        (_f = (_e = this.callbacks).onResume) === null || _f === void 0 ? void 0 : _f.call(_e);
                         this.logger.debug('Broadcast resumed callback triggered');
                         break;
                     case exports.BroadcastOperationType.STOP_BROADCAST:
-                        (_f = (_e = this.callbacks).onStop) === null || _f === void 0 ? void 0 : _f.call(_e);
-                        if (isBroadcastCompleted) {
-                            (_h = (_g = this.callbacks).onFinish) === null || _h === void 0 ? void 0 : _h.call(_g);
-                        }
+                        (_h = (_g = this.callbacks).onStop) === null || _h === void 0 ? void 0 : _h.call(_g);
                         this.logger.debug('Broadcast stopped callback triggered');
                         break;
                 }
@@ -1990,10 +1990,13 @@
          */
         destroy() {
             if (this.unityInstance) {
-                // 移除DOM容器
+                // 移除DOM容器下的canvas元素
                 const container = document.getElementById(this.getContainerId());
                 if (container) {
-                    container.remove();
+                    const canvas = container.querySelector('#unity-canvas');
+                    if (canvas) {
+                        canvas.remove();
+                    }
                 }
                 // 退出Unity实例
                 if (typeof this.unityInstance.Quit === 'function') {
@@ -2012,7 +2015,7 @@
          * @protected
          */
         initGlobalConfig() {
-            const params = Object.assign(Object.assign({}, ConfigManager.getInstance().getConfig()), { token: ConfigManager.getInstance().getToken(), apiBaseUrl: ConfigManager.getInstance().getApiBaseUrl(false) });
+            const params = Object.assign(Object.assign({}, ConfigManager.getInstance().getConfig()), { token: ConfigManager.getInstance().getToken(), apiBaseUrl: ConfigManager.getInstance().getApiBaseUrl(false), assetsUrl: ConfigManager.getInstance().getConfig().assetsUrl });
             console.warn('[ Send Unity message ]: AvatarSDK.InitializeConfig', params);
             this.unityInstance.SendMessage('AvatarSDK', 'InitializeConfig', JSON.stringify(params));
         }
@@ -2082,7 +2085,8 @@
                     // 5. 创建带有唯一标识符的播报服务
                     this.broadcastService = new BroadcastService({
                         unityInstance: this.unityInstance,
-                        instanceId: this.instanceId
+                        instanceId: this.instanceId,
+                        callbacks: this.config.broadcastCallbacks
                     });
                     // 6. 初始化数字人
                     const result = yield this.avatarService.initializeAvatar(avatarCode, cameraType);
@@ -2297,7 +2301,7 @@
          */
         ensureInitialized() {
             if (!this.isInitialized) {
-                throw new SDKError(exports.OperationErrorCode.UNITY_NOT_INITIALIZED, 'SDK未初始化，请先调用initializeAvatar()方法');
+                throw new SDKError(exports.OperationErrorCode.UNITY_NOT_INITIALIZED, 'Avatar尚未初始化，请先调用initializeAvatar()方法');
             }
         }
     }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@zeewain/3d-avatar-sdk",
   "type": "module",
-  "version": "1.2.0",
+  "version": "1.2.1",
   "description": "SDK for ZEE Avatar WebGL integration",
   "author": "ZEEWain",
   "license": "MIT",