smfplayer.js is standard MIDI file player using a WebMidiLink compatible synthesizer.
This program is side of sequencer. Tone Generator side is sf2synth.js.
import SMF from '@logue/smfplayer';
const player = new SMF.Player();
window.addEventListener(
'DOMContentLoaded',
() => {
/** @type {boolean} */
const loop = true;
/** @type {boolean} */
const cc111 = true;
/** @type {boolean} */
const falcom = true;
/** @type {boolean} */
const mfi = true;
/** @type {number} */
const tempo = 1.0;
/** @type {number} 0-16383 */
const volume = 16383 * 0.5;
// player settings
player.setLoop(loop); // Player Loop
player.setCC111Loop(cc111); // CC#111 Loop
player.setFalcomLoop(falcom); // Ys2 Eternal Loop
player.setMFiLoop(mfi); // MFi Loop
player.setTempoRate(tempo); // Playback tempo rate
player.setMasterVolume(volume); // Master Volume
player.setWebMidiLink('https://logue.dev/smfplayer.js/wml.html');
// load standard MIDI file
loadSMF('hoge.mid');
},
false
);
/**
* @param {string} url
*/
function loadSMF(url) {
fetch(url)
.then(response => {
if (!response.ok) {
throw new Error('HTTP error, status = ' + response.status);
}
return response.arrayBuffer();
})
.then(arraybuffer => {
/** @type {string} */
const ext = url.split('.').pop();
switch (ext) {
case 'midi':
case 'mid':
// Load MIDI file
player.loadMidiFile(arraybuffer);
break;
case 'mld':
// Load Polyphonic Ringtone File
player.loadMldFile(arraybuffer);
break;
case 'ms2mml':
// Load Maple Story 2 MML File
player.loadMs2MmlFile(arraybuffer);
break;
case 'mms':
// Load MakiMabi Sequence MML File
player.loadMakiMabiSequenceFile(arraybuffer);
break;
case 'mml':
// Load 3MLE MML File
player.load3MleFile(arraybuffer);
break;
case 'mmi':
// Load Mabicco MML File
player.loadMabiIccoFile(arraybuffer);
break;
default:
throw new Error('Unsupported format:' + ext);
}
player.play();
})
.catch(e => console.error(e));
}For more details, please refer to the source code in demo. (Although there are many Bootstrap dependent codes)
Entry point is SMF.
<script src="https://cdn.jsdelivr.net/npm/@logue/smfplayer@latest/dist/smfplayer.iife.min.js"></script>
<script>
const player = new SMF.Player();
// ...
</script>| Method | Description |
|---|---|
| play() | Play Sequence |
| stop() | Stop Sequence |
| sendAllSoundOff() | Send AllSoundOff to WML |
sendGmReset(lv) |
Send GM Reset SysEx to WML. (Set lv to true for GM Level2.) |
| sendRawMidiMessage() | Send Midi message directly (such as F0,7E,7F.09.01,F7) |
| load3MleFile(ArrayBuffer) | Load 3MLE（*.mml）format MML file. |
| loadMakiMabiSequenceFile(ArrayBuffer) | Load MakiMabi Sequence（*.mms）MML file. |
| loadMidiFile(ArrayBuffer) | Load Standard MIDI file.(SMF1, SMF2 both supported) |
| loadMldFile(ArrayBuffer) | Load Docomo Ringtone Melody（*.mld）file. |
| loadMabiIccoFile(ArrayBuffer) | Load MabiIcco（*.mmi）MML file. |
| loadMs2MmlFile(ArrayBuffer) | Load MapleStory2 MML（*.ms2mml）file. |
| setCC111Loop(boolean) | Enable loop by ControlChange No.111 |
| setFalcomLoop(boolean) | Enable Falcom loop (Used MIDI text) |
| setLoop(boolean) | Enable Loop |
| setMFiLoop(boolean) | Enable Mfi meta data loop. |
| setMasterVolume(number) | Set Master volume（0~1） |
| setPosition(number) | Jump sequence position. |
| setTempoRate(number) | Set Tempo Rate |
| setWebMidiLink(string) | Set WML url. |
| getCopyright() | Get Copyright meta data. |
| getLength() | Get Sequence Length. |
| getLyrics() | Get Lyrics meta data of current position. [^1] |
| getPosition() | Get current position. |
| getSequenceName() | Get Sequence name. (usually contains the song title.) |
| getTextEvent() | Get the TextEvent of current position. |
| getWebMidiLink() | Get WebMidiLink URL |
| getTempo() | Get current tempo. |
| getTime(number) | Output current playing time (hh:mm:ss) |
| getTotalTime() | Output playing time of MIDI file.[^2] |
[^1] This program does not parse karaoke data. (KAR, XF, etc.) [^2] Since it is calculated based on the current tempo, if the tempo changes in the middle of the song, the value here will also change.
When reading the following files, the program change values match those of MSXspirit.dls and are not compatible with GM. Download MSXspirit.sf2 from MabiMmlEmu and load it into wml.html to use it.
| Extension | Description |
|---|---|
| *.mms | MakiMabi Sequence |
| *.mml | 3MLE |
| *.mmi | MabiIcco |
When reading an MML file (*.ms2mml) from MapleStory2, the program change is not included in the file format, so the instrument will be 0 (fixed to piano). increase.
- Firefox 7+
- Google Chrome 7+
- Safari 5.1+
- Edge
Recomposer file (*.rcm) support.
Copyright © 2013 imaya / GREE Inc. Copyright © 2013-2024 by Logue.
PSGConverter.js Copyright © 2006-2012 by Logue.
Licensed under the MIT License.