AudioBufferSourceNode

L'interface AudioBufferSourceNode est un AudioScheduledSourceNode qui représente une source audio constituée de données audio en mémoire, stockées dans un AudioBuffer. Elle est particulièrement utile pour lire des sons qui requierrent des conditions de lecture particulières, comme la synchronisation sur un certain rythme, et peuvent être stockés en mémoire. Si ce type de son doit être lu depuis le disque ou le réseau, il conviendra d'utiliser un AudioWorkletNode.

Un AudioBufferSourceNode n'a pas d'entrée et il comporte une unique sortie, dont le nombre de canaux est spécifié par la propriété buffer. Si aucun buffer n'est paramétré, c'est-à-dire si la valeur de l'attribut est NULL, la sortie contient un seul canal silencieux (chaque échantillon vaut 0).

Un AudioBufferSourceNode ne peut être joué qu'une seule fois; autrement dit un seul appel à la fonction AudioBufferSourceNode.start() est autorisé. Pour rejouer le son, il faut créer un nouvel AudioBufferSourceNode. Heureusement ces noeuds ne demandent pas beaucoup de ressource, et les véritables AudioBuffers peuvent être réutilisés. On dit que les AudioBufferSourceNodes doivent être utilisés en mode "one shot": une fois que la lecture est lancée, toutes les références peuvent être supprimées, et elles seront collectées par le ramasse-miette automatiquement quand la lecture des sons sera terminée.

Plusieurs appels à la fonction AudioBufferSourceNode.stop() sont autorisés. Le dernier appel remplace le précédent, à condition que le AudioBufferSourceNode n'ait pas déjà atteint la fin du buffer.

Nombre d'entrées	0
Nombre de sorties	1
Nombre de canaux	défini par l'objet AudioBuffer associé

var contexteAudio = new (window.AudioContext || window.webkitAudioContext)();
var bouton = document.querySelector("button");
var pre = document.querySelector("pre");
var monScript = document.querySelector("script");

pre.innerHTML = monScript.innerHTML;

// Stéréo
var canaux = 2;

// Crée un tampon vide de deux secondes
// au taux d'échantillonnage du AudioContext
var compteurTrames = contexteAudio.sampleRate * 2.0;

var myArrayBuffer = contexteAudio.createBuffer(
  2,
  compteurTrames,
  contexteAudio.sampleRate,
);

bouton.onclick = function () {
  // remplit le tampon avec du bruit blanc;
  // valeurs aléatoires entre -1.0 et 1.0
  for (var canal = 0; canal < canaux; canal++) {
    // crée le ArrayBuffer qui contient les données
    var nowBuffering = myArrayBuffer.getChannelData(canal);
    for (var i = 0; i < compteurTrames; i++) {
      // Math.random() est compris entre [0; 1.0]
      // audio doit être compris entre [-1.0; 1.0]
      nowBuffering[i] = Math.random() * 2 - 1;
    }
  }

  // crée AudioBufferSourceNode.
  // c'est AudioNode utilisé pour lire un AudioBuffer
  var source = contexteAudio.createBufferSource();
  // initialise le tampon du AudioBufferSourceNode
  source.buffer = myArrayBuffer;
  // connecte l'AudioBufferSourceNode avec la destination
  // de façon à ce qu'on puisse entendre le son
  source.connect(contexteAudio.destination);
  // lance la lecture de la source
  source.start();
};