@fluex/fluexgl-dsp 0.4.7 → 0.4.8

package/README.md

@@ -30,14 +30,14 @@ import { DspPipeline, Channel, LoadAudioSource, AudioClip } from "@fluex/fluexgl
         pathToWorklet: "/data/fluexgl-dsp-processor.worklet"
     });
 
-    await pipeline.InitializeDpsPipeline();
+    await pipeline.initializeDpsPipeline();
 
-    const audioDevice = await pipeline.ResolveDefaultAudioOutputDevice();
+    const audioDevice = await pipeline.resolveDefaultAudioOutputDevice();
 
     if(!audioDevice) return;
 
-    const master = audioDevice.GetMasterChannel();
-    const context = audioDevice.GetContext();
+    const master = audioDevice.getMasterChannel();
+    const context = audioDevice.getContext();
 
     const audioSource = await LoadAudioSource("/music.mp3");
 
@@ -46,11 +46,11 @@ import { DspPipeline, Channel, LoadAudioSource, AudioClip } from "@fluex/fluexgl
     const audioClip = new AudioClip(audioSource);
     const channel = new Channel(context);
 
-    channel.Send(master);
-    audioClip.Send(channel);
+    channel.send(master);
+    audioClip.send(channel);
 
     button.addEventListener("click", function() {
-        audioClip.Play();
+        audioClip.play();
     });
 })();
 ```

package/lib/dist/console-codes.d.ts

@@ -19,7 +19,8 @@ export declare enum ErrorCodes {
     AUDIO_CLIP_ALREADY_ATTACHED = "ERROR:FLUEXGL-DSP@0018",
     AUDIO_CLIP_NOT_FOUND = "ERROR:FLUEXGL-DSP@0019",
     AUDIO_CLIP_PLAYER_NO_CONTEXT = "ERROR:FLUEXGL-DSP@0020",
-    PANNING_OUT_OF_RANGE = "ERROR:FLUEXGL-DSP@0021"
+    PANNING_OUT_OF_RANGE = "ERROR:FLUEXGL-DSP@0021",
+    PITCH_OUT_OF_RANGE = "ERROR:FLUEXGL-DSP@0022"
 }
 export declare enum WarningCodes {
     NO_DEFAULT_AUDIO_DEVICE_FOUND = "WARNING:FLUEXGL-DSP@0001"

package/lib/dist/console-codes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"console-codes.d.ts","sourceRoot":"","sources":["../src/console-codes.ts"],"names":[],"mappings":"AAAA,oBAAY,UAAU;IAClB,qBAAqB,2BAA2B;IAChD,kBAAkB,2BAA2B;IAC7C,sBAAsB,2BAA2B;IACjD,mBAAmB,2BAA2B;IAC9C,iCAAiC,2BAA2B;IAC5D,2BAA2B,2BAA2B;IACtD,sBAAsB,2BAA2B;IACjD,mCAAmC,2BAA2B;IAC9D,uBAAuB,2BAA2B;IAClD,gBAAgB,2BAA2B;IAC3C,wBAAwB,2BAA2B;IACnD,iBAAiB,2BAA2B;IAC5C,6BAA6B,2BAA2B;IACxD,uBAAuB,2BAA2B;IAClD,8BAA8B,2BAA2B;IACzD,sBAAsB,2BAA2B;IACjD,8BAA8B,2BAA2B;IACzD,2BAA2B,2BAA2B;IACtD,oBAAoB,2BAA2B;IAC/C,4BAA4B,2BAA2B;IACvD,oBAAoB,2BAA2B;CAClD;AAED,oBAAY,YAAY;IACpB,6BAA6B,6BAA6B;CAC7D;AAED,oBAAY,YAAY;CAEvB"}
+{"version":3,"file":"console-codes.d.ts","sourceRoot":"","sources":["../src/console-codes.ts"],"names":[],"mappings":"AAAA,oBAAY,UAAU;IAClB,qBAAqB,2BAA2B;IAChD,kBAAkB,2BAA2B;IAC7C,sBAAsB,2BAA2B;IACjD,mBAAmB,2BAA2B;IAC9C,iCAAiC,2BAA2B;IAC5D,2BAA2B,2BAA2B;IACtD,sBAAsB,2BAA2B;IACjD,mCAAmC,2BAA2B;IAC9D,uBAAuB,2BAA2B;IAClD,gBAAgB,2BAA2B;IAC3C,wBAAwB,2BAA2B;IACnD,iBAAiB,2BAA2B;IAC5C,6BAA6B,2BAA2B;IACxD,uBAAuB,2BAA2B;IAClD,8BAA8B,2BAA2B;IACzD,sBAAsB,2BAA2B;IACjD,8BAA8B,2BAA2B;IACzD,2BAA2B,2BAA2B;IACtD,oBAAoB,2BAA2B;IAC/C,4BAA4B,2BAA2B;IACvD,oBAAoB,2BAA2B;IAC/C,kBAAkB,2BAA2B;CAChD;AAED,oBAAY,YAAY;IACpB,6BAA6B,6BAA6B;CAC7D;AAED,oBAAY,YAAY;CAEvB"}

package/lib/dist/console-codes.js

@@ -21,6 +21,7 @@ export var ErrorCodes;
     ErrorCodes["AUDIO_CLIP_NOT_FOUND"] = "ERROR:FLUEXGL-DSP@0019";
     ErrorCodes["AUDIO_CLIP_PLAYER_NO_CONTEXT"] = "ERROR:FLUEXGL-DSP@0020";
     ErrorCodes["PANNING_OUT_OF_RANGE"] = "ERROR:FLUEXGL-DSP@0021";
+    ErrorCodes["PITCH_OUT_OF_RANGE"] = "ERROR:FLUEXGL-DSP@0022";
 })(ErrorCodes || (ErrorCodes = {}));
 export var WarningCodes;
 (function (WarningCodes) {

package/lib/dist/core/classes/AudioClip.d.ts

@@ -11,6 +11,9 @@ export declare class AudioClip {
     startTime: number;
     offsetAtStart: number;
     playbackRate: number;
+    pitch: number;
+    minPitchSemitones: number;
+    maxPitchSemitones: number;
     progressUpdateSpeed: number;
     gainNode: GainNode | null;
     stereoPannerNode: StereoPannerNode | null;
@@ -18,30 +21,36 @@ export declare class AudioClip {
     audioClipPlayer: AudioClipPlayer | null;
     private audioBufferSourceNodes;
     private maxAudioBufferSourceNodes;
+    private audioClipPlayers;
     private progressInterval;
     private events;
     constructor(data: AudioSourceData);
     private createBufferSource;
     private connectSourcesTo;
     private safeDisconnect;
+    private getOutputNodes;
     private rebuildNodeChain;
-    Initialize(audioClipPlayer: AudioClipPlayer): void;
-    Play(timestamp?: number, offset?: number): void | this | null;
-    Seek(seconds: number): void | this;
-    Stop(): AudioClip | null;
-    SetVolume(volume: number): AudioClip;
-    SetPanLevel(panLevel: number): AudioClip;
-    Loop(loop?: boolean): AudioClip;
-    SetMaxAudioBufferSourceNodes(value: number): AudioClip;
-    DisconnectAllAudioBufferSourceNodes(): boolean;
-    AddEventListener<K extends keyof AudioClipEventMap>(event: K, cb: AudioClipEventMap[K]): () => void;
-    Once<K extends keyof AudioClipEventMap>(event: K, cb: AudioClipEventMap[K]): () => void;
-    RemoveEventListener<K extends keyof AudioClipEventMap>(event: K, cb: AudioClipEventMap[K]): AudioClip;
-    ClearEventListeners(event?: keyof AudioClipEventMap): AudioClip;
-    GetChannelData(channel?: number): Float32Array;
-    Send(channel: Channel | Master): void;
-    Unsend(channel: Channel | Master): void;
-    SetPlaybackRateInSemitones(semitones: number): AudioClip;
+    initialize(audioClipPlayer: AudioClipPlayer): void;
+    play(timestamp?: number, offset?: number): void | this | null;
+    seek(seconds: number): void | this;
+    stop(): AudioClip | null;
+    setVolume(volume: number): AudioClip;
+    setPanLevel(panLevel: number): AudioClip;
+    setLoop(loop?: boolean): AudioClip;
+    setMaxAudioBufferSourceNodes(value: number): AudioClip;
+    disconnectAllAudioBufferSourceNodes(): boolean;
+    addEventListener<K extends keyof AudioClipEventMap>(event: K, cb: AudioClipEventMap[K]): () => void;
+    once<K extends keyof AudioClipEventMap>(event: K, cb: AudioClipEventMap[K]): () => void;
+    removeEventListener<K extends keyof AudioClipEventMap>(event: K, cb: AudioClipEventMap[K]): AudioClip;
+    clearEventListeners(event?: keyof AudioClipEventMap): AudioClip;
+    getChannelData(channel?: number): Float32Array;
+    send(channel: Channel | Master): void;
+    unsend(channel: Channel | Master): void;
+    detachFromAudioClipPlayer(audioClipPlayer: AudioClipPlayer): void;
+    setPitch(semitones: number): AudioClip;
+    resetPitch(): AudioClip;
+    /** @deprecated Use {@link setPitch} instead. */
+    setPlaybackRateInSemitones(semitones: number): AudioClip;
     get currentPlaybackTime(): number;
     get duration(): number;
     get volume(): number;

package/lib/dist/core/classes/AudioClip.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AudioClip.d.ts","sourceRoot":"","sources":["../../../src/core/classes/AudioClip.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,iBAAiB,EAAmB,eAAe,EAAE,MAAM,eAAe,CAAC;AAEpF,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAMlC,qBAAa,SAAS;IA4BC,IAAI,EAAE,eAAe;IA1BjC,EAAE,EAAE,MAAM,CAAQ;IAClB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAQ;IAE5B,IAAI,EAAE,OAAO,CAAS;IACtB,SAAS,EAAE,OAAO,CAAS;IAC3B,SAAS,EAAE,MAAM,CAAK;IACtB,aAAa,EAAE,MAAM,CAAK;IAC1B,YAAY,EAAE,MAAM,CAAK;IAEzB,mBAAmB,EAAE,MAAM,CAAM;IAEjC,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAAQ;IACjC,gBAAgB,EAAE,gBAAgB,GAAG,IAAI,CAAQ;IAEjD,OAAO,EAAE,YAAY,GAAG,IAAI,CAAQ;IACpC,eAAe,EAAE,eAAe,GAAG,IAAI,CAAQ;IAEtD,OAAO,CAAC,sBAAsB,CAA+B;IAC7D,OAAO,CAAC,yBAAyB,CAAa;IAE9C,OAAO,CAAC,gBAAgB,CAAoB;IAE5C,OAAO,CAAC,MAAM,CAEb;gBAEkB,IAAI,EAAE,eAAe;IAExC,OAAO,CAAC,kBAAkB;IAc1B,OAAO,CAAC,gBAAgB;IAOxB,OAAO,CAAC,cAAc;IAItB,OAAO,CAAC,gBAAgB;IAmBjB,UAAU,CAAC,eAAe,EAAE,eAAe;IAc3C,IAAI,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM;IAqExC,IAAI,CAAC,OAAO,EAAE,MAAM;IAsBpB,IAAI,IAAI,SAAS,GAAG,IAAI;IAkBxB,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS;IAUpC,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS;IAexC,IAAI,CAAC,IAAI,CAAC,EAAE,OAAO,GAAG,SAAS;IAU/B,4BAA4B,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS;IAatD,mCAAmC,IAAI,OAAO;IAc9C,gBAAgB,CAAC,CAAC,SAAS,MAAM,iBAAiB,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,EAAE,iBAAiB,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI;IAMnG,IAAI,CAAC,CAAC,SAAS,MAAM,iBAAiB,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,EAAE,iBAAiB,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI;IAYvF,mBAAmB,CAAC,CAAC,SAAS,MAAM,iBAAiB,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,EAAE,iBAAiB,CAAC,CAAC,CAAC,GAAG,SAAS;IAarG,mBAAmB,CAAC,KAAK,CAAC,EAAE,MAAM,iBAAiB,GAAG,SAAS;IAW/D,cAAc,CAAC,OAAO,GAAE,MAAU,GAAG,YAAY;IAIjD,IAAI,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM;IAW9B,MAAM,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM;IAWhC,0BAA0B,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS;IAe/D,IAAW,mBAAmB,IAAI,MAAM,CAIvC;IAED,IAAW,QAAQ,IAAI,MAAM,CAE5B;IAED,IAAW,MAAM,IAAI,MAAM,CAE1B;IAED,IAAW,aAAa,IAAI,MAAM,CAEjC;IAED,IAAW,iBAAiB,IAAI,MAAM,CAKrC;IAED,IAAW,UAAU,IAAI,MAAM,CAE9B;IAED,IAAW,gBAAgB,IAAI,MAAM,CAEpC;IAED,IAAW,UAAU,IAAI,MAAM,CAE9B;CACJ"}
+{"version":3,"file":"AudioClip.d.ts","sourceRoot":"","sources":["../../../src/core/classes/AudioClip.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,iBAAiB,EAA+C,eAAe,EAAE,MAAM,eAAe,CAAC;AAEhH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAQlC,qBAAa,SAAS;IAmCC,IAAI,EAAE,eAAe;IAjCjC,EAAE,EAAE,MAAM,CAAQ;IAClB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAQ;IAE5B,IAAI,EAAE,OAAO,CAAS;IACtB,SAAS,EAAE,OAAO,CAAS;IAC3B,SAAS,EAAE,MAAM,CAAK;IACtB,aAAa,EAAE,MAAM,CAAK;IAC1B,YAAY,EAAE,MAAM,CAAK;IACzB,KAAK,EAAE,MAAM,CAAK;IAElB,iBAAiB,EAAE,MAAM,CAAO;IAChC,iBAAiB,EAAE,MAAM,CAAM;IAE/B,mBAAmB,EAAE,MAAM,CAAM;IAEjC,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAAQ;IACjC,gBAAgB,EAAE,gBAAgB,GAAG,IAAI,CAAQ;IAEjD,OAAO,EAAE,YAAY,GAAG,IAAI,CAAQ;IACpC,eAAe,EAAE,eAAe,GAAG,IAAI,CAAQ;IAEtD,OAAO,CAAC,sBAAsB,CAA+B;IAC7D,OAAO,CAAC,yBAAyB,CAAa;IAC9C,OAAO,CAAC,gBAAgB,CAAyB;IAEjD,OAAO,CAAC,gBAAgB,CAAoB;IAE5C,OAAO,CAAC,MAAM,CAIb;IAED,YAAmB,IAAI,EAAE,eAAe,EAAK;IAE7C,OAAO,CAAC,kBAAkB;IAc1B,OAAO,CAAC,gBAAgB;IAOxB,OAAO,CAAC,cAAc;IAItB,OAAO,CAAC,cAAc;IAYtB,OAAO,CAAC,gBAAgB;IA0BjB,UAAU,CAAC,eAAe,EAAE,eAAe,QAqCjD;IAEM,IAAI,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,sBA2E9C;IAEM,IAAI,CAAC,OAAO,EAAE,MAAM,eAoB1B;IAEM,IAAI,IAAI,SAAS,GAAG,IAAI,CAgB9B;IAEM,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAQ1C;IAEM,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,CAa9C;IAEM,OAAO,CAAC,IAAI,CAAC,EAAE,OAAO,GAAG,SAAS,CAQxC;IAEM,4BAA4B,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAW5D;IAEM,mCAAmC,IAAI,OAAO,CAYpD;IAEM,gBAAgB,CAAC,CAAC,SAAS,MAAM,iBAAiB,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,EAAE,iBAAiB,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI,CAIzG;IAEM,IAAI,CAAC,CAAC,SAAS,MAAM,iBAAiB,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,EAAE,iBAAiB,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI,CAU7F;IAEM,mBAAmB,CAAC,CAAC,SAAS,MAAM,iBAAiB,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,EAAE,iBAAiB,CAAC,CAAC,CAAC,GAAG,SAAS,CAW3G;IAEM,mBAAmB,CAAC,KAAK,CAAC,EAAE,MAAM,iBAAiB,GAAG,SAAS,CASrE;IAEM,cAAc,CAAC,OAAO,GAAE,MAAU,GAAG,YAAY,CAEvD;IAEM,IAAI,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,QASpC;IAEM,MAAM,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,QAStC;IAEM,yBAAyB,CAAC,eAAe,EAAE,eAAe,GAAG,IAAI,CAkBvE;IAEM,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,CAmB5C;IAEM,UAAU,IAAI,SAAS,CAE7B;IAED,gDAAgD;IACzC,0BAA0B,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,CAE9D;IAED,IAAW,mBAAmB,IAAI,MAAM,CAIvC;IAED,IAAW,QAAQ,IAAI,MAAM,CAE5B;IAED,IAAW,MAAM,IAAI,MAAM,CAE1B;IAED,IAAW,aAAa,IAAI,MAAM,CAEjC;IAED,IAAW,iBAAiB,IAAI,MAAM,CAGrC;IAED,IAAW,UAAU,IAAI,MAAM,CAE9B;IAED,IAAW,gBAAgB,IAAI,MAAM,CAEpC;IAED,IAAW,UAAU,IAAI,MAAM,CAE9B;CACJ"}

package/lib/dist/core/classes/AudioClip.js

@@ -12,6 +12,9 @@ export class AudioClip {
     startTime = 0;
     offsetAtStart = 0;
     playbackRate = 1;
+    pitch = 0;
+    minPitchSemitones = -24;
+    maxPitchSemitones = 24;
     progressUpdateSpeed = 20;
     gainNode = null;
     stereoPannerNode = null;
@@ -19,9 +22,12 @@ export class AudioClip {
     audioClipPlayer = null;
     audioBufferSourceNodes = [];
     maxAudioBufferSourceNodes = 1;
+    audioClipPlayers = [];
     progressInterval = 0;
     events = {
-        "progress": []
+        "progress": [],
+        "initialize": [],
+        "play": []
     };
     constructor(data) {
         this.data = data;
@@ -45,42 +51,74 @@ export class AudioClip {
     safeDisconnect(node) {
         node?.disconnect();
     }
+    getOutputNodes() {
+        const nodes = [];
+        for (const player of this.audioClipPlayers) {
+            if (player.outputGainNode && !nodes.includes(player.outputGainNode))
+                nodes.push(player.outputGainNode);
+        }
+        return nodes;
+    }
     rebuildNodeChain() {
-        if (!this.context || !this.gainNode || !this.stereoPannerNode || !this.audioClipPlayer || !this.audioClipPlayer.outputGainNode) {
-            Debug.Error("Failed to rebuild node chain, because some of the core AudioNodes are missing.");
+        if (!this.context || !this.gainNode || !this.stereoPannerNode) {
+            Debug.error("Failed to rebuild node chain, because some of the core AudioNodes are missing.");
+            return false;
+        }
+        const destinations = this.getOutputNodes();
+        if (destinations.length === 0) {
+            Debug.error("Failed to rebuild node chain, because no output destinations are available.");
             return false;
         }
-        const destination = this.audioClipPlayer.outputGainNode;
         this.safeDisconnect(this.gainNode);
         this.safeDisconnect(this.stereoPannerNode);
         this.gainNode.connect(this.stereoPannerNode);
-        this.stereoPannerNode.connect(destination);
+        for (const destination of destinations) {
+            this.stereoPannerNode.connect(destination);
+        }
         this.connectSourcesTo(this.gainNode);
         return true;
     }
-    Initialize(audioClipPlayer) {
+    initialize(audioClipPlayer) {
+        const startTimestamp = Date.now(), self = this;
         if (!audioClipPlayer.context)
-            return Debug.Error("Could not initialize AudioClip, because the AudioClipPlayer somehow has no audio context.", [
+            return Debug.error("Could not initialize AudioClip, because the AudioClipPlayer somehow has no audio context.", [
                 `AudioClipPlayer id: ${audioClipPlayer.id}`,
                 `AudioClip id: ${this.id}`
             ], ErrorCodes.AUDIO_CLIP_PLAYER_NO_CONTEXT);
+        if (this.context && this.context !== audioClipPlayer.context) {
+            return Debug.error("Could not initialize AudioClip, because the AudioClipPlayer does not share the same AudioContext.", [
+                `AudioClipPlayer id: ${audioClipPlayer.id}`,
+                `AudioClip id: ${this.id}`
+            ], ErrorCodes.AUDIO_CLIP_PLAYER_NO_CONTEXT);
+        }
         this.audioClipPlayer = audioClipPlayer;
         this.context = audioClipPlayer.context;
-        this.gainNode = new GainNode(this.context);
-        this.stereoPannerNode = new StereoPannerNode(this.context);
+        if (!this.gainNode)
+            this.gainNode = new GainNode(this.context);
+        if (!this.stereoPannerNode)
+            this.stereoPannerNode = new StereoPannerNode(this.context);
+        if (!this.audioClipPlayers.includes(audioClipPlayer))
+            this.audioClipPlayers.push(audioClipPlayer);
+        const endTimestamp = Date.now(), difference = endTimestamp - startTimestamp;
+        this.events.initialize.forEach(function (cb) {
+            cb({
+                durationOfInitialization: difference,
+                context: self.context
+            });
+        });
+        this.rebuildNodeChain();
     }
-    Play(timestamp, offset) {
+    play(timestamp, offset) {
         if (!this.context)
-            return Debug.Error("Could not play audio clip, because context (AudioContext) is undefined.", [
-                "Make sure to attach this AudioClip to an AudioClipPlayer instance, before calling .Play on this AudioClip."
+            return Debug.error("Could not play audio clip, because context (AudioContext) is undefined.", [
+                "Make sure to attach this AudioClip to an AudioClipPlayer instance, before calling .play on this AudioClip."
             ]);
-        const context = this.context;
-        const self = this;
+        const context = this.context, self = this;
         if (this.audioBufferSourceNodes.length > this.maxAudioBufferSourceNodes - 1)
             return null;
         const bufferSource = this.createBufferSource();
         if (!bufferSource) {
-            Debug.Error("Something went wrong.");
+            Debug.error("Something went wrong.");
             return null;
         }
         const actualOffset = offset ?? this.offsetAtStart ?? 0;
@@ -118,12 +156,19 @@ export class AudioClip {
         this.audioBufferSourceNodes.push(bufferSource);
         this.rebuildNodeChain();
         bufferSource.start(timestamp ?? this.startTime, actualOffset);
+        this.events.play.forEach(function (cb) {
+            cb({
+                timestamp: Date.now(),
+                audioBufferSourceNodes: self.audioBufferSourceNodes,
+                context: context,
+            });
+        });
         return this;
     }
-    Seek(seconds) {
+    seek(seconds) {
         if (!this.context)
-            return Debug.Error("Could not seek because the context (AudioContext) of this AudioClip is undefined.", [
-                `Make sure to attach this AudioClip to an AudioClipPlayer instance before calling .Seek on this AudioClip.`,
+            return Debug.error("Could not seek because the context (AudioContext) of this AudioClip is undefined.", [
+                `Make sure to attach this AudioClip to an AudioClipPlayer instance before calling .seek on this AudioClip.`,
                 `AudioClip id: ${this.id}`
             ]);
         const clamped = Math.max(0, Math.min(seconds, this.duration));
@@ -131,11 +176,11 @@ export class AudioClip {
             this.offsetAtStart = clamped;
             return this;
         }
-        this.Stop();
-        this.Play(undefined, clamped);
+        this.stop();
+        this.play(undefined, clamped);
         return this;
     }
-    Stop() {
+    stop() {
         this.audioBufferSourceNodes.forEach(function (node) {
             node.stop();
             node.disconnect();
@@ -148,37 +193,37 @@ export class AudioClip {
         }
         return this;
     }
-    SetVolume(volume) {
+    setVolume(volume) {
         if (!this.context)
-            Debug.Error("Could not set volume because the context (AudioContext) of this AudioClip is undefined.", [
-                "Make sure to attach this AudioClip to an AudioClipPlayer instance before calling .SetVolume() on this AudioClip.",
+            Debug.error("Could not set volume because the context (AudioContext) of this AudioClip is undefined.", [
+                "Make sure to attach this AudioClip to an AudioClipPlayer instance before calling .setVolume() on this AudioClip.",
             ], ErrorCodes.AUDIO_CLIP_PLAYER_NO_CONTEXT);
         this.gainNode?.gain.setValueAtTime(volume, this.context?.currentTime ?? 0);
         return this;
     }
-    SetPanLevel(panLevel) {
+    setPanLevel(panLevel) {
         if (!this.context)
-            Debug.Error("Could not set volume because the context (AudioContext) of this AudioClip is undefined.", [
-                "Make sure to attach this AudioClip to an AudioClipPlayer instance before calling .SetPanLevel() on this AudioClip.",
+            Debug.error("Could not set volume because the context (AudioContext) of this AudioClip is undefined.", [
+                "Make sure to attach this AudioClip to an AudioClipPlayer instance before calling .setPanLevel() on this AudioClip.",
             ], ErrorCodes.AUDIO_CLIP_PLAYER_NO_CONTEXT);
         if (panLevel < -1 || panLevel > 1)
-            Debug.Error("Could not set the pan level because it is not between -1 and 1.", [
+            Debug.error("Could not set the pan level because it is not between -1 and 1.", [
                 `Given value: ${panLevel}.`,
                 `Accepts a value between -1 and 1. Can be a floating number.`
             ], ErrorCodes.PANNING_OUT_OF_RANGE);
         this.stereoPannerNode?.pan.setValueAtTime(panLevel, this.context?.currentTime ?? 0);
         return this;
     }
-    Loop(loop) {
+    setLoop(loop) {
         this.audioBufferSourceNodes.forEach(function (node) {
             node.loop = loop ?? true;
         });
         this.loop = loop ?? true;
         return this;
     }
-    SetMaxAudioBufferSourceNodes(value) {
+    setMaxAudioBufferSourceNodes(value) {
         if (!DSP.overrideMaxAudioBufferNodes) {
-            Debug.Warn("Cannot set maxAudioBufferSourceNodes because the option to override the current maximum value is disabled.", [
+            Debug.warn("Cannot set maxAudioBufferSourceNodes because the option to override the current maximum value is disabled.", [
                 "Set overrideMaxAudioBufferNodes on DSP to true, in order to override the maximum audio buffer source nodes."
             ]);
             return this;
@@ -186,7 +231,7 @@ export class AudioClip {
         this.maxAudioBufferSourceNodes = value;
         return this;
     }
-    DisconnectAllAudioBufferSourceNodes() {
+    disconnectAllAudioBufferSourceNodes() {
         if (!this.context)
             return false;
         const contextCurrentTime = this.context?.currentTime;
@@ -196,19 +241,19 @@ export class AudioClip {
         });
         return true;
     }
-    AddEventListener(event, cb) {
+    addEventListener(event, cb) {
         this.events[event].push(cb);
-        return () => this.RemoveEventListener(event, cb);
+        return () => this.removeEventListener(event, cb);
     }
-    Once(event, cb) {
+    once(event, cb) {
         const wrapper = ((...args) => {
             // @ts-ignore
             cb(...args);
-            this.RemoveEventListener(event, wrapper);
+            this.removeEventListener(event, wrapper);
         });
-        return this.AddEventListener(event, wrapper);
+        return this.addEventListener(event, wrapper);
     }
-    RemoveEventListener(event, cb) {
+    removeEventListener(event, cb) {
         const arr = this.events[event];
         for (let i = 0; i < arr.length; i++) {
             if (arr[i] === cb) {
@@ -218,7 +263,7 @@ export class AudioClip {
         }
         return this;
     }
-    ClearEventListeners(event) {
+    clearEventListeners(event) {
         if (event) {
             this.events[event].length = 0;
         }
@@ -227,37 +272,65 @@ export class AudioClip {
         }
         return this;
     }
-    GetChannelData(channel = 0) {
+    getChannelData(channel = 0) {
         return this.data.audioBuffer.getChannelData(channel);
     }
-    Send(channel) {
+    send(channel) {
         if (!channel.audioClipPlayer)
-            return Debug.Error("Could not send AudioClip signal to channel, because the channel's AudioClipPlayer is undefined.", [
+            return Debug.error("Could not send AudioClip signal to channel, because the channel's AudioClipPlayer is undefined.", [
                 "Make sure to initialize the Channel.",
                 `Channel id: ${channel.id}.`,
                 `AudioClip id: ${this.id}.`
             ]);
-        channel.audioClipPlayer.AttachAudioClip(this);
+        channel.audioClipPlayer.attachAudioClip(this);
     }
-    Unsend(channel) {
+    unsend(channel) {
         if (!channel.audioClipPlayer)
-            return Debug.Error("Could not unsend AudioClip signal to channel, because the channel's AudioClipPlayer is undefined.", [
+            return Debug.error("Could not unsend AudioClip signal to channel, because the channel's AudioClipPlayer is undefined.", [
                 "Make sure to initialize the Channel.",
                 `Channel id: ${channel.id}.`,
                 `AudioClip id: ${this.id}.`
             ]);
-        channel.audioClipPlayer.DetachAudioClip(this);
+        channel.audioClipPlayer.detachAudioClip(this);
+    }
+    detachFromAudioClipPlayer(audioClipPlayer) {
+        const idx = this.audioClipPlayers.indexOf(audioClipPlayer);
+        if (idx === -1)
+            return;
+        this.audioClipPlayers.splice(idx, 1);
+        if (this.audioClipPlayer === audioClipPlayer) {
+            this.audioClipPlayer = this.audioClipPlayers[0] ?? null;
+        }
+        if (this.audioClipPlayers.length === 0) {
+            this.stop();
+            return;
+        }
+        this.rebuildNodeChain();
     }
-    SetPlaybackRateInSemitones(semitones) {
+    setPitch(semitones) {
         if (!this.context)
-            throw new Error("Could not set playback rate because the AudioContext is not defined.");
+            Debug.error("Could not set pitch because the context (AudioContext) of this AudioClip is undefined.", [
+                "Make sure to attach this AudioClip to an AudioClipPlayer instance before calling .setPitch() on this AudioClip.",
+            ], ErrorCodes.AUDIO_CLIP_PLAYER_NO_CONTEXT);
+        if (semitones < this.minPitchSemitones || semitones > this.maxPitchSemitones)
+            Debug.error("Could not set the pitch because it is not within the allowed semitone range.", [
+                `Given value: ${semitones}.`,
+                `Accepts a value between ${this.minPitchSemitones} and ${this.maxPitchSemitones} semitones.`
+            ], ErrorCodes.PITCH_OUT_OF_RANGE);
         const calculatedPlaybackRate = Math.pow(2, semitones / 12);
-        for (const buffer of this.audioBufferSourceNodes) {
-            buffer.playbackRate.setValueAtTime(calculatedPlaybackRate, this.context?.currentTime);
-        }
+        for (const buffer of this.audioBufferSourceNodes)
+            buffer.playbackRate.setValueAtTime(calculatedPlaybackRate, this.context?.currentTime ?? 0);
+        this.pitch = semitones;
         this.playbackRate = calculatedPlaybackRate;
         return this;
     }
+    resetPitch() {
+        return this.setPitch(0);
+    }
+    /** @deprecated Use {@link setPitch} instead. */
+    setPlaybackRateInSemitones(semitones) {
+        return this.setPitch(semitones);
+    }
     get currentPlaybackTime() {
         return (!this.isPlaying || !this.context)
             ? 0

package/lib/dist/core/classes/AudioClipPlayer.d.ts

@@ -9,14 +9,14 @@ export declare class AudioClipPlayer {
     context: AudioContext | null;
     channel: Channel | Master | null;
     constructor(context: AudioContext);
-    AttachAudioClip(audioClip: AudioClip): void;
-    DetachAudioClip(clip: AudioClip): void;
-    Send(channel: Channel | Master): void;
-    Unsend(): void;
-    SetVolume(value: number): void;
-    StopAll(): void;
-    Dispose(): void;
-    SetLabel(label: string): void;
+    attachAudioClip(audioClip: AudioClip): void;
+    detachAudioClip(clip: AudioClip): void;
+    send(channel: Channel | Master): void;
+    unsend(): void;
+    setVolume(value: number): void;
+    stopAll(): void;
+    dispose(): void;
+    setLabel(label: string): void;
     get length(): number;
     get volume(): number;
 }

package/lib/dist/core/classes/AudioClipPlayer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AudioClipPlayer.d.ts","sourceRoot":"","sources":["../../../src/core/classes/AudioClipPlayer.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAGlC,qBAAa,eAAe;IAEjB,KAAK,EAAE,MAAM,CAAqB;IAClC,EAAE,EAAE,MAAM,CAAQ;IAElB,UAAU,EAAE,SAAS,EAAE,CAAM;IAC7B,cAAc,EAAE,QAAQ,GAAG,IAAI,CAAQ;IAEvC,OAAO,EAAE,YAAY,GAAG,IAAI,CAAQ;IACpC,OAAO,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAAQ;gBAEnC,OAAO,EAAE,YAAY;IAK1B,eAAe,CAAC,SAAS,EAAE,SAAS,GAAG,IAAI;IAU3C,eAAe,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI;IAgBtC,IAAI,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI;IAUrC,MAAM,IAAI,IAAI;IAad,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAU9B,OAAO,IAAI,IAAI;IAOf,OAAO,IAAI,IAAI;IAYf,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAIpC,IAAW,MAAM,IAAI,MAAM,CAE1B;IAED,IAAW,MAAM,IAAI,MAAM,CAE1B;CACJ"}
+{"version":3,"file":"AudioClipPlayer.d.ts","sourceRoot":"","sources":["../../../src/core/classes/AudioClipPlayer.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAGlC,qBAAa,eAAe;IAEjB,KAAK,EAAE,MAAM,CAAqB;IAClC,EAAE,EAAE,MAAM,CAAQ;IAElB,UAAU,EAAE,SAAS,EAAE,CAAM;IAC7B,cAAc,EAAE,QAAQ,GAAG,IAAI,CAAQ;IAEvC,OAAO,EAAE,YAAY,GAAG,IAAI,CAAQ;IACpC,OAAO,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAAQ;IAE/C,YAAY,OAAO,EAAE,YAAY,EAGhC;IAEM,eAAe,CAAC,SAAS,EAAE,SAAS,GAAG,IAAI,CAQjD;IAEM,eAAe,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI,CAY5C;IAEM,IAAI,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAQ3C;IAEM,MAAM,IAAI,IAAI,CAWpB;IAEM,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAQpC;IAEM,OAAO,IAAI,IAAI,CAKrB;IAEM,OAAO,IAAI,IAAI,CAUrB;IAEM,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAEnC;IAED,IAAW,MAAM,IAAI,MAAM,CAE1B;IAED,IAAW,MAAM,IAAI,MAAM,CAE1B;CACJ"}

package/lib/dist/core/classes/AudioClipPlayer.js

@@ -12,34 +12,32 @@ export class AudioClipPlayer {
         this.context = context;
         this.outputGainNode = new GainNode(context);
     }
-    AttachAudioClip(audioClip) {
+    attachAudioClip(audioClip) {
         if (this.audioClips.includes(audioClip))
-            return Debug.Error("Could not attach audio clip because it is already part of this channel", [
-                "Call .DetachAudioClip([clip AudioClip]) before attaching audio clip."
+            return Debug.error("Could not attach audio clip because it is already part of this channel", [
+                "Call .detachAudioClip([clip AudioClip]) before attaching audio clip."
             ], ErrorCodes.AUDIO_CLIP_ALREADY_ATTACHED);
-        audioClip.Initialize(this);
+        audioClip.initialize(this);
         this.audioClips.push(audioClip);
     }
-    DetachAudioClip(clip) {
+    detachAudioClip(clip) {
         if (!this.audioClips.includes(clip))
-            return Debug.Error("Could not detach audio clip because it is not part of this channel", [
-                "Call .AttachAudioClip([clip AudioClip]) before detaching audio clip."
+            return Debug.error("Could not detach audio clip because it is not part of this channel", [
+                "Call .attachAudioClip([clip AudioClip]) before detaching audio clip."
             ], ErrorCodes.AUDIO_CLIP_NOT_FOUND);
-        clip.Stop();
-        const self = this;
-        this.audioClips.forEach(function (_clip, index) {
-            if (clip.id === _clip.id)
-                return self.audioClips.splice(index, 1);
-        });
+        const idx = this.audioClips.indexOf(clip);
+        if (idx >= 0)
+            this.audioClips.splice(idx, 1);
+        clip.detachFromAudioClipPlayer(this);
     }
-    Send(channel) {
+    send(channel) {
         if (!this.outputGainNode || !channel.input)
-            return Debug.Error("Could not send AudioClipPlayer signal to a channel/master.");
-        this.Unsend();
+            return Debug.error("Could not send AudioClipPlayer signal to a channel/master.");
+        this.unsend();
         this.channel = channel;
         this.outputGainNode.connect(channel.input);
     }
-    Unsend() {
+    unsend() {
         if (!this.outputGainNode)
             return;
         if (this.channel && this.channel.input) {
@@ -50,7 +48,7 @@ export class AudioClipPlayer {
         }
         this.channel = null;
     }
-    SetVolume(value) {
+    setVolume(value) {
         if (!this.outputGainNode)
             return;
         if (value < 0)
@@ -59,21 +57,21 @@ export class AudioClipPlayer {
             value = 1;
         this.outputGainNode.gain.value = value;
     }
-    StopAll() {
+    stopAll() {
         this.audioClips.forEach(function (clip) {
-            clip.Stop();
+            clip.stop();
         });
     }
-    Dispose() {
-        this.StopAll();
-        this.Unsend();
+    dispose() {
+        this.stopAll();
+        this.unsend();
         this.outputGainNode?.disconnect();
         this.audioClips = [];
         this.outputGainNode = null;
         this.channel = null;
         this.context = null;
     }
-    SetLabel(label) {
+    setLabel(label) {
         this.label = label;
     }
     get length() {

package/lib/dist/core/classes/AudioDevice.d.ts

@@ -7,11 +7,52 @@ export declare class AudioDevice {
     context: AudioContext;
     masterChannel: Master;
     masterChannels: Master[];
+    readonly sampleRate: number;
+    readonly baseLatency: number;
+    readonly outputLatency: number;
+    readonly state: AudioContextState;
+    readonly currentTime: number;
+    readonly maximumFrequency: number;
     constructor(deviceInfo: MediaDeviceInfo);
-    GetMasterChannel(): Master;
-    SetMasterChannel(channel: Master): void;
-    CreateMasterChannel(): Master;
-    GetContext(): AudioContext;
-    CreateChannel(label?: string): Channel;
+    /**
+     * Returns the master channel associated with this audio device.
+     * The master channel is the main output channel for this audio device, and is used to control the overall volume and other properties of the audio output.
+     * @returns
+     */
+    getMasterChannel(): Master;
+    /**
+     * Sets the master channel for this audio device.
+     * The master channel is normally automatically created when the audio device is initialized, but this method allows for the master channel to be changed if needed.
+     * @param channel
+     * @returns
+     */
+    setMasterChannel(channel: Master): void;
+    /**
+     * Creates a new master channel based on the this audio device's audio context, and adds it to the master channels array.
+     * Normally, an audio device should only have one master channel, but this method allows for multiple master channels to be created and used if needed.
+     * @returns
+     */
+    createMasterChannel(): Master;
+    /**
+     * Returns the audio context associated with this audio device.
+     * This method is provided for ease of use, and is a wrapper for the context property.
+     *
+     * The audio context can vary between audio devices, and is used to create channels and master channels that are associated with this audio device.
+     */
+    getContext(): AudioContext;
+    /**
+     * Creates a new channel based on the this audio device's audio context.
+     * This method is a wrapper for the Channel constructor, and is provided for ease of use.
+     * In case you want to create a channel with a different audio context, you can use the Channel constructor directly.
+     *
+     * @example
+     * ```
+     * const myChannel: Channel = audioDevice.createChannel("My Channel");
+     * ```
+     *
+     * @param label
+     * @returns
+     */
+    createChannel(label?: string): Channel;
 }
 //# sourceMappingURL=AudioDevice.d.ts.map

package/lib/dist/core/classes/AudioDevice.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AudioDevice.d.ts","sourceRoot":"","sources":["../../../src/core/classes/AudioDevice.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKpC,qBAAa,WAAW;IAUD,UAAU,EAAE,eAAe;IARvC,EAAE,EAAE,MAAM,CAAQ;IAClB,SAAS,EAAE,MAAM,CAAc;IAE/B,OAAO,EAAE,YAAY,CAAsB;IAE3C,aAAa,EAAE,MAAM,CAA4B;IACjD,cAAc,EAAE,MAAM,EAAE,CAAM;gBAElB,UAAU,EAAE,eAAe;IAEvC,gBAAgB,IAAI,MAAM;IAI1B,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAUvC,mBAAmB,IAAI,MAAM;IAQ7B,UAAU,IAAI,YAAY;IAI1B,aAAa,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO;CAGhD"}
+{"version":3,"file":"AudioDevice.d.ts","sourceRoot":"","sources":["../../../src/core/classes/AudioDevice.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKpC,qBAAa,WAAW;IAkBD,UAAU,EAAE,eAAe;IAhBvC,EAAE,EAAE,MAAM,CAAQ;IAClB,SAAS,EAAE,MAAM,CAAc;IAE/B,OAAO,EAAE,YAAY,CAAsB;IAE3C,aAAa,EAAE,MAAM,CAA4B;IACjD,cAAc,EAAE,MAAM,EAAE,CAAM;IAErC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAA2B;IACtD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAA4B;IACxD,QAAQ,CAAC,aAAa,EAAE,MAAM,CAA8B;IAC5D,QAAQ,CAAC,KAAK,EAAE,iBAAiB,CAAsB;IACvD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAA4B;IAExD,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAA+B;IAEhE,YAAmB,UAAU,EAAE,eAAe,EAAI;IAElD;;;;OAIG;IACI,gBAAgB,IAAI,MAAM,CAEhC;IAED;;;;;OAKG;IACI,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAQ7C;IAED;;;;OAIG;IACI,mBAAmB,IAAI,MAAM,CAMnC;IAED;;;;;OAKG;IACI,UAAU,IAAI,YAAY,CAEhC;IAED;;;;;;;;;;;;OAYG;IACI,aAAa,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAE5C;CACJ"}