DierestrictOwnAudio-Eigenschaft desMediaTrackSettings-Wörterbuchs steuert, ob Systemaudio, das von dem erfassenden Tab stammt, aus der Bildschirmaufnahme herausgefiltert wird, um in einigen Fällen sauberere Bildschirmaufnahmen zu ermöglichen.

Wenn zum Beispiel die erfassende Webseite selbst eingebettete Audiodaten oder Videos abspielt, würde dieses Audio in die Aufnahme einbezogen werden. Da dies zu einem unerwünschten Echo führen oder die beabsichtigten Audioquellen aus anderen Tabs oder Anwendungen stören könnte, ist es wünschenswert, es aus der Aufnahme zu entfernen.

Wert

Ein boolescher Wert, bei demtrue die Einschränkung des Systemaudios des erfassenden Tabs aktiviert undfalse sie deaktiviert.

Wenn der Werttrue ist, wird der User-Agent versuchen, jegliches Audio zu entfernen, das von dem durch den Tab, derMediaDevices.getDisplayMedia() aufgerufen hat, erfassten Audio erzeugt wird. Wenn das Entfernen des Audios durch Verarbeitung fehlschlägt, kann der User-Agent jegliches Audio, das vom erfassenden Tab stammt, ausschließen.

Beispiele

Die folgende Funktion richtet ein Einschränkungsobjekt ein, das die Optionen für einen Aufruf vongetDisplayMedia() angibt.Es fügt dierestrictOwnAudio-Einschränkung (die verlangt, dass das Systemaudio, das vom erfassenden Tab stammt, aus der Bildschirmaufnahme herausgefiltert wird) nur hinzu, wenn bekannt ist, dass sie vom Browser unterstützt wird.Die Erfassung beginnt dann, indemgetDisplayMedia() aufgerufen und der zurückgegebene Stream an das<video>-Element angehängt wird, das durch die VariablevideoElem referenziert wird.

async function capture() {  const supportedConstraints = navigator.mediaDevices.getSupportedConstraints();  const displayMediaOptions = {    audio: {},  };  if (supportedConstraints.restrictOwnAudio) {    displayMediaOptions.audio.restrictOwnAudio = true;  }  try {    videoElem.srcObject =      await navigator.mediaDevices.getDisplayMedia(displayMediaOptions);  } catch (err) {    /* handle the error */  }}

Spezifikationen

Browser-Kompatibilität

Siehe auch

• Screen Capture API
• Verwendung der Screen Capture API
• Fähigkeiten, Einschränkungen und Einstellungen
• MediaDevices.getDisplayMedia()
• MediaStreamTrack.getConstraints()
• MediaStreamTrack.applyConstraints()
• MediaStreamTrack.getSettings()