@babylonjs/core 7.51.3 → 7.52.1

package/AudioV2/abstractAudio/abstractSound.js

@@ -0,0 +1,202 @@
+import { Observable } from "../../Misc/observable.js";
+import { AbstractNamedAudioNode } from "./abstractAudioNode.js";
+import { _GetVolumeAudioProperty, _GetVolumeAudioSubNode } from "./subNodes/volumeAudioSubNode.js";
+/**
+ * Abstract class representing a sound in the audio engine.
+ */
+export class AbstractSound extends AbstractNamedAudioNode {
+    constructor(name, engine, options) {
+        super(name, engine, 3 /* AudioNodeType.HAS_INPUTS_AND_OUTPUTS */); // Inputs are for instances.
+        this._newestInstance = null;
+        this._outBus = null;
+        this._privateInstances = new Set();
+        this._state = 1 /* SoundState.Stopped */;
+        this._instances = this._privateInstances;
+        this._spatialAutoUpdate = true;
+        /**
+         * Observable for when the sound stops playing.
+         */
+        this.onEndedObservable = new Observable();
+        this._onInstanceEnded = (instance) => {
+            if (this._newestInstance === instance) {
+                this._newestInstance = null;
+            }
+            this._privateInstances.delete(instance);
+            if (this._instances.size === 0) {
+                this._state = 1 /* SoundState.Stopped */;
+                this.onEndedObservable.notifyObservers(this);
+            }
+        };
+        this._onOutBusDisposed = () => {
+            this.outBus = null;
+        };
+        if (typeof options.spatialAutoUpdate === "boolean") {
+            this._spatialAutoUpdate = options.spatialAutoUpdate;
+        }
+    }
+    /**
+     * Whether the sound should start playing automatically. Defaults to `false`.
+     */
+    get autoplay() {
+        return this._options.autoplay;
+    }
+    /**
+     * The current playback time of the sound, in seconds.
+     */
+    get currentTime() {
+        const instance = this._getNewestInstance();
+        return instance ? instance.currentTime : 0;
+    }
+    set currentTime(value) {
+        this.startOffset = value;
+        const instance = this._getNewestInstance();
+        if (instance) {
+            instance.currentTime = value;
+        }
+    }
+    /**
+     * Whether the sound should loop. Defaults to `false`.
+     */
+    get loop() {
+        return this._options.loop;
+    }
+    set loop(value) {
+        this._options.loop = value;
+    }
+    /**
+     * The maximum number of instances that can play at the same time. Defaults to `Infinity`.
+     */
+    get maxInstances() {
+        return this._options.maxInstances;
+    }
+    set maxInstances(value) {
+        this._options.maxInstances = value;
+    }
+    /**
+     * The output bus for the sound. Defaults to `null`.
+     * - If not set or `null`, the sound is automatically connected to the audio engine's default main bus.
+     * @see {@link AudioEngineV2.defaultMainBus}
+     */
+    get outBus() {
+        return this._outBus;
+    }
+    set outBus(outBus) {
+        if (this._outBus === outBus) {
+            return;
+        }
+        if (this._outBus) {
+            this._outBus.onDisposeObservable.removeCallback(this._onOutBusDisposed);
+            if (!this._disconnect(this._outBus)) {
+                throw new Error("Disconnect failed");
+            }
+        }
+        this._outBus = outBus;
+        if (this._outBus) {
+            this._outBus.onDisposeObservable.add(this._onOutBusDisposed);
+            if (!this._connect(this._outBus)) {
+                throw new Error("Connect failed");
+            }
+        }
+    }
+    /**
+     * The time within the sound buffer to start playing at, in seconds. Defaults to `0`.
+     */
+    get startOffset() {
+        return this._options.startOffset;
+    }
+    set startOffset(value) {
+        this._options.startOffset = value;
+    }
+    /**
+     * The state of the sound.
+     */
+    get state() {
+        return this._state;
+    }
+    /**
+     * The output volume of the sound.
+     */
+    get volume() {
+        return _GetVolumeAudioProperty(this._subGraph, "volume");
+    }
+    set volume(value) {
+        // The volume subnode is created on initialization and should always exist.
+        const node = _GetVolumeAudioSubNode(this._subGraph);
+        if (!node) {
+            throw new Error("No volume subnode");
+        }
+        node.volume = value;
+    }
+    /**
+     * Releases associated resources.
+     */
+    dispose() {
+        super.dispose();
+        this.stop();
+        this._newestInstance = null;
+        this._outBus = null;
+        this._privateInstances.clear();
+        this.onEndedObservable.clear();
+    }
+    /**
+     * Pauses the sound.
+     */
+    pause() {
+        const it = this._instances.values();
+        for (let next = it.next(); !next.done; next = it.next()) {
+            next.value.pause();
+        }
+        this._state = 5 /* SoundState.Paused */;
+    }
+    /**
+     * Resumes the sound.
+     */
+    resume() {
+        if (this._state !== 5 /* SoundState.Paused */) {
+            return;
+        }
+        const it = this._instances.values();
+        for (let next = it.next(); !next.done; next = it.next()) {
+            next.value.resume();
+        }
+        this._state = 3 /* SoundState.Started */;
+    }
+    _beforePlay(instance) {
+        if (this.state === 5 /* SoundState.Paused */ && this._instances.size > 0) {
+            this.resume();
+            return;
+        }
+        instance.onEndedObservable.addOnce(this._onInstanceEnded);
+        this._privateInstances.add(instance);
+        this._newestInstance = instance;
+    }
+    _afterPlay(instance) {
+        this._state = instance.state;
+    }
+    _setState(state) {
+        this._state = state;
+    }
+    _stopExcessInstances() {
+        if (this.maxInstances < Infinity) {
+            const numberOfInstancesToStop = Array.from(this._instances).filter((instance) => instance.state === 3 /* SoundState.Started */).length - this.maxInstances;
+            const it = this._instances.values();
+            for (let i = 0; i < numberOfInstancesToStop; i++) {
+                const instance = it.next().value;
+                instance.stop();
+            }
+        }
+    }
+    _getNewestInstance() {
+        if (this._instances.size === 0) {
+            return null;
+        }
+        if (!this._newestInstance) {
+            const it = this._instances.values();
+            for (let next = it.next(); !next.done; next = it.next()) {
+                this._newestInstance = next.value;
+            }
+        }
+        return this._newestInstance;
+    }
+}
+//# sourceMappingURL=abstractSound.js.map

