MediaTrackSettings
Das MediaTrackSettings Wörterbuch wird verwendet, um die aktuell konfigurierten Werte für jede Einstellung eines MediaStreamTrack zurückzugeben. Diese Werte werden so nah wie möglich an die zuvor mit einem MediaTrackConstraints Objekt beschriebenen Einschränkungen und mittels applyConstraints() gesetzten Werte angepasst und halten sich an die Standardbeschränkungen für alle Eigenschaften, deren Einschränkungen nicht geändert wurden oder deren benutzerdefinierte Einschränkungen nicht erfüllt werden konnten.
Um mehr zu erfahren, wie Einschränkungen und Einstellungen funktionieren, siehe Fähigkeiten, Einschränkungen und Einstellungen.
Instanz-Eigenschaften
Einige oder alle der folgenden werden im Objekt enthalten sein, entweder weil es vom Browser nicht unterstützt wird oder weil es aufgrund des Kontexts nicht verfügbar ist. Zum Beispiel, da RTP einige dieser Werte während der Aushandlung einer WebRTC-Verbindung nicht bereitstellt, wird ein Track in Verbindung mit einer RTCPeerConnection bestimmte Werte wie facingMode oder groupId nicht enthalten.
Instanz-Eigenschaften aller Medientracks
deviceId-
Ein String, der den aktuellen Wert der
deviceIdEigenschaft angibt. Die Geräte-ID ist ein ursprungs-eindeutiger String, der die Quelle des Tracks identifiziert; dies ist normalerweise eine GUID. Dieser Wert ist spezifisch für die Quelle der Track-Daten und kann nicht für die Festlegung von Einschränkungen verwendet werden; er kann jedoch für die anfängliche Auswahl von Medien verwendet werden, wennMediaDevices.getUserMedia()aufgerufen wird. groupId-
Ein String, der den aktuellen Wert der
groupIdEigenschaft angibt. Die Gruppen-ID ist ein browser-sitzungs-eindeutiger String, der die Quellgruppe des Tracks identifiziert. Zwei Geräte (identifiziert durch diedeviceId) gehören zur gleichen Gruppe, wenn sie vom gleichen physischen Gerät stammen. Zum Beispiel würden die Audio-Ein- und Ausgabegeräte für den Lautsprecher und das Mikrofon, die in ein Telefon integriert sind, dieselbe Gruppen-ID teilen, da sie Teil desselben physischen Geräts sind. Das Mikrofon an einem Headset hätte jedoch eine andere ID. Dieser Wert ist spezifisch für die Quelle der Track-Daten und kann nicht für die Festlegung von Einschränkungen verwendet werden; er kann jedoch für die anfängliche Auswahl von Medien verwendet werden, wennMediaDevices.getUserMedia()aufgerufen wird.
Instanz-Eigenschaften von Audiospuren
autoGainControl-
Ein Boolean, der den aktuellen Wert der
autoGainControlEigenschaft angibt, welchertrueist, wenn automatische Verstärkungsregelung aktiviert ist, undfalseandernfalls. channelCount-
Ein ganzzahliger Wert, der den aktuellen Wert der
channelCountEigenschaft angibt und die Anzahl der Audiokanäle angibt, die auf dem Track vorhanden sind (und damit angibt, wie viele Audioproben in jedem Audioframe vorhanden sind). Dies ist 1 für Mono, 2 für Stereo und so weiter. echoCancellation-
Ein Boolean, der den aktuellen Wert der
echoCancellationEigenschaft angibt, welcher beitrueEcho-Unterdrückung bedeutet und andernfallsfalseist. latency-
Ein Gleitkommawert mit doppelter Genauigkeit, der den aktuellen Wert der
latencyEigenschaft angibt und die Audio-Latenzzeit in Sekunden angibt. Latenz ist die Zeitspanne, die zwischen dem Beginn der Verarbeitung des Audios und dem Zeitpunkt vergeht, zu dem die Daten für den nächsten Stopp im Audioverarbeitungsprozess verfügbar sind. Dieser Wert ist ein Zielwert; die tatsächliche Latenz kann aus verschiedenen Gründen variieren. noiseSuppression-
Ein Boolean, der den aktuellen Wert der
noiseSuppressionEigenschaft angibt:truewenn die Rauschunterdrückung aktiviert ist, undfalseandernfalls. restrictOwnAudio-
Ein Boolean, der den aktuellen Wert der
restrictOwnAudioEigenschaft angibt:true, wenn der Browser versuchen wird, Systemaudio, das vom aufnehmenden Tab stammt, während der Bildschirmaufnahme herauszufiltern, undfalseandernfalls. sampleRate-
Ein ganzzahliger Wert, der den aktuellen Wert der
sampleRateEigenschaft angibt und die Abtastrate in Proben pro Sekunde der Audiodaten spezifiziert. Standard-CD-Audioqualität zum Beispiel hat eine Abtastrate von 41.000 Proben pro Sekunde. sampleSize-
Ein ganzzahliger Wert, der den aktuellen Wert der
sampleSizeEigenschaft angibt und die lineare Größe, in Bits, jeder Audioprobe spezifiziert. CD-Audioqualität zum Beispiel ist 16-Bit, daher wäre dieser Wert in diesem Fall 16. suppressLocalAudioPlayback-
Bestimmt, ob das Audio, das in einem Tab abgespielt wird, weiterhin aus den lokalen Lautsprechern eines Benutzers wiedergegeben wird, wenn der Tab erfasst wird.
volumeVeraltet Nicht standardisiert-
Ein Gleitkommawert mit doppelter Genauigkeit, der den aktuellen Wert der
volumeEigenschaft angibt und den Lautstärkepegel des Tracks spezifiziert. Dieser Wert liegt zwischen 0,0 (stumm) und 1,0 (maximale unterstützte Lautstärke).
Instanz-Eigenschaften von Videospuren
aspectRatio-
Ein Gleitkommawert mit doppelter Genauigkeit, der den aktuellen Wert der
aspectRatioEigenschaft angibt, präzise auf 10 Dezimalstellen. Dies ist die Breite des Bildes in Pixeln dividiert durch seine Höhe in Pixeln. Übliche Werte sind 1.3333333333 (für das klassische Fernseh-4:3-"Standard-" Seitenverhältnis, das auch auf Tablets wie dem iPad von Apple verwendet wird), 1.7777777778 (für das 16:9-High-Definition-Widescreen-Seitenverhältnis) und 1.6 (für das 16:10-Seitenverhältnis, das bei Widescreen-Computern und Tablets häufig ist). facingMode-
Ein String, der den aktuellen Wert der
facingModeEigenschaft angibt, der die Richtung angibt, in die die Kamera zeigt. Der Wert wird einer der folgenden sein:"user"-
Eine Kamera, die auf den Benutzer gerichtet ist (allgemein als "Selfie-Kamera" bekannt), wird für Selbstporträts und Videoanrufe verwendet.
"environment"-
Eine Kamera, die vom Benutzer weg zeigt (wenn der Benutzer auf den Bildschirm schaut). Dies ist typischerweise die höchste Qualitätskamera auf dem Gerät, die für allgemeine Fotografie verwendet wird.
"left"-
Eine Kamera, die zur Umgebung nach links zeigt.
"right"-
Eine Kamera, die zur Umgebung nach rechts zeigt.
frameRate-
Ein Gleitkommawert mit doppelter Genauigkeit, der den aktuellen Wert der
frameRateEigenschaft angibt, die angibt, wie viele Videobilder pro Sekunde der Track enthält. Wenn der Wert aus irgendeinem Grund nicht bestimmt werden kann, wird der Wert mit der vertikalen Synchronisationsrate des Geräts übereinstimmen, auf dem der Benutzeragent läuft. height-
Ein ganzzahliger Wert, der den aktuellen Wert der
heightEigenschaft angibt und die Höhe der Videodaten des Tracks in Pixeln spezifiziert. width-
Ein ganzzahliger Wert, der den aktuellen Wert der
widthEigenschaft angibt und die Breite der Videodaten des Tracks in Pixeln spezifiziert. resizeMode-
Ein String, der den aktuellen Wert der
resizeModeEigenschaft angibt, der den Modus angibt, den der Benutzeragent verwendet, um die Auflösung des Tracks abzuleiten. Der Wert wird einer der folgenden sein:"none"-
Der Track hat die vom Kamera, ihrem Treiber oder dem Betriebssystem angebotene Auflösung.
"crop-and-scale"-
Die Auflösung des Tracks könnte das Ergebnis davon sein, dass der Benutzeragent Zuschneiden oder Herunterskalieren von einer höheren Kameraauflösung verwendet.
Instanz-Eigenschaften von geteilten Bildschirmspuren
Tracks, die Video von einem Benutzerbildschirm teilen (unabhängig davon, ob die Bildschirmdaten vom gesamten Bildschirm oder einem Teil eines Bildschirms, wie einem Fenster oder Tab, stammen), werden im Allgemeinen wie Videospuren behandelt, außer dass sie auch die folgenden zusätzlichen Einstellungen unterstützen:
cursor-
Ein String, der angibt, ob der Mauszeiger im generierten Stream einbezogen wird und unter welchen Bedingungen. Mögliche Werte sind:
always-
Die Maus ist immer im Videoinhalt des
MediaStream