Contact Support | System Status
Page Contents

    Getting Started with Brightcove Video Connect for SharePoint

    This topic provides an overview of Brightcove Video Connect for SharePoint, along with installation instructions for the current version. For details of working with Brightcove videos in Sharepoint, see Using the Connector.

    Introduction

    Version Documentation Download Compatibility Notes
    4.1.2.0 Documentation Plug-in and source *

    SharePoint 2016/2019 On-premise, SharePoint 2016/2019 Online (Office 365), Brightcove CMS & DI API's, Brightcove HTML5 Player

    • Fix: issue with Experiences in certain situations.
    4.0.1.0 Documentation Plug-in and source *

    SharePoint 2013/2016 On-premise, SharePoint 2016 Online (Office 365), Brightcove CMS & DI API's, Brightcove HTML5 Player

    • New AppPart available for embedding Brightcove videos, playlists, and In-page Experiences. Can be used to embed Brightcove players on Modern Experience pages in lieu of using native embed icon.
    • A Proxy server for Brightcove APIs is no longer required, simplifying setup process.
    3.0.2.0 Skip to 4.0.x.x Release EOL

    SharePoint 2013/2016 On-premise, SharePoint 2016 Online (Office 365), Brightcove CMS & DI API's, Brightcove HTML5 Player

    • Supports publishing of In-page Experiences video portals
    • Uses Push-based Dynamic Ingest; now support upload of videos from SharePoint server behind a firewall
    • Uses default ingest profile in Brightcove instead of hard-coded profile
    • Improved UX
    • Simplified installation process
    2.0.2.66 Training Doc EOL SharePoint 2013/2016 On-premise, SharePoint 2016 Online (Office 365), Brightcove CMS & DI API's, Brightcove HTML5 Player
    1.1.2.8 Training Doc EOL SharePoint 2013 On-premise Only, Brightcove Media API, Brightcove Legacy Flash SmartPlayer 

    * © 2019 Brightcove

    Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0.  Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

    For help with this connector, please fill out this worksheet and include it with a support ticket to Brightcove customer support.

    Contents

    Installing Brightcove Video Connect for SharePoint

    Before you begin installation, review the following information about prerequisites and permissions:

    • Before a user can add an app for SharePoint, a member of the Farm Administrators group must configure the environment to support apps for SharePoint. For more information, see Configure an environment for apps for SharePoint 2013 or SharePoint 2016 or SharePoint 2019.
    • A user must have the Manage Web site and Create Sub-sites permissions to add an app for SharePoint. By default, these permissions are available only to users who have the Full Control permission level or who are in the Site Owner's group.
    • When a user adds an app for SharePoint, the app requests permissions that it needs to function (for example, access to Search, or to create a list). Users who do not have those permissions are informed that they do not have sufficient permissions and the app cannot be added. The user can contact a Site or farm administrator to see if the administrator can add the app.
    • A user logged in to a Site as the system account cannot install an app. The system account cannot import app licenses because that could result in performance problems.

    Adding the Brightcove Video Connect App to the App Catalog

    Setting Up App Catalog

    To install the Brightcove connector, the first step is to set up the App Catalog in SharePoint. Use the references below to complete this step.

    Adding the Brightcove Video Connect App to the catalog

    Once the App Catalog is setup, follow the steps listed below:

    1. Verify that the user account that is performing this procedure is a member of the Site Owners or Designers group for the App Catalog.
    2. On the App Catalog Site, click the Apps for SharePoint list.
    3. On the Apps for SharePoint page, click new item.
    4. In the Choose a file box, click Browse, and then locate the folder that contains the BrightcoveConnectorApp file.
    5. Select the App, and then click Open.
    6. Click OK to upload the App.
    7. In the Item details box, supply the Name, Title, Short Description, Icon URL, and other settings for the App. Be sure that the Enabled check box is selected so that users can see the App in their Sites. You can select the Featured check box to list the App in the Featured content view of the App Catalog.
    8. Click Save.

    Installing the Brightcove Video Connect App in a Site

    Follow the steps listed below to install the Brightcove connector in a Site:

    1. Verify that the user account that is performing this procedure is a member of the Site Owners group.
    2. To add the app, go to Site contents:
      Go to Site Contents
      Go to Site Contents
    3. Click the New dropdown, and select App
      Select New App
      Select New App
    4. In the My apps page, that appears, select the Brightcove Video Connector app and click Add:
      Select the Brightcove App
      Select the Brightcove App
    5. In the Grant Permission dialog box, click "Trust it".
      Grant Permissions
      Grant Permissions
    6. At this point, the BrightcoveConnector App for SharePoint is added and appears in Apps section of your Site Contents list. It is now available for use in the Site:
      Brightcove App Added
      Brightcove App Added

    Configuring the Brightcove Video Connect App

    Below are the configuration steps required after the app is added.

    1. Click on the Brightcove Video Connector item in the Site Contents List:
      Click Here to Configure
      Click Here to Configure
    2. A new page will open, and a message will appear indicating that no accounts are defined - this refers to Brightcove accounts to be used with Sharepoint:
      No Accounts Defined Message
      No Accounts Defined Message
    3. Close the message.
    4. In the Account Management settings that appear, click on Add New Account:
      Add New Account
      Add New Account
    5. In the New Account settings, you will click on the various buttons to enter information about your Video Cloud account - if you don't have the information at hand, you can get it from Video Cloud Studio as indicated below:
      New Account Settings
      New Account Settings

      Getting information in Studio

      • Account Name and Account ID can be found on the Account Information page under Admin:
        Account Information Page
        Account Information Page
      • DefaultVideoPlayerID and DefaultPlaylistPlayerID can be found by going to Players module:
        Players Module
        Players Module

        The player ids can be seen under the names in the players list:

        Player IDs
        Player IDs

        If you need to create new players for your account, see:

      • If you have not already created your Client ID and Client Secret, go to API Authentication under Admin in Studio, and follow the instructions in Managing API Authentication Credentials:
        API Authentication
        API Authentication

        The minimum permissions you need for your client credentials are:

        Minimum API Permissions
        Minimum API Permissions
      • For the Author's Group and Viewer's Group, you can select from the dropdown of Sharepoint groups you have defined:
        Selecting Authors and Viewers Groups
        Selecting Authors and Viewers Groups
    6. After you have entered all the necessary information, click Save Account.

    Launching Brightcove Video Connect for SharePoint

    To launch the application, the user can click on the BrightcoveConnector App within the Site Contents listing.

    You will be brought to the Home Page of the Connector App.

    The main navigation in the left column of the Connector is always present and allows the user to navigate all of the sections they have access to (see the section above regarding permissions). Below is a brief description of the purpose of each component of the Connector:

    • Home - The landing page when first entering the Connector.
    • Account Management - Provides the interface for entering the Brightcove Video Cloud account(s) information into SharePoint.
    • Add Videos - Upload new videos into Video Cloud. A video object is also created in SharePoint (except for the actual video file).
    • Manage Videos - Browse and edit existing videos as well as import videos from Video Cloud into SharePoint.
    • Manage Playlists - Create new playlists as well as browse and manage existing playlists.
    • Manage Experiences - Create and manage In-Page Experiences.
    Main Menu
    Main Menu

    Account Management Page

    The Account Management Page displays the current list of configured accounts, along with the assigned groups for Authors and Viewers.

    Account Management Page
    Account Management Page
    1. Account Title - Accounts currently configured (or at least created).
    2. AuthorsGroup - SharePoint group assigned "Author" rights for the account.
    3. ViewersGroup - SharePoint group assigned "Viewer" rights for the account.
    4. Add new account - Open the account creation screen to setup a new account.

    Page last updated on 28 Sep 2020