---
title: AudioBuffer
slug: Web/API/AudioBuffer
translation_of: Web/API/AudioBuffer
---
<p>{{APIRef("Web Audio API")}}</p>

<div>
<p>Interfejs <code>AudioBuffer</code> przedstawia krótki zasób dźwiękowy znajdujący się w pamięci, stworzony z pliku dźwiękowego za pomocą metody {{ domxref("AudioContext.decodeAudioData()") }} lub z surowych danych przy użyciu {{ domxref("AudioContext.createBuffer()") }}. Dane audio umieszczone w AudioBuffer mogą być następnie odtwarzane przez przekazanie ich do {{ domxref("AudioBufferSourceNode") }}.</p>
</div>

<p>Obiekty tego typu są przeznaczone do przechowywania drobnych fragmentów dźwiękowych, zwykle mniej niż 45s. W przypadku dłuższych dźwięków, obiekty implementujące {{domxref("MediaElementAudioSourceNode")}} są bardziej odpowiednie. Bufor zawiera dane w następującym formacie: IEEE754 32 -bitowy liniowy PCM bez przeplotu o nominalnym zakresie między -1 i +1 , czyli 32-bitowy zmiennoprzecinkowy bufor z próbkami o znormalizowanych wartościach między -1.0 a 1.0. Jeśli {{domxref("AudioBuffer")}} ma wiele kanałów, są one przechowywane w osobnym buforze.</p>

<h2 id="Właściwości">Właściwości</h2>

<dl>
 <dt>{{domxref("AudioBuffer.sampleRate")}} {{readonlyInline}}</dt>
 <dd>Zwraca wartość typu <code>float</code> reprezentującą częstotliwość próbkowania danych PCM przechowywanych w buforze wyrażoną w próbkach na sekundę.</dd>
 <dt>{{domxref("AudioBuffer.length")}} {{readonlyInline}}</dt>
 <dd>Zwraca wartość typu <code>int</code> reprezentującą wielkość danych PCM przechowywanych w buforze wyrażoną jako liczba okien próbek.</dd>
 <dt>{{domxref("AudioBuffer.duration")}} {{readonlyInline}}</dt>
 <dd>Zwraca wartość typu <code>double </code>reprezentującą czas trwania danych PCM zapisanych w buforze wyrażoną w sekundach.</dd>
 <dt>{{domxref("AudioBuffer.numberOfChannels")}} {{readonlyInline}}</dt>
 <dd>Zwraca wartość typu<code> int</code> reprezentującą liczbę pojedynczych kanałów audio opisanych przez dane PCM zapisanych w buforze.</dd>
</dl>

<h2 id="Metody">Metody</h2>

<dl>
 <dt>{{domxref("AudioBuffer.getChannelData()")}}</dt>
 <dd>Zwraca tablicę {{jsxref("Float32Array")}} zawierającą dane PCM powiązane z kanałem audio określonym jako parametr <code>channel</code> <code>(0</code> reprezentuje pierwszy kanał).</dd>
 <dt>{{domxref("AudioBuffer.copyFromChannel()")}}</dt>
 <dd>Kopiuje próbki z danego kanału w <span class="idlType"><code>AudioBuffer</code></span> do danej tablicy.</dd>
 <dt>{{domxref("AudioBuffer.copyToChannel()")}}</dt>
 <dd>Kopiuje próbki z danej tablicy do danego <span class="idlType"><code>kanału w AudioBuffer</code></span>.</dd>
</dl>

<h2 id="Przykład">Przykład</h2>

<p>Następujący przykład kodu pokazuje jak stworzyć <code>AudioBuffer</code> i wypełnić go białym szumem. Pełną wersję kodu można znależć w naszym repozytorium <a href="https://github.com/mdn/audio-buffer">audio-buffer demo</a>; jest dostępna także uruchomiona na żywo wersja <a href="http://mdn.github.io/audio-buffer/">running live version</a>.</p>

<pre class="brush: js;highlight:[7,14,27]">// Stereo
var channels = 2;

// Tworzenie pustego, dwusekundowego buffera stereo
// na wskaźniku audio z AudioContext
var frameCount = audioCtx.sampleRate * 2.0;
var myArrayBuffer = audioCtx.createBuffer(channels, frameCount, audioCtx.sampleRate);

