HTMLMediaElement: phương thức addTextTrack()
Baseline
Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.
Phương thức addTextTrack() của giao diện HTMLMediaElement tạo một đối tượng TextTrack mới và thêm nó vào thành phần media. Nó kích hoạt một sự kiện addtrack trên textTracks của thành phần truyền thông này. Không thể sử dụng phương pháp này trên giao diện TextTrackList, chỉ có thể sử dụng HTMLMediaElement.
Cú pháp
js
addTextTrack(kind)
addTextTrack(kind, label)
addTextTrack(kind, label, language)
Tham số
kind- : Một chuỗi đại diện cho thuộc tính
TextTrack.kind(subtitles,captions,descriptions,chapters, hoặcmetadata. label- : Một chuỗi đại diện cho thuộc tính
TextTrack.label. language- : Một chuỗi đại diện cho thuộc tính
TextTrack.language.
Giá trị trả về
Đối tượng TextTrack mới được tạo.
Ngoại lệ
Không có.
Ví dụ
Ví dụ này thêm TextTrack mới với kind được đặt thành "subtitles" và thêm VTTCue mới vào đó.
js
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!"
Đặc tả kỹ thuật
| Specification |
|---|
| HTML> # dom-media-addtexttrack-dev> |