@spatialwalk/avatarkit 1.0.0-beta.30 → 1.0.0-beta.32

package/CHANGELOG.md

@@ -5,6 +5,16 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.0.0-beta.32] - 2025-12-16
+
+### 🔄 Breaking Changes
+- **Host Mode Interface** - Updated `yieldFramesData` method to accept binary data array instead of single binary data. The method now processes multiple protobuf-encoded Message objects in a single call.
+
+## [1.0.0-beta.31] - 2025-12-16
+
+### 🐛 Bugfix
+- **Environment CORS Issue** - Fixed CORS issues when requesting configuration and character data APIs. SDK now provides default configuration fallback when config requests fail, ensuring smooth operation across different environments.
+
 ## [1.0.0-beta.30] - 2025-12-15
 
 ### 🐛 Bugfix

package/README.md

@@ -87,7 +87,7 @@ const avatarView = new AvatarView(avatar, container)
 // 4. Host Mode Workflow:
 // Send audio data first to get conversationId, then use it to send animation data
 const conversationId = avatarView.avatarController.yieldAudioData(audioData, false)
-avatarView.avatarController.yieldFramesData(animationData, conversationId)
+avatarView.avatarController.yieldFramesData(animationDataArray, conversationId) // animationDataArray: (Uint8Array | ArrayBuffer)[]
 ```
 
 ### Complete Examples
@@ -177,7 +177,7 @@ External data source (audio + animation)
     ↓
 AvatarController.yieldAudioData(audioChunk) // Returns conversationId
     ↓
-AvatarController.yieldFramesData(keyframes, conversationId)
+AvatarController.yieldFramesData(keyframesDataArray, conversationId) // keyframesDataArray: (Uint8Array | ArrayBuffer)[] - each element is a protobuf encoded Message
     ↓
 AvatarController → AnimationPlayer (synchronized playback)
     ↓
@@ -272,11 +272,11 @@ constructor(avatar: Avatar, container: HTMLElement)
 ```
 
 **Parameters:**
-- `avatar`: Avatar 实例
-- `container`: Canvas 容器元素（必选）
-  - Canvas 自动使用容器的完整尺寸（宽度和高度）
-  - Canvas 宽高比适应容器尺寸 - 设置容器尺寸以控制宽高比
-  - Canvas 会自动添加到容器中
+- `avatar`: Avatar instance
+- `container`: Canvas container element (required)
+  - Canvas automatically uses the full size of the container (width and height)
+  - Canvas aspect ratio adapts to container size - set container size to control aspect ratio
+  - Canvas will be automatically added to the container
   - SDK automatically handles resize events via ResizeObserver
 
 **Playback Mode:**
@@ -348,8 +348,8 @@ const conversationId = avatarView.avatarController.yieldAudioData(
 
 // Stream animation keyframes (requires conversationId from audio data)
 avatarView.avatarController.yieldFramesData(
-  keyframes: any[],                // Animation keyframes (obtained from your service)
-  conversationId: string          // Conversation ID (required)
+  keyframesDataArray: (Uint8Array | ArrayBuffer)[],  // Animation keyframes binary data array (each element is a protobuf encoded Message)
+  conversationId: string                              // Conversation ID (required)
 )
 ```
 
@@ -472,18 +472,18 @@ enum ConnectionState {
 
 ```typescript
 enum ConversationState {
-  idle = 'idle',      // 呼吸态
-  playing = 'playing' // 播放态
+  idle = 'idle',      // Idle state (breathing animation)
+  playing = 'playing' // Playing state (active conversation)
 }
 ```
 
-**状态说明：**
-- `idle`: 数字人处于呼吸态，等待对话开始
-- `playing`: 数字人正在播放对话内容（包括过渡动画期间）
+**State Description:**
+- `idle`: Avatar is in idle state (breathing animation), waiting for conversation to start
+- `playing`: Avatar is playing conversation content (including during transition animations)
 
-**注意：** 过渡动画期间会提前通知目标状态：
-- 从 `idle` 过渡到 `playing` 时，立即通知 `playing` 状态
-- 从 `playing` 过渡到 `idle` 时，立即通知 `idle` 状态
+**Note:** During transition animations, the target state is notified immediately:
+- When transitioning from `idle` to `playing`, the `playing` state is notified immediately
+- When transitioning from `playing` to `idle`, the `idle` state is notified immediately
 
 ## 🎨 Rendering System
 
@@ -552,7 +552,7 @@ const avatarView = new AvatarView(avatar, container)
 
 // Use
 const conversationId = avatarView.avatarController.yieldAudioData(audioChunk, false)
-avatarView.avatarController.yieldFramesData(keyframes, conversationId)
+avatarView.avatarController.yieldFramesData(keyframesDataArray, conversationId) // keyframesDataArray: (Uint8Array | ArrayBuffer)[]
 
 // Cleanup
 avatarView.avatarController.clear() // Clear all data and resources

package/dist/{StreamingAudioPlayer-CVqWInxw.js → StreamingAudioPlayer-TiKq7LEP.js}

@@ -1,7 +1,7 @@
 var __defProp = Object.defineProperty;
 var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
 var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
-import { A as APP_CONFIG, e as errorToMessage, l as logEvent, a as logger } from "./index-FJY_63Bh.js";
+import { A as APP_CONFIG, e as errorToMessage, l as logEvent, a as logger } from "./index-CFQb9r1N.js";
 class StreamingAudioPlayer {
   constructor(options) {
     __publicField(this, "audioContext", null);

package/dist/core/AvatarController.d.ts

@@ -39,7 +39,7 @@ export declare class AvatarController {
     send(audioData: ArrayBuffer, end?: boolean): string | null;
     close(): void;
     yieldAudioData(data: Uint8Array, isLast?: boolean): string | null;
-    yieldFramesData(keyframes: Flame[], conversationId: string): void;
+    yieldFramesData(keyframesDataArray: (Uint8Array | ArrayBuffer)[], conversationId: string): void;
     pause(): void;
     resume(): Promise<void>;
     interrupt(): void;