MediaStreamAudioSourceNode
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since April 2021.
Das MediaStreamAudioSourceNode Interface ist eine Art von AudioNode, das als Audioquelle fungiert, deren Medien von einem MediaStream empfangen werden, der mit den WebRTC- oder Media Capture- und Streams-APIs gewonnen wurde.
Diese Medien könnten von einem Mikrofon (über getUserMedia()) oder von einem entfernten Teilnehmer in einem WebRTC-Gespräch (Verwendung der Audio-Tracks von RTCPeerConnection) stammen.
Ein MediaStreamAudioSourceNode hat keine Eingänge und genau einen Ausgang und wird mit der AudioContext.createMediaStreamSource() Methode erstellt.
Das MediaStreamAudioSourceNode nimmt das Audio vom ersten MediaStreamTrack, dessen kind Attributswert audio ist. Siehe Track-Reihenfolge für weitere Informationen über die Reihenfolge der Tracks.
Die Anzahl der Kanäle, die vom Knoten ausgegeben werden, stimmt mit der Anzahl der Tracks überein, die im ausgewählten Audio-Track gefunden werden.
| Anzahl der Eingänge | 0 |
|---|---|
| Anzahl der Ausgänge | 1 |
| Anzahl der Kanäle | 2 (beachten Sie jedoch, dass [`AudioNode.channelCount`](/de/docs/Web/API/AudioNode/channelCount) nur für das Up- und Down-Mixing von [`AudioNode`](/de/docs/Web/API/AudioNode)-Eingängen verwendet wird, und MediaStreamAudioSourceNode hat keine Eingänge) |
Konstruktor
MediaStreamAudioSourceNode()-
Erstellt eine neue
MediaStreamAudioSourceNodeObjektinstanz mit den angegebenen Optionen.
Instanzeigenschaften
Zusätzlich zu den folgenden Eigenschaften erbt MediaStreamAudioSourceNode die Eigenschaften seines Elternteils, AudioNode.
mediaStreamNur lesbar-
Der
MediaStream, der beim Erstellen diesesMediaStreamAudioSourceNodeverwendet wurde.
Instanzmethoden
Erbt Methoden von seinem Elternteil, AudioNode.
Verwendungshinweise
Track-Reihenfolge
Für die Zwecke des MediaStreamTrackAudioSourceNode Interface wird die Reihenfolge der Audiotracks im Stream dadurch bestimmt, dass die Tracks, deren kind audio ist, genommen und die Tracks dann nach den Werten ihrer id Eigenschaft in Unicode-Codepoint-Reihenfolge sortiert werden (im Wesentlichen in alphabetischer oder lexikographischer Reihenfolge für IDs, die einfache alphanumerische Zeichenketten sind).
Der erste Track ist dann der Track, dessen id zuerst kommt, wenn die IDs der Tracks alle in Unicode-Codepoint-Reihenfolge sortiert sind.
Es ist jedoch wichtig zu beachten, dass die Regel, die diese Reihenfolge festlegt, lange nach der ersten Einführung dieses Interfaces in die Web Audio API hinzugefügt wurde. Daher können Sie sich nicht einfach darauf verlassen, dass die Reihenfolge zwischen zwei Browsern oder Browserversionen übereinstimmt.
Das MediaStreamTrackAudioSourceNode Interface ist ähnlich wie MediaStreamAudioSourceNode, vermeidet jedoch dieses Problem, indem es Ihnen erlaubt zu spezifizieren, welcher Track verwendet werden soll.
Beispiel
Siehe AudioContext.createMediaStreamSource() für Beispielcode, der dieses Objekt verwendet.
Spezifikationen
| Specification |
|---|
| Web Audio API # MediaStreamAudioSourceNode |
Browser-Kompatibilität
BCD tables only load in the browser