package/AudioV2/abstractAudio/abstractSound.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"abstractSound.js","sourceRoot":"","sources":["../../../../../dev/core/src/AudioV2/abstractAudio/abstractSound.ts"],"names":[],"mappings":"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","sourcesContent":["import { Observable } from \"../../Misc/observable\";\nimport type { Nullable } from \"../../types\";\nimport { SoundState } from \"../soundState\";\nimport { AbstractNamedAudioNode, AudioNodeType } from \"./abstractAudioNode\";\nimport type { _AbstractSoundInstance } from \"./abstractSoundInstance\";\nimport type { PrimaryAudioBus } from \"./audioBus\";\nimport type { AudioEngineV2 } from \"./audioEngineV2\";\nimport type { _AbstractAudioSubGraph } from \"./subNodes/abstractAudioSubGraph\";\nimport type { IVolumeAudioOptions } from \"./subNodes/volumeAudioSubNode\";\nimport { _GetVolumeAudioProperty, _GetVolumeAudioSubNode } from \"./subNodes/volumeAudioSubNode\";\nimport type { AbstractSpatialAudio, ISpatialAudioOptions } from \"./subProperties/abstractSpatialAudio\";\nimport type { AbstractStereoAudio, IStereoAudioOptions } from \"./subProperties/abstractStereoAudio\";\n\n/** @internal */\nexport interface IAbstractSoundOptionsBase {\n    /**\n     * Whether the sound should start playing automatically. Defaults to `false`.\n     */\n    autoplay: boolean;\n    /**\n     * The maximum number of instances that can play at the same time. Defaults to `Infinity`.\n     */\n    maxInstances: number;\n}\n\n/** @internal */\nexport interface IAbstractSoundPlayOptionsBase {\n    /**\n     * Whether the sound should loop. Defaults to `false`.\n     */\n    loop: boolean;\n    /**\n     * The time within the sound buffer to start playing at, in seconds. Defaults to `0`.\n     */\n    startOffset: number;\n}\n\n/**\n * Options for creating a sound.\n */\nexport interface IAbstractSoundOptions extends IAbstractSoundOptionsBase, IAbstractSoundPlayOptions, ISpatialAudioOptions, IStereoAudioOptions {\n    /**\n     * The output bus for the sound. Defaults to `null`.\n     * - If not set or `null`, the sound is automatically connected to the audio engine's default main bus.\n     * @see {@link AudioEngineV2.defaultMainBus}\n     */\n    outBus: Nullable<PrimaryAudioBus>;\n}\n\n/**\n * Options for playing a sound.\n */\nexport interface IAbstractSoundPlayOptions extends IAbstractSoundPlayOptionsBase, IVolumeAudioOptions {}\n\n/**\n * Options stored in a sound.\n * @internal\n */\nexport interface IAbstractSoundStoredOptions extends IAbstractSoundOptionsBase, IAbstractSoundPlayOptionsBase {}\n\n/**\n * Abstract class representing a sound in the audio engine.\n */\nexport abstract class AbstractSound extends AbstractNamedAudioNode {\n    private _newestInstance: Nullable<_AbstractSoundInstance> = null;\n    private _outBus: Nullable<PrimaryAudioBus> = null;\n    private _privateInstances = new Set<_AbstractSoundInstance>();\n    private _state: SoundState = SoundState.Stopped;\n\n    protected _instances: ReadonlySet<_AbstractSoundInstance> = this._privateInstances;\n    protected abstract readonly _options: IAbstractSoundStoredOptions;\n    protected _spatialAutoUpdate: boolean = true;\n    protected abstract _subGraph: _AbstractAudioSubGraph;\n\n    /**\n     * Observable for when the sound stops playing.\n     */\n    public readonly onEndedObservable = new Observable<AbstractSound>();\n\n    protected constructor(name: string, engine: AudioEngineV2, options: Partial<IAbstractSoundOptions>) {\n        super(name, engine, AudioNodeType.HAS_INPUTS_AND_OUTPUTS); // Inputs are for instances.\n\n        if (typeof options.spatialAutoUpdate === \"boolean\") {\n            this._spatialAutoUpdate = options.spatialAutoUpdate;\n        }\n    }\n\n    /**\n     * Whether the sound should start playing automatically. Defaults to `false`.\n     */\n    public get autoplay(): boolean {\n        return this._options.autoplay;\n    }\n\n    /**\n     * The current playback time of the sound, in seconds.\n     */\n    public get currentTime(): number {\n        const instance = this._getNewestInstance();\n        return instance ? instance.currentTime : 0;\n    }\n\n    public set currentTime(value: number) {\n        this.startOffset = value;\n\n        const instance = this._getNewestInstance();\n        if (instance) {\n            instance.currentTime = value;\n        }\n    }\n\n    /**\n     * Whether the sound should loop. Defaults to `false`.\n     */\n    public get loop(): boolean {\n        return this._options.loop;\n    }\n\n    public set loop(value: boolean) {\n        this._options.loop = value;\n    }\n\n    /**\n     * The maximum number of instances that can play at the same time. Defaults to `Infinity`.\n     */\n    public get maxInstances(): number {\n        return this._options.maxInstances;\n    }\n\n    public set maxInstances(value: number) {\n        this._options.maxInstances = value;\n    }\n\n    /**\n     * The output bus for the sound. Defaults to `null`.\n     * - If not set or `null`, the sound is automatically connected to the audio engine's default main bus.\n     * @see {@link AudioEngineV2.defaultMainBus}\n     */\n    public get outBus(): Nullable<PrimaryAudioBus> {\n        return this._outBus;\n    }\n\n    public set outBus(outBus: Nullable<PrimaryAudioBus>) {\n        if (this._outBus === outBus) {\n            return;\n        }\n\n        if (this._outBus) {\n            this._outBus.onDisposeObservable.removeCallback(this._onOutBusDisposed);\n            if (!this._disconnect(this._outBus)) {\n                throw new Error(\"Disconnect failed\");\n            }\n        }\n\n        this._outBus = outBus;\n\n        if (this._outBus) {\n            this._outBus.onDisposeObservable.add(this._onOutBusDisposed);\n            if (!this._connect(this._outBus)) {\n                throw new Error(\"Connect failed\");\n            }\n        }\n    }\n\n    /**\n     * The spatial properties of the sound.\n     */\n    public abstract spatial: AbstractSpatialAudio;\n\n    /**\n     * The time within the sound buffer to start playing at, in seconds. Defaults to `0`.\n     */\n    public get startOffset(): number {\n        return this._options.startOffset;\n    }\n\n    public set startOffset(value: number) {\n        this._options.startOffset = value;\n    }\n\n    /**\n     * The state of the sound.\n     */\n    public get state(): SoundState {\n        return this._state;\n    }\n\n    /**\n     * The stereo properties of the sound.\n     */\n    public abstract stereo: AbstractStereoAudio;\n\n    /**\n     * The output volume of the sound.\n     */\n    public get volume(): number {\n        return _GetVolumeAudioProperty(this._subGraph, \"volume\");\n    }\n\n    public set volume(value: number) {\n        // The volume subnode is created on initialization and should always exist.\n        const node = _GetVolumeAudioSubNode(this._subGraph);\n        if (!node) {\n            throw new Error(\"No volume subnode\");\n        }\n\n        node.volume = value;\n    }\n\n    /**\n     * Releases associated resources.\n     */\n    public override dispose(): void {\n        super.dispose();\n\n        this.stop();\n\n        this._newestInstance = null;\n        this._outBus = null;\n\n        this._privateInstances.clear();\n        this.onEndedObservable.clear();\n    }\n\n    /**\n     * Plays the sound.\n     * - Triggers `onEndedObservable` if played for the full duration and the `loop` option is not set.\n     * @param options The options to use when playing the sound. Options set here override the sound's options.\n     */\n    public abstract play(options?: Partial<IAbstractSoundPlayOptions>): void;\n\n    /**\n     * Pauses the sound.\n     */\n    public pause(): void {\n        const it = this._instances.values();\n        for (let next = it.next(); !next.done; next = it.next()) {\n            next.value.pause();\n        }\n\n        this._state = SoundState.Paused;\n    }\n\n    /**\n     * Resumes the sound.\n     */\n    public resume(): void {\n        if (this._state !== SoundState.Paused) {\n            return;\n        }\n\n        const it = this._instances.values();\n        for (let next = it.next(); !next.done; next = it.next()) {\n            next.value.resume();\n        }\n\n        this._state = SoundState.Started;\n    }\n\n    /**\n     * Stops the sound.\n     * - Triggers `onEndedObservable` if the sound is playing.\n     */\n    public abstract stop(): void;\n\n    protected _beforePlay(instance: _AbstractSoundInstance): void {\n        if (this.state === SoundState.Paused && this._instances.size > 0) {\n            this.resume();\n            return;\n        }\n\n        instance.onEndedObservable.addOnce(this._onInstanceEnded);\n        this._privateInstances.add(instance);\n        this._newestInstance = instance;\n    }\n\n    protected _afterPlay(instance: _AbstractSoundInstance): void {\n        this._state = instance.state;\n    }\n\n    protected _setState(state: SoundState): void {\n        this._state = state;\n    }\n\n    protected abstract _createInstance(): _AbstractSoundInstance;\n\n    protected _stopExcessInstances(): void {\n        if (this.maxInstances < Infinity) {\n            const numberOfInstancesToStop = Array.from(this._instances).filter((instance) => instance.state === SoundState.Started).length - this.maxInstances;\n            const it = this._instances.values();\n\n            for (let i = 0; i < numberOfInstancesToStop; i++) {\n                const instance = it.next().value;\n                instance.stop();\n            }\n        }\n    }\n\n    private _getNewestInstance(): Nullable<_AbstractSoundInstance> {\n        if (this._instances.size === 0) {\n            return null;\n        }\n\n        if (!this._newestInstance) {\n            const it = this._instances.values();\n            for (let next = it.next(); !next.done; next = it.next()) {\n                this._newestInstance = next.value;\n            }\n        }\n\n        return this._newestInstance;\n    }\n\n    private _onInstanceEnded: (instance: _AbstractSoundInstance) => void = (instance) => {\n        if (this._newestInstance === instance) {\n            this._newestInstance = null;\n        }\n\n        this._privateInstances.delete(instance);\n\n        if (this._instances.size === 0) {\n            this._state = SoundState.Stopped;\n            this.onEndedObservable.notifyObservers(this);\n        }\n    };\n\n    private _onOutBusDisposed = () => {\n        this.outBus = null;\n    };\n}\n"]}

