# PictureInPictureProvider

Artifact: [androidx.core:core](https://developer.android.com/jetpack/androidx/releases/core) [View Source](https://cs.android.com/search?q=file:androidx/core/app/PictureInPictureProvider.kt+class:androidx.core.app.PictureInPictureProvider) Added in [1.18.0](https://developer.android.com/jetpack/androidx/releases/core#1.18.0)

*** ** * ** ***

<br />

```
public interface PictureInPictureProvider extends OnPictureInPictureModeChangedProvider, OnPictureInPictureUiStateChangedProvider, OnUserLeaveHintProvider
```

<br />

Known direct subclasses [ComponentActivity](https://developer.android.com/reference/androidx/activity/ComponentActivity)

|---|---|
| `https://developer.android.com/reference/androidx/activity/ComponentActivity` | Base class for activities that enables composition of higher level components. |

Known indirect subclasses [AppCompatActivity](https://developer.android.com/reference/androidx/appcompat/app/AppCompatActivity), [BaseCarAppActivity](https://developer.android.com/reference/androidx/car/app/activity/BaseCarAppActivity), [CarAppActivity](https://developer.android.com/reference/androidx/car/app/activity/CarAppActivity), [FragmentActivity](https://developer.android.com/reference/androidx/fragment/app/FragmentActivity), [LauncherActivity](https://developer.android.com/reference/androidx/car/app/activity/LauncherActivity)

|---|---|
| `https://developer.android.com/reference/androidx/appcompat/app/AppCompatActivity` | Base class for activities that wish to use some of the newer platform features on older Android devices. |
| `https://developer.android.com/reference/androidx/car/app/activity/BaseCarAppActivity` | Core logic for CarAppLibrary Activity interaction with a host. |
| `https://developer.android.com/reference/androidx/car/app/activity/CarAppActivity` | The class representing a car app activity in the main display. |
| `https://developer.android.com/reference/androidx/fragment/app/FragmentActivity` | Base class for activities that want to use the support-based `https://developer.android.com/reference/androidx/fragment/app/Fragment`. |
| `https://developer.android.com/reference/androidx/car/app/activity/LauncherActivity` | This class handles providing the right launcher activity when running native applications and Car App Library applications. |

*** ** * ** ***

Provider interface to support PiP (Picture-in-Picture) functionalities.

## Summary

| ### Public methods |
|---|---|
| `abstract void` | `https://developer.android.com/reference/androidx/core/app/PictureInPictureProvider#enterPictureInPictureMode(androidx.core.app.PictureInPictureParamsCompat)(@https://developer.android.com/reference/androidx/annotation/NonNull https://developer.android.com/reference/androidx/core/app/PictureInPictureParamsCompat params)` Available since API 24 in the framework Activity class, puts the activity in picture-in-picture mode if possible in the current system state. |
| `abstract void` | `https://developer.android.com/reference/androidx/core/app/PictureInPictureProvider#setPictureInPictureParams(androidx.core.app.PictureInPictureParamsCompat)(@https://developer.android.com/reference/androidx/annotation/NonNull https://developer.android.com/reference/androidx/core/app/PictureInPictureParamsCompat params)` Available since API 26 in the framework Activity class, updates the properties of the picture-in-picture activity, or sets it to be used later when `https://developer.android.com/reference/androidx/core/app/PictureInPictureProvider#enterPictureInPictureMode(androidx.core.app.PictureInPictureParamsCompat)` is called |

### Inherited methods

From [androidx.core.app.OnPictureInPictureModeChangedProvider](https://developer.android.com/reference/androidx/core/app/OnPictureInPictureModeChangedProvider) `abstract void` `https://developer.android.com/reference/androidx/core/app/OnPictureInPictureModeChangedProvider#addOnPictureInPictureModeChangedListener(androidx.core.util.Consumer)(

@https://developer.android.com/reference/androidx/annotation/NonNull https://developer.android.com/reference/androidx/core/util/Consumer<@https://developer.android.com/reference/androidx/annotation/NonNull https://developer.android.com/reference/androidx/core/app/PictureInPictureModeChangedInfo> listener

)`

Add a new listener that will get a callback associated with `https://developer.android.com/reference/android/app/Activity.html#onPictureInPictureModeChanged(boolean)` with the new `https://developer.android.com/reference/androidx/core/app/PictureInPictureModeChangedInfo`.
`abstract void` `https://developer.android.com/reference/androidx/core/app/OnPictureInPictureModeChangedProvider#removeOnPictureInPictureModeChangedListener(androidx.core.util.Consumer)(

@https://developer.android.com/reference/androidx/annotation/NonNull https://developer.android.com/reference/androidx/core/util/Consumer<@https://developer.android.com/reference/androidx/annotation/NonNull https://developer.android.com/reference/androidx/core/app/PictureInPictureModeChangedInfo> listener

)`

Remove a previously added listener.
From [androidx.core.app.OnPictureInPictureUiStateChangedProvider](https://developer.android.com/reference/androidx/core/app/OnPictureInPictureUiStateChangedProvider) `abstract void` `https://developer.android.com/reference/androidx/core/app/OnPictureInPictureUiStateChangedProvider#addOnPictureInPictureUiStateChangedListener(androidx.core.util.Consumer)(

@https://developer.android.com/reference/androidx/annotation/NonNull https://developer.android.com/reference/androidx/core/util/Consumer<@https://developer.android.com/reference/androidx/annotation/NonNull https://developer.android.com/reference/androidx/core/app/PictureInPictureUiStateCompat> listener

)`

Add a new listener that will get a callback associated with `https://developer.android.com/reference/android/app/Activity.html#onPictureInPictureUiStateChanged(android.app.PictureInPictureUiState)` with the new `https://developer.android.com/reference/androidx/core/app/PictureInPictureUiStateCompat`.
`abstract void` `https://developer.android.com/reference/androidx/core/app/OnPictureInPictureUiStateChangedProvider#removeOnPictureInPictureUiStateChangedListener(androidx.core.util.Consumer)(

@https://developer.android.com/reference/androidx/annotation/NonNull https://developer.android.com/reference/androidx/core/util/Consumer<@https://developer.android.com/reference/androidx/annotation/NonNull https://developer.android.com/reference/androidx/core/app/PictureInPictureUiStateCompat> listener

)`

Remove a previously added listener.
From [androidx.core.app.OnUserLeaveHintProvider](https://developer.android.com/reference/androidx/core/app/OnUserLeaveHintProvider) `abstract void` `https://developer.android.com/reference/androidx/core/app/OnUserLeaveHintProvider#addOnUserLeaveHintListener(java.lang.Runnable)(@https://developer.android.com/reference/androidx/annotation/NonNull https://developer.android.com/reference/java/lang/Runnable.html listener)`

Add a new listener that will get a callback associated with `https://developer.android.com/reference/android/app/Activity.html#onUserLeaveHint()`
`abstract void` `https://developer.android.com/reference/androidx/core/app/OnUserLeaveHintProvider#removeOnUserLeaveHintListener(java.lang.Runnable)(@https://developer.android.com/reference/androidx/annotation/NonNull https://developer.android.com/reference/java/lang/Runnable.html listener)`

Remove a previously added listener.

## Public methods

### enterPictureInPictureMode

Added in [1.18.0](https://developer.android.com/jetpack/androidx/releases/core#1.18.0)

```
abstract void enterPictureInPictureMode(@NonNull PictureInPictureParamsCompat params)
```

Available since API 24 in the framework Activity class, puts the activity in picture-in-picture mode if possible in the current system state. Any prior calls to `https://developer.android.com/reference/androidx/core/app/PictureInPictureProvider#setPictureInPictureParams(androidx.core.app.PictureInPictureParamsCompat)` will still apply when entering picture-in-picture through this call.

### setPictureInPictureParams

Added in [1.18.0](https://developer.android.com/jetpack/androidx/releases/core#1.18.0)

```
abstract void setPictureInPictureParams(@NonNull PictureInPictureParamsCompat params)
```

Available since API 26 in the framework Activity class, updates the properties of the picture-in-picture activity, or sets it to be used later when `https://developer.android.com/reference/androidx/core/app/PictureInPictureProvider#enterPictureInPictureMode(androidx.core.app.PictureInPictureParamsCompat)` is called

| Parameters |
|---|---|
| `@https://developer.android.com/reference/androidx/annotation/NonNull https://developer.android.com/reference/androidx/core/app/PictureInPictureParamsCompat params` | `https://developer.android.com/reference/android/app/PictureInPictureParams.html` to use for picture-in-picture mode. |