@antha/audio 0.4.0 → 0.4.2

package/dist/audio-file.d.ts

@@ -241,6 +241,7 @@ export declare class AudioFile extends ListenTarget<AllAudioFileEvents> {
     readonly isDestroyed: boolean;
     readonly gainNode: GainNode;
     readonly sourceKey: string;
+    protected readonly activeBufferSources: Set<AudioBufferSourceNode>;
     constructor(params: AudioFileParams);
     /**
      * Load the audio file so it's ready to play. This will automatically be called on the first
@@ -257,6 +258,8 @@ export declare class AudioFile extends ListenTarget<AllAudioFileEvents> {
      *   if audio is currently disabled.
      */
     play(): Promise<boolean>;
+    /** Stops every active playback while preserving the loaded audio buffer. */
+    stop(): void;
     /** Destroys this audio file entirely; it cannot be used anymore. */
     destroy(): Promise<void>;
     /**

package/dist/audio-file.js

@@ -159,6 +159,7 @@ export class AudioFile extends ListenTarget {
     isDestroyed = false;
     gainNode;
     sourceKey;
+    activeBufferSources = new Set();
     constructor(params) {
         super();
         this.params = params;
@@ -231,7 +232,9 @@ export class AudioFile extends ListenTarget {
         const bufferSource = this.audioContext.createBufferSource();
         bufferSource.buffer = audioBuffer;
         bufferSource.connect(this.outputNode);
+        this.activeBufferSources.add(bufferSource);
         bufferSource.addEventListener('ended', () => {
+            this.activeBufferSources.delete(bufferSource);
             deferredPlayPromise.resolve(true);
             this.dispatch(new AudioFilePlayEndEvent());
         });
@@ -239,6 +242,14 @@ export class AudioFile extends ListenTarget {
         bufferSource.start();
         return deferredPlayPromise.promise;
     }
+    /** Stops every active playback while preserving the loaded audio buffer. */
+    stop() {
+        const activeBufferSources = [...this.activeBufferSources];
+        this.activeBufferSources.clear();
+        activeBufferSources.forEach((bufferSource) => {
+            bufferSource.stop();
+        });
+    }
     /** Destroys this audio file entirely; it cannot be used anymore. */
     async destroy() {
         if (this.isDestroyed) {
@@ -246,6 +257,7 @@ export class AudioFile extends ListenTarget {
             return;
         }
         makeWritable(this).isDestroyed = true;
+        this.stop();
         super.destroy();
         const cacheEntry = await this.audioCache[this.urlOrBase64];
         if (cacheEntry) {

package/dist/audio-player.d.ts

@@ -58,6 +58,12 @@ export declare class AudioPlayer extends ListenTarget<AllAudioFileEvents> {
     protected setupAudioFile(params: Readonly<AudioSetupParams>): AudioFile;
     /** Unloads all the attached files. */
     unloadFiles(files: ReadonlyArray<Readonly<AudioSetupParams>>): Promise<void>;
+    /** Stops all active playback for an already-loaded audio file. */
+    stopFile(file: Readonly<AudioSetupParams>): void;
+    /** Stops all active playback for the given already-loaded audio files. */
+    stopFiles(files: ReadonlyArray<Readonly<AudioSetupParams>>): void;
+    /** Stops all active playback without unloading any audio files. */
+    stopAllFiles(): void;
     /** Load a batch of audio files. */
     loadFiles(files: ReadonlyArray<Readonly<AudioSetupParams>>, options?: Readonly<PartialWithUndefined<{
         progressCallback: AudioLoadProgressCallback;

package/dist/audio-player.js

@@ -1,4 +1,4 @@
-import { awaitedBlockingMap, clamp, makeWritable, } from '@augment-vir/common';
+import { awaitedBlockingMap, clamp, getObjectTypedValues, makeWritable, } from '@augment-vir/common';
 import { ListenTarget } from 'typed-event-target';
 import { AudioFile, createAudioSourceKey, PlayingEnabledEvent, setupEffects, } from './audio-file.js';
 /**
@@ -72,6 +72,23 @@ export class AudioPlayer extends ListenTarget {
             delete this.audioFiles[sourceKey];
         }));
     }
+    /** Stops all active playback for an already-loaded audio file. */
+    stopFile(file) {
+        const sourceKey = createAudioSourceKey(file);
+        this.audioFiles[sourceKey]?.stop();
+    }
+    /** Stops all active playback for the given already-loaded audio files. */
+    stopFiles(files) {
+        files.forEach((file) => {
+            this.stopFile(file);
+        });
+    }
+    /** Stops all active playback without unloading any audio files. */
+    stopAllFiles() {
+        getObjectTypedValues(this.audioFiles).forEach((audioFile) => {
+            audioFile.stop();
+        });
+    }
     /** Load a batch of audio files. */
     async loadFiles(files, options = {}) {
         let loadedCount = 0;

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@antha/audio",
-    "version": "0.4.0",
+    "version": "0.4.2",
     "description": "An Antha mod for handling audio.",
     "keywords": [
         "vir",
@@ -37,7 +37,7 @@
         "@augment-vir/common": "^32.2.3"
     },
     "devDependencies": {
-        "@antha/engine": "^0.4.0",
+        "@antha/engine": "^0.4.2",
         "@augment-vir/test": "^32.2.3",
         "@web/dev-server-esbuild": "^2.0.0",
         "@web/test-runner": "^1.0.0",
@@ -46,7 +46,7 @@
         "typed-event-target": "^4.3.3"
     },
     "peerDependencies": {
-        "@antha/engine": "^0.4.0",
+        "@antha/engine": "^0.4.2",
         "element-vir": ">=26",
         "typed-event-target": ">=4.3"
     },