/ brightcove

Getting started with Brightcove on Sitecore 9

Brightcove platform is one of the industry-leading platforms for media. Installing their package helps in better integration with Sitecore. Enjoy the benefits of both the worlds without much of a hassle. I will walk you through the installation steps. Those who are familiar with Brightcove installation till Sitecore 8 we would need to install two packages Sitecore Media Framework and Brightcove.

PreRequisite

  • Sitecore 9 (Documented on Sitecore 9.02)
  • Brightcove
    • Package
    • Cloud Account accesss
    • Api Access keys

Official Documentation and Download links can be found in the following link
https://support.brightcove.com/getting-started-brightcove-video-connect-sitecore-experience-platform

Package
https://github.com/BrightcoveOS/Sitecore-Connector/releases/tag/v9.0.1
Source code
https://github.com/BrightcoveOS/Sitecore-Connector/tree/v9.0.1

Installation

We just have one package, Media Framework is integrated in Brightcove module. Another change the Brightcove use to have their own versioning till now but going forward the Brightcove version will match the Sitecore major version. The version we will install is Brightcove 9 for Sitecore 9.

Install the package from the Sitecore Desktop or Control panel
Control Panel > Administration > Install a package
brightcove_sitecore_9_install_13
Sitecore Desktop > Choose Developement Tools > Installation Wizard
Click upload package > Choose the package downloaded and upload
brightcove_sitecore_9_install_1

Choose the uploaded package and click next
brightcove_sitecore_9_install_2

brightcove_sitecore_9_install_3
There is a note for post install, We might miss the notes I have copied the notes for convenience

After installation, update the Sitecore.MediaFramework.Services.Brightcove.Extended.config.disabled file with the correct values, then remove the .disabled extension.

Also, run the temp/Sitecore 9.0 Media Framework Reporting Data Update Script.sql script to create the reporting databases.

Click next and Install.
brightcove_sitecore_9_install_4

Post Install

Step 1:
We need to deploy & publish the playback page events,
Select the Workbox option from the startup menu check the Analytics workflow and deploy the playback events.
brightcove_sitecore_9_install_11

Step 2:
I enabled the config file most of it was standard values only thing I updated was the BaseUrl at line 49. \inetpub\wwwroot\sc9.local\App_Config\Include\MediaFramework\Sitecore.MediaFramework.Services.Brightcove.Extended.config

Step 3:
Open the downloaded package and navigate to the following path to find the SQL Script mentioned by the package installer.
Brightcove.Media.Framework-9.0.1.zip\package.zip\files\temp\Sitecore 9.0 Media Framework Reporting Data Update Script
brightcove_sitecore_9_install_5

Configuration

Let go to the content editor and expand the Media Library to check if we have a Mediaframework Item > Accounts
Time to create a new account before doing this follow this video to get the account credentials from the Brightcove cloud
https://support.brightcove.com/getting-started-brightcove-video-connect-sitecore-experience-platform#linking

Once we have the application client id and secret time to configure.Right click account and add an account. Key in the publisher id which is your account id.
brightcove_sitecore_9_install_6

Next Step would be to add players. We should match the players created in the cloud. I created two players one with and the other one is without the playlist. When you try to add a new player in the Sitecore it will ask you the player id use the one listed on the cloud.
brightcove_sitecore_9_install_7

Final step click on the settings and choose the default players.
brightcove_sitecore_9_install_8

We are all set now let us do an import to check if everything is working as expected. When you are in the Media > Media Framework Library.Choose the Mediaframework in the ribbon. Start with Import Tags to test and later do the Import Videos. Once the import is completed it should have all the videos and tags. Time to publish and use it on the site.
brightcove_sitecore_9_install_12

Challenges

I faced an error while running the import from the Media Framework Ribbon action.

Account item validation failed.
brightcove_sitecore_9_install_10
I was able to sort out the issue with the help of Yogesh Patel, it was identified as Sitecore bug. The Sitecore.Kernel.dll needs to be patched as a fix. Please create a support ticket and request a patch for your environment to avoid overwriting any exisiting fixes and that should sort the issue.

I have attached the patch for your testing.
Sitecore.Kernel_Brightcoveo_Fix

If you face any issues like the videos not showing try doing a reindex for the Mediaframework node.

Ref:
If you are intrested in Brightcove install for Sitecore 8 refer Gopi's blog

Photo by Plush Design Studio on Unsplash