一 背景

市面上的一些视频类应用，比如爱奇艺，哔哩哔哩等都有小窗功能；为了提供更好的用户体验，那咱也有必要对Android系统支持的画中画模式进行一番调研；

二 简介

从Android 8.0（API级别26）开始，Android允许活动以画中画（PiP）模式启动。PiP是一种特殊的多窗口模式，主要用于视频播放。它允许用户在屏幕的一个角落观看固定大小的视频窗口，同时在主屏幕上浏览内容或切换应用程序。

PiP利用Android 7.0中提供的多窗口API来提供固定的视频覆盖窗口。要向应用程序添加PiP功能，您需要注册支持PiP的Activity，根据需要将活动切换到PiP模式，并确保在活动处于PiP模式时隐藏UI元素并继续视频播放。

PiP窗口出现在屏幕的最顶层，并在系统选择的一个角落。

三 生命周期

进入PiP

调用enterPictureInPictureMode()方法

image.png

退出PiP

点击小窗中的全屏按钮

image.png

从上面的生命周期可以得出，进入或退出PiP都会引发Actvitity的销毁和重建；如果我们想避免重建可以对confingChanges进行配置；另外Activity或Fragment的onPictureInPictureModeChanged()方法可以监听PiP的状态；

四 实现步骤

声明PiP支持

默认情况下，系统不会自动为您的应用程序提供PiP支持。如果您希望在应用程序中支持PiP，可以在清单文件中注册Activity时，将android:supportsPictureInPicture设置为true。此外，还要指定Activity的configChanges，以确保在PiP模式转换期间发生布局更改时不会重新启动您的Activity。

<activity android:name="VideoActivity"

 android:supportsPictureInPicture="true"

 android:configChanges=

 "screenSize|smallestScreenSize|screenLayout|orientation"/>

 ...

判断是否支持PiP

boolean mPipMode = getPackageManager().hasSystemFeature(PackageManager.FEATURE_PICTURE_IN_PICTURE)

进入PiP

override fun onActionClicked(action: Action) {
 if (action.id.toInt() == R.id.lb_control_picture_in_picture) {
   activity?.enterPictureInPictureMode()
       return
   }
}

UI处理

当活动进入或退出PiP模式时，系统会调用Activity.onPictureInPictureModeChanged()或Fragment.onPictureInPictureModeChanged()。

您应该重写这些回调方法来重新绘制活动的UI元素。请记住，在PiP模式下，您的活动以一个小窗口显示。当活动处于PiP模式时，用户无法与您的应用程序的UI元素进行交互，并且小型UI元素的细节可能难以看清。最好提供最简化的UI的视频播放活动，以提供最佳的用户体验。

如果您的应用程序需要为PiP提供自定义操作，请参阅本页面上的“添加控件”。在您的活动进入PiP模式之前，删除其他UI元素，并在活动恢复全屏模式时恢复它们：

override fun onPictureInPictureModeChanged(isInPictureInPictureMode: Boolean,

 newConfig: Configuration) {

 if (isInPictureInPictureMode) {

     // Hide the full-screen UI (controls, etc.) while in PiP mode.

 } else {

 // Restore the full-screen UI.

 }

}

添加控件

PiP窗口可以在用户打开窗口菜单时显示控件（通过在移动设备上轻触窗口或通过电视遥控器选择菜单）。

如果应用程序具有活动媒体会话，则会显示播放、暂停、下一个和上一个控件。

您还可以通过在进入PiP模式之前使用PictureInPictureParams.Builder.setActions()构建PictureInPictureParams来明确指定自定义操作，并在进入PiP模式时传递这些参数使用enterPictureInPictureMode(android.app.PictureInPictureParams)或setPictureInPictureParams(android.app.PictureInPictureParams)。

setActions方式

MediaSession方式
初始化MediaSession
自定义MediaSessionCallback，响应控件操作；

单播放Activity

在您的应用程序中，用户在主屏幕上浏览内容时，可能会选择一个新的视频，而视频播放活动处于PiP模式。为了避免让用户感到困惑，应该在现有的播放活动中以全屏模式播放新的视频，而不是启动一个新的活动。

为了确保单个活动用于视频播放请求，并根据需要切换进入或退出PiP模式，请在清单文件中将活动的android:launchMode设置为singleTask：

<activity android:name="VideoActivity"

 ...

 android:supportsPictureInPicture="true"

 android:launchMode="singleTask"

 ...

在您的活动中，重写onNewIntent()方法，并处理新的视频请求，如果需要的话停止任何正在播放的现有视频。