From 2f52386a77121e647dd0c07f135bc8e9742aca13 Mon Sep 17 00:00:00 2001 From: class04m02 Date: Thu, 24 Sep 2026 03:38:43 +0000 Subject: [PATCH] =?UTF-8?q?feat:=20Web=20Audio=20=E5=A4=8D=E9=9F=B3?= =?UTF-8?q?=E5=90=88=E6=88=90=E5=99=A8=EF=BC=8816=20=E9=9F=B3=E8=89=B2?= =?UTF-8?q?=E6=97=8F=20+=20=E9=BC=93=E7=BB=84=20+=20=E6=B7=B7=E5=93=8D=20+?= =?UTF-8?q?=20=E5=81=B7=E5=A3=B0=EF=BC=89?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- js/synth.js | 462 ++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 462 insertions(+) create mode 100644 js/synth.js diff --git a/js/synth.js b/js/synth.js new file mode 100644 index 0000000..257513a --- /dev/null +++ b/js/synth.js @@ -0,0 +1,462 @@ +/* + * synth.js —— 基于 Web Audio API 的多音色复音合成器 + * ------------------------------------------------------------------ + * 设计要点: + * 1. 每个音符 = 一个 Voice 对象:多个振荡器 -> 低通滤波 -> ADSR 包络 -> 输出 + * 2. 音色按 General MIDI 的 16 个乐器族(program / 8)归类,用一个参数表描述 + * 3. 通道 9(第 10 通道)特殊处理为鼓组,用噪声 + 音高包络合成打击乐 + * 4. 支持 CC7(音量) / CC10(声像) / CC11(表情) / CC120,123(全部音符关闭) + * 5. 支持复音数上限与"偷声"(voice stealing),避免卡顿 + * 6. 生成式脉冲响应卷积混响,无需外部音频资源 + */ +(function (root, factory) { + if (typeof module === 'object' && module.exports) module.exports = factory(); + else root.MidiSynth = factory(); +})(typeof self !== 'undefined' ? self : this, function () { + 'use strict'; + + /* ---------------------------------------------------------------- */ + /* 音色参数表:w=[相对音量, 波形, 八度偏移, 失谐(音分)] */ + /* a 起音 / d 衰减 / s 保持 / r 释放 (秒) */ + /* cut 低通截止 / q 品质因数 / rev 混响发送量 / gain 总增益 */ + /* ---------------------------------------------------------------- */ + var FAMILIES = [ + /* 0 钢琴 */ { w: [[0.85, 'triangle'], [0.45, 'sine', 1], [0.12, 'sawtooth']], a: 0.004, d: 1.6, s: 0.16, r: 0.35, cut: 3200, q: 0.7, rev: 0.16, gain: 1.0 }, + /* 1 半音打击 */ { w: [[0.9, 'sine'], [0.35, 'triangle', 1]], a: 0.003, d: 0.9, s: 0.05, r: 0.5, cut: 4200, q: 0.7, rev: 0.30, gain: 0.95 }, + /* 2 风琴 */ { w: [[0.7, 'square'], [0.5, 'square', 1], [0.32, 'sine', -1]], a: 0.012, d: 0.05, s: 0.95, r: 0.12, cut: 2600, q: 0.5, rev: 0.20, gain: 0.75 }, + /* 3 吉他 */ { w: [[0.8, 'sawtooth'], [0.4, 'triangle', 1]], a: 0.006, d: 0.9, s: 0.12, r: 0.35, cut: 2800, q: 0.8, rev: 0.18, gain: 0.95 }, + /* 4 贝斯 */ { w: [[0.9, 'sawtooth'], [0.6, 'sine', -1]], a: 0.008, d: 0.6, s: 0.45, r: 0.18, cut: 1100, q: 1.0, rev: 0.05, gain: 1.15 }, + /* 5 弦乐 */ { w: [[0.8, 'sawtooth'], [0.8, 'sawtooth', 0, 7]], a: 0.18, d: 0.4, s: 0.85, r: 0.7, cut: 2400, q: 0.6, rev: 0.45, gain: 0.8 }, + /* 6 合奏 */ { w: [[0.7, 'sawtooth'], [0.6, 'square', 0, -6]], a: 0.12, d: 0.4, s: 0.85, r: 0.6, cut: 2200, q: 0.6, rev: 0.42, gain: 0.8 }, + /* 7 铜管 */ { w: [[0.9, 'sawtooth'], [0.4, 'square', 1]], a: 0.06, d: 0.3, s: 0.78, r: 0.3, cut: 3000, q: 0.9, rev: 0.28, gain: 0.85 }, + /* 8 簧管 */ { w: [[0.8, 'square'], [0.4, 'sawtooth', 0, 5]], a: 0.05, d: 0.3, s: 0.82, r: 0.3, cut: 2000, q: 0.8, rev: 0.30, gain: 0.75 }, + /* 9 吹管 */ { w: [[0.9, 'sine'], [0.35, 'triangle', 1], [0.08, 'sawtooth']], a: 0.08, d: 0.3, s: 0.88, r: 0.35, cut: 3400, q: 0.6, rev: 0.40, gain: 0.85 }, + /* 10 合成主音 */ { w: [[0.9, 'sawtooth'], [0.5, 'square', 0, 8]], a: 0.02, d: 0.35, s: 0.6, r: 0.3, cut: 2800, q: 1.2, rev: 0.25, gain: 0.8 }, + /* 11 合成铺底 */ { w: [[0.7, 'sawtooth'], [0.7, 'triangle', 0, -9], [0.4, 'sine', 1]], a: 0.6, d: 1.2, s: 0.7, r: 1.4, cut: 1600, q: 0.5, rev: 0.60, gain: 0.7 }, + /* 12 音效 */ { w: [[0.6, 'sawtooth'], [0.5, 'sine', 1]], a: 0.4, d: 1.5, s: 0.5, r: 1.4, cut: 1800, q: 0.7, rev: 0.60, gain: 0.7 }, + /* 13 民族 */ { w: [[0.8, 'triangle'], [0.4, 'sawtooth', 1]], a: 0.01, d: 0.8, s: 0.2, r: 0.4, cut: 2800, q: 0.8, rev: 0.25, gain: 0.9 }, + /* 14 打击 */ { w: [[0.8, 'triangle'], [0.4, 'square', 1]], a: 0.002, d: 0.5, s: 0.03, r: 0.3, cut: 4500, q: 0.7, rev: 0.30, gain: 0.9 }, + /* 15 特效 */ { w: [[0.7, 'sawtooth'], [0.5, 'square', 1]], a: 0.05, d: 1.2, s: 0.2, r: 0.8, cut: 2200, q: 0.7, rev: 0.50, gain: 0.7 } + ]; + + function familyFor(program, channel) { + if (channel === 9) return FAMILIES[14]; + var p = program | 0; + if (p < 0) p = 0; else if (p > 127) p = 127; + return FAMILIES[Math.min(15, Math.floor(p / 8))]; + } + + /* ------------------------- 鼓组音色映射 ------------------------- */ + function drumSpec(midi) { + switch (midi) { + case 35: case 36: return { kind: 'kick', f0: 165, f1: 45, decay: 0.38, gain: 1.0, rev: 0.05 }; + case 38: case 40: return { kind: 'snare', decay: 0.24, gain: 0.55, freq: 1800, q: 0.9, body: 190, bf1: 130, bg: 0.45, rev: 0.22 }; + case 37: return { kind: 'clap', decay: 0.12, gain: 0.4, freq: 2400, q: 1.4, rev: 0.2 }; + case 39: return { kind: 'clap', decay: 0.22, gain: 0.5, freq: 1400, q: 1.2, rev: 0.25 }; + case 42: return { kind: 'hat', decay: 0.06, gain: 0.32, freq: 9500, q: 0.8, rev: 0.06 }; + case 44: return { kind: 'hat', decay: 0.09, gain: 0.32, freq: 7500, q: 0.8, rev: 0.08 }; + case 46: return { kind: 'hat', decay: 0.38, gain: 0.30, freq: 8200, q: 0.7, rev: 0.18 }; + case 49: return { kind: 'cymbal', decay: 1.5, gain: 0.30, freq: 6200, q: 0.5, rev: 0.4 }; + case 57: return { kind: 'cymbal', decay: 1.0, gain: 0.30, freq: 7200, q: 0.5, rev: 0.35 }; + case 51: case 59: return { kind: 'cymbal', decay: 0.7, gain: 0.26, freq: 8200, q: 0.6, rev: 0.25 }; + case 41: case 43: return { kind: 'tom', f0: 130, f1: 80, decay: 0.38, gain: 0.7, rev: 0.2 }; + case 45: case 47: return { kind: 'tom', f0: 180, f1: 110, decay: 0.34, gain: 0.7, rev: 0.2 }; + case 48: case 50: return { kind: 'tom', f0: 235, f1: 145, decay: 0.3, gain: 0.7, rev: 0.2 }; + default: return { kind: 'noise', decay: 0.16, gain: 0.4, freq: 1600, q: 0.9, rev: 0.2 }; + } + } + + /* --------------------------- 工具函数 --------------------------- */ + + function makeNoiseBuffer(ctx, seconds) { + var len = Math.floor(ctx.sampleRate * seconds); + var buf = ctx.createBuffer(1, len, ctx.sampleRate); + var d = buf.getChannelData(0); + for (var i = 0; i < len; i++) d[i] = Math.random() * 2 - 1; + return buf; + } + + /* 生成一段指数衰减的噪声作为混响脉冲响应 */ + function makeImpulse(ctx, seconds, decay) { + var len = Math.floor(ctx.sampleRate * seconds); + var buf = ctx.createBuffer(2, len, ctx.sampleRate); + for (var c = 0; c < 2; c++) { + var d = buf.getChannelData(c); + for (var i = 0; i < len; i++) { + d[i] = (Math.random() * 2 - 1) * Math.pow(1 - i / len, decay); + } + } + return buf; + } + + function clampTime(ctx, t) { + var now = ctx.currentTime; + return (t == null || t < now) ? now : t; + } + + /* 冻结某个 AudioParam 在时刻 t 的值(优先使用 cancelAndHoldAtTime) */ + function holdParam(param, t) { + if (typeof param.cancelAndHoldAtTime === 'function') { + try { param.cancelAndHoldAtTime(t); return; } catch (e) { /* 继续走降级方案 */ } + } + var v = param.value; + param.cancelScheduledValues(t); + param.setValueAtTime(v, t); + } + + /* ============================ 旋律声部 ============================ */ + function Voice(synth, channel, midi, velocity, when, program) { + this.synth = synth; + this.ctx = synth.ctx; + this.channel = channel; + this.midi = midi; + this.key = channel * 128 + midi; + this.released = false; + this.stopTime = Infinity; + this.isDrum = false; + + var ctx = this.ctx; + var fam = familyFor(program, channel); + this.fam = fam; + + var freq = 440 * Math.pow(2, (midi - 69) / 12); + this.freq = freq; + + var vel = Math.max(1, Math.min(127, velocity)) / 127; + var peak = Math.pow(vel, 1.35) * 0.30 * fam.gain; + this.peak = peak; + + var t0 = when; + + var out = ctx.createGain(); + out.gain.setValueAtTime(0.0001, t0); + out.gain.linearRampToValueAtTime(peak, t0 + fam.a); + out.gain.linearRampToValueAtTime(Math.max(peak * fam.s, 0.0001), t0 + fam.a + fam.d); + + var filter = ctx.createBiquadFilter(); + filter.type = 'lowpass'; + var nyq = ctx.sampleRate / 2; + var cut = fam.cut * (0.55 + 0.45 * vel) + freq * 0.8; + cut = Math.max(180, Math.min(cut, nyq - 800)); + filter.frequency.setValueAtTime(cut, t0); + filter.frequency.exponentialRampToValueAtTime(Math.max(180, cut * 0.45), t0 + fam.a + fam.d + 0.05); + filter.Q.value = fam.q; + filter.connect(out); + + /* 振荡器组 */ + this.oscs = []; + for (var i = 0; i < fam.w.length; i++) { + var spec = fam.w[i]; + var f = freq * Math.pow(2, spec[2] || 0); + if (f > nyq - 500) continue; + var osc = ctx.createOscillator(); + osc.type = spec[1]; + osc.frequency.setValueAtTime(f, t0); + if (spec[3]) osc.detune.setValueAtTime(spec[3], t0); + var og = ctx.createGain(); + og.gain.value = spec[0]; + osc.connect(og); + og.connect(filter); + osc.start(t0); + this.oscs.push(osc); + } + + /* 输出路由:干声进通道总线,湿声送混响总线 */ + out.connect(synth.channels[channel].vol); + if (synth.reverb && fam.rev > 0.01) { + var send = ctx.createGain(); + send.gain.value = fam.rev; + out.connect(send); + send.connect(synth.reverb); + this.send = send; + } + + this.out = out; + this.filter = filter; + } + + Voice.prototype.release = function (when) { + if (this.released) return; + this.released = true; + var ctx = this.ctx; + var t = clampTime(ctx, when); + var rel = this.fam.r; + holdParam(this.out.gain, t); + this.out.gain.linearRampToValueAtTime(0.0001, t + rel); + this.stopTime = t + rel + 0.06; + this._stopOscs(this.stopTime); + }; + + /* 立即掐断(用于偷声 / 全部音符关闭) */ + Voice.prototype.cut = function (when) { + this.released = true; + var t = clampTime(this.ctx, when); + holdParam(this.out.gain, t); + this.out.gain.linearRampToValueAtTime(0.0001, t + 0.025); + this.stopTime = t + 0.05; + this._stopOscs(this.stopTime); + }; + + Voice.prototype._stopOscs = function (t) { + for (var i = 0; i < this.oscs.length; i++) { + try { this.oscs[i].stop(t); } catch (e) { /* 已停止 */ } + } + }; + + /* ============================ 鼓组声部 ============================ */ + function DrumVoice(synth, midi, velocity, when) { + this.synth = synth; + this.ctx = synth.ctx; + this.midi = midi; + this.key = 9 * 128 + midi; + this.channel = 9; + this.released = true; // 打击乐不需要 note-off + this.isDrum = true; + + var ctx = this.ctx; + var spec = drumSpec(midi); + var vel = Math.max(1, Math.min(127, velocity)) / 127; + var amp = Math.pow(vel, 1.2) * spec.gain; + var dur = spec.decay; + var t0 = when; + + var out = ctx.createGain(); + out.gain.setValueAtTime(Math.max(amp, 0.0001), t0); + out.gain.exponentialRampToValueAtTime(0.0005, t0 + dur); + out.connect(synth.channels[9].vol); + if (synth.reverb && spec.rev > 0.01) { + var send = ctx.createGain(); + send.gain.value = spec.rev; + out.connect(send); + send.connect(synth.reverb); + this.send = send; + } + this.out = out; + this.sources = []; + + if (spec.kind === 'kick' || spec.kind === 'tom') { + var o = ctx.createOscillator(); + o.type = 'sine'; + o.frequency.setValueAtTime(spec.f0, t0); + o.frequency.exponentialRampToValueAtTime(spec.f1, t0 + dur * 0.75); + o.connect(out); + o.start(t0); + o.stop(t0 + dur + 0.05); + this.sources.push(o); + } else { + var src = ctx.createBufferSource(); + src.buffer = synth.noise; + src.loop = true; + var f = ctx.createBiquadFilter(); + if (spec.kind === 'hat' || spec.kind === 'cymbal') { + f.type = 'highpass'; + f.frequency.value = spec.freq; + } else { + f.type = 'bandpass'; + f.frequency.value = spec.freq; + } + f.Q.value = spec.q || 0.8; + src.connect(f); + f.connect(out); + src.start(t0); + src.stop(t0 + dur + 0.05); + this.sources.push(src); + + if (spec.body) { // 军鼓加一点鼓皮基音 + var bo = ctx.createOscillator(); + bo.type = 'triangle'; + bo.frequency.setValueAtTime(spec.body, t0); + bo.frequency.exponentialRampToValueAtTime(spec.bf1, t0 + dur * 0.6); + var bg = ctx.createGain(); + bg.gain.setValueAtTime(Math.max(amp * spec.bg, 0.0001), t0); + bg.gain.exponentialRampToValueAtTime(0.0005, t0 + dur * 0.8); + bo.connect(bg); + bg.connect(synth.channels[9].vol); + bo.start(t0); + bo.stop(t0 + dur + 0.05); + this.sources.push(bo); + } + } + + this.stopTime = t0 + dur + 0.1; + } + + DrumVoice.prototype.release = function () { /* 打击乐自动衰减 */ }; + DrumVoice.prototype.cut = function (when) { + var t = clampTime(this.ctx, when); + holdParam(this.out.gain, t); + this.out.gain.linearRampToValueAtTime(0.0005, t + 0.02); + this.stopTime = t + 0.05; + for (var i = 0; i < this.sources.length; i++) { + try { this.sources[i].stop(this.stopTime); } catch (e) { /* 忽略 */ } + } + }; + + /* ============================= 合成器 ============================= */ + function Synth(ctx, options) { + options = options || {}; + this.ctx = ctx; + + var master = ctx.createGain(); + master.gain.value = options.volume == null ? 0.85 : options.volume; + + var comp = ctx.createDynamicsCompressor(); + comp.threshold.value = -10; + comp.knee.value = 24; + comp.ratio.value = 6; + comp.attack.value = 0.004; + comp.release.value = 0.22; + + var analyser = ctx.createAnalyser(); + analyser.fftSize = 1024; + analyser.smoothingTimeConstant = 0.7; + + master.connect(comp); + comp.connect(analyser); + analyser.connect(ctx.destination); + + this.master = master; + this.comp = comp; + this.analyser = analyser; + + /* 混响总线(生成式脉冲响应,失败则自动关闭) */ + this.reverb = null; + this.reverbGain = null; + try { + var conv = ctx.createConvolver(); + conv.buffer = makeImpulse(ctx, 2.2, 2.6); + var wet = ctx.createGain(); + wet.gain.value = 0.9; + conv.connect(wet); + wet.connect(master); + this.reverb = conv; + this.reverbGain = wet; + } catch (e) { this.reverb = null; } + + /* 16 个通道总线:音量 -> 声像 -> 主输出 */ + this.channels = []; + for (var i = 0; i < 16; i++) { + var vol = ctx.createGain(); + vol.gain.value = 0.8; + var pan = null; + if (typeof ctx.createStereoPanner === 'function') { + pan = ctx.createStereoPanner(); + vol.connect(pan); + pan.connect(master); + } else { + vol.connect(master); + } + this.channels.push({ + vol: vol, + pan: pan, + base: 0.8, // CC7 通道音量 + expr: 1 // CC11 表情 + }); + } + + this.noise = makeNoiseBuffer(ctx, 2); + this.voices = []; + this.pending = {}; + this.maxVoices = options.maxVoices || 40; + } + + Synth.prototype.setVolume = function (v) { + var val = Math.max(0, Math.min(1.5, v)); + this.master.gain.setTargetAtTime(val, this.ctx.currentTime, 0.02); + }; + + Synth.prototype.noteOn = function (channel, midi, velocity, when, program) { + if (!this.ctx) return; + if (velocity <= 0) { this.noteOff(channel, midi, when); return; } + var t = clampTime(this.ctx, when); + this._gc(t); + if (this.voices.length >= this.maxVoices) this._steal(t); + + var voice; + if (channel === 9) { + voice = new DrumVoice(this, midi, velocity, t); + } else { + voice = new Voice(this, channel, midi, velocity, t, program || 0); + var k = channel * 128 + midi; + (this.pending[k] || (this.pending[k] = [])).push(voice); + } + this.voices.push(voice); + }; + + Synth.prototype.noteOff = function (channel, midi, when) { + if (channel === 9) return; + var k = channel * 128 + midi; + var arr = this.pending[k]; + if (!arr || !arr.length) return; + var v = arr.shift(); + if (!arr.length) delete this.pending[k]; + v.release(clampTime(this.ctx, when)); + }; + + Synth.prototype.handleCC = function (channel, number, value, when) { + var ch = this.channels[channel]; + if (!ch) return; + var t = clampTime(this.ctx, when); + if (number === 7) { + ch.base = value / 127; + ch.vol.gain.setTargetAtTime(ch.base * ch.expr, t, 0.03); + } else if (number === 11) { + ch.expr = value / 127; + ch.vol.gain.setTargetAtTime(ch.base * ch.expr, t, 0.03); + } else if (number === 10 && ch.pan) { + ch.pan.pan.setTargetAtTime((value - 64) / 64, t, 0.03); + } else if (number === 120 || number === 123) { + this.panic(t); + } + }; + + /* 强制掐断所有正在发声的音符 */ + Synth.prototype.panic = function (when) { + var t = when == null ? this.ctx.currentTime : when; + var list = this.voices.slice(); + for (var i = 0; i < list.length; i++) { + try { list[i].cut(t); } catch (e) { /* 忽略 */ } + } + this.pending = {}; + }; + + Synth.prototype.voiceCount = function () { return this.voices.length; }; + + /* 当前正在发声的 音高集合(用于可视化) */ + Synth.prototype.activeNotes = function () { + var set = []; + for (var i = 0; i < this.voices.length; i++) { + if (!this.voices[i].released) set.push(this.voices[i].key); + } + return set; + }; + + Synth.prototype._gc = function (t) { + for (var i = this.voices.length - 1; i >= 0; i--) { + if (this.voices[i].stopTime <= t) this.voices.splice(i, 1); + } + for (var k in this.pending) { + var arr = this.pending[k]; + for (var j = arr.length - 1; j >= 0; j--) if (arr[j].released) arr.splice(j, 1); + if (!arr.length) delete this.pending[k]; + } + }; + + Synth.prototype._steal = function (t) { + var idx = -1; + for (var i = 0; i < this.voices.length; i++) { + if (!this.voices[i].released) { idx = i; break; } + } + if (idx === -1) idx = 0; + var v = this.voices.splice(idx, 1)[0]; + if (v) { try { v.cut(t); } catch (e) { /* 忽略 */ } } + }; + + return { + Synth: Synth, + Voice: Voice, + FAMILIES: FAMILIES, + familyFor: familyFor, + drumSpec: drumSpec + }; +});