Closed Captioning Brightcove videos with CaptionSync is easy using our integration. This tutorial describes how to set up CaptionSync's integration with Brightcove systems pre-2017.
Note that as of June 2016, all Brightcove users will be defaulted to the new Brightcove Studio. All of your video content, metadata, and user information is automatically available in the new Studio upon login. You may switch back to a previous version at any time by clicking the Legacy Studio link, in the top-right-hand corner of the screen. To learn how to add captions to your media files using newer versions of Brightcove Studio, just follow the steps in our Brightcove Studio tutorial.
Video Tutorial (This video is an alternative to the Text Tutorial)
One-Time Setup (CaptionSync account):
- Log into CaptionSync, go to Settings -> Account Features, select Enable my account for Legacy Brightcove Integration from the drop-down menu, and click Request Account Feature. You will receive an email updating you about the feature status. Note that if you don't see Brightcove on the "Account Feature to Add" drop-down menu, it's already enabled.
- Once you're notified that the feature is enabled, log into your Brightcove account and copy an API read token with URL access. This can be found in the Brightcove Studio under Account Settings -> API Management.
- Paste the read token into the appropriate field on your AST account under Settings -> Legacy Brightcove (see screenshot below). This token allows AST to retrieve media files from your Brightcove account for captioning.
- On your Brightcove account, copy the write token, then paste it into the appropriate field on your AST account. This token allows AST to update the metadata for your videos after they have been captioned.
- On the same screen in your AST account, you will also need to set the Base URL to Captions and the Callback URL for Captions. These fields indicate where the caption files will be stored after they are created. Note also that AST can host the caption files for you if you do not have a hosting location on your own server. If you choose to use CaptionSync hosting, you can accept the default values for the Base URL and Callback URL fields.
- Click Update Settings:
One-Time Setup (Brightcove account):
The Brightcove Accessible Player reads the location of the caption file for each video from a custom metadata field that you must add to your account. Here are the steps to add the custom field:
- In your Brightcove account, go to Account Settings -> Video Fields.
- Click Add Custom Field and create a new custom field with an internal name of dfxppath and type text. The Display Name that you use for this field can vary, but we suggest using Caption URL.
- Save your settings. This new metadata field will now be available for all videos that you upload, and will be used by the CaptionSync integration to set the complete URL for the caption file when the caption job is complete.
- In your CaptionSync account, go to Caption/Transcribe -> New Brightcove List for Captioning.
- Enter a short description for your list and add any optional transcription notes. On the Tags field, you can enter a tag, which will filter only a subset of all your Brightcove videos. This is useful if you have many videos in your library. The tags are a set of keywords that can be assigned to a video or set of videos on your Brightcove account. Learn in our Brightcove Tags article how to set them up.
- On the next screen, you will be presented with a list of videos that have not been captioned yet. You can select or deselect videos before submitting your job. If you used a tag when submitting the list, you will only be presented with the videos tagged in your Brightcove system.
Click Caption Selected Videos:
To see details of a request, cancel it or to submit a redo, log into CaptionSync and go to Captioning -> Status of Submissions. You may also use the Brightcove ID to track the status of your submissions by pasting the ID at the end of the https://web.automaticsync.com/show_details.php?bc_id= URL; then copy and paste the URL in your browser.
When your captions are complete they will be posted to the location specified in the Brightcove Settings on your CaptionSync account and the Caption URL metadata field will be updated for each video. You will also receive email notification of completion of the captioning job, unless you have disabled the notification feature.
Preparing your Player:
To display captions or subtitles on a Brightcove player, you need to add one or more plug-ins to your players, and customize it for accessibility requirements.
If you're using the Chromeless Video Player, you just need to follow the instructions below under step 2 and 3, in order to customize it appropriately. But if you wish to create a new accessible player, follow all the steps:
1. Go to Publishing -> New Player. On the dialog box, name the player and select the Accessible Video Player template, from the Template drop-down menu. Then click Create Player:
2. Select the newly created player, and click Settings. Open the Plug-Ins tab, and enter the URL to the remotely hosted captions file:
http://admin.brightcove.com/viewer/plugins/ClosedCaptionsModule.swf . Click Add. Finally, click Save Changes:
3. Open your captioned media file using the player you just created and customized:
You can toggle captions on and off by clicking the CC icon (note: the picture below illustrates the Accessible Video Player template):
You may wish to customize your players further using the Brightcove Player APIs or BEML.
- If you have a Purchase Order account, a valid Purchase Order needs to be set before you make any requests from Brightcove. If there isn’t a default Purchase Order set, the most recent valid one will be used. If there aren’t any valid Purchase Orders, all captioning requests will be rejected.
- Brightcove systems pre-2017 require a custom output called .bc.xml -- this is generated automatically when you make your Captioning request using this integration. However, Brightcove systems pre-2017 also accept the.dfxp.xml caption file.