@adatechnology/game-audio 0.3.3 → 0.3.5

package/dist/index.js

@@ -986,6 +986,56 @@ function noiseBuffer(store, context, seconds) {
   return store.buffer;
 }
 
+// src/webaudio/engine-queue.ts
+var nowMs = () => typeof performance === "undefined" ? Date.now() : performance.now();
+function scheduleTask(task) {
+  if (typeof MessageChannel === "undefined") {
+    setTimeout(task, 0);
+    return;
+  }
+  const channel = new MessageChannel();
+  channel.port1.onmessage = () => {
+    channel.port1.close();
+    task();
+  };
+  channel.port2.postMessage(0);
+}
+function createStartQueue(options = {}) {
+  const budgetMs = options.budgetMs ?? 2;
+  const maxLatencyMs = options.maxLatencyMs ?? 250;
+  let jobs = [];
+  let scheduled = false;
+  const drain = () => {
+    scheduled = false;
+    const began = nowMs();
+    while (jobs.length > 0) {
+      const job = jobs.shift();
+      if (nowMs() - job.queuedAt > maxLatencyMs) job.drop();
+      else job.run();
+      if (nowMs() - began >= budgetMs) break;
+    }
+    if (jobs.length > 0) schedule();
+  };
+  const schedule = () => {
+    if (scheduled) return;
+    scheduled = true;
+    scheduleTask(drain);
+  };
+  return {
+    push(job) {
+      jobs.push({ ...job, queuedAt: nowMs() });
+      schedule();
+    },
+    clear() {
+      for (const job of jobs) job.drop();
+      jobs = [];
+    },
+    get size() {
+      return jobs.length;
+    }
+  };
+}
+
 // src/webaudio/realize-game.ts
 var end = (layer, start) => start + layer.duration + layer.tail;
 var firstFilter = (layer) => layer.filters?.bank[0];
@@ -1435,15 +1485,43 @@ function createAudioEngine(options = {}) {
     ...playOptions.params ? { params: playOptions.params } : {},
     ...options.occlusion && playOptions.position && recipe.falloff?.model !== "none" ? { occlusion: options.occlusion(playOptions.position) } : {}
   });
-  const start = (plan, store, voiceId, delay = 0) => {
+  const startQueue = options.deferredStart ? createStartQueue(options.deferredStart) : null;
+  const build = (plan, store, delay) => {
     const audio = context;
-    const realized = realize(plan, {
+    return realize(plan, {
       context: audio,
       output: outputFor(plan.bus),
       ...chain?.wet ? { wet: chain.wet } : {},
       noise: () => noiseBuffer(store, audio, mix.noise.seconds),
       time: audio.currentTime + delay
     });
+  };
+  const deferVoice = (plan, store, voiceId, delay) => {
+    let built = null;
+    let cancelled = false;
+    const pending = {
+      get sources() {
+        return built?.sources ?? [];
+      },
+      stop() {
+        cancelled = true;
+        built?.stop();
+      }
+    };
+    startQueue.push({
+      run() {
+        if (!cancelled && context) built = build(plan, store, delay);
+      },
+      drop() {
+        if (voiceId === void 0) return;
+        voices.release(voiceId);
+        active.delete(voiceId);
+      }
+    });
+    return pending;
+  };
+  const start = (plan, store, voiceId, delay = 0) => {
+    const realized = startQueue ? deferVoice(plan, store, voiceId, delay) : build(plan, store, delay);
     if (voiceId === void 0) return null;
     voices.setLength(voiceId, plan.length + delay);
     active.set(voiceId, realized);
@@ -1559,6 +1637,12 @@ function createAudioEngine(options = {}) {
       const audio = ready();
       if (audio) unlockContext(audio);
     },
+    warmUp() {
+      const audio = ready();
+      if (!audio) return false;
+      noiseBuffer(shared, audio, mix.noise.seconds);
+      return true;
+    },
     level(bus) {
       watched.add(bus);
       ensureBus(bus);
@@ -1582,6 +1666,7 @@ function createAudioEngine(options = {}) {
       };
     },
     dispose() {
+      startQueue?.clear();
       for (const id of active.keys()) voices.release(id);
       for (const loop of [...loops]) loop.stop();
       active.clear();