package/AudioV2/abstractAudio/abstractSoundInstance.d.ts

@@ -0,0 +1,34 @@
+import { Observable } from "../../Misc/observable";
+import { SoundState } from "../soundState";
+import { AbstractAudioNode } from "./abstractAudioNode";
+import type { AbstractSound, IAbstractSoundPlayOptions, IAbstractSoundPlayOptionsBase } from "./abstractSound";
+/**
+ * Options for creating a sound instance.
+ * @internal
+ * */
+export interface IAbstractSoundInstanceOptions extends IAbstractSoundPlayOptionsBase {
+}
+/** @internal */
+export declare abstract class _AbstractSoundInstance extends AbstractAudioNode {
+    protected _sound: AbstractSound;
+    protected _state: SoundState;
+    /** Observable triggered when the sound instance's playback ends */
+    readonly onEndedObservable: Observable<_AbstractSoundInstance>;
+    /** Observable triggered if the sound instance encounters an error and can not be played */
+    readonly onErrorObservable: Observable<any>;
+    /** Observable triggered when the sound instance's state changes */
+    readonly onStateChangedObservable: Observable<_AbstractSoundInstance>;
+    protected abstract readonly _options: IAbstractSoundInstanceOptions;
+    protected constructor(sound: AbstractSound);
+    abstract currentTime: number;
+    abstract readonly startTime: number;
+    /** The playback state of the sound instance */
+    get state(): SoundState;
+    /** @internal */
+    dispose(): void;
+    abstract play(options: Partial<IAbstractSoundPlayOptions>): void;
+    abstract pause(): void;
+    abstract resume(): void;
+    abstract stop(): void;
+    protected _setState(value: SoundState): void;
+}

