@spatialwalk/avatarkit 1.0.0-beta.25 → 1.0.0-beta.27

package/CHANGELOG.md

@@ -5,6 +5,33 @@ 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.27] - 2025-12-04
+
+### 🐛 Bugfix
+
+## [1.0.0-beta.26] - 2025-12-03
+
+### ✨ New Features
+- **Log Level Configuration** - Added `logLevel` configuration option to control SDK logging verbosity
+  - `LogLevel.off` - Disable all logs
+  - `LogLevel.error` - Only error logs
+  - `LogLevel.warning` - Warning and error logs
+  - `LogLevel.all` - All logs (default)
+- **Standardized CLS Logging Events** - All CLS logging events now use standardized field names for better querying
+  - Standard events: `sdk_initialized`, `send_audio_failed`, `message_error`, `heartbeat_failed`, `service_restarted`, `session_token_invalid`, `session_token_expired`, `yield_animation_failed`, `fetch_avatar_metadata_failed`, `download_avatar_assets_failed`
+  - Standard fields: `req_id`, `con_id`, `avatar_id`, `description`
+- **End-to-End Latency Tracking** - Added `driving_latency` event to track latency metrics for both SDK and Host modes
+  - Tracks: `start`, `tap2`, `tap4`, `end`, `first_frame` timestamps
+  - Automatically reported at key moments during audio/animation processing
+
+### 🔧 Improvements
+- **CLS Configuration Alignment** - Updated CLS endpoints and Topic IDs to match iOS SDK configuration
+- **Default API Endpoints** - Fixed default API endpoint for `intl` environment to `api.intl.spatialwalk.cloud`
+- **Error Code Enum** - Added new error codes: `appIDUnrecognized`, `sessionTokenInvalid`, `sessionTokenExpired`, `failedToFetchAvatarMetadata`, `failedToDownloadAvatarAssets`
+
+### 🗑️ Removed
+- **Redundant Log Events** - Removed unnecessary log events: `playback_paused`, `playback_resumed`, `reconnecting`, `connect_success`, `server_error`, `decode_failed`
+
 ## [1.0.0-beta.25] - 2025-12-03
 
 ### 🔧 Improvements

package/README.md

@@ -29,7 +29,8 @@ import {
   AvatarView,
   Configuration,
   Environment,
-  DrivingServiceMode
+  DrivingServiceMode,
+  LogLevel
 } from '@spatialwalk/avatarkit'
 
 // 1. Initialize SDK
@@ -39,6 +40,11 @@ const configuration: Configuration = {
   drivingServiceMode: DrivingServiceMode.sdk, // Optional, 'sdk' is default
   // - DrivingServiceMode.sdk: SDK mode - SDK handles WebSocket communication
   // - DrivingServiceMode.host: Host mode - Host app provides audio and animation data
+  logLevel: LogLevel.all, // Optional, 'all' is default
+  // - LogLevel.off: Disable all logs
+  // - LogLevel.error: Only error logs
+  // - LogLevel.warning: Warning and error logs
+  // - LogLevel.all: All logs (info, warning, error)
 }
 
 await AvatarKit.initialize('your-app-id', configuration)
