Add sounds list to new audio engine

packages/dev/core/src/AudioV2/abstractAudio/audioEngineV2.ts

@@ -1,6 +1,7 @@
 import type { Nullable } from "../../types";
 import type { IAudioParameterRampOptions } from "../audioParameter";
 import type { AbstractAudioNode, AbstractNamedAudioNode } from "./abstractAudioNode";
+import type { AbstractSound } from "./abstractSound";
 import type { AbstractSoundSource, ISoundSourceOptions } from "./abstractSoundSource";
 import type { AudioBus, IAudioBusOptions } from "./audioBus";
 import type { IMainAudioBusOptions, MainAudioBus } from "./mainAudioBus";
@@ -51,6 +52,7 @@ export type AudioEngineV2State = "closed" | "interrupted" | "running" | "suspend
 export abstract class AudioEngineV2 {
     /** Not owned, but all items should be in `_nodes` container, too, which is owned. */
     private readonly _mainBuses = new Set<MainAudioBus>();
+    private readonly _sounds = new Array<AbstractSound>();
 
     /** Owned top-level sound and bus nodes. */
     private readonly _nodes = new Set<AbstractNamedAudioNode>();
@@ -132,6 +134,13 @@ export abstract class AudioEngineV2 {
         this._parameterRampDuration = Math.max(0, value);
     }
 
+    /**
+     * The list of static and streaming sounds created by the audio engine.
+     */
+    public get sounds(): ReadonlyArray<AbstractSound> {
+        return this._sounds;
+    }
+
     /**
      * Creates a new audio bus.
      * @param name - The name of the audio bus.
@@ -213,6 +222,7 @@ export abstract class AudioEngineV2 {
 
         this._mainBuses.clear();
         this._nodes.clear();
+        this._sounds.length = 0;
 
         this._defaultMainBus = null;
     }
@@ -275,6 +285,19 @@ export abstract class AudioEngineV2 {
     protected _removeNode(node: AbstractNamedAudioNode): void {
         this._nodes.delete(node);
     }
+
+    protected _addSound(sound: AbstractSound): void {
+        this._sounds.push(sound);
+        this._addNode(sound);
+    }
+
+    protected _removeSound(sound: AbstractSound): void {
+        const index = this._sounds.indexOf(sound);
+        if (index !== -1) {
+            this._sounds.splice(index, 1);
+        }
+        this._removeNode(sound);
+    }
 }
 
 /**

packages/dev/core/src/AudioV2/webAudio/webAudioEngine.ts

@@ -1,6 +1,7 @@
 import { Observable } from "../../Misc/observable";
 import type { Nullable } from "../../types";
 import type { AbstractNamedAudioNode } from "../abstractAudio/abstractAudioNode";
+import type { AbstractSound } from "../abstractAudio/abstractSound";
 import type { AbstractSoundSource, ISoundSourceOptions } from "../abstractAudio/abstractSoundSource";
 import type { AudioBus, IAudioBusOptions } from "../abstractAudio/audioBus";
 import type { AudioEngineV2State, IAudioEngineV2Options } from "../abstractAudio/audioEngineV2";
@@ -413,6 +414,16 @@ export class _WebAudioEngine extends AudioEngineV2 {
         super._removeNode(node);
     }
 
+    /** @internal */
+    public override _addSound(sound: AbstractSound): void {
+        super._addSound(sound);
+    }
+
+    /** @internal */
+    public override _removeSound(sound: AbstractSound): void {
+        super._removeSound(sound);
+    }
+
     /** @internal */
     public _addUpdateObserver(callback: () => void): void {
         if (!this._updateObservable) {

packages/dev/core/src/AudioV2/webAudio/webAudioStaticSound.ts

@@ -90,7 +90,7 @@ export class _WebAudioStaticSound extends StaticSound implements IWebAudioSuperN
             this.play();
         }
 
-        this.engine._addNode(this);
+        this.engine._addSound(this);
     }
 
     /** @internal */
@@ -141,7 +141,7 @@ export class _WebAudioStaticSound extends StaticSound implements IWebAudioSuperN
 
         this._subGraph.dispose();
 
-        this.engine._removeNode(this);
+        this.engine._removeSound(this);
     }
 
     /** @internal */

packages/dev/core/src/AudioV2/webAudio/webAudioStreamingSound.ts

@@ -92,7 +92,7 @@ export class _WebAudioStreamingSound extends StreamingSound implements IWebAudio
             this.play(options);
         }
 
-        this.engine._addNode(this);
+        this.engine._addSound(this);
     }
 
     /** @internal */
@@ -127,7 +127,7 @@ export class _WebAudioStreamingSound extends StreamingSound implements IWebAudio
 
         this._subGraph.dispose();
 
-        this.engine._removeNode(this);
+        this.engine._removeSound(this);
     }
 
     /** @internal */

packages/tools/tests/test/audioV2/audioEngineV2.sounds.test.ts

@@ -0,0 +1,31 @@
+import { InitAudioV2Tests } from "./utils/audioV2.utils";
+
+import { expect, test } from "@playwright/test";
+
+InitAudioV2Tests();
+
+test.describe("AudioEngineV2 sounds", () => {
+    test("Sounds count should be 1 when sound is created", async ({ page }) => {
+        const soundCount = await page.evaluate(async () => {
+            const audioEngine = await AudioV2Test.CreateAudioEngineAsync();
+            await AudioV2Test.CreateSoundAsync(audioTestConfig.pulseTrainSoundFile, { spatialPosition: new BABYLON.Vector3(0, 0, -1) });
+
+            return audioEngine.sounds.length;
+        });
+
+        expect(soundCount).toBe(1);
+    });
+
+    test("Sounds count should be 0 when sound is disposed", async ({ page }) => {
+        const soundCount = await page.evaluate(async () => {
+            const audioEngine = await AudioV2Test.CreateAudioEngineAsync();
+            const sound = await AudioV2Test.CreateSoundAsync(audioTestConfig.pulseTrainSoundFile, { spatialPosition: new BABYLON.Vector3(0, 0, -1) });
+
+            sound.dispose();
+
+            return audioEngine.sounds.length;
+        });
+
+        expect(soundCount).toBe(0);
+    });
+});