MediaTrackSupportedConstraints: 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 MediaTrackSupportedConstraints-Wörterbuchs zeigt an, ob die suppressLocalAudioPlayback-Einschränkung durch den User-Agent und das Gerät, auf dem der Inhalt verwendet wird, unterstützt wird.

Die Liste der unterstützten Einschränkungen wird durch den Aufruf von navigator.mediaDevices.getSupportedConstraints() abgerufen.

Wert

Ein boolescher Wert, der true ist, wenn die suppressLocalAudioPlayback-Einschränkung vom Gerät und User-Agent unterstützt wird.

Beispiele

Die folgende Funktion richtet das Optionsobjekt für den Aufruf von getDisplayMedia() ein. Sie fügt die suppressLocalAudioPlayback-Einschränkung hinzu (in der Anfrage, dass aufgenommener Ton nicht über die lokalen Lautsprecher des Benutzers wiedergegeben wird), nur wenn bekannt ist, dass diese vom Browser unterstützt wird. Die Aufnahme wird dann gestartet, indem getDisplayMedia() aufgerufen und der zurückgegebene Stream an das Videoelement gebunden wird, 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