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

package/CHANGELOG.md

@@ -5,6 +5,11 @@ 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

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)
     ↓
@@ -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)
 )
 ```
 
@@ -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-B07iPxK4.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-CCBBCJi2.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;