RTCEncodedVideoFrame: getMetadata()-Methode - Web-APIs | MDN

Seitenleiste umschalten

Farbschema

Systemeinstellung
Hell
Dunkel

Deutsch

Sprache merken Mehr erfahren

RTCEncodedVideoFrame: getMetadata()-Methode

Baseline Weitgehend verfügbar

Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit August 2023 browserübergreifend verfügbar.

Hinweis: Diese Funktion ist in Dedicated Web Workers verfügbar.

Die getMetadata()-Methode der RTCEncodedVideoFrame-Schnittstelle gibt ein Objekt zurück, das die mit dem Frame verknüpften Metadaten enthält.

Dies umfasst Informationen über den Frame, wie seine Größe, Video-Codierung, andere Frames, die zur Konstruktion eines vollständigen Bildes benötigt werden, Zeitstempel und weitere Informationen.

In diesem Artikel

Syntax

getMetadata()

Rückgabewert

Ein Objekt mit den folgenden Eigenschaften:

contributingSources

Ein Array von Quellen (ssrc), die zum Frame beigetragen haben. Betrachten Sie den Fall einer Konferenzanwendung, die Audio und Video von mehreren Benutzern kombiniert. Die synchronizationSource würde die ssrc der Anwendung enthalten, während contributingSources die ssrc-Werte aller einzelnen Video- und Audioquellen enthalten würde.

dependencies

Ein Array von positiven ganzen Zahlen, die die frameIds von Frames anzeigen, auf die dieser Frame angewiesen ist. Für einen Schlüssel-Frame wird dies leer sein, da ein Schlüssel-Frame alle Informationen enthält, die benötigt werden, um das Bild zu konstruieren. Für einen Delta-Frame werden alle Frames aufgeführt, die zur Darstellung dieses Frames benötigt werden. Der Typ des Frames kann mit RTCEncodedVideoFrame.type ermittelt werden.

frameId

Ein positiver Ganzzahlenwert, der die ID dieses Frames angibt.

height

Eine positive Ganzzahl, die die Höhe des Frames angibt. Der Maximalwert beträgt 65535.

mimeType

Ein String, der den MIME-Typ des verwendeten Codecs enthält, wie zum Beispiel "video/VP8".

payloadType

Ein positiver Ganzzahlenwert im Bereich von 0 bis 127, der das Format der RTP-Nutzlast beschreibt. Die Zuordnungen von Werten zu Formaten sind in RFC3550 definiert.

receiveTime

Ein DOMHighResTimeStamp, der den Zeitstempel des letzten empfangenen Pakets eines eingehenden Frames (von einem RTCRtpReceiver) angibt, das zur Erzeugung dieses Medien-Frames verwendet wurde, relativ zu Performance.timeOrigin.

rtpTimestamp

Eine positive ganze Zahl, die den Abtastzeitpunkt des ersten Oktetts im RTP-Datenpaket widerspiegelt (siehe RFC 3550).

spatialIndex

Eine positive ganze Zahl, die den räumlichen Index des Frames angibt. Einige Codecs ermöglichen die Erzeugung von Schichten von Frames mit unterschiedlichen Auflösungen. Frames in höheren Schichten können selektiv weggelassen werden, um bei Bedarf die Bitrate zu reduzieren und dennoch eine akzeptable Videoqualität beizubehalten.

synchronizationSource

Ein positiver Ganzzahlenwert, der die Synchronisationsquelle ("ssrc") des Stroms von RTP-Paketen angibt, die durch diesen kodierten Video-Frame beschrieben werden. Eine Quelle könnte eine Kamera oder ein Mikrofon sein oder eine Art Mixer-App, die mehrere Quellen kombiniert. Alle Pakete von derselben Quelle teilen dieselbe Zeitquelle und Sequenzraum und können daher relativ zueinander geordnet werden. Beachten Sie, dass zwei Frames mit demselben Wert sich auf dieselbe Quelle beziehen (für weitere Informationen siehe RTCInboundRtpStreamStats.ssrc).

temporalIndex

Eine positive ganze Zahl, die den zeitlichen Index des Frames angibt. Einige Codecs gruppieren Frames in Schichten, basierend darauf, ob das Weglassen eines Frames die Dekodierung anderer verhindert. Frames in höheren Schichten können selektiv weggelassen werden, um bei Bedarf die Bitrate zu reduzieren und dennoch eine akzeptable Videoqualität zu gewährleisten.

width

Eine positive Ganzzahl, die die Breite des Frames angibt. Der Maximalwert beträgt 65535.

Beispiele

Diese WebRTC Encoded Transform-Implementierung zeigt, wie Sie die Frame-Metadaten in einer transform()-Funktion abrufen und protokollieren können.

js
addEventListener("rtctransform", (event) => {
  const transform = new TransformStream({
    async transform(encodedFrame, controller) {
      // Get the metadata and log
      const frameMetaData = encodedFrame.getMetadata();
      console.log(frameMetaData);

      // Enqueue the frame without modifying
      controller.enqueue(encodedFrame);
    },
  });
  event.transformer.readable
    .pipeThrough(transform)
    .pipeTo(event.transformer.writable);
});

Das resultierende Objekt von einer lokalen Webcam könnte wie das unten gezeigte aussehen. Beachten Sie, dass es keine beitragenden Quellen gibt, da nur eine Quelle vorhanden ist.

json
{
  "contributingSources": [],
  "mimeType": "video/VP8",
  "payloadType": 96,
  "rtpTimestamp": 2503280194,
  "synchronizationSource": 1736709460,
  "dependencies": [],
  "frameId": 1,
  "height": 240,
  "spatialIndex": 0,
  "temporalIndex": 0,
  "width": 320
}

Verwendung von WebRTC Encoded Transforms

Help improve MDN

War diese Übersetzung hilfreich?

Ja Nein

Erfahren Sie, wie Sie beitragen können Diese Seite wurde automatisch aus dem Englischen übersetzt.

Übersetzung auf GitHub anzeigen • Fehler mit dieser Übersetzung melden

WebRTC API
RTCEncodedVideoFrame
Konstruktor
1. RTCEncodedVideoFrame()
Instanzeigenschaften
Instanzmethoden
1. getMetadata()
Verwandte Seiten für WebRTC
Anleitungen
1. Einführung in WebRTC-Protokolle
2. Einführung in das Real-time Transport Protocol (RTP)
3. WebRTC-Konnektivität
4. Herstellen einer Verbindung: Das WebRTC-Perfect-Negotiation-Muster
5. Lebenszyklus einer WebRTC-Sitzung
6. Signalisierung und Videoanrufe
7. Verwenden von WebRTC-Datenkanälen
8. Verwendung von DTMF mit WebRTC
9. Verwenden von WebRTC Encoded Transforms
10. Ein einfaches RTCDataChannel-Beispiel
11. Bau eines internetfähigen Telefons mit PeerJS

RTCEncodedVideoFrame: getMetadata()-Methode

In diesem Artikel

Syntax

Parameter

Rückgabewert

Beispiele

Spezifikationen

Browser-Kompatibilität

Siehe auch

Help improve MDN