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

package/dist/examples/test-vue3/src/components/UnityPreview.vue

@@ -0,0 +1,189 @@
+<template>
+  <el-card class="unity-preview" shadow="hover">
+    <template #header>
+      <div class="card-header">
+        <span>Unity 预览</span>
+        <el-tag v-if="sdkStatus.unityLoaded" type="success" size="default">已加载</el-tag>
+        <el-tag v-else type="info" size="default">未加载</el-tag>
+      </div>
+    </template>
+
+    <div class="unity-container-wrapper" v-loading="sdkStatus.unityLoaded && !sdkStatus.avatarLoaded && loadingProgress === 1" element-loading-text="数字人加载中，请稍候..." element-loading-background="rgba(0, 0, 0, 0)">
+      <div id="unity-container" class="unity-container">
+        <div v-if="!sdkStatus.unityLoaded" class="unity-tip">
+          <i class="el-icon-monitor"></i>
+          <p>Unity 内容将在此处加载...</p>
+        </div>
+      </div>
+    </div>
+
+    <div class="unity-controls">
+      <el-button-group>
+        <el-button
+          type="warning"
+          size="default"
+          icon="close"
+          :disabled="!sdkStatus.avatarLoaded"
+          @click="handleUnloadAvatar" 
+        >
+          卸载Avatar
+        </el-button>
+        <el-button
+          type="danger"
+          size="default"
+          icon="delete"
+          :disabled="!sdkStatus.unityLoaded"
+          @click="handleDestroySDK"
+        >
+          销毁实例
+        </el-button>
+      </el-button-group>
+    </div>
+
+    <!-- 加载进度显示 -->
+    <div v-if="loadingProgress > 0 && loadingProgress < 1" class="loading-progress">
+      <el-progress
+        :percentage="Math.round(loadingProgress * 100)"
+        :stroke-width="6"
+        text-inside
+      />
+      <p class="progress-text">Unity 加载中，请稍候...</p>
+    </div>
+  </el-card>
+</template>
+
+<script setup lang="ts">
+import { defineProps, defineEmits } from 'vue';
+
+interface ISDKStatus {
+  unityLoaded: boolean;
+  avatarLoaded: boolean;
+}
+
+const props = defineProps<{
+  sdkStatus: ISDKStatus;
+  loadingProgress: number;
+}>();
+
+const emit = defineEmits<{
+  (e: 'unload-avatar'): void;
+  (e: 'destroy-sdk'): void;
+}>();
+
+function handleUnloadAvatar() {
+  emit('unload-avatar');
+}
+
+function handleDestroySDK() {
+  emit('destroy-sdk');
+}
+</script>
+
+<style lang="scss" scoped>
+// Unity预览
+.unity-preview {
+  position: relative;
+  display: flex;
+  width: 100%;
+  height: 100%;
+  overflow: hidden;
+  flex-direction: column;
+  .card-header {
+    display: flex;
+    justify-content: space-between;
+    align-items: center;
+    font-weight: 600;
+  }
+  :deep(.el-card__body) {
+    display: flex;
+    width: 100%;
+    height: 100%;
+    flex-direction: column;
+    box-sizing: border-box;
+  }
+  .unity-container-wrapper {
+    position: relative;
+    width: 100%;
+    max-height: 600px; // 添加最大高度限制
+    margin-bottom: 15px;
+    overflow: hidden; // 防止内容溢出
+    flex: 1;
+  }
+  .unity-container {
+    position: relative;
+    width: 100%;
+    height: 100%;
+    max-height: 100%; // 确保不超过父容器
+    overflow: hidden;
+    background-color: #000;
+    border-radius: 4px;
+  }
+  .unity-tip {
+    position: absolute;
+    top: 50%;
+    left: 50%;
+    color: white; // 确保在黑色背景上文字可见
+    text-align: center;
+    transform: translate(-50%, -50%);
+    i {
+      margin-bottom: 10px;
+      font-size: 48px;
+    }
+    p {
+      margin: 0;
+      font-size: 14px;
+    }
+  }
+  .unity-controls {
+    display: flex;
+    justify-content: center;
+    padding-top: 10px;
+  }
+  .loading-progress {
+    position: absolute;
+    top: 50%;
+    left: 50%;
+    width: 80%;
+    transform: translate(-50%, -50%);
+    text-align: center;
+    z-index: 10;
+    .progress-text {
+      color: white;
+      margin-top: 10px;
+      font-size: 14px;
+    }
+  }
+}
+
+// 移动端优化
+@media screen and (width <= 768px) {
+  .unity-preview {
+    .unity-container-wrapper {
+      height: 250px;
+      max-height: 250px; // 确保移动端不会超过设定高度
+      flex: none;
+      overflow: hidden; // 防止内容溢出
+    }
+    .unity-controls {
+      .el-button-group {
+        display: flex;
+        flex-direction: column;
+        .el-button {
+          margin: 2px 0;
+        }
+      }
+    }
+  }
+}
+
+// 平板端优化
+@media screen and (width <= 992px) and (width > 768px) {
+  .unity-preview {
+    .unity-container-wrapper {
+      height: 300px; // 平板端适中高度
+      max-height: 300px; // 确保平板端不会超过设定高度
+      overflow: hidden; // 防止内容溢出
+    }
+  }
+}
+</style>

