[project-s] AudioRenderer.tsのリファクタリングとコメントの追加

[sigprogramming]

内容

AudioRenderer.tsのリファクタリングとコメントの追加を行います。

用語の説明と補足

コンテキスト時刻

AudioContextの場合は、AudioContextを作成してからの経過時間になります。単位は秒です。
現在のコンテキスト時刻はcurrentTimeプロパティで取得できます。

// 現在のコンテキスト時刻を取得する
const contextTime = audioContext.currentTime;

Web Audio APIでは音声処理はレンダリングスレッドで行われるため、再生・停止のタイミングをメインスレッドから正確にコントロールするには、コンテキスト時刻で再生時刻・停止時刻を指定（スケジュール）する必要があります。

• 2.2. 制御スレッドとレンダリングスレッド（Web Audio API 日本語訳）

オフラインレンダリング

OfflineAudioContextを使用して行うレンダリングで、音声デバイスへの出力を行いません。

トランスポート（Transport）

DAWのトランスポートのイメージです。
イベントスケジューラーを使用して複数のシーケンスのスケジューリングを行います。

• トランスポート:Transportとは | 偏ったDTM用語辞典 - DTM / MIDI 用語の意味・解説 | g200kg Music & Software

シーケンス（Sequence）

DAWのトラック、リージョンのイメージです。
音源とイベントを持ちます。

• トラック:Trackとは | 偏ったDTM用語辞典 - DTM / MIDI 用語の意味・解説 | g200kg Music & Software
• リージョン:Regionとは | 偏ったDTM用語辞典 - DTM / MIDI 用語の意味・解説 | g200kg Music & Software

スケジューリング

トランスポートとイベントスケジューラーのスケジューリング処理は、以下のページを参考に実装しています。

• 二つの時計についての物語 | Articles | web.dev
• Advanced techniques: Creating and sequencing audio - Web APIs | MDN

関連 Issue

ref #1041

その他

[Hiroshiba]

LGTM！！！！！！

ドキュメントすごくありがたいです！！！
プルリクエストの説明も含めて、内容がなんとなくわかった気持ちになれました！

これは追加してくださいというよりも読んでみた感想なのですが、スケジューラー、イベント、シンセサイザー、ボイスあたりが未定義というか具体的な役割がまだちょっとつかめなかったかもです！
あとなんとなくですが、ユーザーがノートを置いてから、音声が作られ、AudioPlayerが再生するまでの一通りのデータの流れを、なんとなくのシーケンス図として書いてあげればだいぶ流れが掴みやすいかもと思いました！

プルリクエストでの説明がかなり有用なので、これもドキュメントに含めてあげたい気が少ししました。
docsディレクトリあたりに適当にメモファイル（project-s.mdでも何でも）を置いておいて、そこに全体用の説明をちょくちょく書いていく手もあるかもです！

[Hiroshiba]

マージします！

[sigprogramming]

レビュー＆マージありがとうございます！
クラス・インターフェースを一通り整理できたら、ドキュメント（シーケンス図など）を書こうと思います！