KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

AudioNode — audiografieknopen en verbindingen

AudioNode is de basisinterface voor Web Audio-knopen. De methode connect() leidt audioverwerking door of stuurt een audioparameter aan.

Versie: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntax

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 is de basisinterface voor bronnen, processors en uitgangen in een Web Audio-graaf. Maak concrete knopen, bijvoorbeeld met context.createGain(), in plaats van new AudioNode() te gebruiken. Dit is een browser-API en geen onderdeel van ECMAScript; de aanwezigheid van Node 24 bevestigt niet dat deze API beschikbaar is.

AudioNode.connect, aangeroepen als node.connect(...), verbindt een uitgang met de ingang van een andere knoop of met een AudioParam. De variant met een knoop als argument retourneert het doel en maakt ketens mogelijk; de variant met een AudioParam retourneert undefined. Poortindexen zijn standaard 0; het zijn geen kanaalnummers. Verschillende contexten veroorzaken InvalidAccessError, en indexen buiten het bereik veroorzaken IndexSizeError. Een identieke verbinding wordt genegeerd als deze wordt herhaald.

Voorbeelden

(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);

Resultaat

128 true

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen