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, bevor Sie diese produktiv verwenden.

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

BCD tables only load in the browser

Siehe auch