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

package/README.md

@@ -750,7 +750,7 @@ updateBroadcastCallbacks(callbacks: IBroadcastCallbacks): void
 ```typescript
 interface IBroadcastCallbacks {
   onStart?: () => void;           // 播报开始
-  onFinish?: () => void;          // 播报完成
+  onFinish?: () => void;          // 播报完成（每调用一次`startBroadcast`，在播报结束后都会触发一次回调）
   onError?: (error: Error) => void; // 播报错误
   onPause?: () => void;           // 播报暂停
   onResume?: () => void;          // 播报恢复
@@ -775,8 +775,6 @@ getBroadcastStatus(): {
   isActive: boolean;
   isGeneratingAudio: boolean;
   hasReceivedAudio: boolean;
-  pendingCallbacks: number;
-  hasController: boolean;
   queueInfo?: {
     totalTasks: number;              // 队列中总任务数
     requestingTasks: number;         // 正在请求中的任务数
@@ -788,14 +786,12 @@ getBroadcastStatus(): {
 }
 ```
 
-获取播报状态信息，包括队列状态监控。
+获取播报状态信息，包括队列状态监控。`当播报队列中最后一条音频播放完毕后，队列状态信息将被重置。`
 
 **返回值说明：**
-- `isActive`: 播报服务是否活跃（有任务在队列中或正在生成音频）
+- `isActive`: 播报服务是否活跃（是否正在播报音频或正在生成音频）
 - `isGeneratingAudio`: 是否正在生成音频
-- `hasReceivedAudio`: 是否已收到音频
-- `pendingCallbacks`: 待处理的回调数量
-- `hasController`: 是否有活跃的请求控制器
+- `hasReceivedAudio`: 是否已收到至少一条音频数据
 - `queueInfo`: 队列详细信息
   - `totalTasks`: 队列中的总任务数
   - `requestingTasks`: 正在发起SSE请求的任务数

package/dist/examples/test-vue2/package.json

