AudioNode

Ein AudioNode ist eine generische Schnittstelle um ein Signalverarbeitungsmodul wie z.B. ein HTML <audio> (en-US) or <video> Element, ein OscillatorNode (en-US), die Audio Destination, ein zwischengeschaltenes audio-verarbeitendes Modul wie z.B. einen BiquadFilterNode (en-US) oder ConvolverNode (en-US)), oder LautstĂ€rkeregler (like GainNode).

AudioNodes participating in an AudioContext create a audio routing graph.

Ein AudioNode hat Ein- und AusgĂ€nge, jeweils mit einer gegebenen Anzahl an KanĂ€len. Einen AudioNode ohne EingĂ€nge und mit einem oder mehreren AusgĂ€ngen nennt man source node (dt.: Quellknoten). Die Art der Signalverarbeitung in einem Audio Node variiert mit dessen Funktion. Der folgende Ablauf liegt jedoch immer zugrunde:  das Signal am Eingang wird eingelesen,  das Signal wird zu einem neuen Signal verarbeitet und an den Ausgang geleitet. In einigen FĂ€llen, wir das Signal unverarbeitet durchgeschleust, so z.B. beim AnalyserNode (en-US), wo das Resultat der Signalverarbeitung separat zugĂ€nglich ist.

Mehrere Nodes können zu einem Processing Graph (dt.:Verarbeitungs-Netz) verbunden werden. Ein solcher Graph befindet sich immer in genau einem AudioContext. Signal- verarbeitende Nodes erben die Eigenschaften und Methoden von Audio Node, implementieren aber auch eigene FunktionalitĂ€t. Weitere Informationen geben die Seiten der speziellen Audio Nodes,  die sie auf der Homepage der Web Audio API finden.

Hinweis: Ein AudioNode kann das Ziel von Events sein, und implementiert daher die EventTarget Schnittstelle.

Properties

AudioNode.context (en-US) SchreibgeschĂŒtzt
Liefert den assoziierten AudioContext, der den signalverarbeitenden Graphen (processing graph) enthĂ€lt, in den der Node eingebunden ist.
AudioNode.numberOfInputs (en-US) SchreibgeschĂŒtzt
Liefert die Anzahl der EingĂ€nge des Nodes. Source nodes (dt. Quellknoten) sind definiert als Nodes, deren numberOfInputs Eigenschaft einen Wert von aufweist.
AudioNode.numberOfOutputs (en-US) SchreibgeschĂŒtzt
Liefert die Anzahl der AusgĂ€nge des Nodes. Destination nodes (dt.: Zielknoten) â€” wie AudioDestinationNode — haben einen Wert von  0 fĂŒr diese Eigenschaft.
AudioNode.channelCount (en-US)
Represents an integer used to determine how many channels are used when up-mixing and down-mixing connections to any inputs to the node. Its usage and precise definition depend on the value of AudioNode.channelCountMode (en-US).
AudioNode.channelCountMode (en-US)
Represents an enumerated value describing the way channels must be matched between the node's inputs and outputs.
AudioNode.channelInterpretation (en-US)
Represents an enumerated value describing the meaning of the channels. This interpretation will define how audio up-mixing and down-mixing will happen.
The possible values are "speakers" or "discrete".

Methods

Also implements methods from the interface EventTarget.

AudioNode.connect(AudioNode) (en-US)
Allows us to connect one output of this node to one input of another node.
AudioNode.connect(AudioParam)
Allows us to connect one output of this node to one input of an audio parameter.
AudioNode.disconnect() (en-US)
Allows us to disconnect the current node from another one it is already connected to.

Example

This simple snippet of code shows the creation of some audio nodes, and how the AudioNode properties and methods can be used. You can find examples of such usage on any of the examples linked to on the Web Audio API landing page (for example Violent Theremin.)

var AudioContext = window.AudioContext || window.webkitAudioContext;

var audioCtx = new AudioContext();

var oscillator = audioCtx.createOscillator();
var gainNode = audioCtx.createGain();

oscillator.connect(gainNode);
gainNode.connect(audioCtx.destination);

oscillator.context;
oscillator.numberOfInputs;
oscillator.numberOfOutputs;
oscillator.channelCount;

Specifications

Specification Status Comment
Web Audio API
Die Definition von 'AudioNode' in dieser Spezifikation.
Arbeitsentwurf  

Browser compatibility

Wir konvertieren die KompatibilitÀtsdaten in ein maschinenlesbares JSON Format. Diese KompatibilitÀtstabelle liegt noch im alten Format vor, denn die darin enthaltenen Daten wurden noch nicht konvertiert. Finde heraus wie du helfen kannst! (en-US)
Feature Chrome Firefox (Gecko) Internet Explorer Opera Safari (WebKit)
Basic support 10.0webkit (en-US) 25.0 (25.0) Nicht unterstĂŒtzt 15.0webkit (en-US)
22 (unprefixed)
(Ja)
channelCount channelCountMode (Ja) webkit (en-US) (Ja) Nicht unterstĂŒtzt (Ja) Nicht unterstĂŒtzt
connect(AudioParam) (Ja) webkit (en-US) (Ja) Nicht unterstĂŒtzt (Ja) Nicht unterstĂŒtzt
Feature Android Firefox Mobile (Gecko) Firefox OS (Gecko) IE Phone Opera Mobile Safari Mobile
Basic support ? 25.0 1.2 ? ? ?
channelCount
channelCountMode
Nicht unterstĂŒtzt (Ja) (Ja) Nicht unterstĂŒtzt Nicht unterstĂŒtzt Nicht unterstĂŒtzt
connect(AudioParam) Nicht unterstĂŒtzt (Ja) (Ja) Nicht unterstĂŒtzt Nicht unterstĂŒtzt Nicht unterstĂŒtzt

See also