@zeewain/3d-avatar-sdk 1.2.3 → 1.2.4-1

package/dist/examples/test-vue3/src/App.vue

@@ -299,7 +299,7 @@ function initializeSDKConfig(): ZEEAvatarSDK | null {
     env: globalConfig.env,
     apiUrl: globalConfig.apiBaseUrl,
     resourcesUrl: globalConfig.resourcesUrl || undefined,
-
+    enableDebugLog: true,
     // 待机动作列表：比心，左手指示（低）
     idleMotionList: globalConfig.idleMotionListString?.split(',').filter(item => item.trim()) || [],
 
@@ -452,6 +452,7 @@ async function handleTextBroadcast(params: {
   voiceCode?: string;
   speed?: number;
   broadcastMotionString?: string;
+  isAppend?: boolean;
 }): Promise<void> {
   if (!sdk.value) return;
 
@@ -470,7 +471,7 @@ async function handleTextBroadcast(params: {
       motionPlayMode: 'random'
     };
 
-    await sdk.value.startBroadcast(broadcastParams);
+    await sdk.value.startBroadcast(broadcastParams, params.isAppend);
     addLog('文本播报已开始', 'success');
     // ElMessage.success('文本播报已开始');
   } catch (error) {
@@ -488,6 +489,7 @@ async function handleAudioBroadcast(params: {
   speed?: number;
   audioText?: string;
   broadcastMotionString?: string;
+  isAppend?: boolean;
 }): Promise<void> {
   if (!sdk.value) return;
 
@@ -506,7 +508,7 @@ async function handleAudioBroadcast(params: {
       motionPlayMode: 'random'
     };
 
-    await sdk.value.startBroadcast(broadcastParams);
+    await sdk.value.startBroadcast(broadcastParams, params.isAppend);
     addLog('音频播报已开始', 'success');
     ElMessage.success('音频播报已开始');
   } catch (error) {

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

@@ -115,15 +115,18 @@
                 </div>
               </el-form-item>
               <el-form-item class="action-buttons">
-                <el-button
-                  type="primary"
-                  icon="chat-dot-round"
-                  :loading="isTextLoading"
-                  :disabled="!sdkStatus.canBroadcast || !textFormData.text || !textFormData.voiceCode || !globalConfig.avatarCode"
-                  @click="handleTextBroadcast"
-                >
-                  {{ isTextLoading ? '播报中...' : '执行文本播报' }}
-                </el-button>
+                <div class="action-buttons-container">
+                  <el-button
+                    type="primary"
+                    icon="chat-dot-round"
+                    :loading="isTextLoading"
+                    :disabled="!sdkStatus.canBroadcast || !textFormData.text || !textFormData.voiceCode || !globalConfig.avatarCode"
+                    @click="handleTextBroadcast"
+                  >
+                    {{ isTextLoading ? '播报中...' : '执行文本播报' }}
+                  </el-button>
+                  <el-button @click="handleResetBroadcast">重置</el-button>
+                </div>
               </el-form-item>
             </el-form>
           </div>
@@ -181,15 +184,18 @@
               </el-form-item>
 
               <el-form-item class="action-buttons">
-                <el-button
+                <div class="action-buttons-container">
+                  <el-button
                   type="primary"
                   icon="headset"
                   :loading="isAudioLoading"
                   :disabled="!sdkStatus.canBroadcast || !audioFormData.audioUrl || !globalConfig.avatarCode"
                   @click="handleAudioBroadcast"
-                >
-                  {{ isAudioLoading ? '播报中...' : '执行音频播报' }}
-                </el-button>
+                  >
+                    {{ isAudioLoading ? '播报中...' : '执行音频播报' }}
+                  </el-button>
+                  <el-button @click="handleResetBroadcast">重置</el-button>
+                </div>
               </el-form-item>
             </el-form>
           </div>
@@ -328,6 +334,7 @@ const isAudioLoading = ref(false);
 const pauseLoading = ref(false);
 const resumeLoading = ref(false);
 const stopLoading = ref(false);
+const isStartBroadcast = ref(false);
 
 async function handleTextBroadcast() {
   const { text, volume, speed, voiceCode, broadcastMotionString } = textFormData;
@@ -345,11 +352,12 @@ async function handleTextBroadcast() {
   isTextLoading.value = true;
   result.value = `🔄 正在执行文本播报...\n📝 播报文本: ${text.substring(0, 30)}${text.length > 30 ? '...' : ''}\n🎤 音色编码: ${voiceCode}\n🔊 音量: ${volume}\n⚡ 语速: ${speed}\n\n📡 流式播报中，请等待服务器响应...`;
   try {
-    emit('text-broadcast', { avatarCode, text, volume, speed, voiceCode, broadcastMotionString });
+    emit('text-broadcast', { avatarCode, text, volume, speed, voiceCode, broadcastMotionString, isAppend: isStartBroadcast.value });
+    isStartBroadcast.value = true;
     setTimeout(() => {
       isTextLoading.value = false;
       result.value = '✅ 文本播报请求已发送\n📋 请查看右侧日志面板获取详细信息\n\n📝 操作说明：\n- 播报将以流式方式进行\n- 可使用下方控制按钮暂停/继续/停止\n- 播报过程中会触发相应的事件回调';
-    }, 1000);
+    }, 0);
   } catch (error: any) {
     isTextLoading.value = false;
     result.value = `❌ 播报失败: ${error.message}\n\n🔍 可能的原因：\n- 网络连接问题\n- 音色编码不存在\n- 服务器繁忙\n- 文本内容不符合要求`;
@@ -373,7 +381,8 @@ async function handleAudioBroadcast() {
   isAudioLoading.value = true;
   result.value = `🔄 正在执行音频播报...\n🎵 音频地址: ${audioUrl}\n📝 字幕文本: ${audioText || '无'}\n🔊 音量: ${volume}\n\n📡 正在验证音频文件并加载...`;
   try {
-    emit('audio-broadcast', { avatarCode, audioText, audioUrl, volume, broadcastMotionString });
+    emit('audio-broadcast', { avatarCode, audioText, audioUrl, volume, broadcastMotionString, isAppend: isStartBroadcast.value });
+    isStartBroadcast.value = true;
     setTimeout(() => {
       isAudioLoading.value = false;
       result.value = '✅ 音频播报请求已发送\n📋 请查看右侧日志面板获取详细信息\n\n📝 操作说明：\n- 音频将直接驱动数字人口型\n- 支持MP3、WAV等格式\n- 可使用下方控制按钮进行控制';
@@ -429,7 +438,11 @@ function handleStopBroadcast() {
     result.value = `❌ 停止播报失败: ${error.message}\n\n🔍 可能的原因：\n- Unity通信异常\n- 播报服务未初始化\n- 系统资源异常`;
   }
 }
- 
+
+function handleResetBroadcast() {
+  isStartBroadcast.value = false;
+}
+
 function clearResult() {
   result.value = '等待播报操作...\n\n新版SDK特性：\n- 支持流式播报，实时响应\n- 内置事件回调机制\n- token统一管理，无需重复传递\n- 支持音量和语速控制\n- 实时播报控制（暂停/恢复/停止）';
 }
@@ -502,10 +515,15 @@ function clearResult() {
             &.action-buttons {
               margin-bottom: 0;
               margin-top: 25px;
-              .el-button {
+              .action-buttons-container {
                 width: 100%;
-                padding: 10px 0;
-                font-weight: 500;
+                display: flex;
+                gap: 10px;
+                .el-button {
+                  width: 100%;
+                  padding: 10px 0;
+                  font-weight: 500;
+                }
               }
             }
             .input-help {

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

@@ -9,6 +9,7 @@
   "include": [
     "package.json",
     "vite.config.ts",
-    "vite/**/*.ts"
+    "vite/**/*.ts",
+    "plugins/**/*.ts"
   ]
 }

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

@@ -5,10 +5,12 @@ 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';
+import createHtml from './plugins/html';
 
 // https://vitejs.dev/config/
 export default defineConfig(({ mode, command }) =>
 {
+  const isBuild = command === 'build';
   // 加载环境变量
   const env = loadEnv(mode, process.cwd(), '');
 
@@ -44,7 +46,8 @@ export default defineConfig(({ mode, command }) =>
       Components({
         resolvers: [ElementPlusResolver()],
           dts: true
-        })
+        }),
+      createHtml(isBuild)
     ],
     resolve: {
       alias: {

package/dist/index.d.ts

@@ -351,6 +351,8 @@ interface IAvatarSDKConfig {
     onProgress?: (progress: number) => void;
     /** 播报回调函数，可选 */
     broadcastCallbacks?: IBroadcastCallbacks;
+    /** 是否启用调试日志，默认为false */
+    enableDebugLog?: boolean;
 }
 
 /**
@@ -511,9 +513,10 @@ declare class ZEEAvatarSDK {
     /**
      * 开始播报
      * @param params 播报参数
+     * @param isAppend 是否追加播报
      * @returns Promise<void> 播报操作的Promise
      */
-    startBroadcast(params: IBroadcastParams): Promise<void>;
+    startBroadcast(params: IBroadcastParams, isAppend?: boolean): Promise<void>;
     /**
      * 暂停播报
      * @param resetIdle 是否重置空闲状态
@@ -836,12 +839,20 @@ declare class AvatarService extends UnityBaseService<AvatarOperationType> implem
 declare class BroadcastService extends UnityBaseService<BroadcastOperationType> implements IBroadcastAPI {
     /** 事件回调函数集合 */
     private callbacks;
-    /** 请求控制器，用于取消请求 */
-    private activeController;
+    /** 播报任务队列 */
+    private taskQueue;
+    /** 任务序号计数器 */
+    private taskSequence;
+    /** 当前发送任务的序号 */
+    private currentSendingSequence;
     /** 是否正在生成音频 */
     private isGeneratingAudio;
     /** 是否已经收到音频 */
     private hasReceivedAudio;
+    /** 队列处理定时器 */
+    private queueProcessTimer;
+    /** 主请求控制器（兼容性保留） */
+    private activeController;
     /**
      * 构造函数
      * @param config - 播报服务配置
@@ -874,8 +885,9 @@ declare class BroadcastService extends UnityBaseService<BroadcastOperationType>
     /**
      * 开始播报
      * @param params - 播报参数
+     * @param isAppend - 是否追加播报
      * @returns Promise<void> 播报操作的Promise
-     * @description 开始流式播报，支持文本转语音和自定义音频播报
+     * @description 开始流式播报，支持文本转语音和自定义音频播报。使用队列机制确保音频按序播报
      * @throws {SDKError} 当参数验证失败或播报失败时抛出错误
      * @example
      * ```typescript
@@ -889,17 +901,18 @@ declare class BroadcastService extends UnityBaseService<BroadcastOperationType>
      *   isSubtitle: true
      * });
      *
-     * // 自定义音频播报
+     * // 追加播报（会进入队列按序播报）
      * await broadcastService.startBroadcast({
-     *   type: BroadcastType.AUDIO,
+     *   type: BroadcastType.TEXT,
      *   humanCode: 'human001',
-     *   audioUrl: 'https://example.com/audio.mp3',
+     *   text: '这是第二段内容',
+     *   voiceCode: 'voice001',
      *   volume: 0.8,
-     *   isSubtitle: false
-     * });
+     *   isSubtitle: true
+     * }, true);
      * ```
      */
-    startBroadcast(params: IBroadcastParams): Promise<void>;
+    startBroadcast(params: IBroadcastParams, isAppend?: boolean): Promise<void>;
     /**
      * 暂停播报
      * @param resetIdle - 是否重置空闲状态
@@ -940,7 +953,7 @@ declare class BroadcastService extends UnityBaseService<BroadcastOperationType>
     /**
      * 获取播报状态
      * @returns 播报状态信息
-     * @description 获取当前播报服务的状态信息
+     * @description 获取当前播报服务的状态信息，包括队列状态
      */
     getStatus(): {
         isActive: boolean;
@@ -948,12 +961,96 @@ declare class BroadcastService extends UnityBaseService<BroadcastOperationType>
         hasReceivedAudio: boolean;
         pendingCallbacks: number;
         hasController: boolean;
+        queueInfo?: {
+            totalTasks: number;
+            requestingTasks: number;
+            completedTasks: number;
+            failedTasks: number;
+            totalPendingResponses: number;
+            currentSendingSequence: number;
+        };
     };
     /**
      * 销毁播报服务
      * @description 清理所有资源和回调
      */
     destroy(): void;
+    /**
+     * 创建播报任务
+     * @param params - 播报参数
+     * @returns IBroadcastTask 播报任务对象
+     * @description 创建新的播报任务并分配唯一ID和序号
+     * @private
+     */
+    private createBroadcastTask;
+    /**
+     * 添加任务到队列
+     * @param task - 播报任务
+     * @description 将任务添加到队列并立即开始请求
+     * @private
+     */
+    private addTaskToQueue;
+    /**
+     * 处理队列
+     * @description 处理队列中的任务，发起请求生成音频
+     * @private
+     */
+    private processQueue;
+    /**
+     * 队列处理步骤
+     * @description 处理队列中的单个步骤，包括发起请求和发送音频
+     * @private
+     */
+    private processQueueStep;
+    /**
+     * 开始任务请求
+     * @param task - 播报任务
+     * @description 为任务发起流式请求生成音频
+     * @private
+     */
+    private startTaskRequest;
+    /**
+     * 处理任务响应
+     * @param task - 播报任务
+     * @param data - 响应数据
+     * @description 处理任务的流式响应数据
+     * @private
+     */
+    private handleTaskResponse;
+    /**
+     * 发送下一个响应
+     * @param task - 播报任务
+     * @description 发送任务中的第一个待发送响应到Unity，发送后立即删除
+     * @private
+     */
+    private sendNextResponse;
+    /**
+     * 处理任务关闭
+     * @param task - 播报任务
+     * @description 处理任务的流式连接关闭
+     * @private
+     */
+    private handleTaskClose;
+    /**
+     * 处理任务错误
+     * @param task - 播报任务
+     * @param error - 错误对象
+     * @description 处理任务执行过程中的错误
+     * @private
+     */
+    private handleTaskError;
+    /**
+     * 清理已完成的任务
+     * @description 从队列中移除已完成、失败或取消的任务
+     * @private
+     */
+    private cleanupCompletedTasks;
+    /**
+     * 取消所有任务
+     * @description 取消队列中的所有任务
+     * @private
+     */
+    private cancelAllTasks;
     /** 全局回调函数名称 */
     protected get callbackFunctionName(): string;
     /**