オーディオファイル出力機能追加

[argentum384]

概要

FlMML on HTML5 を利用するツールの中にはシーケンサの出力を wav, mp3 などのオーディオファイルに出力できるよう改変しているものが見受けられる。
ただ、かなり大がかりな改変を各々のツール作成者に強いることになってしまっているので、本分であるMML再生機能への影響が小さく、またソースコードサイズが大きくなりすぎない範囲で類似のオーディオファイル出力機能を追加する。

仕様

wav ファイル、mp3 ファイルの出力を可能とする。
出力後ファイルを加工することを考慮し、直接ブラウザにダウンロードさせず、ファイルのバイナリデータを取得するようにする。

• 共通
  • flmml.export***(mml, ...) の形式のメソッドを実行して出力開始
  • 戻り値は Promise<ArrayBuffer[]> とし、出力が完了したら resolve され ArrayBuffer[] として出力ファイルのバイナリデータを取得できる
    • ArrayBuffer[] はそのまま new Blob(...) の第一引数に指定できる
  • 出力中シーケンサは通常再生と異なり、いわばオーディオファイル出力モードで動作する
    • Web Audio は一切操作しない
    • シーケンサで作成した音声バッファも AudioWorkletProcessor には送らず、代わりに同一 Worker 内オーディオファイル出力用の処理に回される
    • 現在の処理位置は通常再生と同様 flmml.getNowMSec() 等で取得可
    • 一時停止 (flmml.pause()) は無効とする
    • 出力中 flmml.stop() を実行すると出力処理を中断し、戻り値の Promise は reject される 中断時点までの分だけ出力して処理完了する
    • 出力中 flmml.play(mml) を実行した場合、 出力中の処理が中断, reject される 中断時点までの分だけ出力して処理完了する。その後通常再生が始まる
    • 出力中 flmml.export***(mml, ...) を再度実行した場合、後から実行した方は reject される
  • チャンネル数とサンプリングレートは FlMML シーケンサ部と同じ 2ch, 44100 Hz で固定
• wav ファイル
  • flmml.exportWav(mml) で出力
  • ビット深度は 16 ビットで固定
• mp3 ファイル
  • flmml.exportMp3(mml, bitrate) で出力
  • ビットレート bitrate は指定可。省略時は 192 (kbps) とする
  • エンコーダに lamejs を利用
  • mp3ファイル出力を利用する場合のみ new FlMML(...) のオプションで lamejs のスクリプトのURLを指定させ、 importScripts(...) で読み込むようにする

[argentum384]

オーディオ出力処理中に停止した場合に reject して例外を投げてしまうのはやり過ぎだし、途中まで処理した分を出力するのはそう難しくないので、処理中に停止した場合は途中までの分を出力して処理完了とする。