@spatialwalk/avatarkit-rtc 1.0.0-beta.6 → 1.0.0-beta.7
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/core/AvatarPlayer.d.ts.map +1 -1
- package/dist/index10.js +80 -47
- package/dist/index10.js.map +1 -1
- package/dist/index11.js +14 -386
- package/dist/index11.js.map +1 -1
- package/dist/index12.js +346 -64
- package/dist/index12.js.map +1 -1
- package/dist/index13.js +174 -14
- package/dist/index13.js.map +1 -1
- package/dist/index2.js +32 -2
- package/dist/index2.js.map +1 -1
- package/dist/index3.js +3 -3
- package/dist/index4.js +2 -2
- package/dist/index6.js +128 -16
- package/dist/index6.js.map +1 -1
- package/dist/index8.js +1 -1
- package/dist/index9.js +60 -163
- package/dist/index9.js.map +1 -1
- package/package.json +2 -2
package/dist/index6.js
CHANGED
|
@@ -116,11 +116,11 @@ const _AnimationHandler = class _AnimationHandler {
|
|
|
116
116
|
if (!keyframes || keyframes.length === 0) {
|
|
117
117
|
return;
|
|
118
118
|
}
|
|
119
|
+
this.ensureSessionActive(frameSeq);
|
|
119
120
|
if (this.config.enableJitterBuffer && frameSeq !== void 0) {
|
|
120
121
|
this.bufferFrame(keyframes[0], frameSeq);
|
|
121
122
|
return;
|
|
122
123
|
}
|
|
123
|
-
this.renderedFrameCount++;
|
|
124
124
|
if (frameSeq !== void 0 && this.lastRenderedFrameSeq !== -1) {
|
|
125
125
|
if (frameSeq < this.lastRenderedFrameSeq) {
|
|
126
126
|
logger.warn(
|
|
@@ -141,7 +141,9 @@ const _AnimationHandler = class _AnimationHandler {
|
|
|
141
141
|
if (frameSeq !== void 0) {
|
|
142
142
|
this.lastRenderedFrameSeq = frameSeq;
|
|
143
143
|
}
|
|
144
|
+
this.renderedFrameCount++;
|
|
144
145
|
this.renderer.renderFrame(keyframes[0]);
|
|
146
|
+
this.logRenderedFrame("direct", frameSeq, isRecovered);
|
|
145
147
|
this.playbackFrameTimestamps.push(performance.now());
|
|
146
148
|
this.playbackFrameCount++;
|
|
147
149
|
if (frameSeq !== void 0) {
|
|
@@ -159,6 +161,10 @@ const _AnimationHandler = class _AnimationHandler {
|
|
|
159
161
|
* @internal
|
|
160
162
|
*/
|
|
161
163
|
async handleTransitionData(protobufData, frameCount) {
|
|
164
|
+
logger.info(
|
|
165
|
+
"AnimationHandler",
|
|
166
|
+
`Start transition packet received (bytes=${protobufData.byteLength}, requestedFrames=${frameCount ?? this.config.transitionStartFrameCount}, hasHandledStart=${this.hasHandledTransitionStart}, isInSession=${this.isInSession}, isPlayingTransition=${this.isPlayingTransition}, isGeneratingStart=${this.isGeneratingStartTransition}, lastRenderedSeq=${this.lastRenderedFrameSeq}, bufferState=${this.bufferState}, buffered=${this.frameBuffer.size})`
|
|
167
|
+
);
|
|
162
168
|
if (this.hasHandledTransitionStart) {
|
|
163
169
|
return;
|
|
164
170
|
}
|
|
@@ -172,6 +178,14 @@ const _AnimationHandler = class _AnimationHandler {
|
|
|
172
178
|
logger.warn("AnimationHandler", "Renderer not ready for transition");
|
|
173
179
|
return;
|
|
174
180
|
}
|
|
181
|
+
if (this.isInSession && (this.lastRenderedFrameSeq >= 0 || this.frameBuffer.size > 0 || this.bufferState !== "direct")) {
|
|
182
|
+
this.hasHandledTransitionStart = true;
|
|
183
|
+
logger.warn(
|
|
184
|
+
"AnimationHandler",
|
|
185
|
+
`Ignoring late transition packet after playback start (lastRenderedSeq=${this.lastRenderedFrameSeq}, bufferState=${this.bufferState}, buffered=${this.frameBuffer.size})`
|
|
186
|
+
);
|
|
187
|
+
return;
|
|
188
|
+
}
|
|
175
189
|
const keyframes = this.decoder(protobufData);
|
|
176
190
|
if (!keyframes || keyframes.length === 0) {
|
|
177
191
|
logger.warn("AnimationHandler", "No target keyframe in transition data");
|
|
@@ -179,11 +193,7 @@ const _AnimationHandler = class _AnimationHandler {
|
|
|
179
193
|
}
|
|
180
194
|
this.hasHandledTransitionStart = true;
|
|
181
195
|
this.hasHandledTransitionEnd = false;
|
|
182
|
-
this.
|
|
183
|
-
this.lastFrameReceivedTime = Date.now();
|
|
184
|
-
this.hasReportedStall = false;
|
|
185
|
-
this.startWatchdog();
|
|
186
|
-
this.startPlaybackStats();
|
|
196
|
+
this.ensureSessionActive();
|
|
187
197
|
const targetFrame = keyframes[0];
|
|
188
198
|
const frames = frameCount ?? this.config.transitionStartFrameCount;
|
|
189
199
|
logger.info("AnimationHandler", `Generating ${frames} transition frames to target`);
|
|
@@ -202,6 +212,7 @@ const _AnimationHandler = class _AnimationHandler {
|
|
|
202
212
|
} catch (error) {
|
|
203
213
|
logger.error("AnimationHandler", "Failed to generate transition:", error);
|
|
204
214
|
this.renderer.renderFrame(targetFrame);
|
|
215
|
+
this.logRenderedFrame("transition-fallback");
|
|
205
216
|
} finally {
|
|
206
217
|
this.isGeneratingStartTransition = false;
|
|
207
218
|
}
|
|
@@ -226,12 +237,14 @@ const _AnimationHandler = class _AnimationHandler {
|
|
|
226
237
|
if (!this.renderer.isReady()) {
|
|
227
238
|
logger.warn("AnimationHandler", "Renderer not ready for transition to idle");
|
|
228
239
|
this.renderer.renderFrame(void 0, true);
|
|
240
|
+
this.logRenderedFrame("idle");
|
|
229
241
|
return;
|
|
230
242
|
}
|
|
231
243
|
const keyframes = this.decoder(protobufData);
|
|
232
244
|
if (!keyframes || keyframes.length === 0) {
|
|
233
245
|
logger.warn("AnimationHandler", "No last keyframe in transition end data, starting idle directly");
|
|
234
246
|
this.renderer.renderFrame(void 0, true);
|
|
247
|
+
this.logRenderedFrame("idle");
|
|
235
248
|
return;
|
|
236
249
|
}
|
|
237
250
|
this.hasHandledTransitionEnd = true;
|
|
@@ -254,6 +267,7 @@ const _AnimationHandler = class _AnimationHandler {
|
|
|
254
267
|
} catch (error) {
|
|
255
268
|
logger.error("AnimationHandler", "Failed to generate reverse transition:", error);
|
|
256
269
|
this.renderer.renderFrame(void 0, true);
|
|
270
|
+
this.logRenderedFrame("idle");
|
|
257
271
|
} finally {
|
|
258
272
|
this.isGeneratingEndTransition = false;
|
|
259
273
|
}
|
|
@@ -266,6 +280,24 @@ const _AnimationHandler = class _AnimationHandler {
|
|
|
266
280
|
this.isInSession = false;
|
|
267
281
|
this.hasReportedStall = false;
|
|
268
282
|
this.renderer.renderFrame(void 0, true);
|
|
283
|
+
this.logRenderedFrame("idle");
|
|
284
|
+
}
|
|
285
|
+
/**
|
|
286
|
+
* Ensure session-level timers/stats are active.
|
|
287
|
+
* @internal
|
|
288
|
+
*/
|
|
289
|
+
ensureSessionActive(frameSeq) {
|
|
290
|
+
if (this.isInSession) {
|
|
291
|
+
return;
|
|
292
|
+
}
|
|
293
|
+
this.isInSession = true;
|
|
294
|
+
this.lastFrameReceivedTime = Date.now();
|
|
295
|
+
this.hasReportedStall = false;
|
|
296
|
+
this.startWatchdog();
|
|
297
|
+
this.startPlaybackStats();
|
|
298
|
+
if (frameSeq !== void 0) {
|
|
299
|
+
logger.info("AnimationHandler", `Session started from animation frame seq=${frameSeq}`);
|
|
300
|
+
}
|
|
269
301
|
}
|
|
270
302
|
/**
|
|
271
303
|
* Reset animation frame tracking (call on session start).
|
|
@@ -438,6 +470,20 @@ const _AnimationHandler = class _AnimationHandler {
|
|
|
438
470
|
* @internal
|
|
439
471
|
*/
|
|
440
472
|
bufferFrame(flame, seq) {
|
|
473
|
+
if (this.lastRenderedFrameSeq >= 0 && seq <= this.lastRenderedFrameSeq) {
|
|
474
|
+
logger.warn(
|
|
475
|
+
"AnimationHandler",
|
|
476
|
+
`Jitter buffer: dropping stale frame seq=${seq} (lastRendered=${this.lastRenderedFrameSeq})`
|
|
477
|
+
);
|
|
478
|
+
return;
|
|
479
|
+
}
|
|
480
|
+
if (this.bufferNextSeq >= 0 && seq < this.bufferNextSeq) {
|
|
481
|
+
logger.warn(
|
|
482
|
+
"AnimationHandler",
|
|
483
|
+
`Jitter buffer: dropping late frame seq=${seq} (nextExpected=${this.bufferNextSeq})`
|
|
484
|
+
);
|
|
485
|
+
return;
|
|
486
|
+
}
|
|
441
487
|
if (this.frameBuffer.has(seq)) {
|
|
442
488
|
return;
|
|
443
489
|
}
|
|
@@ -448,6 +494,10 @@ const _AnimationHandler = class _AnimationHandler {
|
|
|
448
494
|
if (k < oldestSeq) oldestSeq = k;
|
|
449
495
|
}
|
|
450
496
|
this.frameBuffer.delete(oldestSeq);
|
|
497
|
+
logger.warn(
|
|
498
|
+
"AnimationHandler",
|
|
499
|
+
`Jitter buffer: overflow, dropping seq=${oldestSeq} (nextExpected=${this.bufferNextSeq})`
|
|
500
|
+
);
|
|
451
501
|
}
|
|
452
502
|
switch (this.bufferState) {
|
|
453
503
|
case "direct":
|
|
@@ -470,6 +520,45 @@ const _AnimationHandler = class _AnimationHandler {
|
|
|
470
520
|
break;
|
|
471
521
|
}
|
|
472
522
|
}
|
|
523
|
+
/**
|
|
524
|
+
* Drop buffered frames that are now too old to ever be rendered in-order.
|
|
525
|
+
* @internal
|
|
526
|
+
*/
|
|
527
|
+
dropStaleBufferedFrames() {
|
|
528
|
+
if (this.frameBuffer.size === 0) {
|
|
529
|
+
return;
|
|
530
|
+
}
|
|
531
|
+
const minAllowedSeq = Math.max(this.bufferNextSeq, this.lastRenderedFrameSeq + 1);
|
|
532
|
+
if (minAllowedSeq < 0) {
|
|
533
|
+
return;
|
|
534
|
+
}
|
|
535
|
+
let dropped = 0;
|
|
536
|
+
for (const seq of Array.from(this.frameBuffer.keys())) {
|
|
537
|
+
if (seq < minAllowedSeq) {
|
|
538
|
+
this.frameBuffer.delete(seq);
|
|
539
|
+
dropped++;
|
|
540
|
+
}
|
|
541
|
+
}
|
|
542
|
+
if (dropped > 0) {
|
|
543
|
+
logger.warn(
|
|
544
|
+
"AnimationHandler",
|
|
545
|
+
`Jitter buffer: dropped ${dropped} stale frame(s) older than seq=${minAllowedSeq}`
|
|
546
|
+
);
|
|
547
|
+
}
|
|
548
|
+
}
|
|
549
|
+
/**
|
|
550
|
+
* Find the lowest buffered sequence at or after minSeq.
|
|
551
|
+
* @internal
|
|
552
|
+
*/
|
|
553
|
+
findLowestBufferedSeqAtOrAfter(minSeq) {
|
|
554
|
+
let candidate = Infinity;
|
|
555
|
+
for (const seq of this.frameBuffer.keys()) {
|
|
556
|
+
if (seq >= minSeq && seq < candidate) {
|
|
557
|
+
candidate = seq;
|
|
558
|
+
}
|
|
559
|
+
}
|
|
560
|
+
return candidate === Infinity ? null : candidate;
|
|
561
|
+
}
|
|
473
562
|
/**
|
|
474
563
|
* Begin draining the buffer at 25fps.
|
|
475
564
|
* @internal
|
|
@@ -497,28 +586,31 @@ const _AnimationHandler = class _AnimationHandler {
|
|
|
497
586
|
if (this.bufferState !== "draining") {
|
|
498
587
|
return;
|
|
499
588
|
}
|
|
589
|
+
this.dropStaleBufferedFrames();
|
|
500
590
|
const frame = this.frameBuffer.get(this.bufferNextSeq);
|
|
501
591
|
if (frame) {
|
|
502
592
|
this.renderBufferedFrame(frame);
|
|
503
593
|
this.frameBuffer.delete(this.bufferNextSeq);
|
|
504
594
|
this.bufferNextSeq++;
|
|
505
595
|
} else if (this.frameBuffer.size > 0) {
|
|
506
|
-
|
|
507
|
-
|
|
508
|
-
|
|
596
|
+
const nextSeq = this.findLowestBufferedSeqAtOrAfter(this.bufferNextSeq);
|
|
597
|
+
if (nextSeq === null) {
|
|
598
|
+
this.bufferState = "starved";
|
|
599
|
+
logger.warn("AnimationHandler", "Jitter buffer: no in-order frames available, pausing drain");
|
|
600
|
+
return;
|
|
509
601
|
}
|
|
510
|
-
const
|
|
511
|
-
const waitTime = performance.now() -
|
|
602
|
+
const nextFrame = this.frameBuffer.get(nextSeq);
|
|
603
|
+
const waitTime = performance.now() - nextFrame.receivedAt;
|
|
512
604
|
if (waitTime > this.config.maxBufferDelayMs) {
|
|
513
|
-
const gap =
|
|
605
|
+
const gap = Math.max(0, nextSeq - this.bufferNextSeq);
|
|
514
606
|
this.playbackGapCount += gap;
|
|
515
607
|
logger.warn(
|
|
516
608
|
"AnimationHandler",
|
|
517
|
-
`Jitter buffer: skipping ${gap} frame(s) from seq ${this.bufferNextSeq} to ${
|
|
609
|
+
`Jitter buffer: skipping ${gap} frame(s) from seq ${this.bufferNextSeq} to ${nextSeq} after ${waitTime.toFixed(1)}ms`
|
|
518
610
|
);
|
|
519
|
-
this.renderBufferedFrame(
|
|
520
|
-
this.frameBuffer.delete(
|
|
521
|
-
this.bufferNextSeq =
|
|
611
|
+
this.renderBufferedFrame(nextFrame);
|
|
612
|
+
this.frameBuffer.delete(nextSeq);
|
|
613
|
+
this.bufferNextSeq = nextSeq + 1;
|
|
522
614
|
}
|
|
523
615
|
} else {
|
|
524
616
|
this.bufferState = "starved";
|
|
@@ -536,9 +628,17 @@ const _AnimationHandler = class _AnimationHandler {
|
|
|
536
628
|
* @internal
|
|
537
629
|
*/
|
|
538
630
|
renderBufferedFrame(frame) {
|
|
631
|
+
if (this.lastRenderedFrameSeq >= 0 && frame.seq <= this.lastRenderedFrameSeq) {
|
|
632
|
+
logger.warn(
|
|
633
|
+
"AnimationHandler",
|
|
634
|
+
`Jitter buffer: refusing out-of-order render seq=${frame.seq} (lastRendered=${this.lastRenderedFrameSeq})`
|
|
635
|
+
);
|
|
636
|
+
return;
|
|
637
|
+
}
|
|
539
638
|
this.renderer.renderFrame(frame.flame);
|
|
540
639
|
this.lastRenderedFrameSeq = frame.seq;
|
|
541
640
|
this.renderedFrameCount++;
|
|
641
|
+
this.logRenderedFrame("buffer", frame.seq);
|
|
542
642
|
this.playbackFrameTimestamps.push(performance.now());
|
|
543
643
|
this.playbackFrameCount++;
|
|
544
644
|
}
|
|
@@ -575,6 +675,7 @@ const _AnimationHandler = class _AnimationHandler {
|
|
|
575
675
|
if (wasTransitioningToIdle) {
|
|
576
676
|
logger.info("AnimationHandler", "Starting idle animation after transition");
|
|
577
677
|
this.renderer.renderFrame(void 0, true);
|
|
678
|
+
this.logRenderedFrame("idle");
|
|
578
679
|
}
|
|
579
680
|
return;
|
|
580
681
|
}
|
|
@@ -585,6 +686,7 @@ const _AnimationHandler = class _AnimationHandler {
|
|
|
585
686
|
}
|
|
586
687
|
const frame = this.transitionFrames[this.transitionFrameIndex];
|
|
587
688
|
this.renderer.renderFrame(frame);
|
|
689
|
+
this.logRenderedFrame("transition");
|
|
588
690
|
this.transitionFrameIndex++;
|
|
589
691
|
this.transitionTimeoutId = setTimeout(() => {
|
|
590
692
|
if (this.isPlayingTransition) {
|
|
@@ -592,6 +694,16 @@ const _AnimationHandler = class _AnimationHandler {
|
|
|
592
694
|
}
|
|
593
695
|
}, 40);
|
|
594
696
|
}
|
|
697
|
+
/**
|
|
698
|
+
* Emit a per-frame render log for debugging ordering issues.
|
|
699
|
+
* @internal
|
|
700
|
+
*/
|
|
701
|
+
logRenderedFrame(source, seq, isRecovered) {
|
|
702
|
+
logger.info(
|
|
703
|
+
"AnimationHandler",
|
|
704
|
+
`Rendered frame: source=${source}, seq=${seq ?? "n/a"}${isRecovered ? " [RECOVERED]" : ""}`
|
|
705
|
+
);
|
|
706
|
+
}
|
|
595
707
|
};
|
|
596
708
|
/** @internal */
|
|
597
709
|
__publicField(_AnimationHandler, "STALL_TIMEOUT_MS", 3e3);
|
package/dist/index6.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index6.js","sources":["../src/core/AnimationHandler.ts"],"sourcesContent":["/**\n * Animation Handler - Orchestrates animation playback and transitions.\n *\n * This module handles:\n * - Animation frame rendering\n * - Transition playback from idle to animation and back\n * - Frame timing at 25fps\n * - Session state tracking\n *\n * The handler relies on server-sent packet flags (Transition, TransitionEnd, Idle)\n * to determine when to generate transitions, rather than maintaining complex internal state.\n *\n * @internal\n * @packageDocumentation\n */\n\nimport type { Flame } from '../proto/animation';\nimport { decodeAnimationKeyframes } from '../proto/animation';\nimport { logger } from '../utils';\n\n/**\n * Interface for decoding protobuf animation data.\n * Allows custom decoder implementation if needed.\n * @internal\n */\nexport type AnimationDecoder = (protobufData: ArrayBuffer) => Flame[] | null;\n\n/**\n * Interface that applications must implement to render avatar frames.\n * The SDK calls these methods to control the avatar.\n * @internal\n */\nexport interface AvatarRenderer {\n /**\n * Render a single animation frame.\n * @param flame - The frame to render, or undefined to render idle\n * @param startIdle - If true and flame is undefined, start idle animation loop\n */\n renderFrame(flame: Flame | undefined, startIdle?: boolean): void;\n\n /**\n * Generate transition frames from idle position to target frame.\n * @param targetFrame - The target frame to transition to\n * @param frameCount - Number of transition frames to generate\n * @returns Promise resolving to array of transition frames\n */\n generateTransitionFromIdle(\n targetFrame: Flame,\n frameCount: number\n ): Promise<Flame[]>;\n\n /**\n * Check if the renderer is available and ready.\n * @returns true if renderer is ready to accept frames\n */\n isReady(): boolean;\n}\n\n/**\n * Configuration for AnimationHandler.\n * @internal\n */\nexport interface AnimationHandlerConfig {\n /**\n * Number of transition frames when starting animation.\n * Default: 8 (~320ms at 25fps)\n */\n transitionStartFrameCount?: number;\n\n /**\n * Number of transition frames when ending animation.\n * Default: 12 (~480ms at 25fps)\n */\n transitionEndFrameCount?: number;\n\n /**\n * Custom decoder function.\n * Uses built-in protobuf decoder if not provided.\n */\n decoder?: AnimationDecoder;\n\n /**\n * Callback when data stream stalls and fallback to idle is triggered.\n * Called when no animation frames received for 3 seconds during speaking session.\n */\n onStreamStalled?: () => void;\n\n /**\n * Enable jitter buffer for smoother playback.\n * When enabled, frames are buffered and rendered in sequence order at a steady 25fps,\n * absorbing network jitter and out-of-order delivery.\n * Default: true\n */\n enableJitterBuffer?: boolean;\n\n /**\n * Maximum delay (in ms) a frame can sit in the jitter buffer before being rendered.\n * Also controls how long to wait for a missing frame before skipping ahead.\n * Default: 80 (2 frames at 25fps)\n */\n maxBufferDelayMs?: number;\n}\n\n/**\n * Jitter buffer state machine.\n * @internal\n */\ntype BufferState = 'direct' | 'filling' | 'draining' | 'starved';\n\n/**\n * A frame held in the jitter buffer awaiting playback.\n * @internal\n */\ninterface BufferedFrame {\n flame: Flame;\n seq: number;\n receivedAt: number;\n}\n\n/**\n * AnimationHandler manages all animation playback and transition logic.\n *\n * @internal\n * This class is used internally by AvatarPlayer.\n * Applications should not instantiate this class directly.\n */\nexport class AnimationHandler {\n /** @internal */\n private renderer: AvatarRenderer;\n /** @internal */\n private decoder: AnimationDecoder;\n /** @internal */\n private config: Required<Omit<AnimationHandlerConfig, 'decoder' | 'onStreamStalled'>>;\n\n // Frame tracking\n /** @internal */\n private animationFrameCount = 0;\n /** @internal */\n private lastRenderedFrameSeq = -1;\n /** @internal */\n private renderedFrameCount = 0;\n\n // Transition state\n /** @internal */\n private isPlayingTransition = false;\n /** @internal */\n private isTransitioningToIdle = false;\n /** @internal */\n private transitionFrames: Flame[] = [];\n /** @internal */\n private transitionFrameIndex = 0;\n /** @internal */\n private transitionTimeoutId: ReturnType<typeof setTimeout> | null = null;\n\n // Guards against race conditions during async transition generation\n /** @internal */\n private isGeneratingStartTransition = false;\n /** @internal */\n private isGeneratingEndTransition = false;\n\n // Session-level flags to prevent duplicate handling\n // These are reset in resetTracking() for new sessions\n /** @internal */\n private hasHandledTransitionStart = false;\n /** @internal */\n private hasHandledTransitionEnd = false;\n\n // Watchdog for detecting stalled data stream\n /** @internal */\n private lastFrameReceivedTime = 0;\n /** @internal */\n private isInSession = false;\n /** @internal */\n private watchdogTimer: ReturnType<typeof setInterval> | null = null;\n /** @internal */\n private hasReportedStall = false;\n /** @internal */\n private static readonly STALL_TIMEOUT_MS = 3000;\n /** @internal */\n private onStreamStalledCallback: (() => void) | null = null;\n /** @internal */\n private isStalledFallback = false; // True when fallback to idle was triggered due to stall\n\n // Playback stats\n /** @internal */\n private playbackStatsTimer: ReturnType<typeof setInterval> | null = null;\n /** @internal */\n private playbackFrameCount = 0;\n /** @internal */\n private playbackFrameTimestamps: number[] = [];\n /** @internal */\n private playbackGapCount = 0;\n /** @internal */\n private playbackExpectedSeq = -1;\n\n // Jitter buffer\n /** @internal */\n private bufferState: BufferState = 'direct';\n /** @internal */\n private frameBuffer = new Map<number, BufferedFrame>();\n /** @internal */\n private bufferNextSeq = -1;\n /** @internal */\n private bufferDrainTimer: ReturnType<typeof setTimeout> | null = null;\n /** @internal */\n private bufferLastDrainTime = 0;\n /** @internal */\n private static readonly BUFFER_MAX_SIZE = 4;\n /** @internal */\n private static readonly BUFFER_INITIAL_FILL = 2;\n /** @internal */\n private static readonly BUFFER_FRAME_INTERVAL_MS = 40;\n\n /**\n * @internal\n */\n constructor(renderer: AvatarRenderer, config: AnimationHandlerConfig = {}) {\n this.renderer = renderer;\n this.decoder = config.decoder ?? decodeAnimationKeyframes;\n this.config = {\n transitionStartFrameCount: config.transitionStartFrameCount ?? 8,\n transitionEndFrameCount: config.transitionEndFrameCount ?? 12,\n enableJitterBuffer: config.enableJitterBuffer ?? true,\n maxBufferDelayMs: config.maxBufferDelayMs ?? 80,\n };\n this.onStreamStalledCallback = config.onStreamStalled ?? null;\n }\n\n /**\n * Handle animation data received from RTC provider.\n * @param protobufData - Raw protobuf bytes\n * @param frameSeq - Frame sequence number (optional)\n * @param isRecovered - Whether this frame was recovered via ALR\n * @internal\n */\n handleAnimationData(\n protobufData: ArrayBuffer,\n frameSeq?: number,\n isRecovered?: boolean\n ): void {\n // If we were in transition, stop it and play normal animation\n if (this.isPlayingTransition) {\n this.stopTransition();\n }\n\n // Update watchdog state\n const now = Date.now();\n if (this.hasReportedStall) {\n // Recovered from stall\n const stallDuration = now - this.lastFrameReceivedTime;\n logger.info('AnimationHandler', `Data stream resumed after ${stallDuration}ms stall`);\n this.hasReportedStall = false;\n }\n // If we were in stalled fallback, clear the flag (data has resumed, no transition needed)\n if (this.isStalledFallback) {\n logger.info('AnimationHandler', 'Resuming from stall fallback, rendering directly without transition');\n this.isStalledFallback = false;\n }\n this.lastFrameReceivedTime = now;\n\n this.animationFrameCount++;\n\n // Decode\n const keyframes = this.decoder(protobufData);\n if (!keyframes || keyframes.length === 0) {\n return;\n }\n\n // Jitter buffer path: insert into buffer instead of rendering directly\n if (this.config.enableJitterBuffer && frameSeq !== undefined) {\n this.bufferFrame(keyframes[0], frameSeq);\n return;\n }\n\n // Direct path (no buffer)\n this.renderedFrameCount++;\n\n // Check for out-of-order delivery\n if (frameSeq !== undefined && this.lastRenderedFrameSeq !== -1) {\n if (frameSeq < this.lastRenderedFrameSeq) {\n // Out-of-order frame - discard (already rendered a later frame)\n logger.warn(\n 'AnimationHandler',\n `OUT-OF-ORDER: seq=${frameSeq}, lastRendered=${this.lastRenderedFrameSeq}${isRecovered ? ' [RECOVERED]' : ''}, discarding`\n );\n return;\n } else if (frameSeq === this.lastRenderedFrameSeq) {\n // Duplicate frame - skip silently (expected when server sends redundant frames)\n return;\n } else if (frameSeq > this.lastRenderedFrameSeq + 1) {\n const gap = frameSeq - this.lastRenderedFrameSeq - 1;\n logger.warn(\n 'AnimationHandler',\n `GAP: ${gap} frame(s) between ${this.lastRenderedFrameSeq} and ${frameSeq}${isRecovered ? ' [RECOVERED]' : ''}`\n );\n }\n }\n\n if (frameSeq !== undefined) {\n this.lastRenderedFrameSeq = frameSeq;\n }\n\n // Render directly\n this.renderer.renderFrame(keyframes[0]);\n\n // Collect playback stats\n this.playbackFrameTimestamps.push(performance.now());\n this.playbackFrameCount++;\n if (frameSeq !== undefined) {\n if (this.playbackExpectedSeq >= 0 && frameSeq > this.playbackExpectedSeq) {\n this.playbackGapCount += frameSeq - this.playbackExpectedSeq;\n }\n this.playbackExpectedSeq = frameSeq + 1;\n }\n }\n\n /**\n * Handle transition packet - generate and play transition from idle to target.\n * Only starts transition on the first packet; subsequent packets are ignored while transitioning.\n * @param protobufData - Protobuf data containing target frame\n * @param frameCount - Number of transition frames (overrides config if provided)\n * @internal\n */\n async handleTransitionData(\n protobufData: ArrayBuffer,\n frameCount?: number\n ): Promise<void> {\n // Ignore if we've already handled a transition start for this session\n if (this.hasHandledTransitionStart) {\n return;\n }\n // Ignore if already playing or generating a start transition\n if (this.isPlayingTransition && !this.isTransitioningToIdle) {\n return;\n }\n if (this.isGeneratingStartTransition) {\n return;\n }\n\n if (!this.renderer.isReady()) {\n logger.warn('AnimationHandler', 'Renderer not ready for transition');\n return;\n }\n\n // Decode target frame\n const keyframes = this.decoder(protobufData);\n if (!keyframes || keyframes.length === 0) {\n logger.warn('AnimationHandler', 'No target keyframe in transition data');\n return;\n }\n\n // Mark that we've handled transition start for this session\n this.hasHandledTransitionStart = true;\n // Reset transition end flag since we're starting a new transition\n this.hasHandledTransitionEnd = false;\n\n // Start session and watchdog\n this.isInSession = true;\n this.lastFrameReceivedTime = Date.now();\n this.hasReportedStall = false;\n this.startWatchdog();\n this.startPlaybackStats();\n\n const targetFrame = keyframes[0];\n const frames = frameCount ?? this.config.transitionStartFrameCount;\n logger.info('AnimationHandler', `Generating ${frames} transition frames to target`);\n\n // Set guard flag before async operation\n this.isGeneratingStartTransition = true;\n\n try {\n // Generate transition frames from idle to target\n const transitionFrames = await this.renderer.generateTransitionFromIdle(\n targetFrame,\n frames\n );\n logger.info('AnimationHandler', `Generated ${transitionFrames.length} transition frames`);\n\n // Start playing transition frames at 25fps\n this.isPlayingTransition = true;\n this.isTransitioningToIdle = false;\n this.transitionFrames = transitionFrames;\n this.transitionFrameIndex = 0;\n\n this.playTransitionFrame();\n } catch (error) {\n logger.error('AnimationHandler', 'Failed to generate transition:', error);\n // Fallback: render target directly\n this.renderer.renderFrame(targetFrame);\n } finally {\n this.isGeneratingStartTransition = false;\n }\n }\n\n /**\n * Handle transition end - generate and play reverse transition back to idle.\n * Only starts transition on the first packet; subsequent packets are ignored while transitioning.\n * @param protobufData - Protobuf data containing last animation frame\n * @param frameCount - Number of transition frames (overrides config if provided)\n * @internal\n */\n async handleTransitionToIdle(\n protobufData: ArrayBuffer,\n frameCount?: number\n ): Promise<void> {\n // Ignore if we've already handled a transition end for this session\n if (this.hasHandledTransitionEnd) {\n return;\n }\n // Ignore if already playing or generating an end transition\n if (this.isPlayingTransition && this.isTransitioningToIdle) {\n return;\n }\n if (this.isGeneratingEndTransition) {\n return;\n }\n\n if (!this.renderer.isReady()) {\n logger.warn('AnimationHandler', 'Renderer not ready for transition to idle');\n this.renderer.renderFrame(undefined, true);\n return;\n }\n\n // Decode last animation frame\n const keyframes = this.decoder(protobufData);\n if (!keyframes || keyframes.length === 0) {\n logger.warn('AnimationHandler', 'No last keyframe in transition end data, starting idle directly');\n this.renderer.renderFrame(undefined, true);\n return;\n }\n\n // Mark that we've handled transition end for this session\n this.hasHandledTransitionEnd = true;\n\n const lastFrame = keyframes[0];\n const frames = frameCount ?? this.config.transitionEndFrameCount;\n logger.info('AnimationHandler', `Generating ${frames} reverse transition frames to idle`);\n\n // Set guard flag before async operation\n this.isGeneratingEndTransition = true;\n\n try {\n // Generate transition frames from idle to last frame, then reverse\n const transitionFrames = await this.renderer.generateTransitionFromIdle(\n lastFrame,\n frames\n );\n logger.info('AnimationHandler', `Generated ${transitionFrames.length} transition frames, reversing for playback`);\n\n // Reverse frames to play from last animation frame back to idle\n const reversedFrames = transitionFrames.slice().reverse();\n\n // Start playing reversed transition at 25fps\n this.isPlayingTransition = true;\n this.isTransitioningToIdle = true;\n this.transitionFrames = reversedFrames;\n this.transitionFrameIndex = 0;\n\n this.playTransitionFrame();\n } catch (error) {\n logger.error('AnimationHandler', 'Failed to generate reverse transition:', error);\n this.renderer.renderFrame(undefined, true);\n } finally {\n this.isGeneratingEndTransition = false;\n }\n }\n\n /**\n * Start idle animation.\n * @internal\n */\n startIdle(): void {\n this.isInSession = false;\n this.hasReportedStall = false;\n this.renderer.renderFrame(undefined, true);\n }\n\n /**\n * Reset animation frame tracking (call on session start).\n * @internal\n */\n resetTracking(): void {\n this.lastRenderedFrameSeq = -1;\n this.renderedFrameCount = 0;\n this.animationFrameCount = 0;\n // Reset session-level transition flags for new session\n this.hasHandledTransitionStart = false;\n this.hasHandledTransitionEnd = false;\n this.resetPlaybackStats();\n this.flushBuffer();\n logger.info('AnimationHandler', 'Frame tracking reset');\n }\n\n /**\n * Check if currently playing transition frames.\n * @internal\n */\n isInTransition(): boolean {\n return this.isPlayingTransition;\n }\n\n /**\n * Stop transition playback.\n * @internal\n */\n stopTransition(): void {\n if (\n this.isPlayingTransition ||\n this.isGeneratingStartTransition ||\n this.isGeneratingEndTransition\n ) {\n logger.info('AnimationHandler', 'Stopping transition playback');\n }\n this.isPlayingTransition = false;\n this.isTransitioningToIdle = false;\n this.isGeneratingStartTransition = false;\n this.isGeneratingEndTransition = false;\n // Note: We intentionally do NOT reset hasHandledTransitionStart/End here\n // Those are session-level flags, only reset in resetTracking()\n this.transitionFrames = [];\n this.transitionFrameIndex = 0;\n if (this.transitionTimeoutId !== null) {\n clearTimeout(this.transitionTimeoutId);\n this.transitionTimeoutId = null;\n }\n this.flushBuffer();\n }\n\n /**\n * Clean up resources.\n * @internal\n */\n dispose(): void {\n this.stopTransition();\n this.stopWatchdog();\n }\n\n /**\n * Start the watchdog timer to detect stalled data streams.\n * @internal\n */\n private startWatchdog(): void {\n if (this.watchdogTimer) {\n return; // Already running\n }\n\n this.watchdogTimer = setInterval(() => {\n if (!this.isInSession) {\n return;\n }\n\n // Don't check during transition playback (we're playing generated frames, not receiving)\n if (this.isPlayingTransition) {\n return;\n }\n\n const elapsed = Date.now() - this.lastFrameReceivedTime;\n if (elapsed > AnimationHandler.STALL_TIMEOUT_MS && !this.hasReportedStall) {\n logger.error(\n 'AnimationHandler',\n `Data stream stalled: no frames received for ${elapsed}ms, falling back to idle`\n );\n this.hasReportedStall = true;\n this.isStalledFallback = true;\n\n // Trigger fallback to idle\n this.startIdle();\n\n // Notify external listener\n if (this.onStreamStalledCallback) {\n try {\n this.onStreamStalledCallback();\n } catch (e) {\n logger.error('AnimationHandler', 'Error in onStreamStalled callback:', e);\n }\n }\n }\n }, 1000); // Check every 1 second\n }\n\n /**\n * Stop the watchdog timer.\n * @internal\n */\n private stopWatchdog(): void {\n if (this.watchdogTimer) {\n clearInterval(this.watchdogTimer);\n this.watchdogTimer = null;\n }\n this.hasReportedStall = false;\n this.isStalledFallback = false;\n this.stopPlaybackStats();\n }\n\n /**\n * Start the playback stats reporting timer.\n * @internal\n */\n private startPlaybackStats(): void {\n if (this.playbackStatsTimer) {\n return; // Already running\n }\n this.resetPlaybackStats();\n this.playbackStatsTimer = setInterval(() => {\n this.reportPlaybackStats();\n }, 1000);\n }\n\n /**\n * Stop the playback stats reporting timer.\n * @internal\n */\n private stopPlaybackStats(): void {\n if (this.playbackStatsTimer) {\n clearInterval(this.playbackStatsTimer);\n this.playbackStatsTimer = null;\n }\n this.resetPlaybackStats();\n }\n\n /**\n * Reset playback stats counters.\n * @internal\n */\n private resetPlaybackStats(): void {\n this.playbackFrameCount = 0;\n this.playbackFrameTimestamps = [];\n this.playbackGapCount = 0;\n this.playbackExpectedSeq = -1;\n }\n\n /**\n * Report playback stats (called every 1s by timer).\n * Logs FPS, frame loss rate, and playback jitter.\n * @internal\n */\n private reportPlaybackStats(): void {\n // Skip reporting during transitions (locally generated frames)\n if (this.isPlayingTransition) {\n this.resetPlaybackStats();\n return;\n }\n\n // Skip if no frames were rendered this interval\n if (this.playbackFrameCount === 0) {\n return;\n }\n\n const fps = this.playbackFrameCount;\n const totalExpected = this.playbackFrameCount + this.playbackGapCount;\n const lossRate = totalExpected > 0 ? (this.playbackGapCount / totalExpected) * 100 : 0;\n\n // Calculate jitter: std deviation of inter-frame intervals\n let jitter = 0;\n if (this.playbackFrameTimestamps.length >= 2) {\n const intervals: number[] = [];\n for (let i = 1; i < this.playbackFrameTimestamps.length; i++) {\n intervals.push(this.playbackFrameTimestamps[i] - this.playbackFrameTimestamps[i - 1]);\n }\n const mean = intervals.reduce((a, b) => a + b, 0) / intervals.length;\n const variance = intervals.reduce((sum, v) => sum + (v - mean) ** 2, 0) / intervals.length;\n jitter = Math.sqrt(variance);\n }\n\n logger.info(\n 'AnimationHandler',\n `Playback stats: fps=${fps}, lossRate=${lossRate.toFixed(1)}%, jitter=${jitter.toFixed(1)}ms`\n );\n\n // Reset counters for next interval\n this.playbackFrameCount = 0;\n this.playbackFrameTimestamps = [];\n this.playbackGapCount = 0;\n }\n\n // ── Jitter Buffer ──\n\n /**\n * Insert a decoded frame into the jitter buffer.\n * Handles dedup, enforces max size, and drives the buffer state machine.\n * @internal\n */\n private bufferFrame(flame: Flame, seq: number): void {\n // Dedup — server sends each frame twice for resilience\n if (this.frameBuffer.has(seq)) {\n return;\n }\n\n this.frameBuffer.set(seq, { flame, seq, receivedAt: performance.now() });\n\n // Enforce max buffer size — drop oldest when full\n if (this.frameBuffer.size > AnimationHandler.BUFFER_MAX_SIZE) {\n let oldestSeq = Infinity;\n for (const k of this.frameBuffer.keys()) {\n if (k < oldestSeq) oldestSeq = k;\n }\n this.frameBuffer.delete(oldestSeq);\n }\n\n // State machine transitions\n switch (this.bufferState) {\n case 'direct':\n this.bufferState = 'filling';\n if (this.bufferNextSeq < 0) {\n this.bufferNextSeq = seq;\n }\n logger.info('AnimationHandler', `Jitter buffer: filling (first frame seq=${seq})`);\n if (this.frameBuffer.size >= AnimationHandler.BUFFER_INITIAL_FILL) {\n this.startBufferDrain();\n }\n break;\n case 'filling':\n if (this.frameBuffer.size >= AnimationHandler.BUFFER_INITIAL_FILL) {\n this.startBufferDrain();\n }\n break;\n case 'starved':\n this.startBufferDrain();\n break;\n case 'draining':\n // Already draining, frame will be picked up by drain loop\n break;\n }\n }\n\n /**\n * Begin draining the buffer at 25fps.\n * @internal\n */\n private startBufferDrain(): void {\n this.bufferState = 'draining';\n if (this.bufferNextSeq < 0) {\n let minSeq = Infinity;\n for (const k of this.frameBuffer.keys()) {\n if (k < minSeq) minSeq = k;\n }\n this.bufferNextSeq = minSeq;\n }\n logger.info('AnimationHandler', `Jitter buffer: draining (${this.frameBuffer.size} frames buffered)`);\n this.bufferLastDrainTime = performance.now();\n this.drainBufferFrame();\n }\n\n /**\n * Drain one frame from the buffer and schedule the next drain.\n * Handles missing frames (skip-ahead after maxBufferDelayMs) and starvation.\n * @internal\n */\n private drainBufferFrame(): void {\n this.bufferDrainTimer = null;\n\n if (this.bufferState !== 'draining') {\n return;\n }\n\n const frame = this.frameBuffer.get(this.bufferNextSeq);\n\n if (frame) {\n // Expected frame found — render it\n this.renderBufferedFrame(frame);\n this.frameBuffer.delete(this.bufferNextSeq);\n this.bufferNextSeq++;\n } else if (this.frameBuffer.size > 0) {\n // Expected frame missing — check if we should skip ahead\n let oldestSeq = Infinity;\n for (const k of this.frameBuffer.keys()) {\n if (k < oldestSeq) oldestSeq = k;\n }\n const oldestFrame = this.frameBuffer.get(oldestSeq)!;\n const waitTime = performance.now() - oldestFrame.receivedAt;\n\n if (waitTime > this.config.maxBufferDelayMs) {\n // Oldest frame has waited too long — skip ahead\n const gap = oldestSeq - this.bufferNextSeq;\n this.playbackGapCount += gap;\n logger.warn(\n 'AnimationHandler',\n `Jitter buffer: skipping ${gap} frame(s) from seq ${this.bufferNextSeq} to ${oldestSeq}`\n );\n this.renderBufferedFrame(oldestFrame);\n this.frameBuffer.delete(oldestSeq);\n this.bufferNextSeq = oldestSeq + 1;\n }\n // else: wait for the missing frame (render nothing this cycle)\n } else {\n // Buffer empty — starvation\n this.bufferState = 'starved';\n logger.warn('AnimationHandler', 'Jitter buffer: starved, pausing drain');\n return; // Don't schedule next drain\n }\n\n // Schedule next drain with drift correction\n const now = performance.now();\n const nextTarget = this.bufferLastDrainTime + AnimationHandler.BUFFER_FRAME_INTERVAL_MS;\n const delay = Math.max(0, nextTarget - now);\n this.bufferLastDrainTime = nextTarget;\n this.bufferDrainTimer = setTimeout(() => this.drainBufferFrame(), delay);\n }\n\n /**\n * Render a single frame from the buffer and collect playback stats.\n * @internal\n */\n private renderBufferedFrame(frame: BufferedFrame): void {\n this.renderer.renderFrame(frame.flame);\n this.lastRenderedFrameSeq = frame.seq;\n this.renderedFrameCount++;\n\n // Playback stats\n this.playbackFrameTimestamps.push(performance.now());\n this.playbackFrameCount++;\n }\n\n /**\n * Flush the jitter buffer, stop the drain loop, and revert to direct mode.\n * @internal\n */\n private flushBuffer(): void {\n this.frameBuffer.clear();\n this.bufferState = 'direct';\n this.bufferNextSeq = -1;\n this.bufferLastDrainTime = 0;\n if (this.bufferDrainTimer !== null) {\n clearTimeout(this.bufferDrainTimer);\n this.bufferDrainTimer = null;\n }\n }\n\n /**\n * Play a single transition frame and schedule the next one.\n * @internal\n */\n private playTransitionFrame(): void {\n if (\n !this.isPlayingTransition ||\n this.transitionFrameIndex >= this.transitionFrames.length\n ) {\n // Transition complete\n const wasTransitioningToIdle = this.isTransitioningToIdle;\n this.isPlayingTransition = false;\n this.isTransitioningToIdle = false;\n this.transitionFrames = [];\n this.transitionFrameIndex = 0;\n if (this.transitionTimeoutId !== null) {\n clearTimeout(this.transitionTimeoutId);\n this.transitionTimeoutId = null;\n }\n logger.info('AnimationHandler', 'Transition playback complete');\n\n // If transitioning to idle, start idle animation\n if (wasTransitioningToIdle) {\n logger.info('AnimationHandler', 'Starting idle animation after transition');\n this.renderer.renderFrame(undefined, true);\n }\n return;\n }\n\n if (!this.renderer.isReady()) {\n this.isPlayingTransition = false;\n this.isTransitioningToIdle = false;\n return;\n }\n\n const frame = this.transitionFrames[this.transitionFrameIndex];\n this.renderer.renderFrame(frame);\n this.transitionFrameIndex++;\n\n // Schedule next frame at 25fps (40ms)\n this.transitionTimeoutId = setTimeout(() => {\n if (this.isPlayingTransition) {\n this.playTransitionFrame();\n }\n }, 40);\n }\n}\n"],"names":[],"mappings":"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"}
|
|
1
|
+
{"version":3,"file":"index6.js","sources":["../src/core/AnimationHandler.ts"],"sourcesContent":["/**\n * Animation Handler - Orchestrates animation playback and transitions.\n *\n * This module handles:\n * - Animation frame rendering\n * - Transition playback from idle to animation and back\n * - Frame timing at 25fps\n * - Session state tracking\n *\n * The handler relies on server-sent packet flags (Transition, TransitionEnd, Idle)\n * to determine when to generate transitions, rather than maintaining complex internal state.\n *\n * @internal\n * @packageDocumentation\n */\n\nimport type { Flame } from '../proto/animation';\nimport { decodeAnimationKeyframes } from '../proto/animation';\nimport { logger } from '../utils';\n\n/**\n * Interface for decoding protobuf animation data.\n * Allows custom decoder implementation if needed.\n * @internal\n */\nexport type AnimationDecoder = (protobufData: ArrayBuffer) => Flame[] | null;\n\n/**\n * Interface that applications must implement to render avatar frames.\n * The SDK calls these methods to control the avatar.\n * @internal\n */\nexport interface AvatarRenderer {\n /**\n * Render a single animation frame.\n * @param flame - The frame to render, or undefined to render idle\n * @param startIdle - If true and flame is undefined, start idle animation loop\n */\n renderFrame(flame: Flame | undefined, startIdle?: boolean): void;\n\n /**\n * Generate transition frames from idle position to target frame.\n * @param targetFrame - The target frame to transition to\n * @param frameCount - Number of transition frames to generate\n * @returns Promise resolving to array of transition frames\n */\n generateTransitionFromIdle(\n targetFrame: Flame,\n frameCount: number\n ): Promise<Flame[]>;\n\n /**\n * Check if the renderer is available and ready.\n * @returns true if renderer is ready to accept frames\n */\n isReady(): boolean;\n}\n\n/**\n * Configuration for AnimationHandler.\n * @internal\n */\nexport interface AnimationHandlerConfig {\n /**\n * Number of transition frames when starting animation.\n * Default: 8 (~320ms at 25fps)\n */\n transitionStartFrameCount?: number;\n\n /**\n * Number of transition frames when ending animation.\n * Default: 12 (~480ms at 25fps)\n */\n transitionEndFrameCount?: number;\n\n /**\n * Custom decoder function.\n * Uses built-in protobuf decoder if not provided.\n */\n decoder?: AnimationDecoder;\n\n /**\n * Callback when data stream stalls and fallback to idle is triggered.\n * Called when no animation frames received for 3 seconds during speaking session.\n */\n onStreamStalled?: () => void;\n\n /**\n * Enable jitter buffer for smoother playback.\n * When enabled, frames are buffered and rendered in sequence order at a steady 25fps,\n * absorbing network jitter and out-of-order delivery.\n * Default: true\n */\n enableJitterBuffer?: boolean;\n\n /**\n * Maximum delay (in ms) a frame can sit in the jitter buffer before being rendered.\n * Also controls how long to wait for a missing frame before skipping ahead.\n * Default: 80 (2 frames at 25fps)\n */\n maxBufferDelayMs?: number;\n}\n\n/**\n * Jitter buffer state machine.\n * @internal\n */\ntype BufferState = 'direct' | 'filling' | 'draining' | 'starved';\n\n/**\n * A frame held in the jitter buffer awaiting playback.\n * @internal\n */\ninterface BufferedFrame {\n flame: Flame;\n seq: number;\n receivedAt: number;\n}\n\n/**\n * AnimationHandler manages all animation playback and transition logic.\n *\n * @internal\n * This class is used internally by AvatarPlayer.\n * Applications should not instantiate this class directly.\n */\nexport class AnimationHandler {\n /** @internal */\n private renderer: AvatarRenderer;\n /** @internal */\n private decoder: AnimationDecoder;\n /** @internal */\n private config: Required<Omit<AnimationHandlerConfig, 'decoder' | 'onStreamStalled'>>;\n\n // Frame tracking\n /** @internal */\n private animationFrameCount = 0;\n /** @internal */\n private lastRenderedFrameSeq = -1;\n /** @internal */\n private renderedFrameCount = 0;\n\n // Transition state\n /** @internal */\n private isPlayingTransition = false;\n /** @internal */\n private isTransitioningToIdle = false;\n /** @internal */\n private transitionFrames: Flame[] = [];\n /** @internal */\n private transitionFrameIndex = 0;\n /** @internal */\n private transitionTimeoutId: ReturnType<typeof setTimeout> | null = null;\n\n // Guards against race conditions during async transition generation\n /** @internal */\n private isGeneratingStartTransition = false;\n /** @internal */\n private isGeneratingEndTransition = false;\n\n // Session-level flags to prevent duplicate handling\n // These are reset in resetTracking() for new sessions\n /** @internal */\n private hasHandledTransitionStart = false;\n /** @internal */\n private hasHandledTransitionEnd = false;\n\n // Watchdog for detecting stalled data stream\n /** @internal */\n private lastFrameReceivedTime = 0;\n /** @internal */\n private isInSession = false;\n /** @internal */\n private watchdogTimer: ReturnType<typeof setInterval> | null = null;\n /** @internal */\n private hasReportedStall = false;\n /** @internal */\n private static readonly STALL_TIMEOUT_MS = 3000;\n /** @internal */\n private onStreamStalledCallback: (() => void) | null = null;\n /** @internal */\n private isStalledFallback = false; // True when fallback to idle was triggered due to stall\n\n // Playback stats\n /** @internal */\n private playbackStatsTimer: ReturnType<typeof setInterval> | null = null;\n /** @internal */\n private playbackFrameCount = 0;\n /** @internal */\n private playbackFrameTimestamps: number[] = [];\n /** @internal */\n private playbackGapCount = 0;\n /** @internal */\n private playbackExpectedSeq = -1;\n\n // Jitter buffer\n /** @internal */\n private bufferState: BufferState = 'direct';\n /** @internal */\n private frameBuffer = new Map<number, BufferedFrame>();\n /** @internal */\n private bufferNextSeq = -1;\n /** @internal */\n private bufferDrainTimer: ReturnType<typeof setTimeout> | null = null;\n /** @internal */\n private bufferLastDrainTime = 0;\n /** @internal */\n private static readonly BUFFER_MAX_SIZE = 4;\n /** @internal */\n private static readonly BUFFER_INITIAL_FILL = 2;\n /** @internal */\n private static readonly BUFFER_FRAME_INTERVAL_MS = 40;\n\n /**\n * @internal\n */\n constructor(renderer: AvatarRenderer, config: AnimationHandlerConfig = {}) {\n this.renderer = renderer;\n this.decoder = config.decoder ?? decodeAnimationKeyframes;\n this.config = {\n transitionStartFrameCount: config.transitionStartFrameCount ?? 8,\n transitionEndFrameCount: config.transitionEndFrameCount ?? 12,\n enableJitterBuffer: config.enableJitterBuffer ?? true,\n maxBufferDelayMs: config.maxBufferDelayMs ?? 80,\n };\n this.onStreamStalledCallback = config.onStreamStalled ?? null;\n }\n\n /**\n * Handle animation data received from RTC provider.\n * @param protobufData - Raw protobuf bytes\n * @param frameSeq - Frame sequence number (optional)\n * @param isRecovered - Whether this frame was recovered via ALR\n * @internal\n */\n handleAnimationData(\n protobufData: ArrayBuffer,\n frameSeq?: number,\n isRecovered?: boolean\n ): void {\n // If we were in transition, stop it and play normal animation\n if (this.isPlayingTransition) {\n this.stopTransition();\n }\n\n // Update watchdog state\n const now = Date.now();\n if (this.hasReportedStall) {\n // Recovered from stall\n const stallDuration = now - this.lastFrameReceivedTime;\n logger.info('AnimationHandler', `Data stream resumed after ${stallDuration}ms stall`);\n this.hasReportedStall = false;\n }\n // If we were in stalled fallback, clear the flag (data has resumed, no transition needed)\n if (this.isStalledFallback) {\n logger.info('AnimationHandler', 'Resuming from stall fallback, rendering directly without transition');\n this.isStalledFallback = false;\n }\n this.lastFrameReceivedTime = now;\n\n this.animationFrameCount++;\n\n // Decode\n const keyframes = this.decoder(protobufData);\n if (!keyframes || keyframes.length === 0) {\n return;\n }\n\n // In lossy networks the transition packet may be delayed/lost.\n // Ensure session-level watchdog/stats still start on first valid playback frame.\n this.ensureSessionActive(frameSeq);\n\n // Jitter buffer path: insert into buffer instead of rendering directly\n if (this.config.enableJitterBuffer && frameSeq !== undefined) {\n this.bufferFrame(keyframes[0], frameSeq);\n return;\n }\n\n // Direct path (no buffer)\n // Check for out-of-order delivery\n if (frameSeq !== undefined && this.lastRenderedFrameSeq !== -1) {\n if (frameSeq < this.lastRenderedFrameSeq) {\n // Out-of-order frame - discard (already rendered a later frame)\n logger.warn(\n 'AnimationHandler',\n `OUT-OF-ORDER: seq=${frameSeq}, lastRendered=${this.lastRenderedFrameSeq}${isRecovered ? ' [RECOVERED]' : ''}, discarding`\n );\n return;\n } else if (frameSeq === this.lastRenderedFrameSeq) {\n // Duplicate frame - skip silently (expected when server sends redundant frames)\n return;\n } else if (frameSeq > this.lastRenderedFrameSeq + 1) {\n const gap = frameSeq - this.lastRenderedFrameSeq - 1;\n logger.warn(\n 'AnimationHandler',\n `GAP: ${gap} frame(s) between ${this.lastRenderedFrameSeq} and ${frameSeq}${isRecovered ? ' [RECOVERED]' : ''}`\n );\n }\n }\n\n if (frameSeq !== undefined) {\n this.lastRenderedFrameSeq = frameSeq;\n }\n\n // Render directly\n this.renderedFrameCount++;\n this.renderer.renderFrame(keyframes[0]);\n this.logRenderedFrame('direct', frameSeq, isRecovered);\n\n // Collect playback stats\n this.playbackFrameTimestamps.push(performance.now());\n this.playbackFrameCount++;\n if (frameSeq !== undefined) {\n if (this.playbackExpectedSeq >= 0 && frameSeq > this.playbackExpectedSeq) {\n this.playbackGapCount += frameSeq - this.playbackExpectedSeq;\n }\n this.playbackExpectedSeq = frameSeq + 1;\n }\n }\n\n /**\n * Handle transition packet - generate and play transition from idle to target.\n * Only starts transition on the first packet; subsequent packets are ignored while transitioning.\n * @param protobufData - Protobuf data containing target frame\n * @param frameCount - Number of transition frames (overrides config if provided)\n * @internal\n */\n async handleTransitionData(\n protobufData: ArrayBuffer,\n frameCount?: number\n ): Promise<void> {\n logger.info(\n 'AnimationHandler',\n `Start transition packet received (bytes=${protobufData.byteLength}, requestedFrames=${frameCount ?? this.config.transitionStartFrameCount}, hasHandledStart=${this.hasHandledTransitionStart}, isInSession=${this.isInSession}, isPlayingTransition=${this.isPlayingTransition}, isGeneratingStart=${this.isGeneratingStartTransition}, lastRenderedSeq=${this.lastRenderedFrameSeq}, bufferState=${this.bufferState}, buffered=${this.frameBuffer.size})`\n );\n\n // Ignore if we've already handled a transition start for this session\n if (this.hasHandledTransitionStart) {\n return;\n }\n // Ignore if already playing or generating a start transition\n if (this.isPlayingTransition && !this.isTransitioningToIdle) {\n return;\n }\n if (this.isGeneratingStartTransition) {\n return;\n }\n\n if (!this.renderer.isReady()) {\n logger.warn('AnimationHandler', 'Renderer not ready for transition');\n return;\n }\n\n // Once streaming playback has started, start-transition packets are stale.\n // Ignore them to avoid jumping back into transition and causing visual jitter.\n if (\n this.isInSession && (\n this.lastRenderedFrameSeq >= 0 ||\n this.frameBuffer.size > 0 ||\n this.bufferState !== 'direct'\n )\n ) {\n this.hasHandledTransitionStart = true;\n logger.warn(\n 'AnimationHandler',\n `Ignoring late transition packet after playback start (lastRenderedSeq=${this.lastRenderedFrameSeq}, bufferState=${this.bufferState}, buffered=${this.frameBuffer.size})`\n );\n return;\n }\n\n // Decode target frame\n const keyframes = this.decoder(protobufData);\n if (!keyframes || keyframes.length === 0) {\n logger.warn('AnimationHandler', 'No target keyframe in transition data');\n return;\n }\n\n // Mark that we've handled transition start for this session\n this.hasHandledTransitionStart = true;\n // Reset transition end flag since we're starting a new transition\n this.hasHandledTransitionEnd = false;\n\n // Start session and watchdog\n this.ensureSessionActive();\n\n const targetFrame = keyframes[0];\n const frames = frameCount ?? this.config.transitionStartFrameCount;\n logger.info('AnimationHandler', `Generating ${frames} transition frames to target`);\n\n // Set guard flag before async operation\n this.isGeneratingStartTransition = true;\n\n try {\n // Generate transition frames from idle to target\n const transitionFrames = await this.renderer.generateTransitionFromIdle(\n targetFrame,\n frames\n );\n logger.info('AnimationHandler', `Generated ${transitionFrames.length} transition frames`);\n\n // Start playing transition frames at 25fps\n this.isPlayingTransition = true;\n this.isTransitioningToIdle = false;\n this.transitionFrames = transitionFrames;\n this.transitionFrameIndex = 0;\n\n this.playTransitionFrame();\n } catch (error) {\n logger.error('AnimationHandler', 'Failed to generate transition:', error);\n // Fallback: render target directly\n this.renderer.renderFrame(targetFrame);\n this.logRenderedFrame('transition-fallback');\n } finally {\n this.isGeneratingStartTransition = false;\n }\n }\n\n /**\n * Handle transition end - generate and play reverse transition back to idle.\n * Only starts transition on the first packet; subsequent packets are ignored while transitioning.\n * @param protobufData - Protobuf data containing last animation frame\n * @param frameCount - Number of transition frames (overrides config if provided)\n * @internal\n */\n async handleTransitionToIdle(\n protobufData: ArrayBuffer,\n frameCount?: number\n ): Promise<void> {\n // Ignore if we've already handled a transition end for this session\n if (this.hasHandledTransitionEnd) {\n return;\n }\n // Ignore if already playing or generating an end transition\n if (this.isPlayingTransition && this.isTransitioningToIdle) {\n return;\n }\n if (this.isGeneratingEndTransition) {\n return;\n }\n\n if (!this.renderer.isReady()) {\n logger.warn('AnimationHandler', 'Renderer not ready for transition to idle');\n this.renderer.renderFrame(undefined, true);\n this.logRenderedFrame('idle');\n return;\n }\n\n // Decode last animation frame\n const keyframes = this.decoder(protobufData);\n if (!keyframes || keyframes.length === 0) {\n logger.warn('AnimationHandler', 'No last keyframe in transition end data, starting idle directly');\n this.renderer.renderFrame(undefined, true);\n this.logRenderedFrame('idle');\n return;\n }\n\n // Mark that we've handled transition end for this session\n this.hasHandledTransitionEnd = true;\n\n const lastFrame = keyframes[0];\n const frames = frameCount ?? this.config.transitionEndFrameCount;\n logger.info('AnimationHandler', `Generating ${frames} reverse transition frames to idle`);\n\n // Set guard flag before async operation\n this.isGeneratingEndTransition = true;\n\n try {\n // Generate transition frames from idle to last frame, then reverse\n const transitionFrames = await this.renderer.generateTransitionFromIdle(\n lastFrame,\n frames\n );\n logger.info('AnimationHandler', `Generated ${transitionFrames.length} transition frames, reversing for playback`);\n\n // Reverse frames to play from last animation frame back to idle\n const reversedFrames = transitionFrames.slice().reverse();\n\n // Start playing reversed transition at 25fps\n this.isPlayingTransition = true;\n this.isTransitioningToIdle = true;\n this.transitionFrames = reversedFrames;\n this.transitionFrameIndex = 0;\n\n this.playTransitionFrame();\n } catch (error) {\n logger.error('AnimationHandler', 'Failed to generate reverse transition:', error);\n this.renderer.renderFrame(undefined, true);\n this.logRenderedFrame('idle');\n } finally {\n this.isGeneratingEndTransition = false;\n }\n }\n\n /**\n * Start idle animation.\n * @internal\n */\n startIdle(): void {\n this.isInSession = false;\n this.hasReportedStall = false;\n this.renderer.renderFrame(undefined, true);\n this.logRenderedFrame('idle');\n }\n\n /**\n * Ensure session-level timers/stats are active.\n * @internal\n */\n private ensureSessionActive(frameSeq?: number): void {\n if (this.isInSession) {\n return;\n }\n\n this.isInSession = true;\n this.lastFrameReceivedTime = Date.now();\n this.hasReportedStall = false;\n this.startWatchdog();\n this.startPlaybackStats();\n\n if (frameSeq !== undefined) {\n logger.info('AnimationHandler', `Session started from animation frame seq=${frameSeq}`);\n }\n }\n\n /**\n * Reset animation frame tracking (call on session start).\n * @internal\n */\n resetTracking(): void {\n this.lastRenderedFrameSeq = -1;\n this.renderedFrameCount = 0;\n this.animationFrameCount = 0;\n // Reset session-level transition flags for new session\n this.hasHandledTransitionStart = false;\n this.hasHandledTransitionEnd = false;\n this.resetPlaybackStats();\n this.flushBuffer();\n logger.info('AnimationHandler', 'Frame tracking reset');\n }\n\n /**\n * Check if currently playing transition frames.\n * @internal\n */\n isInTransition(): boolean {\n return this.isPlayingTransition;\n }\n\n /**\n * Stop transition playback.\n * @internal\n */\n stopTransition(): void {\n if (\n this.isPlayingTransition ||\n this.isGeneratingStartTransition ||\n this.isGeneratingEndTransition\n ) {\n logger.info('AnimationHandler', 'Stopping transition playback');\n }\n this.isPlayingTransition = false;\n this.isTransitioningToIdle = false;\n this.isGeneratingStartTransition = false;\n this.isGeneratingEndTransition = false;\n // Note: We intentionally do NOT reset hasHandledTransitionStart/End here\n // Those are session-level flags, only reset in resetTracking()\n this.transitionFrames = [];\n this.transitionFrameIndex = 0;\n if (this.transitionTimeoutId !== null) {\n clearTimeout(this.transitionTimeoutId);\n this.transitionTimeoutId = null;\n }\n this.flushBuffer();\n }\n\n /**\n * Clean up resources.\n * @internal\n */\n dispose(): void {\n this.stopTransition();\n this.stopWatchdog();\n }\n\n /**\n * Start the watchdog timer to detect stalled data streams.\n * @internal\n */\n private startWatchdog(): void {\n if (this.watchdogTimer) {\n return; // Already running\n }\n\n this.watchdogTimer = setInterval(() => {\n if (!this.isInSession) {\n return;\n }\n\n // Don't check during transition playback (we're playing generated frames, not receiving)\n if (this.isPlayingTransition) {\n return;\n }\n\n const elapsed = Date.now() - this.lastFrameReceivedTime;\n if (elapsed > AnimationHandler.STALL_TIMEOUT_MS && !this.hasReportedStall) {\n logger.error(\n 'AnimationHandler',\n `Data stream stalled: no frames received for ${elapsed}ms, falling back to idle`\n );\n this.hasReportedStall = true;\n this.isStalledFallback = true;\n\n // Trigger fallback to idle\n this.startIdle();\n\n // Notify external listener\n if (this.onStreamStalledCallback) {\n try {\n this.onStreamStalledCallback();\n } catch (e) {\n logger.error('AnimationHandler', 'Error in onStreamStalled callback:', e);\n }\n }\n }\n }, 1000); // Check every 1 second\n }\n\n /**\n * Stop the watchdog timer.\n * @internal\n */\n private stopWatchdog(): void {\n if (this.watchdogTimer) {\n clearInterval(this.watchdogTimer);\n this.watchdogTimer = null;\n }\n this.hasReportedStall = false;\n this.isStalledFallback = false;\n this.stopPlaybackStats();\n }\n\n /**\n * Start the playback stats reporting timer.\n * @internal\n */\n private startPlaybackStats(): void {\n if (this.playbackStatsTimer) {\n return; // Already running\n }\n this.resetPlaybackStats();\n this.playbackStatsTimer = setInterval(() => {\n this.reportPlaybackStats();\n }, 1000);\n }\n\n /**\n * Stop the playback stats reporting timer.\n * @internal\n */\n private stopPlaybackStats(): void {\n if (this.playbackStatsTimer) {\n clearInterval(this.playbackStatsTimer);\n this.playbackStatsTimer = null;\n }\n this.resetPlaybackStats();\n }\n\n /**\n * Reset playback stats counters.\n * @internal\n */\n private resetPlaybackStats(): void {\n this.playbackFrameCount = 0;\n this.playbackFrameTimestamps = [];\n this.playbackGapCount = 0;\n this.playbackExpectedSeq = -1;\n }\n\n /**\n * Report playback stats (called every 1s by timer).\n * Logs FPS, frame loss rate, and playback jitter.\n * @internal\n */\n private reportPlaybackStats(): void {\n // Skip reporting during transitions (locally generated frames)\n if (this.isPlayingTransition) {\n this.resetPlaybackStats();\n return;\n }\n\n // Skip if no frames were rendered this interval\n if (this.playbackFrameCount === 0) {\n return;\n }\n\n const fps = this.playbackFrameCount;\n const totalExpected = this.playbackFrameCount + this.playbackGapCount;\n const lossRate = totalExpected > 0 ? (this.playbackGapCount / totalExpected) * 100 : 0;\n\n // Calculate jitter: std deviation of inter-frame intervals\n let jitter = 0;\n if (this.playbackFrameTimestamps.length >= 2) {\n const intervals: number[] = [];\n for (let i = 1; i < this.playbackFrameTimestamps.length; i++) {\n intervals.push(this.playbackFrameTimestamps[i] - this.playbackFrameTimestamps[i - 1]);\n }\n const mean = intervals.reduce((a, b) => a + b, 0) / intervals.length;\n const variance = intervals.reduce((sum, v) => sum + (v - mean) ** 2, 0) / intervals.length;\n jitter = Math.sqrt(variance);\n }\n\n logger.info(\n 'AnimationHandler',\n `Playback stats: fps=${fps}, lossRate=${lossRate.toFixed(1)}%, jitter=${jitter.toFixed(1)}ms`\n );\n\n // Reset counters for next interval\n this.playbackFrameCount = 0;\n this.playbackFrameTimestamps = [];\n this.playbackGapCount = 0;\n }\n\n // ── Jitter Buffer ──\n\n /**\n * Insert a decoded frame into the jitter buffer.\n * Handles dedup, enforces max size, and drives the buffer state machine.\n * @internal\n */\n private bufferFrame(flame: Flame, seq: number): void {\n // Never allow frames older than what we've already rendered.\n if (this.lastRenderedFrameSeq >= 0 && seq <= this.lastRenderedFrameSeq) {\n logger.warn(\n 'AnimationHandler',\n `Jitter buffer: dropping stale frame seq=${seq} (lastRendered=${this.lastRenderedFrameSeq})`\n );\n return;\n }\n\n // If we're already waiting for a newer sequence, this frame arrived too late.\n if (this.bufferNextSeq >= 0 && seq < this.bufferNextSeq) {\n logger.warn(\n 'AnimationHandler',\n `Jitter buffer: dropping late frame seq=${seq} (nextExpected=${this.bufferNextSeq})`\n );\n return;\n }\n\n // Dedup — server sends each frame twice for resilience\n if (this.frameBuffer.has(seq)) {\n return;\n }\n\n this.frameBuffer.set(seq, { flame, seq, receivedAt: performance.now() });\n\n // Enforce max buffer size — drop oldest when full\n if (this.frameBuffer.size > AnimationHandler.BUFFER_MAX_SIZE) {\n let oldestSeq = Infinity;\n for (const k of this.frameBuffer.keys()) {\n if (k < oldestSeq) oldestSeq = k;\n }\n this.frameBuffer.delete(oldestSeq);\n logger.warn(\n 'AnimationHandler',\n `Jitter buffer: overflow, dropping seq=${oldestSeq} (nextExpected=${this.bufferNextSeq})`\n );\n }\n\n // State machine transitions\n switch (this.bufferState) {\n case 'direct':\n this.bufferState = 'filling';\n if (this.bufferNextSeq < 0) {\n this.bufferNextSeq = seq;\n }\n logger.info('AnimationHandler', `Jitter buffer: filling (first frame seq=${seq})`);\n if (this.frameBuffer.size >= AnimationHandler.BUFFER_INITIAL_FILL) {\n this.startBufferDrain();\n }\n break;\n case 'filling':\n if (this.frameBuffer.size >= AnimationHandler.BUFFER_INITIAL_FILL) {\n this.startBufferDrain();\n }\n break;\n case 'starved':\n this.startBufferDrain();\n break;\n case 'draining':\n // Already draining, frame will be picked up by drain loop\n break;\n }\n }\n\n /**\n * Drop buffered frames that are now too old to ever be rendered in-order.\n * @internal\n */\n private dropStaleBufferedFrames(): void {\n if (this.frameBuffer.size === 0) {\n return;\n }\n\n const minAllowedSeq = Math.max(this.bufferNextSeq, this.lastRenderedFrameSeq + 1);\n if (minAllowedSeq < 0) {\n return;\n }\n\n let dropped = 0;\n for (const seq of Array.from(this.frameBuffer.keys())) {\n if (seq < minAllowedSeq) {\n this.frameBuffer.delete(seq);\n dropped++;\n }\n }\n\n if (dropped > 0) {\n logger.warn(\n 'AnimationHandler',\n `Jitter buffer: dropped ${dropped} stale frame(s) older than seq=${minAllowedSeq}`\n );\n }\n }\n\n /**\n * Find the lowest buffered sequence at or after minSeq.\n * @internal\n */\n private findLowestBufferedSeqAtOrAfter(minSeq: number): number | null {\n let candidate = Infinity;\n for (const seq of this.frameBuffer.keys()) {\n if (seq >= minSeq && seq < candidate) {\n candidate = seq;\n }\n }\n return candidate === Infinity ? null : candidate;\n }\n\n /**\n * Begin draining the buffer at 25fps.\n * @internal\n */\n private startBufferDrain(): void {\n this.bufferState = 'draining';\n if (this.bufferNextSeq < 0) {\n let minSeq = Infinity;\n for (const k of this.frameBuffer.keys()) {\n if (k < minSeq) minSeq = k;\n }\n this.bufferNextSeq = minSeq;\n }\n logger.info('AnimationHandler', `Jitter buffer: draining (${this.frameBuffer.size} frames buffered)`);\n this.bufferLastDrainTime = performance.now();\n this.drainBufferFrame();\n }\n\n /**\n * Drain one frame from the buffer and schedule the next drain.\n * Handles missing frames (skip-ahead after maxBufferDelayMs) and starvation.\n * @internal\n */\n private drainBufferFrame(): void {\n this.bufferDrainTimer = null;\n\n if (this.bufferState !== 'draining') {\n return;\n }\n\n this.dropStaleBufferedFrames();\n\n const frame = this.frameBuffer.get(this.bufferNextSeq);\n\n if (frame) {\n // Expected frame found — render it\n this.renderBufferedFrame(frame);\n this.frameBuffer.delete(this.bufferNextSeq);\n this.bufferNextSeq++;\n } else if (this.frameBuffer.size > 0) {\n // Expected frame missing — check if we should skip ahead to the next in-order frame.\n const nextSeq = this.findLowestBufferedSeqAtOrAfter(this.bufferNextSeq);\n\n if (nextSeq === null) {\n this.bufferState = 'starved';\n logger.warn('AnimationHandler', 'Jitter buffer: no in-order frames available, pausing drain');\n return;\n }\n\n const nextFrame = this.frameBuffer.get(nextSeq)!;\n const waitTime = performance.now() - nextFrame.receivedAt;\n\n if (waitTime > this.config.maxBufferDelayMs) {\n // Missing frame didn't arrive in time — skip ahead to the next available sequence.\n const gap = Math.max(0, nextSeq - this.bufferNextSeq);\n this.playbackGapCount += gap;\n logger.warn(\n 'AnimationHandler',\n `Jitter buffer: skipping ${gap} frame(s) from seq ${this.bufferNextSeq} to ${nextSeq} after ${waitTime.toFixed(1)}ms`\n );\n this.renderBufferedFrame(nextFrame);\n this.frameBuffer.delete(nextSeq);\n this.bufferNextSeq = nextSeq + 1;\n }\n // else: wait for the missing frame (render nothing this cycle)\n } else {\n // Buffer empty — starvation\n this.bufferState = 'starved';\n logger.warn('AnimationHandler', 'Jitter buffer: starved, pausing drain');\n return; // Don't schedule next drain\n }\n\n // Schedule next drain with drift correction\n const now = performance.now();\n const nextTarget = this.bufferLastDrainTime + AnimationHandler.BUFFER_FRAME_INTERVAL_MS;\n const delay = Math.max(0, nextTarget - now);\n this.bufferLastDrainTime = nextTarget;\n this.bufferDrainTimer = setTimeout(() => this.drainBufferFrame(), delay);\n }\n\n /**\n * Render a single frame from the buffer and collect playback stats.\n * @internal\n */\n private renderBufferedFrame(frame: BufferedFrame): void {\n if (this.lastRenderedFrameSeq >= 0 && frame.seq <= this.lastRenderedFrameSeq) {\n logger.warn(\n 'AnimationHandler',\n `Jitter buffer: refusing out-of-order render seq=${frame.seq} (lastRendered=${this.lastRenderedFrameSeq})`\n );\n return;\n }\n\n this.renderer.renderFrame(frame.flame);\n this.lastRenderedFrameSeq = frame.seq;\n this.renderedFrameCount++;\n this.logRenderedFrame('buffer', frame.seq);\n\n // Playback stats\n this.playbackFrameTimestamps.push(performance.now());\n this.playbackFrameCount++;\n }\n\n /**\n * Flush the jitter buffer, stop the drain loop, and revert to direct mode.\n * @internal\n */\n private flushBuffer(): void {\n this.frameBuffer.clear();\n this.bufferState = 'direct';\n this.bufferNextSeq = -1;\n this.bufferLastDrainTime = 0;\n if (this.bufferDrainTimer !== null) {\n clearTimeout(this.bufferDrainTimer);\n this.bufferDrainTimer = null;\n }\n }\n\n /**\n * Play a single transition frame and schedule the next one.\n * @internal\n */\n private playTransitionFrame(): void {\n if (\n !this.isPlayingTransition ||\n this.transitionFrameIndex >= this.transitionFrames.length\n ) {\n // Transition complete\n const wasTransitioningToIdle = this.isTransitioningToIdle;\n this.isPlayingTransition = false;\n this.isTransitioningToIdle = false;\n this.transitionFrames = [];\n this.transitionFrameIndex = 0;\n if (this.transitionTimeoutId !== null) {\n clearTimeout(this.transitionTimeoutId);\n this.transitionTimeoutId = null;\n }\n logger.info('AnimationHandler', 'Transition playback complete');\n\n // If transitioning to idle, start idle animation\n if (wasTransitioningToIdle) {\n logger.info('AnimationHandler', 'Starting idle animation after transition');\n this.renderer.renderFrame(undefined, true);\n this.logRenderedFrame('idle');\n }\n return;\n }\n\n if (!this.renderer.isReady()) {\n this.isPlayingTransition = false;\n this.isTransitioningToIdle = false;\n return;\n }\n\n const frame = this.transitionFrames[this.transitionFrameIndex];\n this.renderer.renderFrame(frame);\n this.logRenderedFrame('transition');\n this.transitionFrameIndex++;\n\n // Schedule next frame at 25fps (40ms)\n this.transitionTimeoutId = setTimeout(() => {\n if (this.isPlayingTransition) {\n this.playTransitionFrame();\n }\n }, 40);\n }\n\n /**\n * Emit a per-frame render log for debugging ordering issues.\n * @internal\n */\n private logRenderedFrame(\n source: 'direct' | 'buffer' | 'transition' | 'idle' | 'transition-fallback',\n seq?: number,\n isRecovered?: boolean\n ): void {\n logger.info(\n 'AnimationHandler',\n `Rendered frame: source=${source}, seq=${seq ?? 'n/a'}${isRecovered ? ' [RECOVERED]' : ''}`\n );\n }\n}\n"],"names":[],"mappings":"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"}
|
package/dist/index8.js
CHANGED