button.onclick = function() {
  // Wypełnienie buffera białym szumem;
  // Wartość losowa pomiędzy -1.0 a 1.0
  for (var channel = 0; channel &lt; channels; channel++) {
    // To daje nam aktualną tablice zawierającą dane
    var nowBuffering = myArrayBuffer.getChannelData(channel);
    for (var i = 0; i &lt; frameCount; i++) {
      // Math.random() znajduje się w przedziale [0; 1.0]
      // audio musi znajdować się w [-1.0; 1.0]
      nowBuffering[i] = Math.random() * 2 - 1;
    }
  }

  // Dostarczenie AudioBufferSourceNode.
  // To jest AudioNode dedykowane do używania wtedy, kiedy chcemy odtworzyć dany AudioBuffer
  var source = audioCtx.createBufferSource();

  // Określanie buffera w AudioBufferSourceNode
  source.buffer = myArrayBuffer;

  // Podłączanie AudioBufferSourceNode do
  // destynacji, dzięki czemu możemy usłyszeć dźwięk
  source.connect(audioCtx.destination);

  // start odtwarzania źródła
  source.start();

}
</pre>

<h2 id="Specyfikacje">Specyfikacje</h2>

<table class="standard-table">
 <tbody>
  <tr>
   <th scope="col">Specyfikacja</th>
   <th scope="col">Status</th>
   <th scope="col">Komentarz</th>
  </tr>
  <tr>
   <td>{{SpecName('Web Audio API', '#the-audiobuffer-interface', 'AudioBuffer')}}</td>
   <td>{{Spec2('Web Audio API')}}</td>
   <td>Definicja wstępna.</td>
  </tr>
 </tbody>
</table>

<h2 id="Kompatybilność_z_przeglądarkami">Kompatybilność z przeglądarkami</h2>

<div>{{CompatibilityTable}}</div>

<div id="compat-desktop">
<table class="compat-table">
 <tbody>
  <tr>
   <th>Cecha</th>
   <th>Chrome</th>
   <th>Firefox (Gecko)</th>
   <th>Internet Explorer</th>
   <th>Opera</th>
   <th>Safari (WebKit)</th>
  </tr>
  <tr>
   <td>Wsparcie podstawowe</td>
   <td>14 {{property_prefix("webkit")}}</td>
   <td>{{CompatGeckoDesktop(25)}}</td>
   <td>{{CompatNo}}</td>
   <td>15 {{property_prefix("webkit")}}<br>
    22</td>
   <td>6 {{property_prefix("webkit")}}</td>
  </tr>
  <tr>
   <td><code>copyFromChannel()</code> and <code>copyToChannel()</code></td>
   <td>{{CompatUnknown}}</td>
   <td>{{CompatGeckoDesktop(27)}}</td>
   <td>{{CompatNo}}</td>
   <td>{{CompatUnknown}}</td>
   <td>{{CompatNo}}</td>
  </tr>
 </tbody>
</table>
</div>

<div id="compat-mobile">
<table class="compat-table">
 <tbody>
  <tr>
   <th>Cecha</th>
   <th>Android</th>
   <th>Chrome</th>
   <th>Firefox Mobile (Gecko)</th>
   <th>Firefox OS</th>
   <th>IE Phone</th>
   <th>Opera Mobile</th>
   <th>Safari Mobile</th>
  </tr>
  <tr>
   <td>Wsparcie podstawowe</td>
   <td>{{CompatNo}}</td>
   <td>28 {{property_prefix("webkit")}}</td>
   <td>{{CompatGeckoMobile(25)}}</td>
   <td>1.2</td>
   <td>{{CompatNo}}</td>
   <td>{{CompatNo}}</td>
   <td>6 {{property_prefix("webkit")}}</td>
  </tr>
  <tr>
   <td><code>copyFromChannel()</code> and <code>copyToChannel()</code></td>
   <td>{{CompatNo}}</td>
   <td>{{CompatUnknown}}</td>
   <td>{{CompatGeckoMobile(27)}}</td>
   <td> </td>
   <td>{{CompatNo}}</td>
   <td>{{CompatNo}}</td>
   <td>{{CompatNo}}</td>
  </tr>
 </tbody>
</table>
</div>

<h2 id="Zobacz_także">Zobacz także</h2>

<ul>
 <li><a href="/en-US/docs/Web/API/Web_Audio_API/Using_Web_Audio_API">Używanie Web Audio API</a></li>
</ul>