Brightcove Player SDK for Android Samples

Sample apps for the Brightcove Player SDK for Android and its plugins. This is the reference repository for building with the SDK: each capability is demonstrated by a small, focused app, and every capability ships a Java and a Kotlin variant kept at parity.

Prerequisites

The latest Android Studio.
JDK 17 (required since SDK 8.3.0).
Android 5.0 (API 21) or later on the device/emulator; the apps compile and target API 36.
Builds with the bundled Gradle 8.13 wrapper.
The SDK version is pinned by anpVersion in gradle.properties (currently 10.4.25). To build against a different version, set anpVersion in ~/.gradle/gradle.properties. To develop against a local SDK checkout, set anpVersion=LOCAL (see settings.gradle).
A few samples need artifacts Brightcove does not distribute — the FreeWheel AdManager.aar and the Pulse Pulse.aar. See the FreeWheel and Pulse READMEs.

Repository layout

Samples are grouped by capability. Each top-level folder collects one capability’s samples and has its own README covering shared setup; inside, each sample ships as …SampleApp-java and …SampleApp-kotlin.

Player/  PlayerUI/  IMA/  DAI/  SSAI/  FreeWheel/  Pulse/  DRM/  Cast/  Offline/

Capabilities

Playback — Player/: basic playback, video list / playlist, live / DVR, 360 video, audio-only playback, Picture-in-Picture, thumbnail scrubbing, plus the Android-specific TextureView, AppCompat entry points, and bumper samples.
UI customization — PlayerUI/: custom controls — customized and styled controls, seek-bar colors, and a rewind button.
Advertising — IMA/ · DAI/ · SSAI/ · FreeWheel/ · Pulse/: Google IMA (client-side), Google DAI, Brightcove server-side ad insertion (incl. PAL), FreeWheel, and Pulse.
DRM & offline — DRM/ · Offline/: Widevine Modular playback and offline (downloaded) playback.
Casting — Cast/: Google Cast with the Brightcove Cast Receiver.

Coverage matrix

Every capability ships a Java and a Kotlin sample.

Capability	Sample(s)
Basic playback	`Player/BasicSampleApp-java` · `Player/BasicSampleApp-kotlin`
Video list / playlist	`Player/VideoListSampleApp-java` · `Player/VideoListSampleApp-kotlin`
Live / DVR	`Player/LiveSampleApp-java` · `Player/LiveSampleApp-kotlin`
360 video	`Player/360VideoSampleApp-java` · `Player/360VideoSampleApp-kotlin`
Audio-only playback	`Player/AudioOnlySampleApp-java` · `Player/AudioOnlySampleApp-kotlin`
Picture-in-Picture	`Player/PictureInPictureSampleApp-java` · `Player/PictureInPictureSampleApp-kotlin`
Thumbnail scrubbing	`Player/ThumbnailScrubberSampleApp-java` · `Player/ThumbnailScrubberSampleApp-kotlin`
Custom controls	`PlayerUI/` — 4 samples
IMA ads	`IMA/` — 4 samples
DAI	`DAI/BasicDAISampleApp-java` · `DAI/BasicDAISampleApp-kotlin`
SSAI	`SSAI/` — 2 samples
FreeWheel	`FreeWheel/` — 2 samples
Pulse	`Pulse/PulseSampleApp-java` · `Pulse/PulseSampleApp-kotlin`
DRM (Widevine)	`DRM/WidevineModularSampleApp-java` · `DRM/WidevineModularSampleApp-kotlin`
Fallback HDCP	`DRM/HdcpFallbackSampleApp-java` · `DRM/HdcpFallbackSampleApp-kotlin`
Casting	`Cast/BasicCastBrightcoveReceiverSampleApp-java` · `Cast/BasicCastBrightcoveReceiverSampleApp-kotlin`
Offline playback	`Offline/OfflinePlaybackSampleApp-java` · `Offline/OfflinePlaybackSampleApp-kotlin`
Bumper	`Player/BumperSampleApp-java` · `Player/BumperSampleApp-kotlin`
TextureView	`Player/TextureViewSampleApp-java` · `Player/TextureViewSampleApp-kotlin`
AppCompat entry points	`Player/AppCompatSampleApp-java` · `Player/AppCompatSampleApp-kotlin`

Building

Open the project in Android Studio one of these ways:

Get from VCS (Welcome screen) or File > New > Project from Version Control…, select Git, and enter https://github.com/BrightcoveOS/android-player-samples.git; or
clone the repository and choose File > Open… on its root folder.

Android Studio downloads dependencies and builds every sample. To build from the command line:

./gradlew assembleDebug                                  # all samples
./gradlew :Player:BasicSampleApp-kotlin:assembleDebug    # one sample
./gradlew --stop                                         # stop the Gradle daemon afterwards

Running a sample

Plug in an Android 5.0+ device with USB debugging enabled (or start an emulator), pick the sample from the Run/Debug Configuration selector, and run it.

Support

Use the Support Portal or contact your Account Manager. To hear about new SDK releases, subscribe to the Brightcove Native Player SDKs Google Group.