INDIE INDEX

レベル:実践

Web Audio API とは|ブラウザの中で音を組み立てて鳴らすための仕組み

言葉の意味

Web Audio API(ウェブオーディオ・エーピーアイ)は、ブラウザの中で音を処理し、作り出すための決まりです。音の波形を1つ1つ自分で書かなくても、部品を組み合わせて音を作れます。

Web のページに置く音の要素(audio 要素)は、音の基本的なストリーミング再生を受け持ちます。これに対し、この決まりが受け持つのは、音の大きさを変える、左右の聞こえ方を変える、複数の音を重ねる、効果をかけるなどの処理を、音を鳴らす道筋そのものとして組み立てることです。部品をいくつもつなぎ合わせて、全体としてどう鳴らすかを決めます。

ブラウザで遊ぶゲームで BGM や効果音を鳴らすとき、まず AudioContext を作ります。この決まりの音の処理は AudioContext の中で行われ、音の部品はノードと呼ばれます。音の元になるノード、音を変えるノード、出口のノードをつなぎ合わせた全体が、音を鳴らす道筋になります。出口のノードは、多くの場合は自分で作る必要がなく、ほかのノードを AudioContext の destination につなげます。音量の変化を表すノードが GainNode で、gain の値が初期値の1なら音量は変わらず、0 にすると音は実質的に消えます。たとえば、音の元になるノード、GainNode、destination の順につなぐと、gain の値で音量を変えながら鳴らせます。その形は、次の順に作ります。

  1. AudioContext を作ります。
  2. 音の元になるノードを用意します。
  3. GainNode を作り、音の元になるノードをつなぎます。
  4. GainNode を destination につなぎます。

AudioContext の状態は、作った直後は suspended(時間が進んでいない状態)で、ブラウザが許すと running(音が処理されている状態)に移ります。ブラウザは、この最初の移りを、ページが利用者の操作を受けたあとにだけ許すことがあります。そのときは、クリックなどの操作を受ける処理の中で、状態が suspended のときに resume() を呼んで動かす形になります。ブラウザごとの扱いと、この形を試した記録は、Claude Codeに、BGMと効果音を鳴らす処理を書かせる頼み方【AIでゲーム開発】にあります。

Godot は 4.3 から、Web での音の再生の既定のモードが Web Audio API を使います。Unity は、Web 向けには内部の Web Audio API を土台にした実装で音を扱います。書き出したときの音の制限は、Webに書き出す|UnityとGodotの制限とサーバー設定にあります。

定めているのは W3C(Web の標準を決める団体)です。仕様は、この決まりが Web のほかの仕組みと組み合わせて使われることを前提にしており、ゲームと操作のあるアプリでは、canvas(絵を描くための四角い枠)の平面の描画と、ブラウザの中で立体を描く仕組みと組み合わせて使われることが想定されています。ブラウザ向けのエンジンにも、この仕組みで3次元の音・左右の振り分けなどを備えるものがあります。

次に読む

この言葉が出てくる手順のページは、Claude Codeに、BGMと効果音を鳴らす処理を書かせる頼み方【AIでゲーム開発】です。

情報源

関連ページ2

この言葉を定義している公式のページ

公式の定義

このページの内容の誤りは、問い合わせの窓口で受け付けています。