Android 画中画模式的实现示例

2023-07-08 06:59:03 273

画中画支持

Android8.0（API级别26）允许以画中画模式启动Activity。画中画是一种特殊类型的多窗口模式，最常用于视频播放。使用该模式，用户可以通过固定到屏幕一角的小窗口观看视频，同时在应用之间进行导航或浏览主屏幕上的内容。

画中画利用Android7.0中的多窗口模式API来提供固定的视频叠加窗口。要将画中画添加到您的应用中，您需要注册支持画中画的Activity、根据需要将Activity切换为画中画模式，并确保当Activity处于画中画模式时，界面元素处于隐藏状态且视频能够继续播放。

画中画窗口会显示在屏幕的最上层，位于系统选择的一角。您可以将画中画窗口拖动到其他位置。当您点按该窗口时，会看到两个特殊的控件：全屏切换开关（位于窗口的中心）和关闭按钮（右上角的“X”）。

您的应用会控制当前Activity在何时进入画中画模式。以下是一些示例：

Activity可以在用户点按主屏幕或最近使用的应用按钮来选择其他应用时，进入画中画模式。（这就是Google地图在用户同时运行其他Activity时继续显示方向的方式。）
您的应用可以在用户从某个视频返回以浏览其他内容时，将该视频切换到画中画模式。
您的应用可以在用户观看到某集内容的结束时将视频切换到画中画模式。主屏幕会显示有关这部电视剧下一集的宣传信息或剧情摘要信息。
您的应用可以提供一种方式，让用户可以在观看视频时将其他内容加入播放队列。当主屏幕显示内容选择Activity时，视频会继续以画中画模式播放。

声明对画中画的支持

默认情况下，系统不会自动为应用提供画中画支持。要想在应用中支持画中画，您可以通过将android:supportsPictureInPicture和android:resizeableActivity设置为true，在清单中注册视频Activity。此外，指定您的Activity会处理布局配置更改，这样一来，在画中画模式转换期间发生布局更改时，您的Activity不会重新启动。


将您的Activity切换到画中画模式


要进入画中画模式，Activity必须调用enterPictureInPictureMode()。例如，以下代码会在用户点击应用界面中的专用按钮时，将Activity切换到画中画模式：
@Override
publicvoidonActionClicked(Actionaction){
if(action.getId()==R.id.lb_control_picture_in_picture){
getActivity().enterPictureInPictureMode();
return;
}
...
}

您可能需要添加将Activity切换到画中画模式（而不是进入后台）的逻辑。例如，如果用户在Google地图正在导航时按下主屏幕或最近使用的应用按钮，则该应用会切换到画中画模式。您可以通过替换onUserLeaveHint()来具体了解这种情况：
@Override
publicvoidonUserLeaveHint(){
if(iWantToBeInPipModeNow()){
enterPictureInPictureMode();
}
}

在画中画期间处理界面


当Activity进入或退出画中画模式时，系统会调用Activity.onPictureInPictureModeChanged()或Fragment.onPictureInPictureModeChanged()。
您应替换这些回调以重新绘制Activity的界面元素。请注意，在画中画模式下，您的Activity会在一个小窗口中显示。在画中画模式下，用户可能看不清小界面元素的详细信息，因此不会与这些界面元素互动。界面极简的视频播放Activity可提供出色的用户体验。Activity应仅显示视频播放控件。在Activity进入画中画模式之前移除其他界面元素，并在Activity再次变为全屏时恢复这些元素：
@Override
publicvoidonPictureInPictureModeChanged(booleanisInPictureInPictureMode,ConfigurationnewConfig){
if(isInPictureInPictureMode){
//Hidethefull-screenUI(controls,etc.)whileinpicture-in-picturemode.
}else{
//Restorethefull-screenUI.
...
}
}

添加控件