package/dist/examples/test-vue3/src/main.ts

@@ -0,0 +1,12 @@
+import { createApp } from 'vue'
+import App from './App.vue'
+
+// Element Plus 样式
+import 'element-plus/dist/index.css'
+
+// 创建Vue应用实例
+const app = createApp(App)
+
+// 挂载应用
+app.mount('#app')
+ 

package/dist/examples/test-vue3/src/types.ts

@@ -0,0 +1,9 @@
+export interface IGlobalConfig {
+  token: string;
+  avatarCode: string;
+  env: 'dev' | 'test' | 'prod' | 'custom';
+  webglPath?:string;
+  apiBaseUrl?:string;
+  resourcesUrl?:string;
+  idleMotionListString?:string;
+}

package/dist/examples/test-vue3/tsconfig.json

@@ -0,0 +1,44 @@
+{
+  "compilerOptions": {
+    "target": "ESNext",
+    "useDefineForClassFields": true,
+    "module": "ESNext",
+    "moduleResolution": "Node",
+    "strict": true,
+    "jsx": "preserve",
+    "sourceMap": true,
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "esModuleInterop": true,
+    "lib": [
+      "ESNext",
+      "DOM"
+    ],
+    "skipLibCheck": true,
+    "baseUrl": "./",
+    "paths": {
+      "@/*": [
+        "src/*"
+      ],
+      "#/*": [
+        "typings/*"
+      ]
+    },
+    "types": [
+      "vite/client", // https://cn.vitejs.dev/guide/features.html#typescript-compiler-options
+      "element-plus/global",
+    ]
+  },
+  "include": [
+    "src/**/*.ts",
+    "src/**/*.d.ts",
+    "src/**/*.tsx",
+    "src/**/*.vue",
+    "typings/**/*.d.ts"
+  ],
+  "references": [
+    {
+      "path": "./tsconfig.node.json"
+    }
+  ]
+}

package/dist/examples/test-vue3/tsconfig.node.json

@@ -0,0 +1,14 @@
+{
+  "compilerOptions": {
+    "composite": true,
+    "module": "ESNext",
+    "moduleResolution": "Node",
+    "esModuleInterop": true,
+    "resolveJsonModule": true
+  },
+  "include": [
+    "package.json",
+    "vite.config.ts",
+    "vite/**/*.ts"
+  ]
+}

package/dist/examples/test-vue3/vite.config.ts