package/AudioV2/abstractAudio/abstractSoundInstance.js

@@ -0,0 +1,35 @@
+import { Observable } from "../../Misc/observable.js";
+import { AbstractAudioNode } from "./abstractAudioNode.js";
+/** @internal */
+export class _AbstractSoundInstance extends AbstractAudioNode {
+    constructor(sound) {
+        super(sound.engine, 2 /* AudioNodeType.HAS_OUTPUTS */);
+        this._state = 1 /* SoundState.Stopped */;
+        /** Observable triggered when the sound instance's playback ends */
+        this.onEndedObservable = new Observable();
+        /** Observable triggered if the sound instance encounters an error and can not be played */
+        this.onErrorObservable = new Observable();
+        /** Observable triggered when the sound instance's state changes */
+        this.onStateChangedObservable = new Observable();
+        this._sound = sound;
+    }
+    /** The playback state of the sound instance */
+    get state() {
+        return this._state;
+    }
+    /** @internal */
+    dispose() {
+        super.dispose();
+        this.stop();
+        this.onEndedObservable.clear();
+        this.onStateChangedObservable.clear();
+    }
+    _setState(value) {
+        if (this._state === value) {
+            return;
+        }
+        this._state = value;
+        this.onStateChangedObservable.notifyObservers(this);
+    }
+}
+//# sourceMappingURL=abstractSoundInstance.js.map

