On This Page

Adobe-AEM-Brightcove Connector: Configuration

This topic covers the configuration of the Brightcove connector for Adobe Experience Manager (AEM).

Introduction

The Adobe-AEM-Brightcove Connector allows you to manage Brightcove Video Cloud videos and players within AEM, and easily embed videos in AEM pages.

Note that this guide uses AEM 6.3. The connector also works with AEM 6.2, and the steps are similar.

Configuration steps

The following sections will walk you through the steps to configure the Adobe-AEM-Brightcove Connector using the classic interface. Note that before completing these steps, the connector must be installed - see Adobe-AEM-Brightcove Connector: Installation

Disable DAM transcoding

By default, when you upload video assets to the AEM DAM it will run ffmpeg in the background to transcode the video into a variety of formats. If you do not have a need for the transcoded assets in the DAM, you should turn off the transcoding to save processing time and storage:

Allowed Groups: specify the group that will access the Connector (required) be sure that it is a group you are included in.

Players Store Path: keep default value or use folder of your choice for players for this Brightcove account (required)

Default Video Player ID: keep default value or choose another player ID (required)

Default Video Player Key: deprecated, leave blank or use value from previous connector

Default Playlist Player ID: enter a player ID enabled for playlists if you plan to use playlists (required)

Default Playlist Player Key: deprecated, leave blank or use value from previous connector

Proxy server: leave blank or enter proxy if you were previously using a proxy

Dam Integration Path: keep default value or use folder of your choice for video assets for this Brightcove account (required)

Ingest Profile: specify Brightcove ingest profile to be used for uploaded videos, blank value will use default profile, if blank/default is not working, ask Brightcove support to make sure a default profile is defined in the Video Cloud backend

Test your configuration. Browse to http://localhost:4502/brightcove/admin and select the Brightcove account just added in the pull-down in the upper right corner. If no videos are displayed, it is likely due to one of the following reasons:

Your API credentials Account ID, Client ID, and Client Secret may have been incorrectly entered in the connector configuration

Your API credentials were not configured properly in Brightcove

The currently logged in user is not a member of one of the Allowed Groups in the connector configuration

If you will be using multiple Video Cloud accounts, repeat the previous steps for each account.

Set up Brightcove Players

The last configuration task is to set up Brightcove Players.

Navigate to the Site Admin tools (http://localhost:4502/siteadmin#/content in the Classic UI or http://localhost:4502/sites.html/content in the Touch UI)

In the top-level Websites folder, create new folder that matches the Players Store Path in the configuration. The default is a folder name in the configuration is called brightcovetools with a folder inside called players. If you are connecting to multiple Brightcove accounts, you might want to create a unique players folder for each account.

Inside the players folder create a new Brightcove Player Page:
Player Page Creation

After you create the page, right-click on it and select Properties from the menu in the Classic UI; in the Touch UI, select the page and then click on Properties.

Go the Brightcove Basic tab of the dialog, and the Brightcove account and then select a player from the list:
Select Player

If you also want to make multiple players available for publishing, repeat the steps above to create a page for each player.

If you also want to use playlists, repeat the steps above to create a page for a Playlist Player.

If you are using multiple Brightcove accounts, you will need to create player pages for each one.

Activate Metadata Schema for Brightcove Asset Location

If you are using Touch UI with the v5.4 connector or later, you will need to activate the metadata schema for the Brightcove asset location. This is not necessary if you are only using classic UI. Activate the metadata schema with the following steps:

Open the AEM tools:
AEM Tools

Select Assets:
Assets

Select Metadata Schemas:
Metadata Schemas

Select brightcove and click Apply to Folders:
Select Brightcove

If the brightcove_assets folder does not exist, create a folder named brightcove_assets:
Create

Enter the name "brightcove_assets":
Create brightcove_assets Folder

Select brightcove_assets and click Apply:
Select brightcove_assets

You have now completed the configuration of the AEM-Brightcove Connector. Proceed to Using the Connector.