@@ -0,0 +1,75 @@
+import { resolve } from 'path';
+import { URL, fileURLToPath } from 'node:url';
+import { defineConfig, loadEnv } from 'vite';
+import vue from '@vitejs/plugin-vue';
+import AutoImport from 'unplugin-auto-import/vite';
+import Components from 'unplugin-vue-components/vite';
+import { ElementPlusResolver } from 'unplugin-vue-components/resolvers';
+
+// https://vitejs.dev/config/
+export default defineConfig(({ mode, command }) =>
+{
+  // 加载环境变量
+  const env = loadEnv(mode, process.cwd(), '');
+
+  // 检查是否使用本地SDK开发模式
+  const useLocalSDK = env.VITE_USE_LOCAL_SDK === 'true';
+  const localSDKPath = resolve(fileURLToPath(new URL('.', import.meta.url)), '../../dist/index.esm.js');
+
+  console.log('🔧 Vite 配置信息:');
+  console.log(`   - 运行模式: ${mode}`);
+  console.log(`   - 使用本地 SDK: ${useLocalSDK ? '✅ 是' : '❌ 否'}`);
+  if (useLocalSDK)
+  {
+    console.log(`   - 本地 SDK 路径: ${localSDKPath}`);
+    console.log('   - 运行模式: 开发模式');
+  }
+  else
+  {
+    console.log('   - 运行模式: npm包模式');
+  }
+
+  return {
+    base: env.VITE_PUBLIC_PATH || './',
+    plugins: [
+      vue(),
+      AutoImport({
+        resolvers: [ElementPlusResolver()],
+        imports: [
+          'vue',
+          '@vueuse/core'
+        ],
+          dts: true
+      }),
+      Components({
+        resolvers: [ElementPlusResolver()],
+          dts: true
+        })
+    ],
+    resolve: {
+      alias: {
+          '@': fileURLToPath(new URL('./src', import.meta.url)),
+          // 如果启用本地开发模式，将 SDK 指向本地构建版本
+          ...(useLocalSDK && {
+            '@zeewain/3d-avatar-sdk': localSDKPath
+          })
+        }
+    },
+    server: {
+      open: true,
+      port: 20054,
+      proxy: {
+        '/proxy': {
+          target: env.VITE_APP_API_BASEURL,
+          changeOrigin: command === 'serve' && env.VITE_OPEN_PROXY === 'true',
+          rewrite: path => path.replace(/\/proxy/, '')
+        }
+      }
+
+    },
+    build: {
+      outDir: mode === 'production' ? 'dist' : `dist-${mode}`,
+      sourcemap: false,
+    }
+  }
+});

package/dist/index.d.ts

@@ -956,13 +956,6 @@ declare class BroadcastService extends UnityBaseService<BroadcastOperationType>
     destroy(): void;
     /** 全局回调函数名称 */
     protected get callbackFunctionName(): string;
-    /**
-     * 获取API基础URL
-     * @returns string 返回当前环境的API基础URL
-     * @description 根据当前环境配置获取API基础URL
-     * @private
-     */
-    private getApiBaseUrl;
     /**
      * 获取播报API路径
      * @param type - 播报类型
@@ -987,6 +980,13 @@ declare class BroadcastService extends UnityBaseService<BroadcastOperationType>
      * @private
      */
     private handleError;
+    /**
+     * 处理播报错误
+     * @param errorCode - 错误码
+     * @description 处理播报过程中的错误
+     * @private
+     */
+    private handleBroadcastError;
 }
 
 /**
@@ -1020,7 +1020,7 @@ declare enum NetworkErrorCode {
     CONNECTION_FAILED = 1001,
     /** 请求超时 */
     REQUEST_TIMEOUT = 1002,
-    /** 服务器错误 */
+    /** 服务错误 */
     SERVER_ERROR = 1003,
     /** 未授权访问 */
     UNAUTHORIZED = 1004
@@ -1040,7 +1040,13 @@ declare enum OperationErrorCode {
     /** 操作超时 */
     OPERATION_TIMEOUT = 2004,
     /** 操作被取消 */
-    OPERATION_CANCELLED = 2005
+    OPERATION_CANCELLED = 2005,
+    /** 用户权益额度不存在 */
+    BROADCAST_EQUITY_NOT_EXIST = 2006,
+    /** 用户权益额度不足 */
+    BROADCAST_EQUITY_NOT_ENOUGH = 2007,
+    /** 用户权益额度冻结失败 */
+    BROADCAST_EQUITY_FREEZE_FAILED = 2008
 }
 /**
  * 资源错误码 (3xxx)

package/dist/index.es5.js

@@ -12147,7 +12147,7 @@ var ZEEAvatarSDKLib = (function (exports) {
 	  NetworkErrorCode[NetworkErrorCode["CONNECTION_FAILED"] = 1001] = "CONNECTION_FAILED";
 	  /** 请求超时 */
 	  NetworkErrorCode[NetworkErrorCode["REQUEST_TIMEOUT"] = 1002] = "REQUEST_TIMEOUT";
