HTMLMediaElement: addTextTrack() 方法
addTextTrack()
方法是 HTMLMediaElement
接口的一个方法,用于创建一个新的 TextTrack
对象并将其添加到媒体元素中。它会在该媒体元素的 textTracks
上触发一个 addtrack
事件。此方法不能在 TextTrackList
接口上使用,只能在 HTMLMediaElement
上使用。
语法
js
addTextTrack(kind)
addTextTrack(kind, label)
addTextTrack(kind, label, language)
参数
kind
-
一个字符串,表示
TextTrack.kind
属性(subtitles
、captions
、descriptions
、chapters
或metadata
)。 label
-
一个字符串,表示
TextTrack.label
属性。 language
-
一个字符串,表示
TextTrack.language
属性。
返回值
新创建的 TextTrack
对象。
异常
无。
示例
此示例添加了一个 kind
设置为 "subtitles"
的新 TextTrack
,并向其添加了一个新的 VTTCue
。
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!"
规范
规范 |
---|
HTML # dom-media-addtexttrack-dev |
浏览器兼容性
加载中…