129 lines
5.2 KiB
JavaScript
129 lines
5.2 KiB
JavaScript
// SonicForge Unified MIDI Router
|
||
// Mọi nguồn MIDI (keybed preview, timeline scheduler, hardware MIDI) → chuẩn
|
||
// hóa UnifiedMidiEvent → UnifiedMidiRouter → engine theo trackId. Một điểm
|
||
// dispatch duy nhất: activeVoiceTracker đếm note-on/off đúng (hết stuck
|
||
// notes), panicAllNotesOff() quét toàn bộ voice khi đổi instrument/engine
|
||
// giữa chừng. Chưa nối vào app (T5–T7 sẽ đăng ký engine + dispatch).
|
||
window.SonicUnifiedMidiRouter = window.SonicUnifiedMidiRouter || {};
|
||
|
||
(function () {
|
||
var COMMAND_NOTE_ON = 0x90;
|
||
var COMMAND_NOTE_OFF = 0x80;
|
||
var COMMAND_CC = 0xB0;
|
||
|
||
// Pitch: ép int 0-127 (spec "pitch clamp 0-127").
|
||
function clampPitch(pitch) {
|
||
pitch = Math.round(Number(pitch) || 0);
|
||
if (pitch < 0) return 0;
|
||
if (pitch > 127) return 127;
|
||
return pitch;
|
||
}
|
||
|
||
// Velocity: float 0-1 (vd 100/127) hoặc int → ép int 1-127 (note-on);
|
||
// note-off velocity = 0. Spec "velocity normalize float→int".
|
||
function normalizeVelocity(velocity, isNoteOn) {
|
||
var v = Number(velocity);
|
||
if (!isFinite(v)) v = 0;
|
||
if (v > 0 && v <= 1) v = v * 127;
|
||
v = Math.round(v);
|
||
if (v < 0) v = 0;
|
||
if (v > 127) v = 127;
|
||
if (isNoteOn && v <= 0) v = 1;
|
||
return v;
|
||
}
|
||
|
||
function UnifiedMidiRouter() {
|
||
this.engineRegistry = new Map(); // trackId → TrackInstrument
|
||
// activeVoiceTracker: key `${trackId}_${channel}_${pitch}` → { count, engine }.
|
||
// (Spec dùng `${channel}_${pitch}`; thêm trackId vì engine theo track —
|
||
// 2 track cùng channel+pitch phải đếm riêng, không lệch voice.)
|
||
this._voices = new Map();
|
||
}
|
||
|
||
// Đăng ký engine cho track (null = xóa). Đổi instrument → registerEngine
|
||
// track mới; panic trước đó để không sót voice cũ.
|
||
UnifiedMidiRouter.prototype.registerEngine = function (trackId, engine) {
|
||
if (trackId === undefined || trackId === null) return;
|
||
if (engine) this.engineRegistry.set(trackId, engine);
|
||
else this.engineRegistry.delete(trackId);
|
||
};
|
||
|
||
// Dispatch 1 event từ mọi nguồn. Không ném — voice tracker luôn đếm đúng.
|
||
// Trả true nếu event là note (đã route/count), false nếu không xử lý.
|
||
UnifiedMidiRouter.prototype.dispatchMidiEvent = function (evt) {
|
||
if (!evt) return false;
|
||
var trackId = evt.trackId;
|
||
var engine = (trackId !== undefined && trackId !== null) ? this.engineRegistry.get(trackId) : null;
|
||
var channel = Math.round(Number(evt.channel) || 0);
|
||
if (channel < 0) channel = 0;
|
||
if (channel > 15) channel = 15;
|
||
var pitch = clampPitch(evt.pitch);
|
||
var cmd = Number(evt.command);
|
||
var key = trackId + '_' + channel + '_' + pitch;
|
||
|
||
var isNoteOn = (cmd === COMMAND_NOTE_ON);
|
||
var isNoteOff = (cmd === COMMAND_NOTE_OFF) || (cmd === COMMAND_NOTE_ON && !Number(evt.velocity));
|
||
|
||
if (isNoteOn) {
|
||
var vel = normalizeVelocity(evt.velocity, true);
|
||
var cur = this._voices.get(key);
|
||
if (!cur) {
|
||
cur = { count: 0, engine: engine };
|
||
this._voices.set(key, cur);
|
||
}
|
||
cur.engine = engine;
|
||
cur.count += 1;
|
||
// Chỉ trigger âm ở note-on đầu tiên; các note-on trùng key chỉ tăng
|
||
// count (sustain lặp) — note-off cuối cùng mới tắt voice.
|
||
if (cur.count === 1 && engine && engine.playNote) {
|
||
try { engine.playNote(pitch, vel, evt.durationMs || 500, evt.startTime); } catch (e) {}
|
||
}
|
||
return true;
|
||
}
|
||
|
||
if (isNoteOff) {
|
||
var cur2 = this._voices.get(key);
|
||
if (cur2 && cur2.count > 0) {
|
||
cur2.count -= 1;
|
||
var eng2 = cur2.engine;
|
||
if (cur2.count <= 0) {
|
||
this._voices.delete(key);
|
||
if (eng2 && eng2.noteOff) {
|
||
try { eng2.noteOff(pitch); } catch (e) {}
|
||
}
|
||
}
|
||
}
|
||
return true;
|
||
}
|
||
|
||
return false; // CC / unknown
|
||
};
|
||
|
||
// All Notes Off: quét voice tracker, gửi note-off cho engine sở hữu từng
|
||
// voice, xóa tracker. Gọi khi dừng playback / đổi instrument giữa chừng.
|
||
UnifiedMidiRouter.prototype.panicAllNotesOff = function () {
|
||
var self = this;
|
||
this._voices.forEach(function (v, key) {
|
||
if (v.engine && v.engine.noteOff) {
|
||
var parts = key.split('_');
|
||
var pitch = parseInt(parts[parts.length - 1], 10);
|
||
try { v.engine.noteOff(pitch); } catch (e) {}
|
||
}
|
||
});
|
||
this._voices.clear();
|
||
};
|
||
|
||
// Số voice active cho 1 (track, channel, pitch) — test/debug.
|
||
UnifiedMidiRouter.prototype.activeVoiceCount = function (trackId, channel, pitch) {
|
||
var cur = this._voices.get(trackId + '_' + channel + '_' + pitch);
|
||
return cur ? cur.count : 0;
|
||
};
|
||
|
||
window.SonicUnifiedMidiRouter = {
|
||
UnifiedMidiRouter: UnifiedMidiRouter,
|
||
COMMAND_NOTE_ON: COMMAND_NOTE_ON,
|
||
COMMAND_NOTE_OFF: COMMAND_NOTE_OFF,
|
||
COMMAND_CC: COMMAND_CC
|
||
};
|
||
})();
|