-	  /** 服务器错误 */
+	  /** 服务错误 */
 	  NetworkErrorCode[NetworkErrorCode["SERVER_ERROR"] = 1003] = "SERVER_ERROR";
 	  /** 未授权访问 */
 	  NetworkErrorCode[NetworkErrorCode["UNAUTHORIZED"] = 1004] = "UNAUTHORIZED";
@@ -12169,6 +12169,12 @@ var ZEEAvatarSDKLib = (function (exports) {
 	  OperationErrorCode[OperationErrorCode["OPERATION_TIMEOUT"] = 2004] = "OPERATION_TIMEOUT";
 	  /** 操作被取消 */
 	  OperationErrorCode[OperationErrorCode["OPERATION_CANCELLED"] = 2005] = "OPERATION_CANCELLED";
+	  /** 用户权益额度不存在 */
+	  OperationErrorCode[OperationErrorCode["BROADCAST_EQUITY_NOT_EXIST"] = 2006] = "BROADCAST_EQUITY_NOT_EXIST";
+	  /** 用户权益额度不足 */
+	  OperationErrorCode[OperationErrorCode["BROADCAST_EQUITY_NOT_ENOUGH"] = 2007] = "BROADCAST_EQUITY_NOT_ENOUGH";
+	  /** 用户权益额度冻结失败 */
+	  OperationErrorCode[OperationErrorCode["BROADCAST_EQUITY_FREEZE_FAILED"] = 2008] = "BROADCAST_EQUITY_FREEZE_FAILED";
 	})(exports.OperationErrorCode || (exports.OperationErrorCode = {}));
 	/**
 	 * 资源错误码 (3xxx)
@@ -12254,6 +12260,15 @@ var ZEEAvatarSDKLib = (function (exports) {
 	}, _a[exports.OperationErrorCode.OPERATION_CANCELLED] = {
 	  category: exports.ErrorCategory.OPERATION,
 	  message: '操作被取消'
+	}, _a[exports.OperationErrorCode.BROADCAST_EQUITY_NOT_EXIST] = {
+	  category: exports.ErrorCategory.OPERATION,
+	  message: '用户权益额度不存在'
+	}, _a[exports.OperationErrorCode.BROADCAST_EQUITY_NOT_ENOUGH] = {
+	  category: exports.ErrorCategory.OPERATION,
+	  message: '用户权益额度不足'
+	}, _a[exports.OperationErrorCode.BROADCAST_EQUITY_FREEZE_FAILED] = {
+	  category: exports.ErrorCategory.OPERATION,
+	  message: '用户权益额度冻结失败'
 	},
 	// 资源错误
 	_a[exports.ResourceErrorCode.LOAD_FAILED] = {
@@ -12851,7 +12866,7 @@ var ZEEAvatarSDKLib = (function (exports) {
 	    console.warn("[Unity Warning] ".concat(message), data);
 	  };
 	  SimpleLogger.prototype.error = function (message, error, data) {
-	    console.error("[Unity Error] ".concat(message), error, data);
+	    console.error("[Unity Error] ".concat(message), error, error instanceof SDKError ? error.code : null, data);
 	  };
 	  return SimpleLogger;
 	}();
@@ -13235,6 +13250,7 @@ var ZEEAvatarSDKLib = (function (exports) {
 	/**
 	 * 获取指定环境的配置
 	 * @param env - 环境类型，默认为'dev'
+	 * @param withApiModule - 是否包含API模块路径
 	 * @returns 返回对应环境的配置对象
 	 * @example
 	 * ```typescript
@@ -13242,17 +13258,17 @@ var ZEEAvatarSDKLib = (function (exports) {
 	 * console.log(config.apiBaseUrl); // https://aiip.zeewain.com/api/dh-talker
 	 * ```
 	 */
