MediaTrackConstraints: restrictOwnAudio-Eigenschaft
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, der die gewünschten oder zwingenden Einschränkungen für den Wert der einschränkbaren Eigenschaft restrictOwnAudio angibt.
Diese Eigenschaft steuert, ob Systemaudio, das vom aufzeichnenden Tab stammt, aus der Bildschirmaufnahme herausgefiltert wird. Dadurch können in manchen Fällen sauberere Bildschirmaufnahmen entstehen. Wenn beispielsweise die aufzeichnende Webseite selbst eingebettete Audio- oder Videoinhalte wiedergibt, würde deren Ton in die Aufnahme aufgenommen. Da dies zu einem unerwünschten Echo führen oder die beabsichtigten Audioquellen aus anderen Tabs oder Anwendungen beeinträchtigen 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 prüfen, den MediaDevices.getSupportedConstraints() zurückgibt. Das 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ämtlichen Ton zu entfernen, der von dem Tab stammt, der MediaDevices.getDisplayMedia() aufgerufen hat, um die Bildschirmaufnahme zu starten. Schlägt die Entfernung des Tons durch Verarbeitung fehl, kann der User-Agent sämtlichen Ton aus dem aufzeichnenden Tab ausschließen.
Hinweis: Wenn die aufgenommene Bildschirmoberfläche kein Systemaudio enthält, hat diese Einstellung keine Wirkung.
Wenn der Wert als exact angegeben wird, legt der boolesche Wert dieses Felds eine zwingende Anforderung an die restrictOwnAudio-Funktion 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 |