> ## Documentation Index
> Fetch the complete documentation index at: https://spatialwalk-6179c111.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Changelog

**1.0.0-beta.80**

2025-01

**Next.js Plugin** - Added `withAvatarkit` wrapper for Next.js projects to automate WASM file configuration with webpack

* Patches Emscripten `scriptDirectory` for correct asset resolution
* Copies WASM files to `static/chunks/` automatically
* Adds `application/wasm` Content-Type headers
* Preserves existing webpack and headers configurations

**1.0.0-beta.75**

2025-01

**Local Log Upload** - Automatic local log upload for debugging and troubleshooting

**1.0.0-beta.71**

2024-12

**API Refinement** - Improved API structure by marking internal classes with `@internal` for better code organization

**Type Safety** - Enhanced type definitions by hiding internal implementation details from public API

**1.0.0-beta.64**

2024-12

**Vite Plugin** - Added `avatarkitVitePlugin` to automate WASM file configuration

* Automatically handles WASM MIME types in dev server
* Copies WASM files during build
* Generates `_headers` file for Cloudflare Pages

**1.0.0-beta.63**

2024-12

**Audio Context API** - Added `initializeAudioContext()` method that must be called in user gesture context

* Ensures AudioContext is created properly to satisfy browser security policies
* All audio operations now require prior initialization

**1.0.0-beta.55**

2024-11

**Eye Tracking Control** - Added `eyeTrackingEnabled` parameter to `PostProcessingConfig` for real-time control

**Point Count API** - Added `getPointCount()` method to `AvatarController` to get avatar point cloud count

**1.0.0-beta.51**

2024-11

**Post-Processing Enhancement** - Added `translation` and `eyePose` fields to `PostProcessingConfig`

**Bugfix** - Fixed avatar settings update issue when using cached avatars

**1.0.0-beta.45**

2024-10

**Immediate Rendering** - Post-processing and camera updates apply immediately when playback is paused

**API Change** - Replaced `ready` Promise with `onFirstRendering` callback for better async handling

**1.0.0-beta.36**

2024-10

**Audio Configuration** - Added configurable audio sample rate support (8000-48000 Hz, default: 16000)

* Audio recording and playback automatically use configured sample rate

**1.0.0-beta.35**

2024-10

**API Change** - Changed `setTransform()` method to `transform` getter/setter property

**1.0.0-beta.29**

2024-09

**Breaking Changes** - Removed `Environment.test`, changed default log level to `off`

**New Features** - Added avatar caching methods (`retrieve`, `clear`, `clearAll`)

**Background Image** - Added background image control in `AvatarView`

**1.0.0-beta.28**

2024-09

**Breaking Change** - Renamed `AvatarKit` to `AvatarSDK` for better consistency

* Update imports: `AvatarKit` → `AvatarSDK`

**1.0.0-beta.22**

2024-08

**API Changes** - Renamed `onAvatarState` to `onConversationState`, `Environment.us` to `Environment.intl`

**Volume Control** - Added `setVolume()` and `getVolume()` methods for audio playback control

**1.0.0-beta.17**

2024-08

**Fallback Mechanism** - Added automatic audio-only fallback when animation data is unavailable

**API Change** - Moved playback mode configuration to `AvatarSDK.initialize()`

**1.0.0-beta.3**

2024-07

**Architecture** - Refactored to three-layer architecture (Rendering, Playback, Network)

**Dual Mode** - Added SDK mode and Host mode support

**1.0.0-beta.97**

2026-04

**Breaking Change** — `avatarView.transform` renamed to `avatarView.avatarTransform` (cross-SDK alignment).

**Avatar transform from character settings** — Automatically applies position and scale from character settings.

**Rendering quality** — Improved color accuracy for avatar rendering.

**1.0.0-beta.28**

2026-04

**Rendering quality** — Improved color accuracy for avatar rendering.

**Avatar transform from character settings** — Automatically applies position and scale from character settings.

**WebSocket close codes** — Added handling for auth failure, insufficient balance, session timeout, concurrent limit.

**1.0.0-beta48**

2026-04

**Rendering quality** — Improved color accuracy for avatar rendering.

**Avatar transform from character settings** — Automatically applies position and scale from character settings.

**Device support expansion** — More devices supported through benchmark scoring instead of deny-list.

**WebSocket close codes** — Added handling for auth failure, insufficient balance, session timeout, concurrent limit.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.