video.js contains the ability to include tracks with the video, including subtitles,
captions and descriptions. includeTextTracks will make sure that they are
included on load, and find the defaults to embed with the video.
includeTextTracks(
video,
files,
language = "en",
label = "English",
kind = "subtitles",
default = FALSE
)A video()
A vector of WebVTT files that contain "cues" of when text should appear, hide and what text to display
The valid BCP 47 code for the language of the text track, e.g. "en" for English or "es" for Spanish.
Short descriptive text for the track that will used in the user interface. For example, in a menu for selecting a captions language.
An optional vector to match the type of text tracks in files:
(default): Translations of the dialogue in the video for when audio is available but not understood. Subtitles are shown over the video.
Transcription of the dialogue, sound effects, musical cues, and other audio information for viewer who are deaf/hard of hearing, or the video is muted. Captions are also shown over the video.
Chapter titles that are used to create navigation within the video. Typically, these are in the form of a list of chapters that the viewer can use to navigate the video.
Text descriptions of the action in the content for when the video portion isn't available or because the viewer is blind or not using a screen. Descriptions are read by a screen reader or turned into a separate audio track.
Tracks that have data meant for JavaScript to parse and do something with. These aren't shown to the user.
The boolean default attribute can be used to indicate that a track's
mode should start as "showing". Otherwise, the viewer would need to select their language
from a captions or subtitles menu.
An updated video with text tracks included
All vectors must either be the same length as files or of length 1. In the latter,
they will be applied to all files supplied.
vid <- video("https://vjs.zencdn.net/v/oceans.mp4")
includeTextTracks(vid, "url/to/subtitles.vtt")