feat: Overview

Korilakkuma · Dec 13, 2023 · 91124d2 · 91124d2
1 parent 257175a
commit 91124d2
Show file tree

Hide file tree

Showing 2 changed files with 43 additions and 1 deletion.
diff --git a/docs/docs.css b/docs/docs.css
@@ -30,7 +30,8 @@ main {
 }
 
 h1,
-h2 {
+h2,
+h3 {
   padding: 0;
   margin: var(--base-margin) 0;
 }

diff --git a/docs/index.html b/docs/index.html
@@ -56,6 +56,47 @@ <h1>Web Music</h1>
         です (例えば, Web Music の API は Node.js で使うことはできません. また, Web ブラウザでも Web Workers が生成したスレッドでは, UI
         スレッドと実行コンテキストが異なるので使うことができません).
       </aside>
+      <section>
+        <h2>Web Audio API</h2>
+        <p>
+          Web Music のなかで, もっともコアな API が <strong>Web Audio API</strong> です. 言い換えると, Web
+          をプラットフォームとした音楽アプリケーションを制作するほとんどの場合で必要になる API ということです. なぜなら, HTMLAudioElement
+          はオーディオファイルを再生するための API で, 高度なオーディオ処理をすることはできず (厳密には,
+          <a href="https://egonelbre.com/project/jsfx/" target="_blank" rel="noopener noreferrer">jsfx</a>
+          のようにハッキーな実装をすることでエフェクトをかけるぐらいは可能ですが, 仕様のユースケースとして想定されている使い方ではありません),
+          リアルタイム性やインタラクティブ性も考慮された API ではないからです (厳密には, 考慮された経緯もあって,
+          <code>Audio</code> コンストラクタが定義されています). また, Web Music として, Web MIDI API や WebRTC を使う場合, 実際のオーディオ処理は Web Audio API
+          が実行することになります.
+        </p>
+        <section>
+          <h3>ブラウザ Audio API の歴史</h3>
+          <p>
+            古くは, IE (Internet Explorer) が独自に, <code>bgsound</code> というタグを実装しており, ブラウザでオーディオをファイルを再生することが可能でした
+            (現在の HTMLAudioElement に相当するタグと言えます). その後, Java アプレットや ActionScript (Flash) によって, 現在の Web Audio API
+            で実現できているような高度なオーディオ処理が可能となりました.
+          </p>
+          <p>
+            しかし, これらは特定のベンダーに依存し, また, ブラウザの拡張機能 (プラグイン) という位置づけでした. Web 2.0 (もっと言えば, Ajax) を機にブラウザでも,
+            ネイティブアプリケーションに近いアプリケーションが実装されてくるようになると, これまで拡張機能 (オーディオ処理だけでなく,
+            ストレージやローカルファイルへのアクセス, ソケットなど) に頼っていたような機能をブラウザ標準で (クライアントサイド JavaScript API で)
+            実現できる流れが 2010 年ごろから活発になりました (このころ, HTML5 という位置づけで仕様策定され, モダンブラウザで実装されるようになりました).
+            そういった流れのなかで, Web Audio API も仕様策定されて現在に至っています (<a
+              href="https://www.w3.org/TR/2011/WD-webaudio-20111215/"
+              target="_blank"
+              rel="noopener noreferrer"
+              >草案 (Working Draft) が 2011 年 12 月 15 日 に公開</a
+            >. <a href="https://www.w3.org/TR/webaudio/" target="_blank" rel="noopener noreferrer">2021 年 6 月 17 日に勧告</a> (W3C recommendation
+            で現在の最新バージョン).
+          </p>
+        </section>
+        <aside>
+          <b>Audio Data API</b> 厳密な歴史を記載すると, Web Audio API より先に Firefox で,
+          <a href="https://wiki.mozilla.org/Audio_Data_API" target="_blank" rel="noopener noreferrer">Audio Data API</a> というブラウザ Audio API
+          が実装されていました. HTMLAudioElement の拡張という位置づけであり, 出力するオーディオデータを直接演算する API がメインでした (Web Audio API の
+          <code>ScriptProcessorNode</code> に相当する API). 間もなくして, Web Audio API に統一される方針となり, Firefox も Web Audio API
+          のサポートを開始したので現在は削除されています.
+        </aside>
+      </section>
     </main>
   </body>
 </html>