new player option "volumeTransitionTime"

Author: chrisweb

src/library/audio.ts

@@ -9,6 +9,7 @@ export interface IAudioOptions {
     persistVolume: boolean;
     loadPlayerMode: string;
     addAudioElementsToDom: boolean;
+    volumeTransitionTime: number;
 }
 
 // https://developer.mozilla.org/en-US/docs/Web/API/AudioNode
@@ -534,7 +535,9 @@ export class PlayerAudio {
 
         if (this._audioNodes.gainNode instanceof GainNode) {
             const audioContext = await this.getAudioContext();
-            this._audioNodes.gainNode.gain.setTargetAtTime(gainValue, audioContext.currentTime, 0.1);
+            const timeConstantInMilliseconds = (!isNaN(this._options.volumeTransitionTime) && this._options.volumeTransitionTime > 0) ? this._options.volumeTransitionTime : 100
+            const timeConstantInSeconds = timeConstantInMilliseconds / 1000;
+            this._audioNodes.gainNode.gain.setTargetAtTime(gainValue, audioContext.currentTime, timeConstantInSeconds);
         }
 
     }

src/library/core.ts

@@ -29,6 +29,7 @@ export interface ICoreOptions {
     loadPlayerMode?: typePlayerMode;
     audioContext?: AudioContext;
     addAudioElementsToDom?: boolean;
+    volumeTransitionTime?: number;
 }
 
 export interface ISoundsQueueOptions {
@@ -112,6 +113,7 @@ export class PlayerCore {
             loadPlayerMode: PLAYER_MODE_AUDIO,
             audioContext: null,
             addAudioElementsToDom: false,
+            volumeTransitionTime: 100,
         };
 
         const options = Object.assign({}, defaultOptions, playerOptions);
@@ -158,6 +160,7 @@ export class PlayerCore {
             persistVolume: this._options.persistVolume,
             loadPlayerMode: this._options.loadPlayerMode,
             addAudioElementsToDom: this._options.addAudioElementsToDom,
+            volumeTransitionTime: this._options.volumeTransitionTime,
         };
 
         return audioOptions;
@@ -313,7 +316,9 @@ export class PlayerCore {
 
         if (currentSound !== null) {
 
-            if (!isNaN(currentSound.duration) && (soundPositionInSeconds > currentSound.duration)) {
+            // round duration up as numbers are not integers
+            // so sometimes it is a tiny bit above
+            if (!isNaN(currentSound.duration) && (soundPositionInSeconds >  Math.ceil(currentSound.duration))) {
                 console.warn('soundPositionInSeconds > sound duration')
             }
 
@@ -646,7 +651,9 @@ export class PlayerCore {
                     sound.sourceNode.start(0, sound.playTime);
                 } else {
                     if (sound.playTimeOffset > 0) {
-                        if (sound.playTimeOffset > sound.duration) {
+                        // round duration up as numbers are not integers
+                        // so sometimes it is a tiny bit above
+                        if (sound.playTimeOffset > Math.ceil(sound.duration)) {
                             console.warn('playTimeOffset > sound duration');
                         }
                         // if an offset is defined start playing at that position
@@ -675,7 +682,9 @@ export class PlayerCore {
             } else {
                 // if an offset is defined start playing at that position
                 if (sound.playTimeOffset > 0) {
-                    if (sound.playTimeOffset > sound.duration) {
+                    // round duration up as numbers are not integers
+                    // so sometimes it is a tiny bit above
+                    if (sound.playTimeOffset > Math.ceil(sound.duration)) {
                         console.warn('playTimeOffset > duration');
                     }
                     sound.audioElement.currentTime = sound.playTimeOffset;
@@ -1237,4 +1246,10 @@ export class PlayerCore {
 
     }
 
+    public getCurrentSound(): ISound {
+
+        return this._getSoundFromQueue({ whichSound: PlayerCore.CURRENT_SOUND });
+
+    }
+
 }