@duyquangnvx/pixi-game-engine 0.1.6 → 0.1.7

package/dist/index.cjs

@@ -1327,111 +1327,252 @@ var SceneManager = class {
 
 // src/sound/sound-manager.ts
 var import_sound = require("@pixi/sound");
+var STORAGE_KEY = "sound_settings";
 var SoundManager = class {
   volumes = {
     master: 1,
     music: 1,
     sfx: 1
   };
+  _muted = false;
   currentMusic = null;
   currentMusicAlias = null;
-  playSfx(alias, options = {}) {
-    this.play(alias, options);
+  currentMusicInstance = null;
+  /** Track active SFX instances for pause/resume/stop */
+  activeSfx = /* @__PURE__ */ new Map();
+  /** Whether the AudioContext has been unlocked by user interaction */
+  _unlocked = false;
+  constructor() {
+    this.loadSettings();
+    this.setupUnlockListener();
   }
-  /** Play a sound effect */
-  play(alias, options = {}) {
+  // ─── AudioContext unlock ──────────────────────────────
+  /** 
+   * Browsers block audio until first user interaction.
+   * Call this early or let the auto-listener handle it. 
+   */
+  setupUnlockListener() {
+    const unlock = () => {
+      if (this._unlocked) return;
+      const ctx = import_sound.sound.context;
+      if (ctx.audioContext.state === "suspended") {
+        ctx.audioContext.resume().then(() => {
+          this._unlocked = true;
+          Logger.info("SoundManager", "AudioContext unlocked");
+        });
+      } else {
+        this._unlocked = true;
+      }
+      if (this._unlocked) {
+        document.removeEventListener("pointerdown", unlock);
+        document.removeEventListener("keydown", unlock);
+      }
+    };
+    document.addEventListener("pointerdown", unlock, { once: false });
+    document.addEventListener("keydown", unlock, { once: false });
+  }
+  get isUnlocked() {
+    return this._unlocked;
+  }
+  // ─── SFX ─────────────────────────────────────────────
+  /** Play a sound effect. Returns instance for fine-grained control. */
+  playSfx(alias, options = {}) {
     const snd = import_sound.sound.find(alias);
     if (!snd) {
       Logger.warn("SoundManager", `Sound "${alias}" not found`);
-      return;
+      return null;
     }
-    snd.play({
-      volume: (options.volume ?? 1) * this.volumes.master * this.volumes.sfx,
+    const effectiveVolume = (options.volume ?? 1) * this.volumes.master * this.volumes.sfx;
+    const instance = snd.play({
+      volume: options.fadeIn ? 0 : effectiveVolume,
       loop: options.loop ?? false,
       speed: options.speed ?? 1
     });
+    if (!this.activeSfx.has(alias)) {
+      this.activeSfx.set(alias, /* @__PURE__ */ new Set());
+    }
+    this.activeSfx.get(alias).add(instance);
+    instance.on("end", () => {
+      this.activeSfx.get(alias)?.delete(instance);
+    });
+    if (options.fadeIn && options.fadeIn > 0) {
+      this.fadeInstance(instance, 0, effectiveVolume, options.fadeIn);
+    }
+    return instance;
+  }
+  /** Stop a specific SFX by alias (all instances) */
+  stopSfx(alias, fadeOut) {
+    const instances = this.activeSfx.get(alias);
+    if (!instances) return;
+    for (const inst of instances) {
+      if (fadeOut && fadeOut > 0) {
+        this.fadeInstance(inst, inst.volume, 0, fadeOut, () => {
+          inst.stop();
+        });
+      } else {
+        inst.stop();
+      }
+    }
+    this.activeSfx.delete(alias);
   }
-  /** Play background music (only one at a time) */
+  // ─── Music ───────────────────────────────────────────
+  /** Play background music with optional crossfade */
   playMusic(alias, options = {}) {
-    if (this.currentMusicAlias !== alias) {
-      this.stopMusic();
-    }
+    if (this.currentMusicAlias === alias) return;
     const snd = import_sound.sound.find(alias);
     if (!snd) {
       Logger.warn("SoundManager", `Music "${alias}" not found`);
       return;
     }
-    this.currentMusic = snd;
-    this.currentMusicAlias = alias;
-    snd.play({
-      volume: (options.volume ?? 1) * this.volumes.master * this.volumes.music,
+    const crossfade = options.crossfadeDuration ?? 0;
+    const targetVolume = (options.volume ?? 1) * this.volumes.master * this.volumes.music;
+    if (this.currentMusicInstance && crossfade > 0) {
+      const oldInstance = this.currentMusicInstance;
+      this.fadeInstance(oldInstance, oldInstance.volume, 0, crossfade, () => {
+        oldInstance.stop();
+      });
+    } else {
+      this.stopMusic();
+    }
+    const instance = snd.play({
+      volume: crossfade > 0 ? 0 : targetVolume,
       loop: options.loop ?? true,
       speed: options.speed ?? 1
     });
-  }
-  /** Stop the current music */
-  stopMusic() {
-    if (this.currentMusic) {
-      this.currentMusic.stop();
-      this.currentMusic = null;
-      this.currentMusicAlias = null;
+    this.currentMusic = snd;
+    this.currentMusicAlias = alias;
+    this.currentMusicInstance = instance;
+    if (crossfade > 0) {
+      this.fadeInstance(instance, 0, targetVolume, crossfade);
     }
   }
-  /** Stop a specific sound */
-  stop(alias) {
-    const snd = import_sound.sound.find(alias);
-    if (snd) {
-      snd.stop();
+  stopMusic(fadeOut) {
+    if (!this.currentMusicInstance) return;
+    if (fadeOut && fadeOut > 0) {
+      const inst = this.currentMusicInstance;
+      this.fadeInstance(inst, inst.volume, 0, fadeOut, () => {
+        inst.stop();
+      });
+    } else {
+      this.currentMusicInstance.stop();
     }
-  }
-  /** Stop all sounds */
-  stopAll() {
-    import_sound.sound.stopAll();
     this.currentMusic = null;
     this.currentMusicAlias = null;
+    this.currentMusicInstance = null;
   }
-  /** Pause all sounds */
-  pauseAll() {
-    import_sound.sound.pauseAll();
+  get currentMusicName() {
+    return this.currentMusicAlias;
   }
-  /** Resume all sounds */
-  resumeAll() {
-    import_sound.sound.resumeAll();
+  /** Pause only music */
+  pauseMusic() {
+    this.currentMusicInstance?.set("paused", true);
+  }
+  /** Resume only music */
+  resumeMusic() {
+    this.currentMusicInstance?.set("paused", false);
   }
-  /** Set volume for a channel */
+  // ─── Volume ──────────────────────────────────────────
   setVolume(channel, value) {
     this.volumes[channel] = Math.max(0, Math.min(1, value));
-    this.updateMusicVolume();
+    this.applyVolumes();
+    this.saveSettings();
   }
-  /** Get volume for a channel */
   getVolume(channel) {
     return this.volumes[channel];
   }
-  updateMusicVolume() {
-    if (this.currentMusic) {
-      this.currentMusic.volume = this.volumes.master * this.volumes.music;
+  /** Re-apply volume to all active sounds after a channel change */
+  applyVolumes() {
+    if (this.currentMusicInstance) {
+      this.currentMusicInstance.volume = this.volumes.master * this.volumes.music;
+    }
+    for (const instances of this.activeSfx.values()) {
+      for (const inst of instances) {
+        inst.volume = this.volumes.master * this.volumes.sfx;
+      }
     }
   }
-  /** Mute all sounds */
+  // ─── Mute ────────────────────────────────────────────
   mute() {
+    this._muted = true;
     import_sound.sound.muteAll();
+    this.saveSettings();
   }
-  /** Unmute all sounds */
   unmute() {
+    this._muted = false;
     import_sound.sound.unmuteAll();
+    this.saveSettings();
   }
-  /** Toggle mute */
   toggleMute() {
-    import_sound.sound.toggleMuteAll();
-    return import_sound.sound.context.muted;
+    if (this._muted) this.unmute();
+    else this.mute();
+    return this._muted;
   }
-  /** Check if muted */
   get isMuted() {
-    return import_sound.sound.context.muted;
+    return this._muted;
   }
-  /** Clean up */
+  // ─── Global controls ─────────────────────────────────
+  stopAll() {
+    import_sound.sound.stopAll();
+    this.currentMusic = null;
+    this.currentMusicAlias = null;
+    this.currentMusicInstance = null;
+    this.activeSfx.clear();
+  }
+  pauseAll() {
+    import_sound.sound.pauseAll();
+  }
+  resumeAll() {
+    import_sound.sound.resumeAll();
+  }
+  // ─── Persistence ─────────────────────────────────────
+  saveSettings() {
+    try {
+      const data = {
+        volumes: this.volumes,
+        muted: this._muted
+      };
+      localStorage.setItem(STORAGE_KEY, JSON.stringify(data));
+    } catch {
+    }
+  }
+  loadSettings() {
+    try {
+      const raw = localStorage.getItem(STORAGE_KEY);
+      if (!raw) return;
+      const data = JSON.parse(raw);
+      if (data.volumes) {
+        this.volumes.master = data.volumes.master ?? 1;
+        this.volumes.music = data.volumes.music ?? 1;
+        this.volumes.sfx = data.volumes.sfx ?? 1;
+      }
+      if (data.muted) {
+        this._muted = true;
+        import_sound.sound.muteAll();
+      }
+    } catch {
+    }
+  }
+  // ─── Fade utility ────────────────────────────────────
+  fadeInstance(instance, from, to, duration, onComplete) {
+    const steps = 30;
+    const interval = duration * 1e3 / steps;
+    const delta = (to - from) / steps;
+    let step = 0;
+    const timer = setInterval(() => {
+      step++;
+      instance.volume = from + delta * step;
+      if (step >= steps) {
+        clearInterval(timer);
+        instance.volume = to;
+        onComplete?.();
+      }
+    }, interval);
+  }
+  // ─── Cleanup ─────────────────────────────────────────
   destroy() {
     this.stopAll();
+    document.removeEventListener("pointerdown", this.setupUnlockListener);
+    document.removeEventListener("keydown", this.setupUnlockListener);
   }
 };