package/AudioV2/abstractAudio/abstractSoundInstance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"abstractSoundInstance.js","sourceRoot":"","sources":["../../../../../dev/core/src/AudioV2/abstractAudio/abstractSoundInstance.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAEnD,OAAO,EAAE,iBAAiB,EAAiB,MAAM,qBAAqB,CAAC;AASvE,gBAAgB;AAChB,MAAM,OAAgB,sBAAuB,SAAQ,iBAAiB;IAelE,YAAsB,KAAoB;QACtC,KAAK,CAAC,KAAK,CAAC,MAAM,oCAA4B,CAAC;QAdzC,WAAM,8BAAkC;QAElD,mEAAmE;QACnD,sBAAiB,GAAG,IAAI,UAAU,EAA0B,CAAC;QAE7E,2FAA2F;QAC3E,sBAAiB,GAAG,IAAI,UAAU,EAAO,CAAC;QAE1D,mEAAmE;QACnD,6BAAwB,GAAG,IAAI,UAAU,EAA0B,CAAC;QAOhF,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;IACxB,CAAC;IAMD,+CAA+C;IAC/C,IAAW,KAAK;QACZ,OAAO,IAAI,CAAC,MAAM,CAAC;IACvB,CAAC;IAED,gBAAgB;IACA,OAAO;QACnB,KAAK,CAAC,OAAO,EAAE,CAAC;QAChB,IAAI,CAAC,IAAI,EAAE,CAAC;QACZ,IAAI,CAAC,iBAAiB,CAAC,KAAK,EAAE,CAAC;QAC/B,IAAI,CAAC,wBAAwB,CAAC,KAAK,EAAE,CAAC;IAC1C,CAAC;IAOS,SAAS,CAAC,KAAiB;QACjC,IAAI,IAAI,CAAC,MAAM,KAAK,KAAK,EAAE,CAAC;YACxB,OAAO;QACX,CAAC;QAED,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;QACpB,IAAI,CAAC,wBAAwB,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;IACxD,CAAC;CACJ","sourcesContent":["import { Observable } from \"../../Misc/observable\";\nimport { SoundState } from \"../soundState\";\nimport { AbstractAudioNode, AudioNodeType } from \"./abstractAudioNode\";\nimport type { AbstractSound, IAbstractSoundPlayOptions, IAbstractSoundPlayOptionsBase } from \"./abstractSound\";\n\n/**\n * Options for creating a sound instance.\n * @internal\n * */\nexport interface IAbstractSoundInstanceOptions extends IAbstractSoundPlayOptionsBase {}\n\n/** @internal */\nexport abstract class _AbstractSoundInstance extends AbstractAudioNode {\n    protected _sound: AbstractSound;\n    protected _state: SoundState = SoundState.Stopped;\n\n    /** Observable triggered when the sound instance's playback ends */\n    public readonly onEndedObservable = new Observable<_AbstractSoundInstance>();\n\n    /** Observable triggered if the sound instance encounters an error and can not be played */\n    public readonly onErrorObservable = new Observable<any>();\n\n    /** Observable triggered when the sound instance's state changes */\n    public readonly onStateChangedObservable = new Observable<_AbstractSoundInstance>();\n\n    protected abstract readonly _options: IAbstractSoundInstanceOptions;\n\n    protected constructor(sound: AbstractSound) {\n        super(sound.engine, AudioNodeType.HAS_OUTPUTS);\n\n        this._sound = sound;\n    }\n\n    public abstract currentTime: number;\n\n    public abstract readonly startTime: number;\n\n    /** The playback state of the sound instance */\n    public get state(): SoundState {\n        return this._state;\n    }\n\n    /** @internal */\n    public override dispose(): void {\n        super.dispose();\n        this.stop();\n        this.onEndedObservable.clear();\n        this.onStateChangedObservable.clear();\n    }\n\n    public abstract play(options: Partial<IAbstractSoundPlayOptions>): void;\n    public abstract pause(): void;\n    public abstract resume(): void;\n    public abstract stop(): void;\n\n    protected _setState(value: SoundState) {\n        if (this._state === value) {\n            return;\n        }\n\n        this._state = value;\n        this.onStateChangedObservable.notifyObservers(this);\n    }\n}\n"]}

package/AudioV2/abstractAudio/audioBus.d.ts

@@ -0,0 +1,48 @@
+import type { Nullable } from "../../types";
+import { AbstractAudioBus } from "./abstractAudioBus";
+import type { AudioEngineV2 } from "./audioEngineV2";
+import type { MainAudioBus } from "./mainAudioBus";
+import type { IVolumeAudioOptions } from "./subNodes/volumeAudioSubNode";
+import type { AbstractSpatialAudio, ISpatialAudioOptions } from "./subProperties/abstractSpatialAudio";
+import type { AbstractStereoAudio, IStereoAudioOptions } from "./subProperties/abstractStereoAudio";
+export type PrimaryAudioBus = MainAudioBus | AudioBus;
+/**
+ * Options for creating an audio bus.
+ */
+export interface IAudioBusOptions extends ISpatialAudioOptions, IStereoAudioOptions, IVolumeAudioOptions {
+    /**
+     * The output bus of the audio bus. Defaults to the audio engine's default main bus.
+     * @see {@link AudioEngineV2.defaultMainBus}
+     */
+    outBus: PrimaryAudioBus;
+}
+/**
+ * Abstract class for an audio bus that has spatial audio and stereo output capabilities.
+ *
+ * Instances of this class can be connected to other audio buses.
+ *
+ * Audio buses are created by the {@link CreateAudioBusAsync} function.
+ */
+export declare abstract class AudioBus extends AbstractAudioBus {
+    private _outBus;
+    protected _spatialAutoUpdate: boolean;
+    protected constructor(name: string, engine: AudioEngineV2, options: Partial<IAudioBusOptions>);
+    /**
+     * The output bus of the audio bus. Defaults to the audio engine's default main bus.
+     */
+    get outBus(): Nullable<PrimaryAudioBus>;
+    set outBus(outBus: Nullable<PrimaryAudioBus>);
+    /**
+     * The spatial audio properties of the audio bus.
+     */
+    abstract readonly spatial: AbstractSpatialAudio;
+    /**
+     * The stereo audio properties of the audio bus.
+     */
+    abstract readonly stereo: AbstractStereoAudio;
+    /**
+     * Releases associated resources.
+     */
+    dispose(): void;
+    private _onOutBusDisposed;
+}

package/AudioV2/abstractAudio/audioBus.js

