This article introduces the core features of the Wowza Flowplayer Android SDK and lists all requirements for adding the framework to your Android projects.
For questions or suggestions for improvements to the Android SDK, you can submit a support ticket to firstname.lastname@example.org.
The Wowza Flowplayer Android SDK is a native media player written entirely in Kotlin. It provides an easy-to-use API that enables developers to create Android applications that use the Wowza Flowplayer to play audio and video locally and over the internet.
The SDK framework uses Media3 ExoPlayer at its core, taking advantage of its powerful and well-tested features. It also supports adaptive streaming technologies, such as DASH, HLS, and SmoothStreaming, as well as the most popular single container formats, like MP4, MP3, WebM, and others.
When you integrate the Wowza Flowplayer Android SDK into your applications, you can deliver high-quality video playback, enhance user engagement, monetize your content through ads, and gain valuable insights into viewer behavior. Whether you're building video streaming applications, e-learning platforms, or social media applications, the SDK provides the tools to create compelling video experiences for your users.
The current version of the Wowza Flowplayer Android SDK is v2.0. You can clone our open-source example applications to understand how to integrate the SDK into your projects. For more, see Run the demo application.
With the Android SDK, you can take advantage of the following features when integrating the Wowza Flowplayer into your Android projects:
- MPEG-DASH, HLS, SmoothStreaming, MP4, WebM, and MP3 formats.
- Full-screen, seamless video playback and configurable device orientation management.
- Background playback while other applications are in the foreground.
- DRM-protected media playback.
- Picture-in-picture (PiP) mode.
- Live streaming support.
- IMA3-based Video Ad Serving Template (VAST) ad integration.
- Video Multiple Ad Playlist (VMAP) ad integration.
- Callbacks for monitoring a wide range of player events.
- Advanced playback controls and media session integration.
- Media session integration.
- Customizable player user interface.
- Subtitles using Web Video Text Tracks (WebVTT).
- Ability to control the player with Google Assistant.
For more details, see supported features for the Android SDK.
The Wowza Flowplayer Android SDK doesn't currently support the integration of multiple players at the same time.
Before you start with the latest version of the Wowza Flowplayer Android SDK, check the requirements in the following table. See the Get started section to continue working with the SDK.
|Minimum system requirements
|Android 4.4+ (API level 19+)
|Android Studio Giraffe
If your player is bundled with Wowza Video, access to Wowza Video. See Get Wowza Flowplayer.
To work with the Android SDK, install Android Studio Giraffe. You can use other tools to build your application, but we rely on Android Studio to demonstrate how to work with the SDK.
The steps in this section help you to clone our open-source flowplayer-android-sdk-demo repository and run a demo application in Android Studio. Upon successful completion, you can see examples of different player scenarios in a sample Android application.
You can clone the demo project from GitHub to your machine with the following command:
git clone email@example.com:flowplayer/flowplayer-android-sdk-demo.git
After you clone the demo project, follow these steps in Android Studio so you can launch the demo application and see the player in action.
YOUR_ACCESS_TOKENvalue with your Wowza Flowplayer token and save your manifest.
<meta-data android:name="com.flowplayer.accessToken" android:value="YOUR_ACCESS_TOKEN"/>
Add a virtual device in your emulator or connect a physical device.
If using a virtual device, we suggest the Pixel 7 Pro, running Tiramisu API Level 33 with Android 13.0. You may have to increase the internal storage to 4 GB under advanced settings. For more, see Create and manage virtual devices.
appconfiguration with your virtual device. See Run your app on the emulator .
- Once the Gradle build completes, the target device appears online and the app is available in the emulator.
In the device emulator, open the
app from the home screen.
Click the settings menu to select a media type. You should see various options, such as
Flowplayer no ads, DASH with VMAP, HLS, MP4,
- After the settings menu closes, select an activity or fragment from the Flowplayer Debug screen.
- The player launches in the emulator so you can see how it displays in a sample Android application.