Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

MediaStreamTrackAudioSourceNode: MediaStreamTrackAudioSourceNode() Konstruktor

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Der MediaStreamTrackAudioSourceNode()-Konstruktor der Web Audio API erstellt und gibt ein neues MediaStreamTrackAudioSourceNode-Objekt zurück, dessen Audio aus dem im gegebenen Optionsobjekt angegebenen MediaStreamTrack entnommen wird.

Eine andere Möglichkeit, einen MediaStreamTrackAudioSourceNode zu erstellen, besteht darin, die Methode AudioContext.createMediaStreamTrackSource() aufzurufen und den MediaStreamTrack anzugeben, von dem Sie Audio erhalten möchten.

Syntax

js
new MediaStreamTrackAudioSourceNode(context, options)

Parameter

context

Ein AudioContext, das den Audiokontext darstellt, mit dem der Knoten verknüpft werden soll.

options

Ein Objekt, welches die Eigenschaften definiert, die Sie für den MediaStreamTrackAudioSourceNode festlegen möchten:

mediaStreamTrack

Der MediaStreamTrack, von dem Audio-Daten für die Ausgabe dieses Knotens entnommen werden sollen.

Rückgabewert

Ein neues MediaStreamTrackAudioSourceNode-Objekt, das den Audio-Knoten darstellt, dessen Medien aus dem angegebenen Medien-Track bezogen werden.

Ausnahmen

NotSupportedError DOMException

Wird ausgelöst, wenn der angegebene context kein AudioContext ist.

InvalidStateError DOMException

Wird ausgelöst, wenn der angegebene MediaStreamTrack kein Audiotrack ist (d.h. seine kind-Eigenschaft ist nicht audio).

Beispiel

Dieses Beispiel verwendet getUserMedia(), um Zugriff auf die Kamera des Benutzers zu erhalten und dann einen neuen MediaStreamAudioSourceNode aus dem ersten vom Gerät bereitgestellten Audiotrack zu erstellen.

js
const audioCtx = new AudioContext();

if (navigator.mediaDevices.getUserMedia) {
  navigator.mediaDevices
    .getUserMedia({
      audio: true,
      video: false,
    })
    .then((stream) => {
      const options = {
        mediaStreamTrack: stream.getAudioTracks()[0],
      };

      const source = new MediaStreamTrackAudioSourceNode(audioCtx, options);
      source.connect(audioCtx.destination);
    })
    .catch((err) => {
      console.error(`The following gUM error occurred: ${err}`);
    });
} else {
  console.log("new getUserMedia not supported on your browser!");
}

Spezifikationen

Specification
Web Audio API
# dom-mediastreamtrackaudiosourcenode-mediastreamtrackaudiosourcenode

Browser-Kompatibilität