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, z. B. über die deviceId-Eigenschaft der MediaDeviceInfo-Objekte, die von MediaDevices.enumerateDevices() zurückgegeben werden.

AudioSinkOptions

Ein Objekt, das verschiedene Optionen für eine Sink-ID darstellt. Zurzeit nimmt dies eine einzelne Eigenschaft, type, mit dem Wert none an. Durch das Setzen dieses Parameters wird das Audio verarbeitet, ohne dass es über ein Audioausgabegerät abgespielt wird. Dies ist eine nützliche Option, um den Stromverbrauch 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 (d. h. zurückgegeben von AudioContext.sinkId) zu setzen, wirft keine Fehler, aber der Prozess wird sofort abgebrochen.

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 (sehen Sie sich den Quellcode an) erstellen wir einen Audiographen, der einen dreisekündigen Ausbruch von weißem Rauschen über einen AudioBufferSourceNode erzeugt, den wir auch durch einen GainNode laufen lassen, um die Lautstärke etwas zu reduzieren.

Wir bieten dem Benutzer auch ein Dropdown-Menü, um das Audioausgabegerät spontan ändern zu können. Dazu:

1. Stellen wir eine Schaltfläche bereit, um das Dropdown-Menü zu füllen. Wir rufen zuerst MediaDevices.getUserMedia() auf, um die Berechtigungsabfrage zu aktivieren, die wir zum Aufzählen der Geräte benötigen, und verwenden dann MediaDevices.enumerateDevices(), um alle verfügbaren Geräte zu erhalten. Wir durchlaufen die verschiedenen Geräte und machen jedes als Option in einem <select>-Element verfügbar. Wir erstellen auch eine "None"-Option für den Fall, dass Sie Ihr Audio in keiner Ausgabe abspielen möchten.

   js

   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);
   
       //...
   

2. Fügen wir einen change-Ereignislistener zu dem <select>-Element hinzu, um die Sink-ID und damit das Audioausgabegerät zu ändern, wenn ein neuer Wert ausgewählt wird. Wenn "None" im Dropdown-Menü ausgewählt ist, rufen wir setSinkId() mit dem Objektparameter { type : 'none' } auf, um kein Audiogerät auszuwählen. Andernfalls verwenden wir es mit der im <select>-Element-Wertattribut enthaltenen Audio-Geräte-ID als Parameter.

   js

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

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

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