@spatialwalk/avatarkit 1.0.0-beta.96 → 1.0.0-beta.97

package/CHANGELOG.md

@@ -5,6 +5,24 @@ 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.97]
+
+### ⚡ Breaking Changes
+
+- **`transform` renamed to `avatarTransform`** — `avatarView.transform` is now `avatarView.avatarTransform`. Aligned naming across Web, Android, and iOS SDKs.
+
+### ✨ Features
+
+- **Avatar transform from character settings** — Avatar automatically applies position and scale from character settings. User-set `avatarTransform` stacks on top of the base values.
+
+### 🐛 Bugfixes
+
+- **Rendering quality improvement** — Improved color accuracy for avatar rendering.
+
+### 📝 Documentation
+
+- **send() byte alignment** — Documented PCM S16LE byte alignment requirement for `send()`.
+
 ## [1.0.0-beta.96]
 
 ### 🐛 Bugfixes

package/README.md

@@ -282,7 +282,9 @@ button.addEventListener('click', async () => {
   })
 
   // 7. Send audio data (SDK mode, must be mono PCM16 format matching configured sample rate)
-  // audioData: ArrayBuffer or Uint8Array containing PCM16 audio samples
+  // audioData: ArrayBuffer or Uint8Array containing PCM16 (S16LE) audio samples
+  // ⚠️ Byte length MUST be even (2 bytes per sample). Odd-length data will cause server-side
+  //    validation error and WebSocket disconnect.
   // - PCM files: Can be directly read as ArrayBuffer
   // - WAV files: Extract PCM data from WAV format (may require resampling)
   // - MP3 files: Decode first (e.g., using AudioContext.decodeAudioData()), then convert to PCM16
@@ -590,10 +592,10 @@ avatarView.onFirstRendering = () => {
 
 // Get or set avatar transform (position and scale)
 // Get current transform
-const currentTransform = avatarView.transform // { x: number, y: number, scale: number }
+const currentTransform = avatarView.avatarTransform // { x: number, y: number, scale: number }
 
 // Set transform
-avatarView.transform = { x, y, scale }
+avatarView.avatarTransform = { 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)
@@ -728,16 +730,16 @@ avatarView.controller.onError = (error: AvatarError) => {} // Includes error.cod
 ```typescript
 // Get or set avatar transform (position and scale in canvas)
 // Get current transform
-const currentTransform = avatarView.transform // { x: number, y: number, scale: number }
+const currentTransform = avatarView.avatarTransform // { x: number, y: number, scale: number }
 
 // Set transform
-avatarView.transform = { x, y, scale }
+avatarView.avatarTransform = { 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.transform = { x: 0, y: 0, scale: 1.0 }  // Center, original size
-avatarView.transform = { x: 0.5, y: 0, scale: 2.0 } // Right half, double size
+avatarView.avatarTransform = { x: 0, y: 0, scale: 1.0 }  // Center, original size
+avatarView.avatarTransform = { x: 0.5, y: 0, scale: 2.0 } // Right half, double size
 ```
 
 **Important Notes:**

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@spatialwalk/avatarkit",
   "type": "module",
-  "version": "1.0.0-beta.96",
+  "version": "1.0.0-beta.97",
   "packageManager": "pnpm@10.18.2",
   "description": "AvatarKit SDK - 3D Gaussian Splatting Avatar Rendering SDK",
   "author": "AvatarKit Team",