HTMLMediaElement: addTextTrack() Methode - Web-APIs

HTMLMediaElement: addTextTrack() Methode - Web-APIs | MDN

Baseline Weitgehend verfügbar

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

Die addTextTrack()-Methode des HTMLMediaElement-Interfaces erstellt ein neues TextTrack-Objekt und fügt es dem Medien-Element hinzu. Sie löst ein addtrack-Ereignis auf den textTracks dieses Medien-Elements aus. Diese Methode kann nicht auf einem TextTrackList-Interface verwendet werden, nur auf einem HTMLMediaElement.

Syntax

addTextTrack(kind)
addTextTrack(kind, label)
addTextTrack(kind, label, language)

Parameter

kind: Ein string, der die TextTrack.kind-Eigenschaft repräsentiert (subtitles, captions, descriptions, chapters oder metadata).
label: Ein string, der die TextTrack.label-Eigenschaft repräsentiert.
language: Ein string, der die TextTrack.language-Eigenschaft repräsentiert.

Rückgabewert

Das neu erstellte TextTrack-Objekt.

Ausnahmen

Keine.

Beispiele

Dieses Beispiel fügt ein neues TextTrack hinzu, wobei kind auf "subtitles" gesetzt ist, und fügt diesem einen neuen VTTCue hinzu.

const video = document.querySelector("video");
const newTrack = video.addTextTrack("subtitles");
newTrack.addCue(new VTTCue(3, 6, "Hello world!"));
console.log(newTrack.cues[0].text);
// "Hello world!"

Spezifikationen

Spezifikation
HTML # dom-media-addtexttrack-dev

Browser-Kompatibilität

Siehe auch

Help improve MDN

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