MediaTrackSettings: screenPixelRatio-Eigenschaft

Eine Zahl, die das Bildschirm-Pixel-Verhältnis darstellt.

Dies wird berechnet, indem die Größe eines CSS-Pixels bei einem Seitenzoom von 1.0 und unter Verwendung eines Skalierungsfaktors von 1.0 auf dem erfassenden Bildschirm durch die vertikale Größe eines Pixels von der erfassten Anzeigefläche geteilt wird.

Es ist üblich, dass ein Zoom über das Betriebssystem (OS) auf einen Bildschirm angewendet wird, zum Beispiel wenn das Display ein hochauflösendes Display ist, und Sie möchten, dass die Grafiken in der gleichen physischen Größe wie auf einem Standardauflösungs-Display angezeigt werden. Die Auflösung vor dem Anwenden des Zooms wird als logische Auflösung bezeichnet und die Auflösung nach dem Anwenden des Zooms wird als physische Auflösung bezeichnet.

Wenn der erfasste Bildschirm des Senders herangezoomt ist, ist die physische Auflösung größer als die logische Auflösung. Eine Videokonferenz-App kann daher Bandbreite und CPU sparen, indem sie:

1. Den vom OS auf die erfasste Anzeigefläche angewendeten Zoom entfernt.
2. Das Video der Bildschirmaufnahme in der logischen Auflösung sendet.
3. Den Zoom nach Erhalt auf dem entfernten Client erneut anwendet, um ihn wieder auf die physische Auflösung zu skalieren.

Die screenPixelRatio-Eigenschaft beschreibt das Verhältnis der physischen Größe eines Pixels zur logischen Größe eines CSS-Pixels und ermöglicht es der Anwendung daher herauszufinden, wie viel Zoomfaktor angewendet wurde, und dann das Video auf die logische Größe zu begrenzen.

Zum Beispiel:

• Wenn die erfasste Anzeigefläche auf einem Standardauflösungsbildschirm angezeigt wird, bei dem die physischen Pixelmaße ungefähr den CSS-Pixelmaßen entsprechen, wird screenPixelRatio einen Wert von 1 zurückgeben.
• Wenn jedoch die erfasste Anzeigefläche auf einem Bildschirm mit hoher dpi-Auflösung angezeigt wird, bei dem die physischen Pixelmaße ungefähr doppelt so groß sind wie die CSS-Pixelmaße, wird screenPixelRatio einen Wert von 2 zurückgeben.

In diesem Beispiel definiert die Anwendung eine Konstante RESOLUTION_LIMIT, die den Skalierungsfaktor darstellt, über den die sendende Anwendung das Video in der logischen Auflösung anstelle der physischen Auflösung senden sollte.

Wenn screenPixelRatio diesen Grenzwert überschreitet, verwendet die Anwendung den Wert von screenPixelRatio, um die logische Auflösung von der physischen Auflösung zu berechnen, und begrenzt dann die erfasste MediaStreamTrack auf die logische Auflösung.

const RESOLUTION_LIMIT = 1.5;

async function startCapture() {
  const stream = await navigator.mediaDevices.getDisplayMedia({
    video: true,
  });
  const track = stream.getVideoTracks()[0];
  const settings = track.getSettings();
  const capabilities = track.getCapabilities();

  if (settings.screenPixelRatio > RESOLUTION_LIMIT) {
    const physicalWidth = capabilities.width.max;
    const physicalHeight = capabilities.height.max;
    const logicalWidth = physicalWidth / settings.screenPixelRatio;
    const logicalHeight = physicalHeight / settings.screenPixelRatio;
    await track.applyConstraints({
      width: logicalWidth,
      height: logicalHeight,
    });
  }
}

• Media Capture and Streams API
• Screen Capture API
• Fähigkeiten, Einschränkungen und Einstellungen
• MediaTrackSettings