Invoke Picture in Picture playback (Android)

Learn how to enable users to toggle Picture in Picture functionality in your Android app

With Picture in Picture mode, users can watch video while using other apps. For example, one of your users can continue watching one of your videos while writing an email.



Captions are displayed for only tablets, but disabled for Mobile view.


Android: Oreo 8.0+ (API level 26+)


The following steps will enable the Picture in Picture icon on the player and auto-enable Picture in Picture to work on the UserHint Button click. When a viewer clicks on the Picture in Picture icon or hits the home button, the Picture in Picture mode will be enabled.

  1. Add the Picture in Picture support in the manifest file for the activity that hosts the JW Player.



    Please note that to manually control multi-window configuration changes, such as resizing, you must add the android:configChanges attribute to the activity tag.

  2. Register the activity with the JWPlayer instance for Picture in Picture. The following example shows registering Picture in Picture at onCreate().

    protected void onCreate(Bundle savedInstanceState) {
       mPlayerView = findViewById(;
       mPlayerView.getPlayerAsync(this, getLifecycle(), (JWPlayer player) -> {
           mPlayer = player;
           mPlayer.registerActivityForPip(this, getSupportActionBar());
  3. Notify the player instance about the Picture in Picture feature.

    public void onPictureInPictureModeChanged(boolean isInPictureInPictureMode, Configuration newConfig) {
       super.onPictureInPictureModeChanged(isInPictureInPictureMode, newConfig);
       mPlayer.onPictureInPictureModeChanged(isInPictureInPictureMode, newConfig);

Now that you have successfully implemented the Picture in Picture functionality, you can use the following sections to customize the implementation and listen for events.


JWPlayer.deregisterActivityForPip()Manually disable the Picture in Picture feature

The SDK automatically deregisters activity for Picture in Picture on activity onDestroy().
JWPlayer.enterPictureInPictureMode()Manually enter Picture in Picture mode by associating the feature to a customized external button
JWPlayer.exitPictureInPictureMode()Manually exit Picture in Picture mode by associating the feature to a customized external button
JWPlayer.setPipOnBackground(boolean value)Enable or disable entering Picture in Picture mode when the Home button has been clicked

Default: JWPlayer.setPipOnBackground(true)
JWPlayer.setPipAspectRatio(Rational pipAspectRatio)Set the Picture in Picture aspect ratio

Read setAspectRatio to learn more about this natively supported Android OS customization.
mPlayer.setPipSourceRectHint(Rect pipSourceRectHint)Set the source bounds hint

Read setSourceRectHint to learn more about this natively supported Android OS customization.

Event Listening

Whenever a user enters or exits Picture in Picture mode, an event is fired from the SDK. The following code sample demonstrates how to listen for these events.

public class PlayerEventHandler implements PipPluginEvents.OnPipOpenListener,
PipPluginEvents.OnPipCloseListene {
    public PlayerEventHandler() {
        mPlayer.addListeners(this, EventType.PIP_OPEN, EventType.PIP_CLOSE);

    public void onPipOpen(PipOpenEvent pipOpenEvent) {
       //PiP open is triggered

    public void onPipClose(PipCloseEvent pipCloseEvent) {
        //PiP Close is Triggered