@@ -0,0 +1,53 @@
+import { AbstractAudioBus } from "./abstractAudioBus.js";
+/**
+ * Abstract class for an audio bus that has spatial audio and stereo output capabilities.
+ *
+ * Instances of this class can be connected to other audio buses.
+ *
+ * Audio buses are created by the {@link CreateAudioBusAsync} function.
+ */
+export class AudioBus extends AbstractAudioBus {
+    constructor(name, engine, options) {
+        super(name, engine);
+        this._outBus = null;
+        this._spatialAutoUpdate = true;
+        this._onOutBusDisposed = () => {
+            this.outBus = this.engine.defaultMainBus;
+        };
+        if (typeof options.spatialAutoUpdate === "boolean") {
+            this._spatialAutoUpdate = options.spatialAutoUpdate;
+        }
+    }
+    /**
+     * The output bus of the audio bus. Defaults to the audio engine's default main bus.
+     */
+    get outBus() {
+        return this._outBus;
+    }
+    set outBus(outBus) {
+        if (this._outBus === outBus) {
+            return;
+        }
+        if (this._outBus) {
+            this._outBus.onDisposeObservable.removeCallback(this._onOutBusDisposed);
+            if (!this._disconnect(this._outBus)) {
+                throw new Error("Disconnect failed");
+            }
+        }
+        this._outBus = outBus;
+        if (this._outBus) {
+            this._outBus.onDisposeObservable.add(this._onOutBusDisposed);
+            if (!this._connect(this._outBus)) {
+                throw new Error("Connect failed");
+            }
+        }
+    }
+    /**
+     * Releases associated resources.
+     */
+    dispose() {
+        super.dispose();
+        this._outBus = null;
+    }
+}
+//# sourceMappingURL=audioBus.js.map

package/AudioV2/abstractAudio/audioBus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"audioBus.js","sourceRoot":"","sources":["../../../../../dev/core/src/AudioV2/abstractAudio/audioBus.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAqBtD;;;;;;GAMG;AACH,MAAM,OAAgB,QAAS,SAAQ,gBAAgB;IAKnD,YAAsB,IAAY,EAAE,MAAqB,EAAE,OAAkC;QACzF,KAAK,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QALhB,YAAO,GAA8B,IAAI,CAAC;QAExC,uBAAkB,GAAY,IAAI,CAAC;QA2DrC,sBAAiB,GAAG,GAAG,EAAE;YAC7B,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC;QAC7C,CAAC,CAAC;QAxDE,IAAI,OAAO,OAAO,CAAC,iBAAiB,KAAK,SAAS,EAAE,CAAC;YACjD,IAAI,CAAC,kBAAkB,GAAG,OAAO,CAAC,iBAAiB,CAAC;QACxD,CAAC;IACL,CAAC;IAED;;OAEG;IACH,IAAW,MAAM;QACb,OAAO,IAAI,CAAC,OAAO,CAAC;IACxB,CAAC;IAED,IAAW,MAAM,CAAC,MAAiC;QAC/C,IAAI,IAAI,CAAC,OAAO,KAAK,MAAM,EAAE,CAAC;YAC1B,OAAO;QACX,CAAC;QAED,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACf,IAAI,CAAC,OAAO,CAAC,mBAAmB,CAAC,cAAc,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;YAExE,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;gBAClC,MAAM,IAAI,KAAK,CAAC,mBAAmB,CAAC,CAAC;YACzC,CAAC;QACL,CAAC;QAED,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;QAEtB,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACf,IAAI,CAAC,OAAO,CAAC,mBAAmB,CAAC,GAAG,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;YAE7D,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;gBAC/B,MAAM,IAAI,KAAK,CAAC,gBAAgB,CAAC,CAAC;YACtC,CAAC;QACL,CAAC;IACL,CAAC;IAYD;;OAEG;IACa,OAAO;QACnB,KAAK,CAAC,OAAO,EAAE,CAAC;QAChB,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;IACxB,CAAC;CAKJ","sourcesContent":["import type { Nullable } from \"../../types\";\nimport { AbstractAudioBus } from \"./abstractAudioBus\";\nimport type { AudioEngineV2 } from \"./audioEngineV2\";\nimport type { MainAudioBus } from \"./mainAudioBus\";\nimport type { IVolumeAudioOptions } from \"./subNodes/volumeAudioSubNode\";\nimport type { AbstractSpatialAudio, ISpatialAudioOptions } from \"./subProperties/abstractSpatialAudio\";\nimport type { AbstractStereoAudio, IStereoAudioOptions } from \"./subProperties/abstractStereoAudio\";\n\n// NB: Secondary audio buses will be added later.\nexport type PrimaryAudioBus = MainAudioBus | AudioBus;\n\n/**\n * Options for creating an audio bus.\n */\nexport interface IAudioBusOptions extends ISpatialAudioOptions, IStereoAudioOptions, IVolumeAudioOptions {\n    /**\n     * The output bus of the audio bus. Defaults to the audio engine's default main bus.\n     * @see {@link AudioEngineV2.defaultMainBus}\n     */\n    outBus: PrimaryAudioBus;\n}\n\n/**\n * Abstract class for an audio bus that has spatial audio and stereo output capabilities.\n *\n * Instances of this class can be connected to other audio buses.\n *\n * Audio buses are created by the {@link CreateAudioBusAsync} function.\n */\nexport abstract class AudioBus extends AbstractAudioBus {\n    private _outBus: Nullable<PrimaryAudioBus> = null;\n\n    protected _spatialAutoUpdate: boolean = true;\n\n    protected constructor(name: string, engine: AudioEngineV2, options: Partial<IAudioBusOptions>) {\n        super(name, engine);\n\n        if (typeof options.spatialAutoUpdate === \"boolean\") {\n            this._spatialAutoUpdate = options.spatialAutoUpdate;\n        }\n    }\n\n    /**\n     * The output bus of the audio bus. Defaults to the audio engine's default main bus.\n     */\n    public get outBus(): Nullable<PrimaryAudioBus> {\n        return this._outBus;\n    }\n\n    public set outBus(outBus: Nullable<PrimaryAudioBus>) {\n        if (this._outBus === outBus) {\n            return;\n        }\n\n        if (this._outBus) {\n            this._outBus.onDisposeObservable.removeCallback(this._onOutBusDisposed);\n\n            if (!this._disconnect(this._outBus)) {\n                throw new Error(\"Disconnect failed\");\n            }\n        }\n\n        this._outBus = outBus;\n\n        if (this._outBus) {\n            this._outBus.onDisposeObservable.add(this._onOutBusDisposed);\n\n            if (!this._connect(this._outBus)) {\n                throw new Error(\"Connect failed\");\n            }\n        }\n    }\n\n    /**\n     * The spatial audio properties of the audio bus.\n     */\n    public abstract readonly spatial: AbstractSpatialAudio;\n\n    /**\n     * The stereo audio properties of the audio bus.\n     */\n    public abstract readonly stereo: AbstractStereoAudio;\n\n    /**\n     * Releases associated resources.\n     */\n    public override dispose(): void {\n        super.dispose();\n        this._outBus = null;\n    }\n\n    private _onOutBusDisposed = () => {\n        this.outBus = this.engine.defaultMainBus;\n    };\n}\n"]}

