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

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.34] - 2025-12-16
+
+### ✨ New Features
+- **Avatar Transform API** - Added `setTransform` method to `AvatarView` for controlling avatar position and scale within the canvas. Supports normalized coordinates (-1 to 1) for position and scale factor.
+
+## [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)
     ↓
@@ -292,6 +292,12 @@ const avatarView = new AvatarView(avatar, container)
 // Wait for first frame to render
 await avatarView.ready // Promise that resolves when the first frame is rendered
 
+// Set avatar transform (position and scale)
+avatarView.setTransform(x, y, scale)
+// - x: Horizontal offset in normalized coordinates (-1 to 1, where -1 = left edge, 0 = center, 1 = right edge)
+// - y: Vertical offset in normalized coordinates (-1 to 1, where -1 = bottom edge, 0 = center, 1 = top edge)
+// - scale: Scale factor (1.0 = original size, 2.0 = double size, 0.5 = half size)
+
 // Cleanup resources (must be called before switching characters)
 avatarView.dispose()
 ```
@@ -348,8 +354,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)
 )
 ```
 
@@ -389,6 +395,19 @@ avatarView.avatarController.onConversationState = (state: ConversationState) =>
 avatarView.avatarController.onError = (error: Error) => {}
 ```
 
+#### Avatar Transform Methods
+
+```typescript
+// Set avatar transform (position and scale in canvas)
+avatarView.setTransform(x, y, scale)
+// - x: Horizontal offset in normalized coordinates (-1 to 1, where -1 = left edge, 0 = center, 1 = right edge)
+// - y: Vertical offset in normalized coordinates (-1 to 1, where -1 = bottom edge, 0 = center, 1 = top edge)
+// - scale: Scale factor (1.0 = original size, 2.0 = double size, 0.5 = half size)
+// Example:
+avatarView.setTransform(0, 0, 1.0)  // Center, original size
+avatarView.setTransform(0.5, 0, 2.0) // Right half, double size
+```
+
 **Important Notes:**
 - `start()` and `close()` are only available in SDK mode
 - `yieldAudioData()` and `yieldFramesData()` are only available in Host mode
@@ -552,7 +571,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-D_anvcr1.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-D8QhzqfR.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;

package/dist/core/AvatarView.d.ts

@@ -61,4 +61,5 @@ export declare class AvatarView {
     get isOpaque(): boolean;
     set isOpaque(value: boolean);
     setBackgroundImage(image: HTMLImageElement | string | null): void;
+    setTransform(x: number, y: number, scale: number): void;
 }