-	function getEnvConfig(env, withModule) {
+	function getEnvConfig(env, withApiModule) {
 	  if (env === void 0) {
 	    env = 'dev';
 	  }
-	  if (withModule === void 0) {
-	    withModule = true;
+	  if (withApiModule === void 0) {
+	    withApiModule = true;
 	  }
 	  var baseUrl = ENV_MAP[env];
 	  if (baseUrl) {
 	    return {
-	      apiBaseUrl: "".concat(baseUrl.apiBaseUrl).concat(withModule ? '/api' : '')
+	      apiBaseUrl: "".concat(baseUrl.apiBaseUrl).concat(withApiModule ? '/api' : '')
 	    };
 	  }
 	  return null;
@@ -13325,19 +13341,20 @@ var ZEEAvatarSDKLib = (function (exports) {
 	  };
 	  /**
 	   * 获取API基础URL
-	   * @param withModule 是否包含模块路径
+	   * @param withApiModule 是否包含模块路径
 	   * @returns string API基础URL
 	   * @description 根据当前环境配置获取API基础URL
 	   */
-	  ConfigManager.prototype.getApiBaseUrl = function (withModule) {
+	  ConfigManager.prototype.getApiBaseUrl = function (withApiModule) {
 	    var _a, _b, _c, _d;
-	    if (withModule === void 0) {
-	      withModule = true;
+	    if (withApiModule === void 0) {
+	      withApiModule = true;
 	    }
 	    if (((_a = this.config) === null || _a === void 0 ? void 0 : _a.env) === 'custom' && ((_b = this.config) === null || _b === void 0 ? void 0 : _b.apiUrl)) {
-	      return this.config.apiUrl;
+	      // 如果环境为自定义，则直接返回配置的API，无需添加模块路径
+	      return "".concat(this.config.apiUrl).concat(withApiModule ? '/api' : '');
 	    }
-	    return ((_d = getEnvConfig(((_c = this.config) === null || _c === void 0 ? void 0 : _c.env) || 'prod', withModule)) === null || _d === void 0 ? void 0 : _d.apiBaseUrl) || '';
+	    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
@@ -13827,6 +13844,9 @@ var ZEEAvatarSDKLib = (function (exports) {
 	          this.logger.debug('Broadcast stopped callback triggered');
 	          break;
 	      }
+	    } else {
+	      var error = SDKError.createFromUnityError(code, "Unity operation '".concat(operation, "' failed: ").concat(message));
+	      this.handleError(error);
 	    }
 	  };
 	  /**
@@ -13900,7 +13920,7 @@ var ZEEAvatarSDKLib = (function (exports) {
 	            _c.label = 2;
 	          case 2:
 	            _c.trys.push([2, 4,, 5]);
-	            apiUrl = "".concat(this.getApiBaseUrl()).concat(this.getBroadcastApiPath(params.type));
+	            apiUrl = "".concat(ConfigManager.getInstance().getApiBaseUrl(true)).concat(this.getBroadcastApiPath(params.type));
 	            requestBody = {
 	              humanCode: params.humanCode,
 	              speed: params.speed,
@@ -13937,7 +13957,7 @@ var ZEEAvatarSDKLib = (function (exports) {
 	                var response = JSON.parse(event.data);
 	                // 错误处理
 	                if (response.code !== 0) {
-	                  _this.handleError(new SDKError(exports.NetworkErrorCode.SERVER_ERROR, response.message || '未知服务器错误'));
+	                  _this.handleBroadcastError(response.code);
 	                  return;
 	                }
 	                // 流式播报
@@ -13976,7 +13996,10 @@ var ZEEAvatarSDKLib = (function (exports) {
 	              },
 	              onerror: function onerror(error) {
 	                _this.logger.error('Broadcast stream error', error);
-	                _this.handleError(new SDKError(exports.OperationErrorCode.OPERATION_FAILED, '播报流错误', error));
+	                var sdkError = new SDKError(exports.OperationErrorCode.OPERATION_FAILED, '服务出错了', error);
+	                _this.handleError(sdkError);
+	                // 必须抛出错误，否则会循环重试请求
+	                throw new Error("\u670D\u52A1\u51FA\u9519\u4E86".concat(sdkError.message));
 	              }
 	            })];
 	          case 3:
@@ -14148,16 +14171,6 @@ var ZEEAvatarSDKLib = (function (exports) {
 	    enumerable: false,
 	    configurable: true
 	  });
-	  /**
-	   * 获取API基础URL
-	   * @returns string 返回当前环境的API基础URL
-	   * @description 根据当前环境配置获取API基础URL
-	   * @private
-	   */
-	  BroadcastService.prototype.getApiBaseUrl = function () {
-	    var configManager = ConfigManager.getInstance();
-	    return configManager.getApiBaseUrl();
-	  };
 	  /**
 	   * 获取播报API路径
 	   * @param type - 播报类型
@@ -14167,10 +14180,19 @@ var ZEEAvatarSDKLib = (function (exports) {
 	   * @private
 	   */
 	  BroadcastService.prototype.getBroadcastApiPath = function (type) {
+	    var env = ConfigManager.getInstance().getEnv();
 	    switch (type) {
 	      case exports.BroadcastType.TEXT:
+	        // 临时处理，开发和测试环境使用新接口
+	        if (env === 'dev' || env === 'test') {
+	          return '/aiep-openapi/avatar-interaction/v1/broadcast/text';
+	        }
 	        return '/dh-talker/user/agent/broadcast/text';
 	      case exports.BroadcastType.AUDIO:
+	        // 临时处理，开发和测试环境使用新接口
+	        if (env === 'dev' || env === 'test') {
+	          return '/aiep-openapi/avatar-interaction/v1/broadcast/audio';
+	        }
 	        return '/dh-talker/user/agent/broadcast/customAudio';
 	      default:
 	        throw new SDKError(exports.ConfigErrorCode.INVALID_CONFIG, "\u672A\u77E5\u7684\u64AD\u62A5\u7C7B\u578B: ".concat(type));
@@ -14211,6 +14233,31 @@ var ZEEAvatarSDKLib = (function (exports) {
 	    // 触发错误回调
 	    (_b = (_a = this.callbacks).onError) === null || _b === void 0 ? void 0 : _b.call(_a, error);
 	  };
+	  /**
+	   * 处理播报错误
+	   * @param errorCode - 错误码
+	   * @description 处理播报过程中的错误
+	   * @private
+	   */
+	  BroadcastService.prototype.handleBroadcastError = function (errorCode) {
+	    // 用户权益额度不存在错误码 14001
+	    // 用户权益额度不足错误码 14002
+	    // 用户权益额度冻结失败 14003
+	    switch (errorCode) {
+	      case 14001:
+	        this.handleError(new SDKError(exports.OperationErrorCode.BROADCAST_EQUITY_NOT_EXIST, '用户权益额度不存在'));
+	        break;
+	      case 14002:
+	        this.handleError(new SDKError(exports.OperationErrorCode.BROADCAST_EQUITY_NOT_ENOUGH, '用户权益额度不足'));
+	        break;
+	      case 14003:
+	        this.handleError(new SDKError(exports.OperationErrorCode.BROADCAST_EQUITY_FREEZE_FAILED, '用户权益额度冻结失败'));
+	        break;
+	      default:
+	        this.handleError(new SDKError(exports.OperationErrorCode.OPERATION_FAILED, '播报服务错误'));
+	        break;
+	    }
+	  };
 	  return BroadcastService;
 	}(UnityBaseService);
 
@@ -14349,11 +14396,12 @@ var ZEEAvatarSDKLib = (function (exports) {
 	   * @protected
 	   */
 	  ZEEAvatarLoader.prototype.initGlobalConfig = function () {
-	    var params = __assign(__assign({}, ConfigManager.getInstance().getConfig()), {
+	    var params = {
 	      token: ConfigManager.getInstance().getToken(),
 	      apiBaseUrl: ConfigManager.getInstance().getApiBaseUrl(false),
+	      idleMotionList: ConfigManager.getInstance().getConfig().idleMotionList,
 	      assetsUrl: ConfigManager.getInstance().getConfig().assetsUrl
-	    });
+	    };
 	    console.warn('[ Send Unity message ]: AvatarSDK.InitializeConfig', params);
 	    this.unityInstance.SendMessage('AvatarSDK', 'InitializeConfig', JSON.stringify(params));
 	  };