package/AudioV2/abstractAudio/audioEngineV2.d.ts

@@ -0,0 +1,193 @@
+import type { Nullable } from "../../types";
+import type { AbstractAudioNode, AbstractNamedAudioNode } from "./abstractAudioNode";
+import type { AudioBus, IAudioBusOptions } from "./audioBus";
+import type { IMainAudioBusOptions, MainAudioBus } from "./mainAudioBus";
+import type { IStaticSoundOptions, StaticSound } from "./staticSound";
+import type { IStaticSoundBufferOptions, StaticSoundBuffer } from "./staticSoundBuffer";
+import type { IStreamingSoundOptions, StreamingSound } from "./streamingSound";
+import type { AbstractSpatialAudioListener, ISpatialAudioListenerOptions } from "./subProperties/abstractSpatialAudioListener";
+/**
+ * Gets the most recently created v2 audio engine.
+ * @returns The most recently created v2 audio engine.
+ */
+export declare function LastCreatedAudioEngine(): Nullable<AudioEngineV2>;
+/**
+ * Options for creating a v2 audio engine.
+ */
+export interface IAudioEngineV2Options extends ISpatialAudioListenerOptions {
+    /**
+     * The initial output volume of the audio engine. Defaults to `1`.
+     */
+    volume: number;
+}
+/**
+ * The state of a v2 audio engine.
+ * @see {@link AudioEngineV2.state}
+ */
+export type AudioEngineV2State = "closed" | "interrupted" | "running" | "suspended";
+/**
+ * Abstract base class for v2 audio engines.
+ *
+ * A v2 audio engine based on the WebAudio API can be created with the {@link CreateAudioEngineAsync} function.
+ */
+export declare abstract class AudioEngineV2 {
+    /** Not owned, but all items should be in `_nodes` container, too, which is owned. */
+    private readonly _mainBuses;
+    /** Owned top-level sound and bus nodes. */
+    private readonly _nodes;
+    private _defaultMainBus;
+    protected _listenerAutoUpdate: boolean;
+    protected constructor(options: Partial<IAudioEngineV2Options>);
+    /**
+     * The elapsed time since the audio engine was started, in seconds.
+     */
+    abstract readonly currentTime: number;
+    /**
+     * The default main bus that will be used for audio buses and sounds if their `outBus` option is not set.
+     * @see {@link IAudioBusOptions.outBus}
+     * @see {@link IAbstractSoundOptions.outBus}
+     */
+    get defaultMainBus(): Nullable<MainAudioBus>;
+    /**
+     * The spatial audio listener properties for the audio engine.
+     * - Each audio engine has exactly one listener.
+     */
+    abstract readonly listener: AbstractSpatialAudioListener;
+    /**
+     * The main output node.
+     * - This is the last node in the audio graph before the audio is sent to the speakers.
+     */
+    abstract readonly mainOut: AbstractAudioNode;
+    /**
+     * The current state of the audio engine.
+     *
+     * Possible values are:
+     * - `"closed"`: The audio engine has been closed.
+     * - `"interrupted"`: The audio engine has been interrupted and is not running.
+     * - `"running"`: The audio engine is running normally.
+     * - `"suspended"`: The audio engine is suspended and is not running.
+     */
+    abstract readonly state: AudioEngineV2State;
+    /**
+     * The output volume of the audio engine.
+     */
+    abstract volume: number;
+    /**
+     * Creates a new audio bus.
+     * @param name - The name of the audio bus.
+     * @param options - The options to use when creating the audio bus.
+     * @param engine - The audio engine.
+     * @returns A promise that resolves with the created audio bus.
+     */
+    abstract createBusAsync(name: string, options?: Partial<IAudioBusOptions>): Promise<AudioBus>;
+    /**
+     * Creates a new main audio bus.
+     * @param name - The name of the main audio bus.
+     * @param options - The options to use when creating the main audio bus.
+     * @returns A promise that resolves with the created main audio bus.
+     */
+    abstract createMainBusAsync(name: string, options?: Partial<IMainAudioBusOptions>): Promise<MainAudioBus>;
+    /**
+     * Creates a new static sound.
+     * @param name - The name of the sound.
+     * @param source - The source of the sound.
+     * @param options - The options for the static sound.
+     * @returns A promise that resolves to the created static sound.
+     */
+    abstract createSoundAsync(name: string, source: ArrayBuffer | AudioBuffer | StaticSoundBuffer | string | string[], options?: Partial<IStaticSoundOptions>): Promise<StaticSound>;
+    /**
+     * Creates a new static sound buffer.
+     * @param source - The source of the sound buffer.
+     * @param options - The options for the static sound buffer.
+     * @param engine - The audio engine.
+     * @returns A promise that resolves to the created static sound buffer.
+     */
+    abstract createSoundBufferAsync(source: ArrayBuffer | AudioBuffer | StaticSoundBuffer | string | string[], options?: Partial<IStaticSoundBufferOptions>): Promise<StaticSoundBuffer>;
+    /**
+     * Creates a new streaming sound.
+     * @param name - The name of the sound.
+     * @param source - The source of the sound.
+     * @param options - The options for the streaming sound.
+     * @returns A promise that resolves to the created streaming sound.
+     */
+    abstract createStreamingSoundAsync(name: string, source: HTMLMediaElement | string | string[], options?: Partial<IStreamingSoundOptions>): Promise<StreamingSound>;
+    /**
+     * Releases associated resources.
+     */
+    dispose(): void;
+    /**
+     * Checks if the specified format is valid.
+     * @param format The format to check as an audio file extension like "mp3" or "wav".
+     * @returns `true` if the format is valid; otherwise `false`.
+     */
+    abstract isFormatValid(format: string): boolean;
+    /**
+     * Pauses the audio engine if it is running.
+     * @returns A promise that resolves when the audio engine is paused.
+     */
+    abstract pause(): Promise<void>;
+    /**
+     * Resumes the audio engine if it is not running.
+     * @returns A promise that resolves when the audio engine is running.
+     */
+    abstract resume(): Promise<void>;
+    /**
+     * Unlocks the audio engine if it is locked.
+     * - Note that the returned promise may already be resolved if the audio engine is already unlocked.
+     * @returns A promise that is resolved when the audio engine is unlocked.
+     */
+    unlock(): Promise<void>;
+    protected _addMainBus(mainBus: MainAudioBus): void;
+    protected _removeMainBus(mainBus: MainAudioBus): void;
+    protected _addNode(node: AbstractNamedAudioNode): void;
+    protected _removeNode(node: AbstractNamedAudioNode): void;
+}
+/**
+ * @internal
+ * @param engine - The given audio engine. If `null` then the last created audio engine is used.
+ * @returns the given audio engine or the last created audio engine.
+ * @throws An error if the resulting engine is `null`.
+ */
+export declare function _GetAudioEngine(engine: Nullable<AudioEngineV2>): AudioEngineV2;
+/**
+ * Creates a new audio bus.
+ * @param name - The name of the audio bus.
+ * @param options - The options to use when creating the audio bus.
+ * @param engine - The audio engine.
+ * @returns A promise that resolves with the created audio bus.
+ */
+export declare function CreateAudioBusAsync(name: string, options?: Partial<IAudioBusOptions>, engine?: Nullable<AudioEngineV2>): Promise<AudioBus>;
+/**
+ * Creates a new main audio bus.
+ * @param name - The name of the main audio bus.
+ * @param options - The options to use when creating the main audio bus.
+ * @param engine - The audio engine.
+ * @returns A promise that resolves with the created main audio bus.
+ */
+export declare function CreateMainAudioBusAsync(name: string, options?: Partial<IMainAudioBusOptions>, engine?: Nullable<AudioEngineV2>): Promise<MainAudioBus>;
+/**
+ * Creates a new static sound.
+ * @param name - The name of the sound.
+ * @param source - The source of the sound.
+ * @param options - The options for the static sound.
+ * @param engine - The audio engine.
+ * @returns A promise that resolves to the created static sound.
+ */
+export declare function CreateSoundAsync(name: string, source: ArrayBuffer | AudioBuffer | StaticSoundBuffer | string | string[], options?: Partial<IStaticSoundOptions>, engine?: Nullable<AudioEngineV2>): Promise<StaticSound>;
+/**
+ * Creates a new static sound buffer.
+ * @param source - The source of the sound buffer.
+ * @param options - The options for the static sound buffer.
+ * @param engine - The audio engine.
+ * @returns A promise that resolves to the created static sound buffer.
+ */
+export declare function CreateSoundBufferAsync(source: ArrayBuffer | AudioBuffer | StaticSoundBuffer | string | string[], options?: Partial<IStaticSoundBufferOptions>, engine?: Nullable<AudioEngineV2>): Promise<StaticSoundBuffer>;
+/**
+ * Creates a new streaming sound.
+ * @param name - The name of the sound.
+ * @param source - The source of the sound.
+ * @param options - The options for the streaming sound.
+ * @param engine - The audio engine.
+ * @returns A promise that resolves to the created streaming sound.
+ */
+export declare function CreateStreamingSoundAsync(name: string, source: HTMLMediaElement | string | string[], options?: Partial<IStreamingSoundOptions>, engine?: Nullable<AudioEngineV2>): Promise<StreamingSound>;