HTMLMediaElement: getStartDate() Methode

Die getStartDate() Methode der HTMLMediaElement Schnittstelle gibt ein neues Date-Objekt zurck, das das reale Datum und die Uhrzeit darstellt, die dem Beginn der Medien entsprechen.

Dies ist ntzlich fr Medienstreams, die an eine reale Uhrzeit gebunden sind, wie z.B. eine Live-bertragung, die zu einem bestimmten Datum und einer bestimmten Uhrzeit begann. Fr Medien, die keine Datums- und Zeitinformationen enthalten, wird das zurckgegebene Date-Objekt einen Zeitwert von NaN haben.

Syntax

getStartDate()

Parameter

Keine.

Rckgabewert

Ein Date-Objekt, das das Startdatum und die Startzeit der Medien darstellt. Wenn die Medien keine Datums- und Zeitinformationen enthalten, wird das zurckgegebene Date-Objekt einen Zeitwert von NaN haben.

Beschreibung

Intern speichert jedes Media-Element ein Startdatum, das als NaN (nicht gesetzt) beginnt. Sobald der Browser gengend Daten geladen hat, um die Metadaten der Medien zu lesen, wird das Startdatum auf die reale Zeit gesetzt, die dem Beginn der Medien entspricht sofern das Format eines bereitstellt. Wenn nicht, bleibt das Startdatum NaN.

Fr Medien, die eine Startzeit und ein Startdatum angeben (zum Beispiel eine ber das Web gestreamte Live-TV-bertragung), gibt getStartDate() ein Date-Objekt zurck, das der realen Zeit entspricht, zu der die Medien beginnen. Dies erlaubt es den Medienplayer-Steuerelementen, absolute Zeiten (wie "14:30 Uhr") anzuzeigen, anstatt Zeiten relativ zum Beginn der Wiedergabe (wie "3 Stunden, 12 Minuten").

Das zurckgegebene Date wird in einem der folgenden Flle einen Zeitwert von NaN haben (was es zu einem ungltigen Datum macht):

Es wurden noch keine Daten geladen (readyState ist HAVE_NOTHING), daher wurde das Startdatum nicht gesetzt.
Das Medienformat enthlt keine Datums- und Zeitinformationen.

Das Startdatum ist nicht garantiert verfgbar, sobald das loadedmetadata Ereignis ausgelst wird. Zum Beispiel tragen HLS Streams Daten in Segment-Level #EXT-X-PROGRAM-DATE-TIME Tags, die zu diesem Zeitpunkt mglicherweise noch nicht gelesen wurden. Das Warten auf das loadeddata Ereignis ist stattdessen zuverlssiger ber Formate hinweg, da der Browser bis dahin genug Daten geladen hat, um das Startdatum zu bestimmen.

Beispiele

Startdatum eines Live-Streams anzeigen

Dieses Beispiel ruft das Startdatum eines Live-Streams ab das reale Datum und die Uhrzeit, zu der die bertragung begann, wie vom Server im Stream eingebettet und zeigt es an. Es wird auf das loadeddata Ereignis gehrt, das ausgelst wird, sobald gengend Daten geladen wurden, damit das Startdatum verfgbar ist.

HTML

html

<video src="livestream.m3u8" controls></video>
<output>Start date: loading</output>

JavaScript

const video = document.querySelector("video");
const display = document.querySelector("output");

video.addEventListener("loadeddata", () => {
  const startDate = video.getStartDate();

  if (isNaN(startDate.getTime())) {
    display.textContent = "Start date: not available";
  } else {
    display.textContent = `Start date: ${startDate.toLocaleString()}`;
  }
});

Ergebnis

Die Ausgabe unten zeigt das Startdatum der Medien, wie vom Server bereitgestellt. Beachten Sie, dass dies in den Beispieldaten in stream.m3u8 kodiert ist.

Spezifikationen

Spezifikation
HTML # dom-media-getstartdate

Browser-Kompatibilitt

Siehe auch

Help improve MDN

War diese bersetzung hilfreich?

Ja Nein

Erfahren Sie, wie Sie beitragen knnen Diese Seite wurde automatisch aus dem Englischen bersetzt.

bersetzung auf GitHub anzeigen Fehler mit dieser bersetzung melden