MediaTrackConstraints: restrictOwnAudio-Eigenschaft
Experimentell: Dies ist eine experimentelle Technologie
Überprüfen Sie die Browser-Kompatibilitätstabelle sorgfältig vor der Verwendung auf produktiven Webseiten.
Das MediaTrackConstraints-Wörterbuch enthält die restrictOwnAudio-Eigenschaft, einen ConstrainBoolean, der die angeforderten oder obligatorischen Einschränkungen festlegt, die auf den Wert der restrictOwnAudio-einschränkbaren Eigenschaft angewendet werden.
Diese Eigenschaft steuert, ob das aus dem aufzeichnenden Tab stammende Systemaudio aus der Bildschirmaufnahme herausgefiltert wird, was in einigen Fällen zu saubereren Bildschirmaufzeichnungen führt. Wenn zum Beispiel die aufzeichnende Webseite selbst eingebettete Audios oder Videos wiedergibt, würde dieses Audio in die Aufnahme einbezogen. Da dies zu einem unerwünschten Echo führen oder die beabsichtigten Audioquellen aus anderen Tabs oder Anwendungen stören könnte, ist es wünschenswert, es aus der Aufnahme zu entfernen.
Bei Bedarf können Sie feststellen, ob diese Einschränkung unterstützt wird, indem Sie den Wert von MediaTrackSupportedConstraints.restrictOwnAudio überprüfen, wie er von MediaDevices.getSupportedConstraints() zurückgegeben wird. Dies ist jedoch selten erforderlich, da Browser normalerweise alle Einschränkungen ignorieren, die sie nicht erkennen.
Wert
Ein ConstrainBoolean-Wert.
Ist der Wert true, wird der Benutzeragent versuchen, alle aus dem Tab stammenden Audios zu entfernen, der MediaDevices.getDisplayMedia() aufgerufen hat, um die Bildschirmaufnahme zu starten. Wenn das Entfernen von Audio durch Verarbeitung fehlschlägt, kann der Benutzeragent alle Audios aus dem aufzeichnenden Tab ausschließen.
Hinweis: Wenn die erfasste Anzeigefläche kein Systemaudio enthält, hat diese Einstellung keine Wirkung.
Wird der Wert als exact angegeben, gibt der boolesche Wert dieses Feldes ein genaues Erfordernis für die restrictOwnAudio-Funktion an; wenn der Benutzeragent dieses Erfordernis nicht erfüllen kann, wird die Anfrage zu einem Fehler führen.
Ist der Wert false, wird der Benutzeragent nicht versuchen, das aus dem aufzeichnenden Tab stammende Systemaudio einzuschränken.
Beispiele
let isCapturingTabSystemAudioRestricted = displayStream
.getAudioTracks()[0]
.getSettings().restrictOwnAudio;
Das Beispiel für den Einschränkungsübenden zeigt, wie man Medientrack-Einschränkungen verwendet.
Spezifikationen
This feature does not appear to be defined in any specification.Browser-Kompatibilität
Loading…