MediaTrackConstraints: Eigenschaft restrictOwnAudio
Experimentell: Dies ist eine experimentelle Technologie
Überprüfen Sie die Browser-Kompatibilitätstabelle sorgfältig vor der Verwendung auf produktiven Webseiten.
Die Eigenschaft restrictOwnAudio des MediaTrackConstraints-Dictionarys ist ein ConstrainBoolean, das die angeforderten oder zwingend erforderlichen Einschränkungen für den Wert der einschränkbaren Eigenschaft restrictOwnAudio angibt.
Diese Eigenschaft steuert, ob Systemaudio, das vom aufzeichnenden Tab stammt, bei einer Bildschirmaufnahme herausgefiltert wird. Dadurch lassen sich in manchen Fällen sauberere Bildschirmaufzeichnungen erstellen. Wenn beispielsweise die aufzeichnende Webseite selbst eingebettete Audio- oder Videoinhalte wiedergibt, würde deren Ton in die Aufnahme einfließen. Da dies ein unerwünschtes Echo verursachen oder die gewünschten Audioquellen aus anderen Tabs oder Anwendungen stören könnte, ist es sinnvoll, diesen Ton aus der Aufnahme zu entfernen.
Bei Bedarf können Sie prüfen, ob diese Einschränkung unterstützt wird, indem Sie den Wert von restrictOwnAudio abfragen, den MediaDevices.getSupportedConstraints() zurückgibt. Dies ist jedoch selten erforderlich, da Browser Einschränkungen, die sie nicht erkennen, normalerweise ignorieren.
Wert
Ein ConstrainBoolean-Wert.
Wenn der Wert true ist, versucht der User Agent, sämtliches Audio zu entfernen, das aus dem Tab stammt, der MediaDevices.getDisplayMedia() aufgerufen hat, um die Bildschirmaufnahme zu starten. Falls sich das Audio nicht durch Verarbeitung entfernen lässt, kann der User Agent sämtliches Audio aus dem aufzeichnenden Tab ausschließen.
Hinweis: Wenn die aufgenommene Anzeigefläche kein Systemaudio enthält, hat diese Einstellung keine Wirkung.
Wenn der Wert als exact angegeben wird, legt der boolesche Wert dieses Feldes eine zwingend zu erfüllende Anforderung an die Funktion restrictOwnAudio fest. Kann der User Agent diese Anforderung nicht erfüllen, führt die Anfrage zu einem Fehler.
Wenn der Wert false ist, versucht der User Agent nicht, Systemaudio aus dem aufzeichnenden Tab einzuschränken.
Beispiele
let isCapturingTabSystemAudioRestricted = displayStream
.getAudioTracks()[0]
.getSettings().restrictOwnAudio;
Das Beispiel Constraint exerciser zeigt, wie Sie Einschränkungen für Medientracks verwenden.
Spezifikationen
| Spezifikation |
|---|
| Screen Capture # dom-mediatrackconstraintset-restrictownaudio |