Overview: Adding Captions to a Video

Product(s)
Video Cloud
Role(s)
Studio User
Player Developer
API Developer
Task(s)
Manage Videos
Topic(s)
Accessibility
Captions
Text Tracks
API(s)
CMS API
Dynamic Ingest API
Playback API

In this topic, you will learn how about working with captions in Video Cloud.

Introduction

Closed captions can be added to videos to provide additional or interpretive information to individuals who wish to access it. Captions are necessary so the deaf and hard of hearing can access the audio portion of video presentations.

Example of Captions
Example of Captions

Such text may be used for accessibility, to provide translations of the audio track or some other purpose, but the underlying technology used is the same.

Captions file location

You can choose where to host the WebVTT captions file:

  1. At a Remote URL (remote asset) - In this case, the WebVTT file is hosted on your server and you add the URL for the file to the video metadata.
  2. Uploaded using Video Cloud (ingested) - In this case, the WebVTT file is uploaded (ingested) to Video Cloud. This can be done using the Media module or using the APIs.

Associating captions with a video

There are several ways to associate a captions file with a video:

  1. Using Studio
  2. Modifying the player publishing code
  3. Using the APIs

Adding captions in Studio

Captions can be associated with a video using the Media module. For information, see Adding Captions to Videos using the Media Module.

Modifying the player publishing code

In this case, a <track> tag is added to the player publishing code. For more information, see Programmatically Adding Captions to Videos.

Adding captions via the APIs

How you add captions via the APIs varies depending on whether the captions file will be ingested or used as a remote asset.

  • Remote asset captions - If you prefer to host the captions yourself (or have a captions provider who hosts them), then you can associate the captions with a video using the CMS API. For information, see Using the CMS API: Add WebVTT Captions.

  • Add captions to Video Cloud - If you want to have Brightcove host your captions, you can ingest your WebVTT file using the Dynamic Ingest API. For information, see Ingesting WebVTT Files.

Removing captions

Captions can be removed from videos using the Media module or via the CMS API. In Studio, open the Media module and edit the video properties. Edit the Text Tracks property as needed.

Captions can also be removed using the CMS API by making an Update Video request and submitting a request body with an empty text_tracks array (or an array from which the object associated with that set of captions has been removed).

Styling captions

Styling can be applied to WebVTT captions using CSS. See Styling Captions for details.