MIDI.js Soundfonts 项目使用教程

1. 项目目录结构及介绍

midi-js-soundfonts/
├── FluidR3_GM/
│   ├── instrument1-mp3.js
│   ├── instrument2-mp3.js
│   └── ...
├── MusyngKite/
│   ├── instrument1-mp3.js
│   ├── instrument2-mp3.js
│   └── ...
├── FatBoy/
│   ├── instrument1-mp3.js
│   ├── instrument2-mp3.js
│   └── ...
├── Tabla/
│   ├── instrument1-mp3.js
│   ├── instrument2-mp3.js
│   └── ...
├── .gitignore
├── LICENSE.txt
├── README.md
├── bower.json
└── package.json

目录结构介绍

• FluidR3_GM/: 包含预渲染的 FluidR3_GM 音色文件。
• MusyngKite/: 包含预渲染的 Musyng Kite 音色文件。
• FatBoy/: 包含预渲染的 FatBoy 音色文件。
• Tabla/: 包含预渲染的 Tabla 音色文件。
• .gitignore: Git 忽略文件配置。
• LICENSE.txt: 项目许可证文件。
• README.md: 项目介绍和使用说明。
• bower.json: Bower 包管理配置文件。
• package.json: npm 包管理配置文件。

2. 项目启动文件介绍

项目本身是一个静态资源库，没有传统的启动文件。用户可以通过浏览器直接访问音色文件，或者在 JavaScript 项目中使用 MIDI.js 库加载这些音色文件。

例如，使用 MIDI.js 加载音色文件的示例代码如下：

MIDI.loadPlugin({
    soundfontUrl: "https://gleitz.github.io/midi-js-soundfonts/FluidR3_GM/",
    instrument: "marimba",
    onsuccess: function() {
        console.log("Marimba loaded successfully");
        MIDI.noteOn(0, 60, 127); // 在通道 0 上播放 C4 音符
    }
});

3. 项目配置文件介绍

bower.json

{
  "name": "midi-js-soundfonts",
  "version": "1.0.0",
  "description": "Pre-rendered General MIDI soundfonts that can be used immediately with MIDI.js",
  "license": "MIT",
  "ignore": [
    "**/.*",
    "node_modules",
    "bower_components",
    "test",
    "tests"
  ]
}

package.json

{
  "name": "midi-js-soundfonts",
  "version": "1.0.0",
  "description": "Pre-rendered General MIDI soundfonts that can be used immediately with MIDI.js",
  "license": "MIT",
  "repository": {
    "type": "git",
    "url": "git://github.com/gleitz/midi-js-soundfonts.git"
  },
  "bugs": {
    "url": "https://github.com/gleitz/midi-js-soundfonts/issues"
  },
  "homepage": "https://github.com/gleitz/midi-js-soundfonts"
}

配置文件介绍

• bower.json: 定义了 Bower 包的基本信息，包括包名、版本、描述和许可证等。
• package.json: 定义了 npm 包的基本信息，包括包名、版本、描述、许可证、仓库地址和问题跟踪地址等。

通过这些配置文件，开发者可以方便地管理和使用 midi-js-soundfonts 项目中的音色文件。