CKTIS / JavaScript
AudioNode – Audiograph-Knoten und Verbindungen
AudioNode ist die Basisschnittstelle für Web-Audio-Knoten. Die Methode connect() leitet die Audioverarbeitung weiter oder steuert einen Audio-Parameter.
Version: 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 ist die Basisschnittstelle für Quellen, Prozessoren und Ausgänge in einem Web-Audio-Graphen. Erzeuge konkrete Knoten, zum Beispiel mit context.createGain(), statt new AudioNode() zu verwenden. Dies ist eine Browser-API und kein Teil von ECMAScript; die Verfügbarkeit von Node 24 belegt nicht, dass diese API verfügbar ist.
AudioNode.connect, aufgerufen als node.connect(...), verbindet einen Ausgang mit dem Eingang eines anderen Knotens oder mit einem AudioParam. Die Überladung mit einem Knoten gibt das Ziel zurück und ermöglicht Verkettungen; die Überladung mit einem AudioParam gibt undefined zurück. Die Portindizes haben standardmäßig den Wert 0; sie sind keine Kanalnummern. Unterschiedliche Kontexte lösen InvalidAccessError aus, und Indizes außerhalb des gültigen Bereichs lösen IndexSizeError aus. Eine identische Verbindung wird bei Wiederholung ignoriert.
Beispiele
(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);Ergebnis
128 true
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.