---
title: PannerNode
slug: Web/API/PannerNode
tags:
  - API
  - Interface
  - PannerNode
  - Reference
  - Web Audio API
translation_of: Web/API/PannerNode
---
<p>{{ APIRef("Web Audio API") }}</p>

<div>
<p><code>PannerNode</code> は音源の空間上の位置と振る舞いを表現したインターフェイスで、{{domxref("AudioNode")}} の一種です。右手直交座標系に従って位置を表し、音源の動きは速度ベクトルと、向きを表すサウンドコーンを利用して表現します。</p>
</div>

<p><code>PannerNode</code> は必ず 1 つの入力と、1 つの出力を持ちます。入力はモノラルでもステレオでも構いませんが、出力は必ずステレオとなります。つまりパンニングを行うには最低でも 2 チャンネルの音声チャンネルを必要です。</p>

<p><img alt="The PannerNode brings a spatial position and velocity and a directionality for a given signal." src="https://mdn.mozillademos.org/files/13815/WebAudioPannerNode.png" style="display: block; height: 225px; margin: 0px auto; width: 771px;"></p>

<table class="properties">
 <tbody>
  <tr>
   <th scope="row">入力数</th>
   <td><code>1</code></td>
  </tr>
  <tr>
   <th scope="row">出力数</th>
   <td><code>1</code></td>
  </tr>
  <tr>
   <th scope="row">チャンネルの数え方</th>
   <td><code>"clamped-max"</code></td>
  </tr>
  <tr>
   <th scope="row">チャンネル数</th>
   <td><code>2</code></td>
  </tr>
  <tr>
   <th scope="row">チャンネルの意味</th>
   <td><code>"speakers"</code></td>
  </tr>
 </tbody>
</table>

<h2 id="コンストラクター">コンストラクター</h2>

<dl>
 <dt>{{domxref("PannerNode.PannerNode")}}</dt>
 <dd>新しい <code>PannerNode</code> オブジェクトを作成します。</dd>
</dl>

<h2 id="Properties" name="Properties">属性</h2>

<p><em>親クラスである {{domxref("AudioNode")}} の属性を継承しています。</em></p>

<div class="note">
<p>向きと位置の設定と取得は異なる方法で行います。これは、これらの値が {{domxref("AudioParam")}} として保存されてるためです。値の取得は  <code>PannerNode.positionX</code> のように行えますが、同じ属性に対して値を設定するには <code>PannerNode.positionX.value</code> のように行います。そのため、これらの値は、WebIDL にあるように、読み取り専用とは定義されていません。</p>
</div>

