Subtitles display text on the video screen in order to communicate spoken dialogue and enhance the video experience. There are typically two types of the display text:
- captions for viewers who do not hear properly (Hearing Impaired Subtitles)
- subtitles for non-native speakers, which basically translate the dialogue
Through standardized formats and easy upload, every Qbrick customer is now able to serve an unlimited number of subtitles to their viewers through the Qbrick players, including captions for hearing impaired.
The function is available in the Professional and Enterprise Editions.
The option to display subtitles has been added to the PRO3 and PRO 4 players (Flash players). The feature is not supported in HTML5.
How does it work
Working with subtitles is very easy - per default, the feature is activated in the portal players (ask D&S to turn it on for satellite players, if necessary).
Therefore, all that needs to be done is uploading the subtitles and activating the subtitles button in the player.
Please note that the subtitles can be displayed regardless of the visibility of the button, as soon as one of the subtitles is defined as default. In other words, you can force the subtitles to be shown at all times regardless of the player settings.
How does it look
The subtitles control come as a separate button in the player. If activated in the Embed tab in the OVP, it is accessible at all times and the available subtitles are visible on hover over.
Please note that the naming of the subtitles will be displayed in the own language e.g. 'Dansk' and not 'Danish', 'Deutch' and not 'German' etc.
You can also decide whether you want to show the background panel or not for the subtitles text. E.g. gray background for videos where white text would not be visible at all times.
The setting for displaying the panel is available in the Advanced Editor for each player, on the 'modules' tab (useBackgroundPanel).
The subtitles can be uploaded one by one or in bulk, both directly in the OVP or using the API:
OVP upload - one by one
1. Go to the Media Files tab and expand the media object:
2. In the SUBTITLES section, click the Select file button
3. Match the name with the language the file contains
4. Choose the type of subtitle (Hearing impaired or Standard) from the drop-down
5. Click the plus sign to add the subtitle.
Read more about the API upload in the Developer Space.
Setting up the player
Activating the subtitles button will make it appear on the controls panel in the player. If the player is configured to display the subtitles button but there are no subtitles available for that particular video, the button will be inactive (grayed out).
This is done in the Embed tab:
Other available settings
In the Advanced Editor, a number of other settings are also available:
- useBackgroundPanel - whether or not the subtitles should be displayed on a background when the video is playing. If disabled ('off'), the style in the subtitle file will determine this. If enabled ('on'), all styling will be ignored and the player will use the default plugin style (black background).
- preferredLanguage - configures the preferred language for the player, using the Accept-Language header syntax (as defined in Hypertext Transfer Protocol -- HTTP/1.1). The Accept-Language header provides information about the user's language preferences in the browser.
When activated, the player will try to select the subtitle matching the viewer's browser language, overriding the default subtitle set in the OVP. When disabled, the default subtitle will be used.
- preferredType - configures the preferred subtitle type: 'standard' or 'impaired'. When activated, the player will try to select any subtitle matching that type. This setting should be used together with the 'preferredLangauge' setting, in order to achieve the correct configuration, for example: hearing impaired (preferredType) in French (preferredLanguage).
- useAcceptLanguageHeader - specifies whether the player should use the Accept-Language header provided by the browser to determine the correct language for the viewer. This will override the prefferedLanguage-setting. If disabled, the preferredLanguage will be used.
- checking what subtitles are currently being displayed
- listing all available subtitles for the current clip
- setting the subtitle that is currently being displayed in the player
The VMS API additionally allows for:
- adding subtitles
- removing subtitles
Read more on the API extensions in the Developer Space.
Hearing impaired subtitles
The hearing impaired subtitles provide additional information about instrumental music, environmental sounds or other details necessary to follow the story (e.g. when a doorbell rings or a gun shot is heard).
A regular, non hearing impaired subtitle does not contain anything other than spoken words (plus some visible text like signs or newspaper clips, computer screens.)
The subtitles for hearing impaired can be uploaded in the same way as the remaining subtitles. Mark the file to indicate the special type of subtitles:
Once a hearing impaired subtitle is available, the following icon will appear:
- formatting and styling is not supported for the .srt files
- not all features of TTML 1.0 (http://www.w3.org/TR/ttaf1-dfxp/) are supported. The supported features are covered in detail here: http://osmf.org/dev/osmf/specpdfs/CaptioningPlugin.pdf
The subtitles are not displayed after selecting the language
Please note that there is no validation of the content in the uploaded file, which means that a wrongly formatted subtitle file can potentially be added to the media object. The subtitle will then be selectable in the player, but the actual subtitles will not show up on the screen.
Visit the FAQs section for more details.