画中画窗口会在用户打开窗口菜单（通过点按移动设备上的窗口或使用电视遥控器选择菜单）时显示控件。
如果应用有一个活跃的媒体会话，则窗口会显示播放、暂停、下一个和上一个控件。
您还可以通过在进入画中画模式之前构建PictureInPictureParams（使用PictureInPictureParams.Builder.setActions()）来明确指定自定义操作，并使用enterPictureInPictureMode(android.app.PictureInPictureParams)或setPictureInPictureParams(android.app.PictureInPictureParams)在进入画中画模式时传递这些参数。请注意，如果您尝试添加的控件数量超过getMaxNumPictureInPictureActions()，则系统只会添加上限数量的控件。
在画中画模式下继续播放视频


当您的Activity切换到画中画模式时，系统会将该Activity置于暂停状态并调用Activity的onPause()方法。如果该Activity在画中画模式下暂停，则视频播放不得暂停，而应继续播放。
在Android7.0及更高版本中，当系统调用Activity的onStop()时，您应暂停视频播放；当系统调用Activity的onStart()时，您应恢复视频播放。这样一来，您就无需在onPause()中检查应用是否处于画中画模式，只需继续播放视频即可。
如果您必须在onPause()实现中暂停播放，请通过调用isInPictureInPictureMode()检查画中画模式并相应地处理播放情况，例如：
@Override
publicvoidonPause(){
//IfcalledwhileinPIPmode,donotpauseplayback
if(isInPictureInPictureMode()){
//Continueplayback
...
}else{
//UseexistingplaybacklogicforpausedActivitybehavior.
...
}
}

当您的Activity从画中画模式切换回全屏模式时，系统会恢复您的Activity并调用onResume()方法。
对单个播放Activity使用画中画模式


在您的应用中，用户可能会在主屏幕上浏览内容时选择新的视频，同时还有一个视频播放Activity正处于画中画模式。应以全屏模式在现有的播放Activity中播放新的视频，而不是启动可能会令用户感到困惑的新Activity。
要确保将单个Activity用于视频播放请求并根据需要进入或退出画中画模式，请在清单中将Activity的android:launchMode设置为singleTask：

在您的Activity中，替换onNewIntent()并处理新的视频，从而根据需要停止任何现有的视频播放。
最佳做法


低内存设备可能无法使用画中画模式。在应用使用画中画之前，请务必通过调用hasSystemFeature(PackageManager.FEATURE_PICTURE_IN_PICTURE)进行检查以确保可以使用画中画。
画中画旨在用于播放全屏视频的Activity。将Activity切换到画中画模式时，请避免显示视频内容以外的任何内容。跟踪您的Activity何时进入画中画模式及隐藏界面元素，如在画中画期间处理界面中所述。
由于画中画窗口在屏幕的一角显示为浮动窗口，因此您应避免在主屏幕中可能被画中画窗口遮盖的任何区域内显示重要信息。
当Activity进入画中画模式后，它默认没有获得输入焦点。要在画中画模式下接收输入事件，请使用MediaSession.setCallback()。如需详细了解如何使用setCallback()，请参阅显示“正在播放”卡片。
当您的应用处于画中画模式时，画中画窗口中的视频播放可能会对其他应用（例如，音乐播放器应用或语音搜索应用）造成音频干扰。为避免出现此问题，请在开始播放视频时请求音频焦点，并处理音频焦点更改通知，如管理音频焦点中所述。如果您在处于画中画模式时收到音频焦点丢失通知，请暂停或停止视频播放。
到此这篇关于Android画中画模式的实现示例的文章就介绍到这了,更多相关Android画中画内容请搜索毛票票以前的文章或继续浏览下面的相关文章希望大家以后多多支持毛票票！

Android 画中画模式的实现示例

画中画支持

声明对画中画的支持

将您的Activity切换到画中画模式

在画中画期间处理界面

添加控件

在画中画模式下继续播放视频

对单个播放Activity使用画中画模式

最佳做法

热门推荐

随机推荐