<dl>
 <dt>{{domxref("PannerNode.coneInnerAngle")}}</dt>
 <dd>音量が低減しない範囲を内側にもつコーンの角度が、実数値 (倍精度) で参照できます。</dd>
 <dt>{{domxref("PannerNode.coneOuterAngle")}}</dt>
 <dd>音量が一定値まで低減される範囲を外側に持つコーンの角度が、実数値 (倍精度) で参照できます。低減は  <code>coneOuterGain</code> 属性の値に従います。</dd>
 <dt>{{domxref("PannerNode.coneOuterGain")}}</dt>
 <dd><code>coneOuterAngle</code> の外で行われる音量の低減量を定義します。標準値は <code>0</code> で、これは音が聞こえなくなることを表します。</dd>
 <dt>{{domxref("PannerNode.distanceModel")}}</dt>
 <dd>音量の低減計算に用いるアルゴリズムを定めます。アルゴリズムは定められたものの中から選択します。とりうる値は <code>"linear"</code>、<code>"inverse"</code>、<code>"exponential"</code>で、デフォルト値は <code>"inverse"</code>です。</dd>
 <dt>{{domxref("PannerNode.maxDistance")}}</dt>
 <dd>音源と聴取者の最大距離を定義します。これを超えた場合、音量の低減計算がなされません。</dd>
 <dt>{{domxref("PannerNode.orientationX")}}</dt>
 <dd>右手直交座標系における音源の向きを表すベクトルのうち、水平方向の値です。{{domxref("AudioParam")}} は直接変更できないため、値の変更は{{domxref("AudioParam.value", "value")}} 属性を通して行います。初期値は 1 となっています。</dd>
 <dt>{{domxref("PannerNode.orientationY")}}</dt>
 <dd>右手直交座標系における音源の向きを表すベクトルのうち、垂直方向の値です。{{domxref("AudioParam")}} は直接変更できないため、値の変更は{{domxref("AudioParam.value", "value")}} 属性を通して行います。初期値は 0 となっています。</dd>
 <dt>{{domxref("PannerNode.orientationZ")}}</dt>
 <dd>右手直交座標系における音源の向きを表すベクトルのうち、奥行き(前後)方向の値です{{domxref("AudioParam")}} は直接変更できないため、値の変更は{{domxref("AudioParam.value", "value")}} 属性を通して行います。初期値は 0 となっています。</dd>
 <dt>{{domxref("PannerNode.panningModel")}}</dt>
 <dd>
 <p>立体音響計算を行うアルゴリズムを定めます。アルゴリズムは定められたものの中から選びます。</p>
 </dd>
 <dt>{{domxref("PannerNode.positionX")}}</dt>
 <dd>右手直交座標系における音源の位置を表すベクトルのうち、水平方向の値です{{domxref("AudioParam")}} は直接変更できないため、値の変更は{{domxref("AudioParam.value", "value")}} 属性を通して行います。初期値は 0 となっています。</dd>
 <dt>{{domxref("PannerNode.positionY")}}</dt>
 <dd>右手直交座標系における音源の位置を表すベクトルのうち、垂直方向の値です{{domxref("AudioParam")}} は直接変更できないため、値の変更は{{domxref("AudioParam.value", "value")}} 属性を通して行います。初期値は 0 となっています。</dd>
 <dt>{{domxref("PannerNode.positionZ")}}</dt>
 <dd>右手直交座標系における音源の位置を表すベクトルのうち、奥行き(前後)方向の値です{{domxref("AudioParam")}} は直接変更できないため、値の変更は{{domxref("AudioParam.value", "value")}} 属性を通して行います。初期値は 0 となっています。</dd>
 <dt>{{domxref("PannerNode.refDistance")}}</dt>
 <dd>音量の低減計算に用いる基準距離を表します。音源と聴取者との距離がこれを超えた場合、<code>rolloffFactor</code> と <code>distanceModel</code> に基づいて音量の低減が起きます。</dd>
 <dt>{{domxref("PannerNode.rolloffFactor")}}</dt>
 <dd>音源が聴取者から離れていく際に起きる音量の低減量を定めます。この値は、全ての距離モデルで利用されます。</dd>
</dl>

<h2 id="Methods" name="Methods">メソッド</h2>

<p>親クラスである <em>{{domxref("AudioNode")}}</em> のメソッドを継承しています。</p>

<dl>
 <dt>{{domxref("PannerNode.setPosition()")}}</dt>
 <dd>聴取者に対する音源の相対位置を設定します。聴取者の位置は {{domxref("AudioContext.listener")}}  で参照される{{domxref("AudioListener")}} オブジェクトで表されています。</dd>
</dl>

<dl>
 <dt>{{domxref("PannerNode.setOrientation()")}}</dt>
 <dd>音源が再生されている方向を設定します。</dd>
</dl>

<dl>
 <dt>{{domxref("PannerNode.setVelocity()")}} {{obsolete_inline}}</dt>
 <dd>音源の速度を表したベクトルです。移動する速さと方向を表しています。以前の仕様では下流に接続された{{domxref("AudioBufferSourceNode")}} のピッチを上げ下げするために、{{domxref("PannerNode")}} は速度を表す属性を持っていました。この機能は明瞭に定義されておらず、問題も多かったため、現在の仕様からは削除されています。</dd>
</dl>

<h2 id="Examples" name="Examples">例</h2>

<p>{{page("/ja/docs/Web/API/AudioContext.createPanner","Example")}}</p>

<h2 id="Specifications" name="Specifications">仕様</h2>

<table class="standard-table">
 <tbody>
  <tr>
   <th scope="col">仕様</th>
   <th scope="col">状況</th>
   <th scope="col">コメント</th>
  </tr>
  <tr>
   <td>{{SpecName('Web Audio API', '#the-pannernode-interface', 'PannerNode')}}</td>
   <td>{{Spec2('Web Audio API')}}</td>
   <td></td>
  </tr>
 </tbody>
</table>

<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザー実装状況</h2>

<div>


<p>{{Compat("api.PannerNode")}}</p>
</div>

<h2 id="See_also" name="See_also">関連情報</h2>

<ul>
 <li><a href="/ja/docs/Web_Audio_API/Using_Web_Audio_API">Using the Web Audio API</a></li>
</ul>