MediaTrackSettings: suppressLocalAudioPlayback Eigenschaft

Limited availability

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

Experimentell: Dies ist eine experimentelle Technologie
Überprüfen Sie die Browser-Kompatibilitätstabelle sorgfältig vor der Verwendung auf produktiven Webseiten.

Die suppressLocalAudioPlayback-Eigenschaft des MediaTrackSettings-Wörterbuchs steuert, ob das Audio in einem Tab weiterhin über die lokalen Lautsprecher eines Benutzers abgespielt wird, wenn der Tab erfasst wird.

Zum Beispiel, wenn Sie ein Videogespräch an ein externes AV-System in einem Konferenzraum übertragen, möchten Sie, dass das Audio über das AV-System abgespielt wird und nicht über die lokalen Lautsprecher. Auf diese Weise wird das Audio lauter und klarer und auch synchron mit dem Konferenzvideo.

Wert

Der Wert von suppressLocalAudioPlayback ist ein boolean — true aktiviert die Unterdrückung der lokalen Audiowiedergabe, und false deaktiviert sie.

Beispiele

Die untenstehende Funktion erstellt das Constraints-Objekt, das die Optionen für den Aufruf von getDisplayMedia() spezifiziert. Sie fügt die suppressLocalAudioPlayback-Einschränkung hinzu (wodurch angefordert wird, dass das erfasste Audio nicht über die lokalen Lautsprecher des Benutzers abgespielt wird), nur wenn bekannt ist, dass sie vom Browser unterstützt wird. Das Erfassen wird dann durch den Aufruf von getDisplayMedia() gestartet und der zurückgegebene Stream wird dem Video-Element zugeordnet, auf das die Variable videoElem verweist.

js
async function capture() {
  const supportedConstraints = navigator.mediaDevices.getSupportedConstraints();
  const displayMediaOptions = {
    audio: {},
  };

  if (supportedConstraints.suppressLocalAudioPlayback) {
    displayMediaOptions.audio.suppressLocalAudioPlayback = true;
  }

  try {
    videoElem.srcObject =
      await navigator.mediaDevices.getDisplayMedia(displayMediaOptions);
  } catch (err) {
    /* handle the error */
  }
}

Spezifikationen

Specification
Screen Capture
# dom-mediatrackconstraintset-suppresslocalaudioplayback

Browser-Kompatibilität

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
suppressLocalAudioPlayback constraint
Experimental

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
No support
No support
Experimental. Expect behavior to change in the future.

Siehe auch