> ## Documentation Index
> Fetch the complete documentation index at: https://docs.spatialreal.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Changelog

> AvatarKit Android SDK version update history

## 1.0.0-beta48

### ✨ Features

* **Rendering quality improvement** — Improved color accuracy for avatar rendering.
* **Avatar transform from character settings** — Avatar automatically applies position and scale from character settings. User-set `avatarTransform` stacks on top of the base values.

## 1.0.0-beta47

### ✨ Features

* **Device support expansion** — Previously rejected devices now use benchmark scoring instead of being blocked outright, expanding supported device range.

## 1.0.0-beta46

### 🐛 Bugfixes

* **Render stability** — Fixed a crash on certain devices during view lifecycle transitions.

### ✨ Features

* **WebSocket close code handling** — Added handling for server custom close codes: auth failure, insufficient balance, session timeout, concurrent limit exceeded. Non-recoverable errors are now properly recognized.
* **HTTP error mapping improvement** — Non-mapped HTTP errors now return descriptive error information instead of being silently ignored.

## 1.0.0-beta45

### 🐛 Bugfixes

* **Android \< 12 device support fix** — Fixed a crash that prevented \~30% of devices (Android 11 and below) from completing device support detection.

## 1.0.0-beta44

### 🐛 Bugfixes

* **Pre-init crash fix** — `isDeviceSupported()` no longer crashes when called before `initialize()`.

### 🔧 Improvements

* **Telemetry event queue** — Events sent before SDK initialization are now queued and flushed after `initialize()`.

## 1.0.0-beta43

### ✨ Features

* **Host mode animation end signal** — `yield(animations, conversationId)` now returns a `Boolean` indicating whether the server has sent all animation data for the current conversation.

### 🐛 Bugfixes

* **Background task cleanup** — Fixed background tasks not being properly cancelled when app enters background.

## 1.0.0-beta42

### 🐛 Bugfixes

* **Release build fix** — Fixed crashes in release builds when code minification is enabled.

## 1.0.0-beta41

### 🐛 Bugfixes

* **Release build support** — Fixed crashes in consumer apps when code minification is enabled.

## 1.0.0-beta40

### 🐛 Bugfixes

* **Initialization stability** — Fixed a crash that could occur during SDK initialization on some devices.

## 1.0.0-beta39

### 🐛 Bugfixes

* **Huawei device rendering fix** — Fixed partial flickering on Huawei Mate 70 Pro and similar devices.
* **Close callback timing** — `close()` now triggers `Disconnected` callback synchronously, aligned with iOS/Web behavior.
* **Network reconnect stability** — Improved stability during rapid close/restart cycles.

### ✨ Features

* **Device support threshold** — Lowered benchmark threshold, expanding supported device range from 37% to 61%.

## 1.0.0-beta38

### 🐛 Bugfixes

* **Compressed model cache** — Fixed cache not differentiating between standard and compressed models.
* **Deprecated API removal** — Removed `supportsCurrentDevice()` and `benchmark()` in favor of `isDeviceSupported()` and `deviceScore()`.

## 1.0.0-beta37

### ⚡ Breaking Changes

* **FrameRateInfo** — Unified as pre-computed fields for cross-SDK consistency.

### ✨ Features

* **Frame rate monitor** — Enable/disable switch for frame rate monitoring.
* **Device benchmark** — `deviceScore` and `isDeviceSupported` APIs for runtime device capability assessment.
* **Compressed model (Beta)** — `load()` accepts optional `useCompressedModel` parameter for loading compressed models (\~30% smaller). Please verify rendering quality before using in production.

### 🐛 Bugfixes

* **Detach/attach rendering** — Fixed rendering failure when AvatarView is detached and re-attached to window hierarchy.
* **Duplicate initialize guard** — Prevented duplicate `initialize()` calls from causing unexpected state.
* **AppId validation** — Added `appId` validation on `initialize()` with guidance for obtaining credentials.