@@ -16,7 +16,7 @@
     "lint:all-fix": "npm run lint:fix && npm run lint:css-fix"
   },
   "dependencies": {
-    "@zeewain/3d-avatar-sdk": "^1.2.4",
+    "@zeewain/3d-avatar-sdk": "^1.2.5",
     "core-js": "^3.8.3",
     "element-ui": "^2.15.13",
     "vue": "^2.6.14"

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

@@ -24,7 +24,7 @@
     "@element-plus/icons-vue": "^2.3.1",
     "@vueuse/core": "^13.5.0",
     "@vueuse/integrations": "^13.5.0",
-    "@zeewain/3d-avatar-sdk": "^1.2.4",
+    "@zeewain/3d-avatar-sdk": "^1.2.5",
     "dayjs": "^1.11.13",
     "element-plus": "^2.10.4",
     "vite-plugin-html": "^3.2.2",

package/dist/examples/test-vue3/pnpm-lock.yaml

@@ -15,8 +15,8 @@ dependencies:
     specifier: ^13.5.0
     version: 13.5.0(vue@3.5.17)
   '@zeewain/3d-avatar-sdk':
-    specifier: ^1.2.3
-    version: 1.2.3
+    specifier: ^1.2.4
+    version: 1.2.4
   dayjs:
     specifier: ^1.11.13
     version: 1.11.13
@@ -1124,11 +1124,11 @@ packages:
       - vue
     dev: false
 
-  /@zeewain/3d-avatar-sdk@1.2.3:
-    resolution: {integrity: sha512-jI/ZaoIg+vMDYluxpzTSdG4Mthcv4WhGYQsjL5Kx39qyxf0wmIUVKf7d48tmoDuVr5PtdcCa7w6uLG3I6bjVQQ==}
+  /@zeewain/3d-avatar-sdk@1.2.4:
+    resolution: {integrity: sha512-a+y9HpUjbZgObzR+RfnfjxamdAa6Nk9CWkdHMejPIsYfSogCM6UtN/Jbh1A08RzIH9xrJnsUpTm1nXvvIsT6Vw==}
     dependencies:
       '@microsoft/fetch-event-source': 2.0.1
-      core-js: 3.44.0
+      core-js: 3.45.1
     dev: false
 
   /acorn-jsx@5.3.2(acorn@8.15.0):
@@ -1493,8 +1493,8 @@ packages:
     resolution: {integrity: sha512-9vAdYbHj6x2fLKC4+oPH0kFzY/orMZyG2Aj+kNylHxKGJ/Ed4dpNyAQYwJOdqO4zdM7XpVHmyejQDcQHrnuXbw==}
     dev: false
 
-  /core-js@3.44.0:
-    resolution: {integrity: sha512-aFCtd4l6GvAXwVEh3XbbVqJGHDJt0OZRa+5ePGx3LLwi12WfexqQxcsohb2wgsa/92xtl19Hd66G/L+TaAxDMw==}
+  /core-js@3.45.1:
+    resolution: {integrity: sha512-L4NPsJlCfZsPeXukyzHFlg/i7IIVwHSItR0wg0FLNqYClJ4MQYTYLbC7EkjKYRLZF2iof2MUgN0EGy7MdQFChg==}
     requiresBuild: true
     dev: false
 

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

@@ -47,6 +47,7 @@
 
                   <el-tab-pane label="智能播报" name="text-broadcast">
                     <BroadcastAPI
+                      ref="broadcastAPI"
                       :sdk-status="sdkStatus"
                       :global-config="globalConfig"
                       @text-broadcast="handleTextBroadcast"
@@ -54,6 +55,7 @@
                       @pause-broadcast="handlePauseBroadcast"
                       @resume-broadcast="handleResumeBroadcast"
                       @stop-broadcast="handleStopBroadcast"
+                      @get-broadcast-status="handleGetBroadcastStatus"
                     />
                   </el-tab-pane>
 
@@ -135,6 +137,7 @@
 
                   <el-tab-pane label="智能播报" name="text-broadcast">
                     <BroadcastAPI
+                      ref="broadcastAPI"
                       :sdk-status="sdkStatus"
                       :global-config="globalConfig"
                       @text-broadcast="handleTextBroadcast"
@@ -142,6 +145,7 @@
                       @pause-broadcast="handlePauseBroadcast"
                       @resume-broadcast="handleResumeBroadcast"
                       @stop-broadcast="handleStopBroadcast"
+                      @get-broadcast-status="handleGetBroadcastStatus"
                     />
                   </el-tab-pane>
 
@@ -229,6 +233,7 @@ import InfoCards from './components/InfoCards.vue';
 import UnityPreview from './components/UnityPreview.vue';
 
 import type { IGlobalConfig } from './types';
+import { loadFromCache, saveToCache } from './utils';
 
 interface ISDKStatus {
   unityLoaded: boolean;
@@ -238,6 +243,7 @@ interface ISDKStatus {
   canGetMotion: boolean;
   canControlBroadcast: boolean;
   canControlCamera: boolean;
+  isStartBroadcast: boolean;
 }
 
 interface ILogEntry {
@@ -267,7 +273,8 @@ const sdkStatus = reactive<ISDKStatus>({
   canBroadcast: false,
   canGetMotion: false,
   canControlBroadcast: false,
-  canControlCamera: false
+  canControlCamera: false,
+  isStartBroadcast: false,
 });
 
 // 操作日志
@@ -278,6 +285,7 @@ const logs = reactive<ILogEntry[]>([
 
 // SDK实例
 const sdk = ref<ZEEAvatarSDK | null>(null);
+const broadcastAPI = ref<InstanceType<typeof BroadcastAPI> | null>(null);
 
 // 初始化SDK配置
 function initializeSDKConfig(): ZEEAvatarSDK | null {
@@ -316,12 +324,15 @@ function initializeSDKConfig(): ZEEAvatarSDK | null {
     // 播报回调
     broadcastCallbacks: {
       onStart: () => {
+        sdkStatus.isStartBroadcast = true;
         addLog('播报开始', 'info');
       },
       onFinish: () => {
+        sdkStatus.isStartBroadcast = false;
         addLog('播报完成', 'success');
       },
       onError: (error:any) => {
+        sdkStatus.isStartBroadcast = false;
         addLog(`播报失败: ${error.message}`, 'error');
       },
       onPause: () => {
@@ -331,7 +342,8 @@ function initializeSDKConfig(): ZEEAvatarSDK | null {
         addLog('播报恢复', 'success');
       },
       onStop: () => {
-        addLog('播报停止', 'error');
+        sdkStatus.isStartBroadcast = false;
+        addLog('播报停止', 'warning');
       },
     }
   };
@@ -342,9 +354,8 @@ function initializeSDKConfig(): ZEEAvatarSDK | null {
 
 // 从本地存储加载配置
 function loadStoredConfig(): void {
-  const config = localStorage.getItem('zee_config');
-  if (config) {
-    const configObj = JSON.parse(config);
+  const configObj = loadFromCache('global-config');
+  if (configObj) {
     Object.assign(globalConfig, configObj);
   }
 }
@@ -352,7 +363,7 @@ function loadStoredConfig(): void {
 // 保存全局配置
 function handleSaveConfig(): void {
 
-  localStorage.setItem('zee_config', JSON.stringify(globalConfig));
+  saveToCache('global-config', globalConfig);
 
   addLog('全局配置已保存', 'success');
   ElMessage.success('配置保存成功');
@@ -452,7 +463,6 @@ async function handleTextBroadcast(params: {
   voiceCode?: string;
   speed?: number;
   broadcastMotionString?: string;
-  isAppend?: boolean;
 }): Promise<void> {
   if (!sdk.value) return;
 
@@ -471,7 +481,8 @@ async function handleTextBroadcast(params: {
       motionPlayMode: 'random'
     };
 
-    await sdk.value.startBroadcast(broadcastParams, params.isAppend);
+    console.warn('handleTextBroadcast: ', broadcastParams, sdkStatus.isStartBroadcast);
+    await sdk.value.startBroadcast(broadcastParams, sdkStatus.isStartBroadcast);
     addLog('文本播报已开始', 'success');
     // ElMessage.success('文本播报已开始');
   } catch (error) {
@@ -508,7 +519,7 @@ async function handleAudioBroadcast(params: {
       motionPlayMode: 'random'
     };
 
-    await sdk.value.startBroadcast(broadcastParams, params.isAppend);
+    await sdk.value.startBroadcast(broadcastParams, sdkStatus.isStartBroadcast);
     addLog('音频播报已开始', 'success');
     ElMessage.success('音频播报已开始');
   } catch (error) {
@@ -585,6 +596,14 @@ async function handleStopBroadcast(): Promise<void> {
   }
 }
 
+function handleGetBroadcastStatus() {
+  if (!sdk.value) return;
+  const status = sdk.value.getBroadcastStatus();
+  addLog(`播报状态: ${JSON.stringify(status)}`, 'success');
+  console.warn('AAAAAAAAA播报状态: ', status);
+  ElMessage.success(`播报状态: ${JSON.stringify(status)}`);
+}
+
 // 设置预设镜头
 async function handleSetCameraPreset(params: { preset: string }): Promise<void> {
   if (!sdk.value) return;
@@ -645,6 +664,7 @@ async function handleUnloadAvatar(): Promise<void> {
       sdkStatus.canGetMotion = false;
       sdkStatus.canControlBroadcast = false;
       sdkStatus.canControlCamera = false;
+      sdkStatus.isStartBroadcast = false; // 重置播报状态
       loadingProgress.value = 0;
 
       ElMessage.success('Avatar已卸载');
@@ -668,9 +688,6 @@ function handleDestroySDK(){
       sdk.value = null;
     }
 
-    addLog('SDK 实例已销毁', 'warning');
-    ElMessage.warning('SDK 实例已销毁');
-
     // 重置状态
     sdkStatus.unityLoaded = false;
     sdkStatus.avatarLoaded = false;
@@ -679,8 +696,13 @@ function handleDestroySDK(){
     sdkStatus.canGetMotion = false;
     sdkStatus.canControlBroadcast = false;
     sdkStatus.canControlCamera = false;
+    sdkStatus.isStartBroadcast = false; // 重置播报状态
     loadingProgress.value = 0;
 
+
+    addLog('SDK 实例已销毁', 'warning');
+    ElMessage.warning('SDK 实例已销毁');
+
   } catch (error) {
     const message = error instanceof Error ? error.message : String(error);
     addLog(`销毁失败: ${message}`, 'error');

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

@@ -74,11 +74,6 @@
                   prefix-icon="microphone"
                   :disabled="!sdkStatus.canBroadcast"
                 />
-                <div class="input-help">
-                  <span class="help-text">
-                    常用音色：woman008、man001、child001等
-                  </span>
-                </div>
               </el-form-item>
 
               <el-form-item label="音量" required>
@@ -118,14 +113,19 @@
                 <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>
+                  <el-button
+                    type="info"
+                    size="default"
+                    style="width: 170px;"
+                    @click="handleGetBroadcastStatus">
+                        获取播报状态
+                   </el-button>
                 </div>
               </el-form-item>
             </el-form>
@@ -194,7 +194,13 @@
                   >
                     {{ isAudioLoading ? '播报中...' : '执行音频播报' }}
                   </el-button>
-                  <el-button @click="handleResetBroadcast">重置</el-button>
+                  <el-button
+                    type="info"
+                    size="default"
+                    style="width: 170px;"
+                    @click="handleGetBroadcastStatus">
+                        获取播报状态
+                   </el-button>
                 </div>
               </el-form-item>
             </el-form>
@@ -241,6 +247,7 @@
               >
                 {{ stopLoading ? '停止中...' : '停止' }}
               </el-button>
+
             </div>
           </div>
 
@@ -288,9 +295,10 @@
 </template>
 
 <script setup lang="ts">
-import { ref, reactive } from 'vue';
+import { ref, reactive, watch, onMounted } from 'vue';
 import { ElMessage } from 'element-plus';
-import { VideoPause, VideoPlay, Close } from '@element-plus/icons-vue';
+import { VideoPause, VideoPlay, Close, Refresh } from '@element-plus/icons-vue';
+import { loadFromCache, saveToCache } from '@/utils';
 
 interface ISDKStatus {
   canBroadcast: boolean;
@@ -310,31 +318,76 @@ const emit = defineEmits<{
   (e: 'pause-broadcast'): void;
   (e: 'resume-broadcast'): void;
   (e: 'stop-broadcast'): void;
+  (e: 'get-broadcast-status'): void;
 }>();
 
-const broadcastMode = ref<'text' | 'audio'>('text');
-const textFormData = reactive({
+// 本地缓存键名常量
+const BROADCAST_MODE_CACHE_KEY = 'broadcast-mode';
+const TEXT_FORM_CACHE_KEY = 'broadcast-text-form-data';
+const AUDIO_FORM_CACHE_KEY = 'broadcast-audio-form-data';
+
+
+// 初始化表单数据，优先从缓存加载
+const broadcastMode = ref<'text' | 'audio'>(loadFromCache(BROADCAST_MODE_CACHE_KEY, 'text')!);
+
+const textFormData = reactive(loadFromCache(TEXT_FORM_CACHE_KEY, {
   text: '欢迎使用ZEEAvatarSDK智能体播报功能。这是一个强大的数字人解决方案，支持文本和音频两种播报模式，让您的应用更具互动性！',
   volume: 1.0,
   speed: 1.0,
-  voiceCode: 'VOICE_INT_W_000002',
+  voiceCode: 'VOICE_EXT_W_000011',
   broadcastMotionString: 'DH_ACTION_MODEL103_000003,DH_ACTION_MODEL103_000005',
-});
-const audioFormData = reactive({
+})!);
+
+const audioFormData = reactive(loadFromCache(AUDIO_FORM_CACHE_KEY, {
   audioText: '欢迎使用ZEEAvatarSDK智能体播报功能',
   audioUrl: 'https://example.com/audio/sample.mp3',
   volume: 1.0,
   broadcastMotionString: 'DH_ACTION_MODEL103_000023,DH_ACTION_MODEL103_000010',
-});
+})!);
+
 const result = ref(
-  '等待播报操作...\n\n新版SDK特性：\n- 支持流式播报，实时响应\n- 内置事件回调机制\n- token统一管理，无需重复传递\n- 支持音量和语速控制\n- 实时播报控制（暂停/恢复/停止）'
+  '等待播报操作...\n\n新版SDK特性：\n- 支持流式播报，实时响应\n- 内置事件回调机制\n- token统一管理，无需重复传递\n- 支持音量和语速控制\n- 实时播报控制（暂停/恢复/停止）\n\n💾 表单数据已启用自动缓存功能'
 );
 const isTextLoading = ref(false);
 const isAudioLoading = ref(false);
 const pauseLoading = ref(false);
 const resumeLoading = ref(false);
 const stopLoading = ref(false);
-const isStartBroadcast = ref(false);
+
+// 监听表单数据变化，自动保存到本地缓存
+watch(
+  broadcastMode,
+  (newMode) => {
+    saveToCache(BROADCAST_MODE_CACHE_KEY, newMode);
+  }
+);
+
+watch(
+  textFormData,
+  (newData) => {
+    saveToCache(TEXT_FORM_CACHE_KEY, newData);
+  },
+  { deep: true }
+);
+
+watch(
+  audioFormData,
+  (newData) => {
+    saveToCache(AUDIO_FORM_CACHE_KEY, newData);
+  },
+  { deep: true }
+);
+
+// 组件挂载时的初始化操作
+onMounted(() => {
+  console.log('BroadcastAPI: 已从本地缓存加载表单数据', {
+    broadcastMode: broadcastMode.value,
+    textFormData: textFormData,
+    audioFormData: audioFormData
+  });
+});
+
+
 
 async function handleTextBroadcast() {
   const { text, volume, speed, voiceCode, broadcastMotionString } = textFormData;
@@ -352,8 +405,7 @@ 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, isAppend: isStartBroadcast.value });
-    isStartBroadcast.value = true;
+    emit('text-broadcast', { avatarCode, text, volume, speed, voiceCode, broadcastMotionString });
     setTimeout(() => {
       isTextLoading.value = false;
       result.value = '✅ 文本播报请求已发送\n📋 请查看右侧日志面板获取详细信息\n\n📝 操作说明：\n- 播报将以流式方式进行\n- 可使用下方控制按钮暂停/继续/停止\n- 播报过程中会触发相应的事件回调';
@@ -381,8 +433,7 @@ 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, isAppend: isStartBroadcast.value });
-    isStartBroadcast.value = true;
+    emit('audio-broadcast', { avatarCode, audioText, audioUrl, volume, broadcastMotionString });
     setTimeout(() => {
       isAudioLoading.value = false;
       result.value = '✅ 音频播报请求已发送\n📋 请查看右侧日志面板获取详细信息\n\n📝 操作说明：\n- 音频将直接驱动数字人口型\n- 支持MP3、WAV等格式\n- 可使用下方控制按钮进行控制';
@@ -425,7 +476,6 @@ function handleResumeBroadcast() {
 }
 
 function handleStopBroadcast() {
-  handleResetBroadcast();
   stopLoading.value = true;
   result.value = '🔄 正在停止播报...\n📡 发送停止指令到Unity引擎...\n🧹 清理播报资源和队列...';
   try {
@@ -440,13 +490,15 @@ function handleStopBroadcast() {
   }
 }
 
-function handleResetBroadcast() {
-  isStartBroadcast.value = false;
+function handleGetBroadcastStatus() {
+  emit('get-broadcast-status');
 }
 
+
 function clearResult() {
-  result.value = '等待播报操作...\n\n新版SDK特性：\n- 支持流式播报，实时响应\n- 内置事件回调机制\n- token统一管理，无需重复传递\n- 支持音量和语速控制\n- 实时播报控制（暂停/恢复/停止）';
+  result.value = '等待播报操作...\n\n新版SDK特性：\n- 支持流式播报，实时响应\n- 内置事件回调机制\n- token统一管理，无需重复传递\n- 支持音量和语速控制\n- 实时播报控制（暂停/恢复/停止）\n\n💾 表单数据已启用自动缓存功能';
 }
+
 </script>
 
 <style lang="scss" scoped>

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

@@ -84,6 +84,7 @@
             <el-button
             type="primary"
             size="default"
+            style="height: 40px;"
             @click="saveConfig"
             :disabled="!modelValue.token || !modelValue.avatarCode"
             >

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

@@ -73,9 +73,9 @@ watch(
   () => props.logs,
   async () => {
     await nextTick();
-    if (logContainer.value) {
-      logContainer.value.scrollTop = logContainer.value.scrollHeight;
-    }
+    scrollToBottom();
+  },{
+    deep: true,
   }
 );
 
@@ -133,14 +133,14 @@ function getTypeLabel(type: ILogEntry['type']) {
 <style lang="scss" scoped>
 .log-panel {
   height: 100%;
-  max-height: 650px;
+  max-height: calc(100vh - 80px);
   display: flex;
   flex-direction: column;
   .log-container {
     height: 100%;
     display: flex;
     flex-direction: column;
-    overflow: auto;
+    overflow: hidden;
     .log-list {
       flex: 1;
       overflow-y: auto;

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

@@ -160,8 +160,9 @@
 </template>
 
 <script setup lang="ts">
-import { ref, reactive } from 'vue';
+import { ref, reactive, watch, onMounted } from 'vue';
 import { ElMessage } from 'element-plus';
+import { loadFromCache, saveToCache } from '@/utils';
 
 interface ISDKStatus {
   canPlayMotion: boolean;
@@ -180,18 +181,53 @@ const emit = defineEmits<{
   (e: 'get-current-motion', params: { getRemainingTime: boolean }): void;
 }>();
 
-const motionData = reactive({
+// 本地缓存键名常量
+const MOTION_CACHE_KEY = 'motion-data';
+const QUERY_CACHE_KEY = 'query-data';
+
+
+// 初始化表单数据，优先从缓存加载
+const motionData = reactive(loadFromCache(MOTION_CACHE_KEY, {
   clipCode: 'DH_ACTION_MODEL103_000023',
-}); 
-const queryData = reactive({
+})!); 
+
+const queryData = reactive(loadFromCache(QUERY_CACHE_KEY, {
   getRemainingTime: true,
-});
+})!);
+
 const result = ref(
-  '等待动作操作...\n\n📋 功能说明：\n- 播放动作：输入动作编码来播放指定动作\n- 查询动作：获取当前正在播放的动作信息\n- 剩余时间：可选择查询动作剩余播放时间\n\n'
+  '等待动作操作...\n\n📋 功能说明：\n- 播放动作：输入动作编码来播放指定动作\n- 查询动作：获取当前正在播放的动作信息\n- 剩余时间：可选择查询动作剩余播放时间\n\n💾 表单数据已启用自动缓存功能'
 );
 const playLoading = ref(false);
 const queryLoading = ref(false);
 
+
+// 监听表单数据变化，自动保存到本地缓存
+watch(
+  motionData,
+  (newData) => {
+    saveToCache(MOTION_CACHE_KEY, newData);
+  },
+  { deep: true }
+);
+
+watch(
+  queryData,
+  (newData) => {
+    saveToCache(QUERY_CACHE_KEY, newData);
+  },
+  { deep: true }
+);
+
+// 组件挂载时的初始化操作
+onMounted(() => {
+  console.log('MotionControlAPI: 已从本地缓存加载表单数据', {
+    motionData: motionData,
+    queryData: queryData
+  });
+});
+
+
 async function handlePlayMotion() {
   const { avatarCode } = props.globalConfig;
   const { clipCode } = motionData;
@@ -241,8 +277,9 @@ async function handleGetCurrentMotion() {
 }
 
 function clearResult() {
-  result.value = '等待动作操作...\n\n📋 功能说明：\n- 播放动作：输入动作编码来播放指定动作\n- 查询动作：获取当前正在播放的动作信息\n- 剩余时间：可选择查询动作剩余播放时间\n\n🎭 ';
+  result.value = '等待动作操作...\n\n📋 功能说明：\n- 播放动作：输入动作编码来播放指定动作\n- 查询动作：获取当前正在播放的动作信息\n- 剩余时间：可选择查询动作剩余播放时间\n\n💾 表单数据已启用自动缓存功能';
 }
+
 </script>
 
 <style lang="scss" scoped>

package/dist/examples/test-vue3/src/utils/index.ts

@@ -0,0 +1,35 @@
+/**
+ * 缓存键名前缀
+ */
+export const CACHE_KEY_PREFIX = '3d-avatar-sdk__';
+
+/**
+ * 从本地缓存加载数据
+ * @param key 缓存键名
+ * @param defaultValue 默认值
+ * @returns 缓存的数据或默认值
+ */
+export function loadFromCache<T>(key: string, defaultValue?: T): T | undefined {
+    try {
+        const cached = localStorage.getItem(CACHE_KEY_PREFIX + key);
+        if (cached) {
+            return JSON.parse(cached);
+        }
+    } catch (error) {
+        console.warn(`加载缓存失败 [${key}]:`, error);
+    }
+    return defaultValue;
+}
+
+/**
+ * 保存数据到本地缓存
+ * @param key 缓存键名
+ * @param data 要保存的数据
+ */
+export function saveToCache<T>(key: string, data: T): void {
+    try {
+        localStorage.setItem(CACHE_KEY_PREFIX + key, JSON.stringify(data));
+    } catch (error) {
+        console.warn(`保存缓存失败 [${key}]:`, error);
+    }
+}