一 背景
市面上的一些视频类应用,比如爱奇艺,哔哩哔哩等都有小窗功能;为了提供更好的用户体验,那咱也有必要对Android系统支持的画中画模式进行一番调研;
二 简介
从Android 8.0(API级别26)开始,Android允许活动以画中画(PiP)模式启动。PiP是一种特殊的多窗口模式,主要用于视频播放。它允许用户在屏幕的一个角落观看固定大小的视频窗口,同时在主屏幕上浏览内容或切换应用程序。
PiP利用Android 7.0中提供的多窗口API来提供固定的视频覆盖窗口。要向应用程序添加PiP功能,您需要注册支持PiP的Activity,根据需要将活动切换到PiP模式,并确保在活动处于PiP模式时隐藏UI元素并继续视频播放。
PiP窗口出现在屏幕的最顶层,并在系统选择的一个角落。
三 生命周期
进入PiP
调用enterPictureInPictureMode()方法
退出PiP
点击小窗中的全屏按钮
从上面的生命周期可以得出,进入或退出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()方法,并处理新的视频请求,如果需要的话停止任何正在播放的现有视频。