Closed Captions in Player V4
If closed captions are available for a video, end users can click the CC button on the Player V4 control bar to open the closed captions screen for all browsers with web and mobile platforms. In the closed captions screen end users can enable or disable closed captions in the language of their choice and apply color, opacity, and font styling settings.
By default, if closed caption files are available for a video, they will be enabled and shown in English. You can configure the default behavior and language of closed captions for your player in skin.json by modifying the defaultEnabled and defaultLanguage attributes of the closedCaptionOptions object.
In Player V4, closed captions consist of the text, background, and window. The window is a rectangle that contains the background, which contains the text.
From the closed captions screen end users can preview what the closed captions will look like on the player before applying settings. Note that if closed captions are off, when you make a selection in the GUI, for example, selecting a language, closed captions will automatically turn on with that setting applied.
Supported Input Formats
Closed caption files should be uploaded to Backlot along with your video files. For details on how to upload closed caption files to Backlot, see Ingesting Closed Caption Files and Uploading a Closed Captions File in Backlot.
- Multi-language support
- Text size
- Text, background, and window color
- Text, background, and window opacity
- Text styling
If closed captions are available for a video, the end user has the ability to apply the styling mentioned above.
Storing Closed Caption Settings
With the closed caption screen UI controls, end users can make changes to closed caption styles on the fly. Player V4 saves closed caption settings automatically in the browser. If a user changes a setting (for example, chooses a different font color), the change remains in effect when they open a new browser tab or window, or launch a new browser session. The information is saved using local storage key "ooyala_player_settings". The OO.EVENTS.SAVE_PLAYER_SETTINGS event is triggered when a change is saved.
Enabling or Disabling Closed Captions
To turn closed captions on, the end user clicks. The player displays closed captions immediately after the end user clicks in the default closed caption language. The default closed caption language is English, unless otherwise specified in skin.json.
To turn closed captions off, the end user clicks.
Configuring Language and Caption SettingsIn the popover, click Caption Options to change the language and other settings for closed captions.
Selecting a Language
If you have associated closed captions with your video, end users will be able to select a caption language from the languages you provided.
To customize the closed caption language, the end user clicks Language and selects the desired closed caption language.
The default language is English, unless otherwise specified with the defaultLanguage attribute of the closedCaptionOptions object in skin.json.
Selecting Text, Background, and Window Colors
For the closed caption text, end users can select a color option to apply.
For the closed caption background and window, end users can select a color option or transparent option to apply.
To customize colors, end users click Color Selection and select a color. The default color settings are white text with a transparent window and a black background.
Selecting Text, Background, and Window Opacity
For the closed caption text, background, and window, end users can use the slider bars to select an opacity. The default opacity settings are 100% opacity for text, 0% opacity for the window, and 60% opacity for the background.
To view opacity options, end users click Caption Opacity.
Selecting a Font Type
End users can choose from a selection of font types. All Font types shown are web safe fonts that browsers can render automatically.
To customize the font type, end users click Font Type and select a font. The default font is Proportional Sans-Serif.
Selecting a Font Size
End users can select from small, medium, large, and extra large font sizes.
To customize the font size, end users click Font Size and select a size. The default size is the second text size icon (medium).
Applying Text Enhancements
To apply the text enhancements, end users click Text Enhancements and select an option.