AudioContext: setSinkId() Methode

sinkId

Die Sink-ID des Geräts, das Sie als Audioausgabegerät festlegen möchten. Dies kann einen der folgenden Wertetypen annehmen:

String

Ein String, der die Sink-ID darstellt, die beispielsweise über die deviceId Eigenschaft der MediaDeviceInfo Objekte abgerufen wurde, die von MediaDevices.enumerateDevices() zurückgegeben werden.

AudioSinkOptions

Ein Objekt, das verschiedene Optionen für eine Sink-ID darstellt. Derzeit hat es eine einzige Eigenschaft, type, mit dem Wert none. Wenn dieser Parameter gesetzt wird, wird das Audio verarbeitet, ohne über ein Audioausgabegerät abgespielt zu werden. Dies ist eine nützliche Option, um den Energieverbrauch zu minimieren, wenn Sie keine Wiedergabe zusammen mit der Verarbeitung benötigen.

Ein Promise, das mit einem Wert von undefined erfüllt wird.

Der Versuch, die Sink-ID auf ihren bestehenden Wert zu setzen (z.B. zurückgegeben von AudioContext.sinkId), wirft keine Fehler, beendet aber den Prozess sofort.

InvalidAccessError DOMException

Wird ausgelöst, wenn der Zugriff auf das ausgewählte Audioausgabegerät fehlgeschlagen ist.

NotAllowedError DOMException

Wird ausgelöst, wenn der Browser keine Berechtigung zum Zugriff auf Audiogeräte hat.

NotFoundError DOMException

Wird ausgelöst, wenn die übergebene sinkId keinem auf dem System gefundenen Audiogerät entspricht.

In unserem SetSinkId-Testbeispiel (schauen Sie sich den Quellcode an), erstellen wir einen Audiografen, der eine dreisekündige Wellen von weißem Rauschen über einen AudioBufferSourceNode erzeugt, den wir auch durch einen GainNode laufen lassen, um die Lautstärke etwas zu senken.

mediaDeviceBtn.addEventListener("click", async () => {
  if ("setSinkId" in AudioContext.prototype) {
    selectDiv.textContent = "";

    const stream = await navigator.mediaDevices.getUserMedia({
      audio: true,
    });
    const devices = await navigator.mediaDevices.enumerateDevices();

    // Most of the DOM scripting to generate the dropdown cut out for brevity

    const audioOutputs = devices.filter(
      (device) =>
        device.kind === "audiooutput" && device.deviceId !== "default",
    );

    audioOutputs.forEach((device) => {
      const option = document.createElement("option");
      option.value = device.deviceId;
      option.textContent = device.label;
      select.appendChild(option);
    });

    const option = document.createElement("option");
    option.value = "none";
    option.textContent = "None";
    select.appendChild(option);

    select.addEventListener("change", async () => {
      if (select.value === "none") {
        await audioCtx.setSinkId({ type: "none" });
      } else {
        await audioCtx.setSinkId(select.value);
      }
    });
  }
});

Wir bieten dem Benutzer auch ein Dropdown-Menü, damit er das Audioausgabegerät spontan ändern kann. Dafür:

1. Stellen wir eine Schaltfläche bereit, um das Dropdown-Menü zu füllen. Wir rufen zuerst MediaDevices.getUserMedia() auf, um die benötigten Berechtigungen zu aktivieren, die wir für die Geräteliste benötigen. Dann verwenden wir MediaDevices.enumerateDevices(), um alle verfügbaren Geräte abzurufen. Wir durchlaufen die verschiedenen Geräte und machen jedes als Option in einem <select> Element verfügbar. Wir erstellen auch eine "Keine"-Option für den Fall, dass Sie Ihr Audio in keinem Ausgang wiedergeben möchten.
2. Fügen wir einen change Ereignis-Listener zum <select> Element hinzu, um die Sink-ID und damit das Audioausgabegerät zu ändern, wenn ein neuer Wert ausgewählt wird. Wenn "Keine" im Dropdown gewählt wird, rufen wir setSinkId() mit dem Objektparameter { type : 'none' } auf, um kein Audiogerät auszuwählen, andernfalls führen wir es mit der Audio-Geräte-ID aus, die im value Attribut des <select> Elements als Parameter enthalten ist.

Das Ausgabegerät kann während der Audiowiedergabe geändert werden, ebenso wie davor oder zwischen den Wiedergaben.

• SetSinkId Testbeispiel
• Ändern des Zielausgabegeräts im Web Audio
• AudioContext.sinkId
• sinkchange