CKTIS / JavaScript
AudioNode — nœuds et connexions du graphe audio
AudioNode est l’interface de base des nœuds Web Audio. Sa méthode connect() achemine le traitement audio ou contrôle un paramètre audio.
Version : ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
node.connect(destinationNode) // returns destinationNode
node.connect(destinationNode, output) // returns destinationNode
node.connect(destinationNode, output, input) // returns destinationNode
node.connect(destinationParam) // returns undefined
node.connect(destinationParam, output) // returns undefined
// Omitted output and input indices default to 0.AudioNode est l’interface de base des sources, des processeurs et des sorties d’un graphe Web Audio. Créez des nœuds concrets, par exemple avec context.createGain(), plutôt qu’avec new AudioNode(). Il s’agit d’une API de navigateur, et non d’un élément d’ECMAScript ; la présence de Node 24 ne garantit pas sa disponibilité.
AudioNode.connect, appelée sous la forme node.connect(...), relie une sortie à l’entrée d’un autre nœud ou à un AudioParam. La surcharge qui prend un nœud renvoie la destination, ce qui permet les chaînes d’appels ; celle qui prend un AudioParam renvoie undefined. Les indices des ports valent 0 par défaut ; ce ne sont pas des numéros de canaux. Des contextes différents provoquent InvalidAccessError, et les indices hors limites provoquent IndexSizeError. La répétition d’une connexion identique est ignorée.
Exemples
(async () => {
const context = new OfflineAudioContext(1, 128, 48000);
const buffer = context.createBuffer(1, 128, 48000);
buffer.getChannelData(0).fill(1);
const source = context.createBufferSource();
source.buffer = buffer;
const gain = context.createGain();
gain.gain.value = 0.5;
source.connect(gain).connect(context.destination);
source.start(0);
const rendered = await context.startRendering();
const samples = rendered.getChannelData(0);
console.log(samples.length, samples.every(value => value === 0.5));
})().catch(console.error);Résultat
128 true
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.