@spatius/avatarkit 1.3.1-beta.2 → 1.3.1-beta.3

package/CHANGELOG.md

@@ -5,6 +5,12 @@ 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.3.1-beta.2] - 2026-07-17
+
+### Fixed
+- Fixed playback getting stuck when audio was sent while the connection was still being established and the session later reconnected: the audio clock could freeze, leaving the avatar frozen on a single frame instead of animating in sync with the audio.
+- Fixed the avatar not returning to idle after a playback round finished in that same send-then-connect scenario; it now correctly transitions back to idle when playback ends.
+
 ## [1.3.1-beta.1] - 2026-07-16
 
 ### Changed

package/dist/{StreamingAudioPlayer-2bLnaLam.js → StreamingAudioPlayer-CF0Yrsmz.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-CPolDcOo.js";
+import { A as APP_CONFIG, l as logger, e as errorToMessage, a as logEvent } from "./index-CFPt9NwR.js";
 class StreamingAudioPlayer {
   // Mark if AudioContext is being resumed, avoid concurrent resume requests
   constructor(options) {

package/dist/{index-CPolDcOo.js → index-CFPt9NwR.js}

@@ -12940,7 +12940,7 @@ const _AnimationPlayer = class _AnimationPlayer {
     if (this.streamingPlayer) {
       return;
     }
-    const { StreamingAudioPlayer } = await import("./StreamingAudioPlayer-2bLnaLam.js");
+    const { StreamingAudioPlayer } = await import("./StreamingAudioPlayer-CF0Yrsmz.js");
     const { AvatarSDK: AvatarSDK2 } = await Promise.resolve().then(() => AvatarSDK$1);
     const audioFormat = AvatarSDK2.getAudioFormat();
     this.streamingPlayer = new StreamingAudioPlayer({
@@ -15080,7 +15080,7 @@ class AvatarSDK {
 __publicField(AvatarSDK, "_initializationState", "uninitialized");
 __publicField(AvatarSDK, "_initializingPromise", null);
 __publicField(AvatarSDK, "_configuration", null);
-__publicField(AvatarSDK, "_version", "1.3.1-beta.2");
+__publicField(AvatarSDK, "_version", "1.3.1-beta.3");
 __publicField(AvatarSDK, "_avatarCore", null);
 __publicField(AvatarSDK, "_cachedDeviceScore", null);
 __publicField(AvatarSDK, "_rendererBackend", null);
@@ -16494,16 +16494,13 @@ class AvatarController {
       count: this.frameStarvationEvents.length,
       max_ms: settled.length > 0 ? Math.max(...settled) : 0,
       total_ms: totalStallMs,
-      // 卡顿率 = 卡顿总时长 / 已播放时长（fps.duration_ms；打断轮即播到打断那刻，
-      // 上限为音频时长）。播放时长为 0 时记 0。
+      // 卡顿率 = 卡顿总时长 / 已播放时长（fps.duration_ms；打断轮即播到打断那刻，上限音频时长）
       ratio: stats.durationMs > 0 ? Number((totalStallMs / stats.durationMs).toFixed(4)) : 0,
       req_end: this.frameStarvationEvents.some((e2) => e2.reqEnd),
-      // 每次卡顿明细：开始时间戳（timelineNow，与 tap/anim 同轴）/ 卡顿时的音频时刻 /
-      // 等了多久（null=卡到播放结束没恢复）/ 卡顿开始与恢复时已收到的动画帧数
-      // （frames_at_recover - frames_at_enter = 卡顿期间到帧量）。
+      // 每次卡顿明细：开始时间戳 / 卡顿时的音频时刻(ms) / 等了多久(null=没恢复) / 卡顿开始与恢复时的动画帧数
       events: this.frameStarvationEvents.map((e2) => ({
         start_ts: Math.round(e2.startTs),
-        audio_time: Number(e2.audioTime.toFixed(3)),
+        audio_time_ms: Math.round(e2.audioTime * 1e3),
         duration_ms: e2.durationMs,
         frames_at_enter: e2.framesAtEnter,
         frames_at_recover: e2.framesAtRecover
@@ -16535,7 +16532,9 @@ class AvatarController {
     const latency = ((_a = this.networkLayer) == null ? void 0 : _a.getDrivingServiceLatency()) ?? null;
     logMetric("playback_quality", stall.count > 0 || audioStall.count > 0 ? "warning" : "info", {
       avatar_id: this.avatar.id,
-      conversation_id: ((_b = this.networkLayer) == null ? void 0 : _b.getCurrentConversationId()) || void 0,
+      // backend 模式无 networkLayer，conversation_id 存于本地 currentConversationId；
+      // 对齐 playback_ended 的兜底顺序，避免 backend 上报 conversation_id=undefined。
+      conversation_id: this.currentConversationId || ((_b = this.networkLayer) == null ? void 0 : _b.getCurrentConversationId()) || void 0,
       end_reason: this.playbackEndReason,
       // 是否降级模式（audio-only 无动画帧）：为 true 时 fps/animation_frame_count 空是预期
       is_fallback: this.isFallbackMode,
@@ -16545,10 +16544,10 @@ class AvatarController {
       audio_ended: this.reqEnd,
       animation_frame_count: this.receivedAnimationFrames,
       animation_ended: this.animationEnded,
-      fps,
-      stall,
-      audio_stall: audioStall,
-      ...latency ? { latency } : {}
+      fps: JSON.stringify(fps),
+      stall: JSON.stringify(stall),
+      audio_stall: JSON.stringify(audioStall),
+      ...latency ? { latency: JSON.stringify(resolveMarks(latency)) } : {}
     });
     this.frameStarvationEvents = [];
     this.isFrameStarved = false;
@@ -17261,7 +17260,8 @@ class AvatarController {
       this.isStartingPlayback = false;
       logEvent("playback_started", "info", {
         avatar_id: this.avatar.id,
-        conversation_id: ((_a = this.networkLayer) == null ? void 0 : _a.getCurrentConversationId()) || void 0
+        // backend 模式无 networkLayer，取本地 currentConversationId 兜底（同 playback_ended/quality）
+        conversation_id: this.currentConversationId || ((_a = this.networkLayer) == null ? void 0 : _a.getCurrentConversationId()) || void 0
       });
     } catch (error) {
       const message = error instanceof Error ? error.message : String(error);
@@ -17330,7 +17330,7 @@ class AvatarController {
       state.reported = true;
       logEvent("playback_stuck_after_transition", "error", {
         avatar_id: this.avatar.id,
-        conversation_id: ((_e2 = this.networkLayer) == null ? void 0 : _e2.getCurrentConversationId()) || void 0,
+        conversation_id: this.currentConversationId || ((_e2 = this.networkLayer) == null ? void 0 : _e2.getCurrentConversationId()) || void 0,
         // 诊断信息（包含 audio_context_state 用于诊断，但不作为触发条件）
         audio_context_state: audioContextState,
         audio_time: audioTime,

package/dist/index.js

@@ -1,4 +1,4 @@
-import { m, b, c, p, f, d, o, g, C, n, i, j, D, E, F, k, L, h, R, q, T, r } from "./index-CPolDcOo.js";
+import { m, b, c, p, f, d, o, g, C, n, i, j, D, E, F, k, L, h, R, q, T, r } from "./index-CFPt9NwR.js";
 export {
   m as AnimationType,
   b as Avatar,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@spatius/avatarkit",
   "type": "module",
-  "version": "1.3.1-beta.2",
+  "version": "1.3.1-beta.3",
   "packageManager": "pnpm@10.18.2",
   "description": "AvatarKit SDK - Real-time Avatar Rendering SDK for Web",
   "author": "AvatarKit Team",