fix: guard audio getVolume when volumeKeyframeBuilder is missing

src/components/canvas/players/audio-player.ts

@@ -12,7 +12,7 @@ export class AudioPlayer extends Player {
 	private audioResource: howler.Howl | null;
 	private isPlaying: boolean;
 
-	private volumeKeyframeBuilder!: KeyframeBuilder;
+	private volumeKeyframeBuilder: KeyframeBuilder | undefined;
 
 	private syncTimer: number;
 
@@ -45,8 +45,7 @@ export class AudioPlayer extends Player {
 		this.audioResource = audioResource;
 
 		// Create volume keyframes after timing is resolved (not in constructor)
-		const baseVolume = typeof audioClipConfiguration.volume === "number" ? audioClipConfiguration.volume : 1;
-		this.volumeKeyframeBuilder = new KeyframeBuilder(this.createVolumeKeyframes(audioClipConfiguration, baseVolume), this.getLength(), baseVolume);
+		this.rebuildVolumeKeyframeBuilder();
 
 		// Set initial volume immediately so the Howl never sits at the default of 1.0
 		this.audioResource.volume(this.getVolume());
@@ -115,6 +114,7 @@ export class AudioPlayer extends Player {
 			this.audioResource.unload();
 		}
 		this.audioResource = null;
+		this.volumeKeyframeBuilder = undefined;
 
 		super.dispose();
 	}
@@ -142,23 +142,26 @@ export class AudioPlayer extends Player {
 		}
 
 		this.audioResource = audioResource;
+		this.rebuildVolumeKeyframeBuilder();
 		this.audioResource.volume(this.getVolume());
 	}
 
 	public override reconfigureAfterRestore(): void {
 		super.reconfigureAfterRestore();
 
 		// Rebuild volume keyframes with updated timing
-		const audioAsset = this.clipConfiguration.asset as AudioAsset;
-		const baseVolume = typeof audioAsset.volume === "number" ? audioAsset.volume : 1;
-		this.volumeKeyframeBuilder = new KeyframeBuilder(this.createVolumeKeyframes(audioAsset, baseVolume), this.getLength(), baseVolume);
+		this.rebuildVolumeKeyframeBuilder();
 	}
 
 	public override getSize(): Size {
 		return { width: 0, height: 0 };
 	}
 
 	public getVolume(): number {
+		// A failed keyframe build can leave loaded audio available to the ticker.
+		if (!this.volumeKeyframeBuilder) {
+			return this.getBaseVolume();
+		}
 		return this.volumeKeyframeBuilder.getValue(this.getPlaybackTime());
 	}
 
@@ -173,6 +176,17 @@ export class AudioPlayer extends Player {
 		return Math.abs((this.audioResource.seek() as number) - this.getSourceTime());
 	}
 
+	private getBaseVolume(): number {
+		const audioAsset = this.clipConfiguration.asset as AudioAsset;
+		return typeof audioAsset.volume === "number" ? audioAsset.volume : 1;
+	}
+
+	private rebuildVolumeKeyframeBuilder(): void {
+		const audioAsset = this.clipConfiguration.asset as AudioAsset;
+		const baseVolume = this.getBaseVolume();
+		this.volumeKeyframeBuilder = new KeyframeBuilder(this.createVolumeKeyframes(audioAsset, baseVolume), this.getLength(), baseVolume);
+	}
+
 	private createVolumeKeyframes(asset: AudioAsset, baseVolume: number): Keyframe[] | number {
 		const { effect, volume } = asset;