@spatialwalk/avatarkit 1.0.0-beta.102 → 1.0.0-beta.104

package/CHANGELOG.md

@@ -5,6 +5,18 @@ 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.104]
+
+### 🐛 Bugfixes
+
+- **Telemetry logging** — Fixed console error logs showing only generic event name with no diagnostic details. Each telemetry event now uses its own event name and includes all properties inline for easier debugging.
+
+## [1.0.0-beta.103]
+
+### 🔧 Internal
+
+- Optimize internal type exports
+
 ## [1.0.0-beta.102]
 
 ### 🐛 Bugfixes

package/dist/{StreamingAudioPlayer-tmb18x3O.js → StreamingAudioPlayer-CCmsLyxv.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, l as logger, e as errorToMessage, a as logEvent } from "./index-DNq7oTVY.js";
+import { A as APP_CONFIG, l as logger, e as errorToMessage, a as logEvent } from "./index-BFNu-mKX.js";
 class StreamingAudioPlayer {
   // Mark if AudioContext is being resumed, avoid concurrent resume requests
   constructor(options) {
@@ -143,9 +143,8 @@ class StreamingAudioPlayer {
         });
       } catch (err) {
         logger.errorWithError("[StreamingAudioPlayer] Failed to resume AudioContext:", err);
-        logEvent("character_player", "error", {
+        logEvent("audio_context_resume_failed", "error", {
           sessionId: this.sessionId,
-          event: "audio_context_resume_failed",
           reason: err instanceof Error ? err.message : String(err)
         });
       } finally {
@@ -281,9 +280,8 @@ class StreamingAudioPlayer {
     if (!audioBuffer) {
       const errorMessage = "Failed to create AudioBuffer from PCM data";
       logger.error(errorMessage);
-      logEvent("character_player", "error", {
-        sessionId: this.sessionId,
-        event: "audio_buffer_creation_failed"
+      logEvent("audio_buffer_creation_failed", "error", {
+        sessionId: this.sessionId
       });
       return;
     }
@@ -305,8 +303,7 @@ class StreamingAudioPlayer {
           const lastChunk = this.audioChunks[this.scheduledChunks - 1];
           if (lastChunk && !lastChunk.isLast) {
             this.log("All audio chunks ended but end=false, pausing and setting autoContinue");
-            logEvent("character_player", "warning", {
-              event: "audio_buffer_stall",
+            logEvent("audio_buffer_stall", "warning", {
               scheduled_chunks: this.scheduledChunks,
               audio_time: this.getCurrentTime()
             });
@@ -330,9 +327,8 @@ class StreamingAudioPlayer {
       });
     } catch (err) {
       logger.errorWithError("Failed to schedule audio chunk:", err);
-      logEvent("character_player", "error", {
+      logEvent("schedule_chunk_failed", "error", {
         sessionId: this.sessionId,
-        event: "schedule_chunk_failed",
         reason: err instanceof Error ? err.message : String(err)
       });
     }

package/dist/core/AvatarView.d.ts

@@ -1,4 +1,4 @@
-import { CameraConfig, KeyframeData } from '../types';
+import { CameraConfig } from '../types';
 import { Avatar } from './Avatar';
 import { AvatarController } from './AvatarController';
 export declare class AvatarView {
@@ -57,19 +57,6 @@ export declare class AvatarView {
      * 更新相机配置
      */
     updateCameraConfig(cameraConfig: CameraConfig): void;
-    /**
-     * Render specified keyframe (pure rendering mode, no audio-animation synchronization)
-     * Suitable for scenarios where external application controls audio playback and animation playback
-     * @param keyframeData - Keyframe data
-     * @param enableIdleRendering - Whether to enable idle loop rendering. true: Enable idle rendering and return immediately (skip this keyframe); false: Disable idle rendering and process keyframe (default)
-     */
-    renderFlame(keyframeData: KeyframeData, enableIdleRendering?: boolean): Promise<void>;
-    generateTransition(options: {
-        from?: KeyframeData;
-        to?: KeyframeData;
-        frameCount: number;
-        useLinear?: boolean;
-    }): Promise<KeyframeData[]>;
     /**
      * Render a single animation frame from raw protobuf data.
      *
@@ -107,6 +94,22 @@ export declare class AvatarView {
      * Start idle animation (stop pure rendering mode, resume idle loop).
      */
     startIdle(): void;
+    /**
+     * Generate transition frames from protobuf data.
+     *
+     * Decodes the protobuf, extracts the target keyframe, and generates
+     * transition frames from the current idle position to the target.
+     * The caller is responsible for playing the returned frames at the desired cadence.
+     *
+     * @param data - Raw protobuf bytes containing the target frame
+     * @param frameCount - Number of transition frames to generate
+     * @param options - Additional options
+     * @param options.useLinear - Use linear interpolation (default: true)
+     * @returns Array of opaque keyframe data for sequential playback
+     */
+    generateTransitionFromProtobuf(data: ArrayBuffer | Uint8Array, frameCount: number, options?: {
+        useLinear?: boolean;
+    }): Promise<unknown[]>;
     /**
      * Cancel any in-progress frame sequence playback.
      * Called by renderFromProtobuf when streaming frames arrive during transition.

package/dist/{index-DNq7oTVY.js → index-BFNu-mKX.js}

@@ -9415,7 +9415,8 @@ function logEvent(event, level = "info", contents = {}) {
     error: "error"
   };
   const logMethod = logLevels[level] ?? "log";
-  logger[logMethod](`[Telemetry] ${event}`, context);
+  const propsDescription = Object.entries(contents).map(([k2, v2]) => `${k2}=${v2}`).join(", ");
+  logger[logMethod](`[Telemetry] ${event} [${propsDescription}]`);
   trackEvent(event, level, context);
 }
 const _AnimationPlayer = class _AnimationPlayer {
@@ -9508,7 +9509,7 @@ const _AnimationPlayer = class _AnimationPlayer {
     if (this.streamingPlayer) {
       return;
     }
-    const { StreamingAudioPlayer } = await import("./StreamingAudioPlayer-tmb18x3O.js");
+    const { StreamingAudioPlayer } = await import("./StreamingAudioPlayer-CCmsLyxv.js");
     const { AvatarSDK: AvatarSDK2 } = await Promise.resolve().then(() => AvatarSDK$1);
     const audioFormat = AvatarSDK2.getAudioFormat();
     this.streamingPlayer = new StreamingAudioPlayer({
@@ -9521,8 +9522,7 @@ const _AnimationPlayer = class _AnimationPlayer {
     } catch (error) {
       const message = error instanceof Error ? error.message : String(error);
       logger.error("[AnimationPlayer] Failed to initialize streaming player:", message);
-      logEvent("character_player", "error", {
-        event: "streaming_player_initialize_failed",
+      logEvent("streaming_player_initialize_failed", "error", {
         reason: message
       });
       throw error;
@@ -11548,7 +11548,7 @@ class AvatarSDK {
 __publicField(AvatarSDK, "_initializationState", "uninitialized");
 __publicField(AvatarSDK, "_initializingPromise", null);
 __publicField(AvatarSDK, "_configuration", null);
-__publicField(AvatarSDK, "_version", "1.0.0-beta.102");
+__publicField(AvatarSDK, "_version", "1.0.0-beta.104");
 __publicField(AvatarSDK, "_avatarCore", null);
 __publicField(AvatarSDK, "_dynamicSdkConfig", null);
 __publicField(AvatarSDK, "_cachedDeviceScore", null);
@@ -13450,9 +13450,8 @@ class AvatarController {
       volume = Math.max(0, Math.min(1, volume));
     }
     (_a = this.animationPlayer) == null ? void 0 : _a.setVolume(volume);
-    logEvent("character_player", "info", {
+    logEvent("volume_changed", "info", {
       avatar_id: this.avatar.id,
-      event: "volume_changed",
       volume
     });
   }
@@ -13515,8 +13514,7 @@ class AvatarController {
         this.emit("stopRendering");
         if (this.frameStarvationEvents.length > 0) {
           const hasReqEnd = this.frameStarvationEvents.some((e2) => e2.reqEnd);
-          logEvent("character_player", "warning", {
-            event: "frame_starvation",
+          logEvent("frame_starvation", "warning", {
             avatar_id: this.avatar.id,
             conversationId: ((_a2 = this.networkLayer) == null ? void 0 : _a2.getCurrentConversationId()) || void 0,
             starvation_count: this.frameStarvationEvents.length,
@@ -13526,9 +13524,8 @@ class AvatarController {
         }
         this.frameStarvationEvents = [];
         this.isFrameStarved = false;
-        logEvent("character_player", "info", {
+        logEvent("playback_ended", "info", {
           avatar_id: this.avatar.id,
-          event: "playback_ended",
           conversationId: ((_b2 = this.networkLayer) == null ? void 0 : _b2.getCurrentConversationId()) || void 0
         });
         this.clearPlaybackData();
@@ -13554,9 +13551,8 @@ class AvatarController {
       this.notifyConversationState(AvatarState.playing);
       this.startPlaybackLoop();
       this.isStartingPlayback = false;
-      logEvent("character_player", "info", {
+      logEvent("playback_started", "info", {
         avatar_id: this.avatar.id,
-        event: "playback_started",
         conversationId: ((_a = this.networkLayer) == null ? void 0 : _a.getCurrentConversationId()) || void 0
       });
     } catch (error) {
@@ -13617,8 +13613,7 @@ class AvatarController {
     const shouldReport = state.audioTimeZeroCount > this.MAX_AUDIO_TIME_ZERO_COUNT || state.audioTimeStuckCount > this.MAX_AUDIO_TIME_STUCK_COUNT || hasScheduledButNoActive && this.isPlaying;
     if (shouldReport && isNotPaused) {
       state.reported = true;
-      logEvent("character_player", "error", {
-        event: "playback_stuck_after_transition",
+      logEvent("playback_stuck_after_transition", "error", {
         avatar_id: this.avatar.id,
         conversationId: ((_e2 = this.networkLayer) == null ? void 0 : _e2.getCurrentConversationId()) || void 0,
         // 诊断信息（包含 audioContextState 用于诊断，但不作为触发条件）
@@ -13863,9 +13858,8 @@ class AvatarController {
         this.isFallbackMode = false;
         this.clearPlaybackData();
         this.resetConversationIdState();
-        logEvent("character_player", "info", {
+        logEvent("audio_only_playback_ended", "info", {
           avatar_id: this.avatar.id,
-          event: "audio_only_playback_ended",
           conversationId: this.getEffectiveConversationId() || void 0
         });
       });
@@ -13881,9 +13875,8 @@ class AvatarController {
       this.currentState = AvatarState.playing;
       this.notifyConversationState(AvatarState.playing, true);
       this.startAudioMonitoringLoop();
-      logEvent("character_player", "info", {
+      logEvent("audio_only_playback_started", "info", {
         avatar_id: this.avatar.id,
-        event: "audio_only_playback_started",
         conversationId: this.getEffectiveConversationId() || void 0
       });
     } catch (error) {
@@ -17954,9 +17947,9 @@ class AvatarView {
   }
   /**
    * Render specified keyframe (pure rendering mode, no audio-animation synchronization)
-   * Suitable for scenarios where external application controls audio playback and animation playback
    * @param keyframeData - Keyframe data
-   * @param enableIdleRendering - Whether to enable idle loop rendering. true: Enable idle rendering and return immediately (skip this keyframe); false: Disable idle rendering and process keyframe (default)
+   * @param enableIdleRendering - Whether to enable idle loop rendering
+   * @internal
    */
   async renderFlame(keyframeData, enableIdleRendering) {
     if (!this.isInitialized || !this.renderSystem) {
@@ -17987,6 +17980,7 @@ class AvatarView {
       throw error;
     }
   }
+  /** @internal */
   async generateTransition(options) {
     if (!this.isInitialized) {
       throw new Error("AvatarView not initialized");
@@ -18098,6 +18092,30 @@ class AvatarView {
   startIdle() {
     this.renderFlame(void 0, true);
   }
+  /**
+   * Generate transition frames from protobuf data.
+   *
+   * Decodes the protobuf, extracts the target keyframe, and generates
+   * transition frames from the current idle position to the target.
+   * The caller is responsible for playing the returned frames at the desired cadence.
+   *
+   * @param data - Raw protobuf bytes containing the target frame
+   * @param frameCount - Number of transition frames to generate
+   * @param options - Additional options
+   * @param options.useLinear - Use linear interpolation (default: true)
+   * @returns Array of opaque keyframe data for sequential playback
+   */
+  async generateTransitionFromProtobuf(data, frameCount, options) {
+    const keyframes = decodeAnimationKeyframes(data);
+    if (!keyframes || keyframes.length === 0) {
+      return [];
+    }
+    return this.generateTransition({
+      to: keyframes[0],
+      frameCount,
+      useLinear: (options == null ? void 0 : options.useLinear) ?? true
+    });
+  }
   /**
    * Cancel any in-progress frame sequence playback.
    * Called by renderFromProtobuf when streaming frames arrive during transition.

package/dist/index.js

@@ -1,4 +1,4 @@
-import { b, c, m, f, d, j, g, C, i, D, E, k, h, L, R, n } from "./index-DNq7oTVY.js";
+import { b, c, m, f, d, j, g, C, i, D, E, k, h, L, R, n } from "./index-BFNu-mKX.js";
 export {
   b as Avatar,
   c as AvatarController,

package/dist/types/index.d.ts

@@ -119,26 +119,6 @@ export interface CameraConfig {
     up?: [number, number, number];
     aspect?: number;
 }
-/**
- * Animation keyframe data
- * Used to represent avatar pose and expression parameters
- */
-export interface KeyframeData {
-    /** Translation [x, y, z] */
-    translation: number[];
-    /** Rotation [x, y, z] (Euler angles, in radians) */
-    rotation: number[];
-    /** Neck pose [x, y, z] (in radians) */
-    neckPose: number[];
-    /** Jaw pose [x, y, z] (in radians) */
-    jawPose: number[];
-    /** Eye pose [x, y, z, x, y, z] (3 parameters for each eye) */
-    eyePose: number[];
-    /** Eyelid [x, y] */
-    eyeLid: number[];
-    /** Expression parameters array */
-    expression: number[];
-}
 /**
  * Post-processing parameter configuration
  * Used to overlay in real-time on animation parameters returned by the server

package/package.json

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