@motionscript/browser 0.0.0-stage → 0.1.0-alpha.10

package/dist/audio/player.js

@@ -0,0 +1,217 @@
+import { AudioSink } from "@motionscript/core";
+import { AudioBusGraph } from "./bus-graph";
+import { applyLoop, wrapIntoRegion } from "./loop-region";
+import { applySpeedToPlaybackRate, buildAudioEffectGraph, buildLevel, playbackOf, sourceOffsetOf } from "./effect-graph";
+/**
+ * Web Audio implementation of {@link AudioSink} — decodes and caches source
+ * buffers, then schedules/plays {@link AudioRequest}s as `AudioBufferSourceNode`s
+ * through a shared master gain (global mute and volume). `schedule` registers the
+ * active set of requests for the current frame; `syncTo` then starts/stops
+ * sources to match `clipTime`, so playback follows scrubbing and seeks.
+ */
+export class WebAudioSink extends AudioSink {
+    borrowed;
+    _context = null;
+    bufferCache = new Map();
+    decoding = new Map();
+    active = new Map();
+    scheduled = [];
+    disposed = false;
+    /** The master gain and the live bus chains (shared across every clip that names one), built with the context. */
+    _graph = null;
+    muted = false;
+    volume = 1;
+    constructor(context) {
+        super();
+        this.borrowed = context;
+    }
+    /**
+     * The context, created on first use rather than with the sink: a new
+     * AudioContext opens the audio device (50–65 ms on a desktop), and a
+     * session that never plays or decodes sound never needs one.
+     */
+    getContext() {
+        this._context ??= this.borrowed ?? new AudioContext();
+        return this._context;
+    }
+    get context() {
+        return this.getContext();
+    }
+    get graph() {
+        if (!this._graph) {
+            const master = this.context.createGain();
+            master.connect(this.context.destination);
+            this._graph = { master, buses: new AudioBusGraph(this.context, master) };
+            this.applyMasterGain();
+        }
+        return this._graph;
+    }
+    /**
+     * Resume the AudioContext. Must be called from within a user gesture
+     * (e.g. a click handler) the first time, or browsers keep the context
+     * suspended and no audio is heard.
+     */
+    unlock() {
+        if (this.context.state === "suspended") {
+            this.context.resume();
+        }
+    }
+    has(src) {
+        return this.bufferCache.has(src);
+    }
+    async append(src, data) {
+        if (this.bufferCache.has(src))
+            return;
+        const existing = this.decoding.get(src);
+        if (existing)
+            return existing;
+        // decodeAudioData detaches `data` — that's fine, the caller in
+        // AssetManager.fetchAudio discards its reference immediately after
+        // awaiting append. Skipping the defensive .slice(0) saves a multi-MB
+        // allocation per audio source.
+        const job = this.context.decodeAudioData(data).then((buffer) => {
+            this.bufferCache.set(src, buffer);
+        }).finally(() => {
+            this.decoding.delete(src);
+        });
+        this.decoding.set(src, job);
+        await job;
+    }
+    /** Drops cached buffers and stops active sources for srcs/requests no longer referenced — called when the asset set changes (e.g. seeking across scene boundaries). */
+    retain(keep) {
+        for (const src of [...this.bufferCache.keys()]) {
+            if (!keep.has(src))
+                this.bufferCache.delete(src);
+        }
+        for (const [id, active] of this.active) {
+            if (!keep.has(active.request.src))
+                this.stopSource(id, active);
+        }
+    }
+    /** Replaces the active request set; stops any currently-playing source whose request is no longer scheduled. Actual start/stop-to-match-time happens in `syncTo`. */
+    schedule(requests) {
+        const next = new Set(requests.map(r => r.id));
+        for (const [id, active] of this.active) {
+            if (!next.has(id))
+                this.stopSource(id, active);
+        }
+        this.scheduled = requests.slice();
+    }
+    /** Starts sources whose `[startAt, endAt)` window now contains `clipTime` (computing the correct buffer offset for the seek point) and stops any that have fallen outside it. */
+    syncTo(clipTime) {
+        const liveIds = new Set();
+        for (const req of this.scheduled) {
+            // `endAt` is `Infinity` for an open clip, so the comparison needs no
+            // nullish fallback — see AudioRequest.endAt.
+            const isInWindow = clipTime >= req.startAt && clipTime < req.endAt;
+            if (!isInWindow)
+                continue;
+            liveIds.add(req.id);
+            if (!this.active.has(req.id)) {
+                const buffer = this.bufferCache.get(req.src);
+                if (buffer)
+                    this.playBuffer(buffer, req, clipTime);
+            }
+        }
+        for (const [id, active] of this.active) {
+            if (!liveIds.has(id))
+                this.stopSource(id, active);
+        }
+    }
+    async play(time, _speed, _reverse) {
+        if (this.context.state === "suspended") {
+            await this.context.resume();
+        }
+        this.syncTo(time);
+    }
+    stop() {
+        for (const [id, active] of this.active) {
+            this.stopSource(id, active);
+        }
+        // A bus's curves are scheduled against the clock of the run that built
+        // it, so the next play, from wherever it lands, builds them again.
+        this._graph?.buses.dispose();
+    }
+    setMuted(muted) {
+        this.muted = muted;
+        this.applyMasterGain();
+    }
+    setVolume(volume) {
+        this.volume = Math.max(0, volume);
+        this.applyMasterGain();
+    }
+    /** Mute and volume are held separately so unmuting restores the set level. */
+    applyMasterGain() {
+        if (this._graph)
+            this._graph.master.gain.value = this.muted ? 0 : this.volume;
+    }
+    /** Starts a buffer source mid-clip if `clipTime` lands after the request's start — the offset accounts for the request's trim, the elapsed time since `startAt`, and its speed. */
+    playBuffer(buffer, req, clipTime) {
+        const startTime = this.context.currentTime;
+        const playback = playbackOf(req, buffer.duration);
+        const elapsed = Math.max(0, clipTime - req.startAt);
+        const source = this.context.createBufferSource();
+        source.buffer = buffer;
+        const loopRegion = applyLoop(source, req);
+        if (playback.rate !== 1)
+            source.playbackRate.value = playback.rate;
+        applySpeedToPlaybackRate(source.playbackRate, playback.speedRamp, playback.sourceLength, playback.clipDuration, startTime, elapsed);
+        const graph = buildAudioEffectGraph(this.context, source, req.effects ?? [], startTime, playback.clipDuration, elapsed);
+        const level = buildLevel(this.context, graph.output, req, playback, startTime, elapsed);
+        // Into this clip's bus chain, or straight to the master when it has none.
+        // The chain is shared: two clips on one bus reach the same nodes, which is
+        // what makes a bus effect one tail rather than one per clip.
+        level.output.connect(this.graph.buses.inputFor(req.bus, startTime, clipTime));
+        const audioOffset = req.trimStart + sourceOffsetOf(playback, elapsed);
+        source.start(startTime, wrapIntoRegion(loopRegion, audioOffset));
+        for (const osc of graph.oscillators)
+            osc.start(startTime);
+        source.onended = () => {
+            if (this.active.get(req.id)?.source === source) {
+                this.active.delete(req.id);
+            }
+        };
+        this.active.set(req.id, {
+            source,
+            request: req,
+            nodes: [...graph.nodes, ...level.nodes],
+            oscillators: graph.oscillators,
+        });
+    }
+    stopSource(id, active) {
+        try {
+            active.source.onended = null;
+            active.source.stop();
+            for (const osc of active.oscillators)
+                osc.stop();
+            active.source.disconnect();
+            for (const node of active.nodes)
+                node.disconnect();
+        }
+        catch {
+            // already stopped
+        }
+        this.active.delete(id);
+    }
+    dispose() {
+        if (this.disposed)
+            return;
+        this.disposed = true;
+        super.dispose();
+        this.bufferCache.clear();
+        this.decoding.clear();
+        this.scheduled.length = 0;
+        this._graph?.buses.dispose();
+        try {
+            this._graph?.master.disconnect();
+        }
+        catch {
+            // already disconnected
+        }
+        const owned = this.borrowed ? null : this._context;
+        if (owned && owned.state !== "closed") {
+            owned.close();
+        }
+    }
+}
+//# sourceMappingURL=player.js.map