@@ -362,11 +368,6 @@ avatarView.avatarController.yieldFramesData(
 #### Common Methods (Both Modes)
 
 ```typescript
-// Pause playback (can be resumed later)
-avatarView.avatarController.pause()
-
-// Resume playback (from paused state)
-await avatarView.avatarController.resume()
 
 // Interrupt current playback (stops and clears data)
 avatarView.avatarController.interrupt()
@@ -402,14 +403,35 @@ avatarView.avatarController.onError = (error: Error) => {}
 interface Configuration {
   environment: Environment
   drivingServiceMode?: DrivingServiceMode  // Optional, default is 'sdk' (SDK mode)
+  logLevel?: LogLevel  // Optional, default is 'all' (all logs)
+}
+```
+
+### LogLevel
+
+Control the verbosity of SDK logs:
+
+```typescript
+enum LogLevel {
+  off = 'off',        // Disable all logs
+  error = 'error',    // Only error logs
+  warning = 'warning', // Warning and error logs
+  all = 'all'         // All logs (info, warning, error) - default
 }
 ```
 
+**Note:** `LogLevel.off` completely disables all logging, including error logs. Use with caution in production environments.
+
 **Description:**
 - `environment`: Specifies the environment (cn/intl/test), SDK will automatically use the corresponding API address and WebSocket address based on the environment
 - `drivingServiceMode`: Specifies the driving service mode
   - `DrivingServiceMode.sdk` (default): SDK mode - SDK handles WebSocket communication automatically
   - `DrivingServiceMode.host`: Host mode - Host application provides audio and animation data
+- `logLevel`: Controls the verbosity of SDK logs
+  - `LogLevel.off`: Disable all logs
+  - `LogLevel.error`: Only error logs
+  - `LogLevel.warning`: Warning and error logs
+  - `LogLevel.all` (default): All logs (info, warning, error)
 - `sessionToken`: Set separately via `AvatarKit.setSessionToken()`, not in Configuration
 
 ```typescript

package/dist/{StreamingAudioPlayer-BWRB8VI8.js → StreamingAudioPlayer-C6v9Ed55.js}

@@ -1,7 +1,7 @@
 var C = Object.defineProperty;
 var g = (h, t, e) => t in h ? C(h, t, { enumerable: !0, configurable: !0, writable: !0, value: e }) : h[t] = e;
 var s = (h, t, e) => g(h, typeof t != "symbol" ? t + "" : t, e);
-import { A as m, e as f, l as c, a as n } from "./index-Bebn1P_5.js";
+import { A as m, e as f, l as c, a as n } from "./index-s9KqPWVW.js";
 class y {
   constructor(t) {
     // AudioContext is managed internally
@@ -350,4 +350,3 @@ class y {
 export {
   y as StreamingAudioPlayer
 };
-//# sourceMappingURL=StreamingAudioPlayer-BWRB8VI8.js.map

package/dist/animation/AnimationWebSocketClient.d.ts

@@ -50,4 +50,3 @@ export declare class AnimationWebSocketClient extends EventEmitter {
     private handleMessage;
     private scheduleReconnect;
 }
-//# sourceMappingURL=AnimationWebSocketClient.d.ts.map

package/dist/animation/utils/eventEmitter.d.ts

@@ -10,4 +10,3 @@ export declare class EventEmitter {
     removeAllListeners(event?: string): void;
 }
 export {};
-//# sourceMappingURL=eventEmitter.d.ts.map

package/dist/animation/utils/flameConverter.d.ts

@@ -23,4 +23,3 @@ export declare function convertWasmParamsToProtoFlame(wasmParams: FlameParams):
  * Create a neutral proto Flame (zero pose)
  */
 export declare function createNeutralFlameProto(): Flame;
-//# sourceMappingURL=flameConverter.d.ts.map

package/dist/audio/AnimationPlayer.d.ts

@@ -73,4 +73,3 @@ export declare class AnimationPlayer {
     getVolume(): number;
     dispose(): void;
 }
-//# sourceMappingURL=AnimationPlayer.d.ts.map

package/dist/audio/StreamingAudioPlayer.d.ts

@@ -134,4 +134,3 @@ export declare class StreamingAudioPlayer {
      */
     private log;
 }
-//# sourceMappingURL=StreamingAudioPlayer.d.ts.map

package/dist/avatar_core_wasm-BPIbbUx_.js

@@ -1661,4 +1661,3 @@ async function XI(Z = {}) {
 export {
   XI as default
 };
-//# sourceMappingURL=avatar_core_wasm-BPIbbUx_.js.map

package/dist/config/app-config.d.ts

@@ -41,4 +41,3 @@ export declare const APP_CONFIG: {
         enablePerformanceMetrics: boolean;
     };
 };
-//# sourceMappingURL=app-config.d.ts.map

package/dist/config/constants.d.ts

@@ -26,4 +26,3 @@ export declare const ENV_TEST: boolean;
  * - URL has debug=1 parameter
  */
 export declare function isDebugMode(): boolean;
-//# sourceMappingURL=constants.d.ts.map

package/dist/config/sdk-config-loader.d.ts

@@ -9,4 +9,3 @@ export declare function fetchSdkConfig(version: string): Promise<Partial<Record<
  * 清除配置缓存（用于测试或重新加载）
  */
 export declare function clearSdkConfigCache(): void;
-//# sourceMappingURL=sdk-config-loader.d.ts.map

package/dist/core/Avatar.d.ts

@@ -12,4 +12,3 @@ export declare class Avatar {
      */
     constructor(id: string, characterMeta: CharacterMeta, resources: PreloadResult);
 }
-//# sourceMappingURL=Avatar.d.ts.map

package/dist/core/AvatarController.d.ts

@@ -29,6 +29,8 @@ export declare class AvatarController {
     private readonly MAX_KEYFRAMES;
     private readonly KEYFRAMES_CLEANUP_THRESHOLD;
     private isAudioOnlyMode;
+    private hostModeMetrics;
+    private readonly audioBytesPerSecond;
     constructor(avatar: Avatar, options?: {
         playbackMode?: DrivingServiceMode;
     });
@@ -166,5 +168,9 @@ export declare class AvatarController {
      * Emit event
      */
     protected emit(event: string, data?: any): void;
+    /**
+     * 上报 driving_latency 事件（Host 模式）
+     * @private
+     */
+    private reportDrivingLatency;
 }
-//# sourceMappingURL=AvatarController.d.ts.map

package/dist/core/AvatarDownloader.d.ts

@@ -78,4 +78,3 @@ export declare class AvatarDownloader {
     getCharacterById(characterId: string): Promise<CharacterMeta>;
 }
 export {};
-//# sourceMappingURL=AvatarDownloader.d.ts.map

package/dist/core/AvatarKit.d.ts

@@ -46,4 +46,3 @@ export declare class AvatarKit {
      */
     private static _fetchSdkConfig;
 }
-//# sourceMappingURL=AvatarKit.d.ts.map

package/dist/core/AvatarManager.d.ts

@@ -20,4 +20,3 @@ export declare class AvatarManager {
      */
     clearCache(): void;
 }
-//# sourceMappingURL=AvatarManager.d.ts.map

package/dist/core/AvatarView.d.ts

@@ -161,4 +161,3 @@ export declare class AvatarView {
      */
     private handleResize;
 }
-//# sourceMappingURL=AvatarView.d.ts.map

package/dist/core/NetworkLayer.d.ts

@@ -5,4 +5,3 @@
  * @internal Not part of public API
  */
 export {};
-//# sourceMappingURL=NetworkLayer.d.ts.map

package/dist/generated/driveningress/v1/driveningress.d.ts

@@ -77,4 +77,3 @@ export interface MessageFns<T> {
     fromPartial<I extends Exact<DeepPartial<T>, I>>(object: I): T;
 }
 export {};
-//# sourceMappingURL=driveningress.d.ts.map

package/dist/generated/driveningress/v2/driveningress.d.ts

@@ -78,4 +78,3 @@ export interface MessageFns<T> {
     fromPartial<I extends Exact<DeepPartial<T>, I>>(object: I): T;
 }
 export {};
-//# sourceMappingURL=driveningress.d.ts.map

package/dist/generated/google/protobuf/struct.d.ts

@@ -105,4 +105,3 @@ export interface ListValueWrapperFns {
     unwrap(message: ListValue): Array<any>;
 }
 export {};
-//# sourceMappingURL=struct.d.ts.map

package/dist/generated/google/protobuf/timestamp.d.ts

@@ -126,4 +126,3 @@ export interface MessageFns<T> {
     fromPartial<I extends Exact<DeepPartial<T>, I>>(object: I): T;
 }
 export {};
-//# sourceMappingURL=timestamp.d.ts.map