インストール

アルファ版 — npm では未公開

このパッケージはアルファ版であり、まだ npm レジストリに公開されていません。このページのコマンドは最初の公開リリースまで動作しません。それまでは本サイトのライブデモでお試しください。

npmパッケージ

Node.js プロジェクトの依存関係としてインストールします。

npm

npm install @libraz/midi-sketch-bach

yarn

yarn add @libraz/midi-sketch-bach

pnpm

pnpm add @libraz/midi-sketch-bach

bun

bun add @libraz/midi-sketch-bach

インポートして使用します。

import { init, BachGenerator } from '@libraz/midi-sketch-bach'

await init()
const generator = new BachGenerator()

CLI（グローバルインストール）

@libraz/midi-sketch-bach コマンドをどこからでも使えるようにグローバルインストールします。

npm install -g @libraz/midi-sketch-bach

インストールせずに直接実行することもできます。

npx @libraz/midi-sketch-bach --form fugue -o fugue.mid

ブラウザでの利用

MIDI Sketch Bach はWebAssemblyを介してブラウザ上で動作します。ブラウザ環境で使用する場合は、WASM ファイルのパスを指定してください。

import { init, BachGenerator } from '@libraz/midi-sketch-bach'

// ブラウザ環境ではWASM ファイルの場所を指定
await init({ wasmPath: '/wasm/bach.wasm' })

const generator = new BachGenerator()
generator.generate({ form: 'fugue', key: 0 })

const midi = generator.getMidi()
// ダウンロードリンクを作成
const blob = new Blob([midi], { type: 'audio/midi' })
const url = URL.createObjectURL(blob)
// ダウンロード処理の全体は JavaScript API ページを参照

WASM パスについて

Node.jsではWASM ファイルは自動的に解決されます。ブラウザ環境では、.wasm ファイルが配信されている場所を wasmPath オプションで指定する必要があります。

バンドラーの設定

Vite

Vite プロジェクトでは、WASM ファイルが正しく配信されるように設定します。

// vite.config.js
export default {
  optimizeDeps: {
    exclude: ['@libraz/midi-sketch-bach']
  }
}

Webpack

Webpack の場合、.wasm ファイルのアセット処理を設定する必要があります。

// webpack.config.js
module.exports = {
  experiments: {
    asyncWebAssembly: true
  }
}

システム要件

• Node.js: 18.0以降
• ブラウザ: WebAssembly対応の現代的なブラウザ（Chrome、Firefox、Safari、Edge）
• ネイティブ依存関係なし: JavaScript + WebAssemblyのみで構成されています