/* * midi-parser.js —— 纯 JavaScript 的 Standard MIDI File (SMF) 解析器 * ------------------------------------------------------------------ * 零依赖,浏览器 / Node.js 双端可用。 * * 负责把 .mid 二进制文件还原成"可播放的音乐数据": * - 块结构解析(MThd / MTrk) * - 变长数量(VLQ)解码 * - 运行状态(running status)还原 * - 通道事件 / 系统独占事件 / 元事件 * - 速度映射表(Tempo Map):把"tick 时间轴"换算成"秒时间轴" * - 音符配对:note-on / note-off 合成带时长的音符对象 * * 对外接口: * MidiParser.parse(arrayBuffer) -> Song * MidiParser.noteName(midiNumber) -> "C4" */ (function (root, factory) { if (typeof module === 'object' && module.exports) module.exports = factory(); else root.MidiParser = factory(); })(typeof self !== 'undefined' ? self : this, function () { 'use strict'; var NOTE_NAMES = ['C', 'C#', 'D', 'D#', 'E', 'F', 'F#', 'G', 'G#', 'A', 'A#', 'B']; var DEFAULT_TEMPO = 500000; // 微秒 / 四分音符 == 120 BPM /* ------------------------------------------------------------------ */ /* 工具函数 */ /* ------------------------------------------------------------------ */ function noteName(midi) { var i = ((midi % 12) + 12) % 12; return NOTE_NAMES[i] + (Math.floor(midi / 12) - 1); } function readString(bytes, offset, len) { var s = ''; for (var i = 0; i < len; i++) s += String.fromCharCode(bytes[offset + i]); return s; } function decodeText(bytes) { if (typeof TextDecoder !== 'undefined') { try { return new TextDecoder('utf-8').decode(bytes); } catch (e) { /* 退化处理 */ } } var s = ''; for (var i = 0; i < bytes.length; i++) s += String.fromCharCode(bytes[i]); return s; } /* 变长数量解码:每字节 7 位有效位,最高位表示"还有后续字节" */ function readVlq(view, offset) { var value = 0, byte, guard = 0; do { byte = view.getUint8(offset++); value = value * 128 + (byte & 0x7f); guard++; } while ((byte & 0x80) && guard < 5); return { value: value, next: offset }; } /* ------------------------------------------------------------------ */ /* 单个 MTrk 块的解析 */ /* ------------------------------------------------------------------ */ function parseTrack(view, start, end, index) { var events = []; var p = start; var tick = 0; // 累计的绝对 tick var running = 0; // 运行状态(上一个通道状态字节) var name = ''; while (p < end) { // 1) 读取 delta time var d = readVlq(view, p); tick += d.value; p = d.next; if (p >= end) break; // 2) 读取状态字节(可能省略,沿用运行状态) var status = view.getUint8(p); if (status & 0x80) { p++; running = status; } else { status = running; } if (!status) break; // 数据异常,安全退出 if (status === 0xff) { /* ---- 元事件 ---- */ var metaType = view.getUint8(p++); var ml = readVlq(view, p); p = ml.next; var mdata = new Uint8Array(view.buffer, view.byteOffset + p, ml.value); p += ml.value; var me = { tick: tick, type: 'meta', metaType: metaType, data: mdata, track: index }; if (metaType === 0x51 && ml.value >= 3) { me.tempo = (mdata[0] << 16) | (mdata[1] << 8) | mdata[2]; } else if (metaType >= 0x01 && metaType <= 0x09) { me.text = decodeText(mdata); if (metaType === 0x03 || metaType === 0x04) name = me.text; } events.push(me); } else if (status === 0xf0 || status === 0xf7) { /* ---- 系统独占事件:读取后跳过 ---- */ var sl = readVlq(view, p); p = sl.next; events.push({ tick: tick, type: 'sysex', track: index, data: new Uint8Array(view.buffer, view.byteOffset + p, sl.value) }); p += sl.value; } else if (status >= 0x80 && status <= 0xef) { /* ---- 通道事件 ---- */ var type = status & 0xf0; var channel = status & 0x0f; var d1 = view.getUint8(p++); var d2 = 0; if (type !== 0xc0 && type !== 0xd0) d2 = view.getUint8(p++); events.push({ tick: tick, type: type, channel: channel, data1: d1, data2: d2, track: index }); } else { break; // 无法识别的状态字节,终止本轨解析 } } return { index: index, name: name, events: events, endTick: tick }; } /* ------------------------------------------------------------------ */ /* 主解析流程 */ /* ------------------------------------------------------------------ */ function parse(arrayBuffer) { if (!arrayBuffer || typeof arrayBuffer.byteLength !== 'number') { throw new Error('需要传入 ArrayBuffer'); } if (arrayBuffer.byteLength < 14) throw new Error('文件过短,不是合法的 MIDI 文件'); var view = new DataView(arrayBuffer); var bytes = new Uint8Array(arrayBuffer); if (readString(bytes, 0, 4) !== 'MThd') { throw new Error('缺少 MThd 头块,不是标准 MIDI 文件'); } var headerLen = view.getUint32(4); var format = view.getUint16(8); var declaredTracks = view.getUint16(10); var division = view.getUint16(12); /* --- 时间分辨率 --- */ var ticksPerBeat = 480; var smpte = null; if (division & 0x8000) { // SMPTE 时间码:高字节为负的帧率,低字节为每帧 tick 数 var fps = 256 - ((division >> 8) & 0xff); smpte = { fps: fps, ticksPerFrame: division & 0xff }; } else { ticksPerBeat = division || 480; } /* --- 遍历所有 MTrk 块 --- */ var p = 8 + headerLen; var tracks = []; var ti = 0; while (p + 8 <= arrayBuffer.byteLength) { var id = readString(bytes, p, 4); var len = view.getUint32(p + 4); p += 8; if (id === 'MTrk') { var end = Math.min(p + len, arrayBuffer.byteLength); tracks.push(parseTrack(view, p, end, ti++)); } p += len; } if (!tracks.length) throw new Error('没有找到任何 MTrk 轨道'); /* ---------------- 构建 Tempo Map ---------------- */ var rawTempos = [{ tick: 0, usPerQuarter: DEFAULT_TEMPO }]; tracks.forEach(function (t) { t.events.forEach(function (e) { if (e.type === 'meta' && e.metaType === 0x51 && e.tempo) { rawTempos.push({ tick: e.tick, usPerQuarter: e.tempo }); } }); }); rawTempos.sort(function (a, b) { return a.tick - b.tick; }); var segments = []; // { tick, time, usPerQuarter } var curTick = 0, curTime = 0, curUs = DEFAULT_TEMPO; segments.push({ tick: 0, time: 0, usPerQuarter: curUs }); for (var i = 0; i < rawTempos.length; i++) { var tm = rawTempos[i]; if (tm.tick <= curTick) { // 同一 tick 上重复出现,后者覆盖前者 segments[segments.length - 1].usPerQuarter = tm.usPerQuarter; curUs = tm.usPerQuarter; continue; } curTime += (tm.tick - curTick) * (curUs / 1e6 / ticksPerBeat); curTick = tm.tick; curUs = tm.usPerQuarter; segments.push({ tick: curTick, time: curTime, usPerQuarter: curUs }); } /* tick -> 秒 的换算(分段线性,二分查找) */ function tickToTime(tick) { if (smpte) return tick / (smpte.fps * smpte.ticksPerFrame); var lo = 0, hi = segments.length - 1, idx = 0; while (lo <= hi) { var mid = (lo + hi) >> 1; if (segments[mid].tick <= tick) { idx = mid; lo = mid + 1; } else hi = mid - 1; } var s = segments[idx]; return s.time + (tick - s.tick) * (s.usPerQuarter / 1e6 / ticksPerBeat); } /* ---------------- 事件 -> 音符 ---------------- */ var notes = []; var controllers = []; var pitchBends = []; var markers = []; var totalTicks = 0; tracks.forEach(function (track, tIdx) { var active = {}; // "ch*128+key" -> 未闭合的音符 var programs = {}; // channel -> 当前 GM 音色号 var count = 0; function closeNote(n, endTick) { if (endTick < n.startTick) endTick = n.startTick; var start = tickToTime(n.startTick); var stop = tickToTime(endTick); notes.push({ midi: n.midi, name: noteName(n.midi), velocity: n.velocity, channel: n.channel, program: n.program, track: tIdx, startTick: n.startTick, endTick: endTick, start: start, duration: Math.max(stop - start, 0.02) }); count++; } track.events.forEach(function (e) { if (e.type === 0x90 && e.data2 > 0) { var k = e.channel * 128 + e.data1; if (active[k]) closeNote(active[k], e.tick); // 同音重叠,先收尾前一个 active[k] = { midi: e.data1, velocity: e.data2, channel: e.channel, startTick: e.tick, program: programs[e.channel] || 0 }; } else if (e.type === 0x80 || (e.type === 0x90 && e.data2 === 0)) { var k2 = e.channel * 128 + e.data1; if (active[k2]) { closeNote(active[k2], e.tick); delete active[k2]; } } else if (e.type === 0xc0) { programs[e.channel] = e.data1; track.programs = programs; } else if (e.type === 0xb0) { controllers.push({ tick: e.tick, channel: e.channel, number: e.data1, value: e.data2, track: tIdx, time: 0 }); } else if (e.type === 0xe0) { pitchBends.push({ tick: e.tick, channel: e.channel, value: ((e.data2 << 7) | e.data1) - 8192, track: tIdx, time: 0 }); } else if (e.type === 'meta' && e.text !== undefined) { markers.push({ tick: e.tick, text: e.text, metaType: e.metaType, track: tIdx, time: 0 }); } }); // 轨道结束时仍未收到 note-off 的音符,用轨道末尾时间收尾 Object.keys(active).forEach(function (k) { closeNote(active[k], track.endTick); delete active[k]; }); track.noteCount = count; if (track.endTick > totalTicks) totalTicks = track.endTick; }); // 补齐秒时间 controllers.forEach(function (c) { c.time = tickToTime(c.tick); }); pitchBends.forEach(function (b) { b.time = tickToTime(b.tick); }); markers.forEach(function (m) { m.time = tickToTime(m.tick); }); // 音符按起始时间排序(后续调度依赖有序性) notes.sort(function (a, b) { return a.start - b.start; }); /* ---------------- 统计信息 ---------------- */ var duration = 0; var minNote = 127, maxNote = 0; var channelSet = {}; notes.forEach(function (n) { var e = n.start + n.duration; if (e > duration) duration = e; if (n.midi < minNote) minNote = n.midi; if (n.midi > maxNote) maxNote = n.midi; channelSet[n.channel] = true; }); var tempoList = segments.map(function (s) { return { tick: s.tick, time: s.time, usPerQuarter: s.usPerQuarter, bpm: Math.round(60000000 / s.usPerQuarter * 100) / 100 }; }); return { format: format, declaredTracks: declaredTracks, division: division, ticksPerBeat: ticksPerBeat, smpte: smpte, duration: duration, totalTicks: totalTicks, notes: notes, controllers: controllers, pitchBends: pitchBends, markers: markers, tempos: tempoList, bpm: tempoList.length ? tempoList[0].bpm : 120, minNote: notes.length ? minNote : 60, maxNote: notes.length ? maxNote : 72, channels: Object.keys(channelSet).map(Number).sort(function (a, b) { return a - b; }), tracks: tracks.map(function (t) { return { index: t.index, name: t.name || '', noteCount: t.noteCount || 0, eventCount: t.events.length, endTick: t.endTick, programs: t.programs || {} }; }) }; } /* ---- 供外部使用:根据歌曲信息生成一个可读的标题 ---- */ function guessTitle(song) { var m = (song.markers || []).filter(function (x) { return x.metaType === 0x03 || x.metaType === 0x01; }); if (m.length && m[0].text) return m[0].text; for (var i = 0; i < song.tracks.length; i++) { if (song.tracks[i].name) return song.tracks[i].name; } return ''; } return { parse: parse, noteName: noteName, guessTitle: guessTitle, NOTE_NAMES: NOTE_NAMES }; });