package/dist/audio/player.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"player.js","sourceRoot":"","sources":["../../src/audio/player.ts"],"names":[],"mappings":"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","sourcesContent":["import { AudioSink, AudioRequest } from \"@motionscript/core\";\nimport { AudioBusGraph } from \"./bus-graph\";\nimport { applyLoop, wrapIntoRegion } from \"./loop-region\";\nimport { applySpeedToPlaybackRate, buildAudioEffectGraph, buildLevel, playbackOf, sourceOffsetOf } from \"./effect-graph\";\n\ntype ActiveSource = {\n    source: AudioBufferSourceNode;\n    request: AudioRequest;\n    /** Effect and level nodes to disconnect on teardown. */\n    nodes: AudioNode[];\n    /** Tremolo LFOs to stop on teardown. */\n    oscillators: OscillatorNode[];\n};\n\n/**\n * Web Audio implementation of {@link AudioSink} — decodes and caches source\n * buffers, then schedules/plays {@link AudioRequest}s as `AudioBufferSourceNode`s\n * through a shared master gain (global mute and volume). `schedule` registers the\n * active set of requests for the current frame; `syncTo` then starts/stops\n * sources to match `clipTime`, so playback follows scrubbing and seeks.\n */\nexport class WebAudioSink extends AudioSink {\n    private readonly borrowed: AudioContext | undefined;\n    private _context: AudioContext | null = null;\n    private bufferCache = new Map<string, AudioBuffer>();\n    private decoding = new Map<string, Promise<void>>();\n    private active = new Map<string, ActiveSource>();\n    private scheduled: AudioRequest[] = [];\n    private disposed: boolean = false;\n    /** The master gain and the live bus chains (shared across every clip that names one), built with the context. */\n    private _graph: { master: GainNode; buses: AudioBusGraph } | null = null;\n    private muted = false;\n    private volume = 1;\n\n    constructor(context?: AudioContext) {\n        super();\n        this.borrowed = context;\n    }\n\n    /**\n     * The context, created on first use rather than with the sink: a new\n     * AudioContext opens the audio device (50–65 ms on a desktop), and a\n     * session that never plays or decodes sound never needs one.\n     */\n    getContext(): AudioContext {\n        this._context ??= this.borrowed ?? new AudioContext();\n        return this._context;\n    }\n\n    private get context(): AudioContext {\n        return this.getContext();\n    }\n\n    private get graph(): { master: GainNode; buses: AudioBusGraph } {\n        if (!this._graph) {\n            const master = this.context.createGain();\n            master.connect(this.context.destination);\n            this._graph = { master, buses: new AudioBusGraph(this.context, master) };\n            this.applyMasterGain();\n        }\n        return this._graph;\n    }\n\n    /**\n     * Resume the AudioContext. Must be called from within a user gesture\n     * (e.g. a click handler) the first time, or browsers keep the context\n     * suspended and no audio is heard.\n     */\n    unlock(): void {\n        if (this.context.state === \"suspended\") {\n            this.context.resume();\n        }\n    }\n\n    has(src: string): boolean {\n        return this.bufferCache.has(src);\n    }\n\n    async append(src: string, data: ArrayBuffer): Promise<void> {\n        if (this.bufferCache.has(src)) return;\n        const existing = this.decoding.get(src);\n        if (existing) return existing;\n\n        // decodeAudioData detaches `data` — that's fine, the caller in\n        // AssetManager.fetchAudio discards its reference immediately after\n        // awaiting append. Skipping the defensive .slice(0) saves a multi-MB\n        // allocation per audio source.\n        const job = this.context.decodeAudioData(data).then((buffer) => {\n            this.bufferCache.set(src, buffer);\n        }).finally(() => {\n            this.decoding.delete(src);\n        });\n        this.decoding.set(src, job);\n        await job;\n    }\n\n    /** Drops cached buffers and stops active sources for srcs/requests no longer referenced — called when the asset set changes (e.g. seeking across scene boundaries). */\n    retain(keep: ReadonlySet<string>): void {\n        for (const src of [...this.bufferCache.keys()]) {\n            if (!keep.has(src)) this.bufferCache.delete(src);\n        }\n        for (const [id, active] of this.active) {\n            if (!keep.has(active.request.src)) this.stopSource(id, active);\n        }\n    }\n\n    /** Replaces the active request set; stops any currently-playing source whose request is no longer scheduled. Actual start/stop-to-match-time happens in `syncTo`. */\n    schedule(requests: readonly AudioRequest[]): void {\n        const next = new Set(requests.map(r => r.id));\n        for (const [id, active] of this.active) {\n            if (!next.has(id)) this.stopSource(id, active);\n        }\n        this.scheduled = requests.slice();\n    }\n\n    /** Starts sources whose `[startAt, endAt)` window now contains `clipTime` (computing the correct buffer offset for the seek point) and stops any that have fallen outside it. */\n    syncTo(clipTime: number): void {\n        const liveIds = new Set<string>();\n\n        for (const req of this.scheduled) {\n            // `endAt` is `Infinity` for an open clip, so the comparison needs no\n            // nullish fallback — see AudioRequest.endAt.\n            const isInWindow = clipTime >= req.startAt && clipTime < req.endAt;\n            if (!isInWindow) continue;\n\n            liveIds.add(req.id);\n            if (!this.active.has(req.id)) {\n                const buffer = this.bufferCache.get(req.src);\n                if (buffer) this.playBuffer(buffer, req, clipTime);\n            }\n        }\n\n        for (const [id, active] of this.active) {\n            if (!liveIds.has(id)) this.stopSource(id, active);\n        }\n    }\n\n    async play(time: number, _speed: number, _reverse: boolean): Promise<void> {\n        if (this.context.state === \"suspended\") {\n            await this.context.resume();\n        }\n        this.syncTo(time);\n    }\n\n    stop(): void {\n        for (const [id, active] of this.active) {\n            this.stopSource(id, active);\n        }\n        // A bus's curves are scheduled against the clock of the run that built\n        // it, so the next play, from wherever it lands, builds them again.\n        this._graph?.buses.dispose();\n    }\n\n    setMuted(muted: boolean): void {\n        this.muted = muted;\n        this.applyMasterGain();\n    }\n\n    setVolume(volume: number): void {\n        this.volume = Math.max(0, volume);\n        this.applyMasterGain();\n    }\n\n    /** Mute and volume are held separately so unmuting restores the set level. */\n    private applyMasterGain(): void {\n        if (this._graph) this._graph.master.gain.value = this.muted ? 0 : this.volume;\n    }\n\n    /** Starts a buffer source mid-clip if `clipTime` lands after the request's start — the offset accounts for the request's trim, the elapsed time since `startAt`, and its speed. */\n    private playBuffer(buffer: AudioBuffer, req: AudioRequest, clipTime: number): void {\n        const startTime = this.context.currentTime;\n        const playback = playbackOf(req, buffer.duration);\n        const elapsed = Math.max(0, clipTime - req.startAt);\n\n        const source = this.context.createBufferSource();\n        source.buffer = buffer;\n        const loopRegion = applyLoop(source, req);\n        if (playback.rate !== 1) source.playbackRate.value = playback.rate;\n        applySpeedToPlaybackRate(\n            source.playbackRate, playback.speedRamp, playback.sourceLength, playback.clipDuration, startTime, elapsed,\n        );\n\n        const graph = buildAudioEffectGraph(\n            this.context, source, req.effects ?? [], startTime, playback.clipDuration, elapsed,\n        );\n        const level = buildLevel(this.context, graph.output, req, playback, startTime, elapsed);\n        // Into this clip's bus chain, or straight to the master when it has none.\n        // The chain is shared: two clips on one bus reach the same nodes, which is\n        // what makes a bus effect one tail rather than one per clip.\n        level.output.connect(this.graph.buses.inputFor(req.bus, startTime, clipTime));\n\n        const audioOffset = req.trimStart + sourceOffsetOf(playback, elapsed);\n        source.start(startTime, wrapIntoRegion(loopRegion, audioOffset));\n        for (const osc of graph.oscillators) osc.start(startTime);\n\n        source.onended = () => {\n            if (this.active.get(req.id)?.source === source) {\n                this.active.delete(req.id);\n            }\n        };\n\n        this.active.set(req.id, {\n            source,\n            request: req,\n            nodes: [...graph.nodes, ...level.nodes],\n            oscillators: graph.oscillators,\n        });\n    }\n\n    private stopSource(id: string, active: ActiveSource): void {\n        try {\n            active.source.onended = null;\n            active.source.stop();\n            for (const osc of active.oscillators) osc.stop();\n            active.source.disconnect();\n            for (const node of active.nodes) node.disconnect();\n        } catch {\n            // already stopped\n        }\n        this.active.delete(id);\n    }\n\n    dispose(): void {\n        if (this.disposed) return;\n        this.disposed = true;\n        super.dispose();\n        this.bufferCache.clear();\n        this.decoding.clear();\n        this.scheduled.length = 0;\n        this._graph?.buses.dispose();\n        try {\n            this._graph?.master.disconnect();\n        } catch {\n            // already disconnected\n        }\n        const owned = this.borrowed ? null : this._context;\n        if (owned && owned.state !== \"closed\") {\n            owned.close();\n        }\n    }\n}\n"]}