This article will help you get started with the development of Kaltura’s Video Player SDK for Android.

Before You Begin

This document describes the steps required for integrating the Playkit SDK in Android applications.

Please follow these instructions carefully to make sure the integration is successful. The article also shows you how to create a player using PlayerConfig.

In addition, you’ll also learn how to receive a PlayerConfig.Media object using the built-in MockMediaProvider.

By following these simple steps, you’ll be able to create your own player and start using it immediately.

System Requirements

To integrate the Kaltura Player Android SDK, the minimum system requirements are:

  • IDE: Android Studio 2.0 or later (see
  • OS version: Android 4.1 or later.
  • Java JDK 7 or later (see
  • Android SDK and Android SDK Tools

Developer Skills

Developers should have some background knowledge and experience with system setup before building Mobile SDK applications.

The required developer skillsets includes:

  • Familiarity with video delivery formats, ad delivery, DRM (when needed), login and passcode flows (these are essential for designing and debugging Mobile SDK applications).
  • At least 1-2 years of experience with the relative coding language Java (for Android development)
  • Hybrid requirement: Proficiency in HTML5 and JavaScript languages.

Known Issues and Limitations

The follwoing known issues and limitations are applicable to Android devices.

Black screen blinking when using the player in Fragment

There is a well known issue using Android SurfaceView inside Fragment. You can see this in stackoverflow here.

When the surface view appears in the window for the very fist time, it requests to change the window’s parameters by calling a private IWindowSession.relayout(..) method. This method “gives” the user a new frame, window, and window surface, which are empty at this stage.

Our solution is as follows:

1 . Add the following line of code to the root activity that is actually responsible for creating the Player Fragment:

    protected void onCreate(Bundle savedInstanceState) {


2 . Then, call the following:


immediately after the super.onCreate(savedInstanceState); But before this line:


This will make the surfaceView translucent until the layout is actually created.

Quick Start

In this section, you’ll learn how to build a basic video playback application using the Kaltura Player SDK for Android.

Android Quick Start

Have Questions or Need Help?

Check out the Kaltura Player SDK Forum page for different ways of getting in touch.