android-player-samples

Provides sample apps for the Brightcove Player SDK and Plugins for Android

View the Project on GitHub BrightcoveOS/android-player-samples

android-player-samples

Provides sample apps for the Brightcove Player SDK and Plugins for Android.

Learn more about the Brightcove Native Player SDKs.

The Android sample app projects in this repository can be inserted directly into Android Studio and subsequently executed or simulated. This version of the sample apps supports the latest Brightcove SDK and plugins. The following sample apps are included:

Brightcove ExoPlayer sample apps:

An important note

Starting from the SDK v8.3.0, the sample apps require Java 17.

The Issues tab is now closed. To report any problem or provide feedback, please refer to the Support section below.

Brightcove Java sample apps using ExoPlayer

Note that in order to enable the FreeWheel sample apps, you must independently obtain the non-free FreeWheel AdManager.aar library archive and install it into the directory libs/ which is typically located at the root of your /home/ directory. The Brightcove Native SDK for Android and the FreeWheel sample apps require the FreeWheel AdManager library version 6.28.0. Please note that Brightcove does not distribute the FreeWheel libraries. Contact FreeWheel directly for more information on how to obtain their products.

Brightcove Kotlin sample apps using ExoPlayer

Installing the sample apps

Currently, all of the sample app projects must be installed together as a bundle. Individual sample app projects also have specific dependencies. For those specific dependencies, see the individual project descriptions above for details.

To install the sample apps into Android Studio, please make sure you have the latest version. You can obtain and install the latest version from: Android Studio After Android Studio is installed, please follow the following steps:

From Android Studio using VCS installation:

  1. Select the Checkout From Version Control option in the new project dialog,
  2. Pick the GITHUB menu entry
  3. Use https://github.com/BrightcoveOS/android-player-samples.git for the URL
  4. Click on SUBMIT and use default values on subsequent screens.

From Android Studio using Import

  1. Clone this repo to your file system.
  2. In the File menu, select the Import Project… option in the new project dialog,
  3. Using the file selector dialog, select the top level build.gradle file from the cloned repo on your system,
  4. Click on OK and use default values on subsequent screens.

Android Studio will now download, import and build all of the sample apps. At this point the samples will be in your instance of Android Studio where you can observe the snippets in action on a physical or virtual device, walk through the code using the Android Studio debugger, search on keywords or just browse Android source code.

Overriding the default build behavior

By default, the sample apps will build with the most recent Brightcove Android Native Player version at build time. To override this behavior with a specific version, create a file named .gradle/gradle.properties in your home directory and set the value of the property anpVersion to the desired version. An invalid version will cause no sample app projects to be configured.

Building with Gradle on the command line

These sample apps now build with the latest released version of Gradle, 7.4.1. Please note that when building these apps from the command line, that the Gradle daemon is started, and will continue to run after the build completes.

To stop the daemon after the build completes, run the following: ./gradlew --stop

Running a sample app

  1. To run a sample app on an Android 5.0 or later device, plug the device into the computer and ensure that USB debugging is enabled.
  2. Select a sample app from the Run/Debug Configuration selector and click on the run (green button) icon to start the sample.

Support

If you have questions, need help or want to provide feedback, please use the Support Portal or contact your Account Manager. To receive notification of new SDK software releases, subscribe to the Brightcove Native Player SDKs Google Group.

Enjoy!

The Brightcove Player Android Team