畫中畫支持

Android 8.0（API 級別 26）允許以畫中畫模式啟動 Activity。畫中畫是一種特殊類型的多窗口模式，最常用于視頻播放。使用該模式，用戶可以通過固定到屏幕一角的小窗口觀看視頻，同時在應用之間進行導航或瀏覽主屏幕上的內容。

畫中畫利用 Android 7.0 中的多窗口模式 API 來提供固定的視頻疊加窗口。要將畫中畫添加到您的應用中，您需要注冊支持畫中畫的 Activity、根據需要將 Activity 切換為畫中畫模式，并確保當 Activity 處于畫中畫模式時，界面元素處于隱藏狀態且視頻能夠繼續播放。

畫中畫窗口會顯示在屏幕的最上層，位于系統選擇的一角。您可以將畫中畫窗口拖動到其他位置。當您點按該窗口時，會看到兩個特殊的控件：全屏切換開關（位于窗口的中心）和關閉按鈕（右上角的“X”）。

您的應用會控制當前 Activity 在何時進入畫中畫模式。以下是一些示例：

Activity 可以在用戶點按主屏幕或最近使用的應用按鈕來選擇其他應用時，進入畫中畫模式。（這就是 Google 地圖在用戶同時運行其他 Activity 時繼續顯示方向的方式。） 您的應用可以在用戶從某個視頻返回以瀏覽其他內容時，將該視頻切換到畫中畫模式。 您的應用可以在用戶觀看到某集內容的結束時將視頻切換到畫中畫模式。主屏幕會顯示有關這部電視劇下一集的宣傳信息或劇情摘要信息。 您的應用可以提供一種方式，讓用戶可以在觀看視頻時將其他內容加入播放隊列。當主屏幕顯示內容選擇 Activity 時，視頻會繼續以畫中畫模式播放。聲明對畫中畫的支持

默認情況下，系統不會自動為應用提供畫中畫支持。要想在應用中支持畫中畫，您可以通過將 android:supportsPictureInPicture 和 android:resizeableActivity 設置為 true，在清單中注冊視頻 Activity。此外，指定您的 Activity 會處理布局配置更改，這樣一來，在畫中畫模式轉換期間發生布局更改時，您的 Activity 不會重新啟動。

<activity android:name='VideoActivity' android:resizeableActivity='true' android:supportsPictureInPicture='true' android:configChanges= 'screenSize|smallestScreenSize|screenLayout|orientation' ...將您的 Activity 切換到畫中畫模式

要進入畫中畫模式，Activity 必須調用 enterPictureInPictureMode()。例如，以下代碼會在用戶點擊應用界面中的專用按鈕時，將 Activity 切換到畫中畫模式：

@Override public void onActionClicked(Action action) { if (action.getId() == R.id.lb_control_picture_in_picture) { getActivity().enterPictureInPictureMode(); return; } ... }

您可能需要添加將 Activity 切換到畫中畫模式（而不是進入后臺）的邏輯。例如，如果用戶在 Google 地圖正在導航時按下主屏幕或最近使用的應用按鈕，則該應用會切換到畫中畫模式。您可以通過替換 onUserLeaveHint() 來具體了解這種情況：

@Override public void onUserLeaveHint () { if (iWantToBeInPipModeNow()) { enterPictureInPictureMode(); } }在畫中畫期間處理界面

當 Activity 進入或退出畫中畫模式時，系統會調用 Activity.onPictureInPictureModeChanged() 或 Fragment.onPictureInPictureModeChanged()。

您應替換這些回調以重新繪制 Activity 的界面元素。請注意，在畫中畫模式下，您的 Activity 會在一個小窗口中顯示。在畫中畫模式下，用戶可能看不清小界面元素的詳細信息，因此不會與這些界面元素互動。界面極簡的視頻播放 Activity 可提供出色的用戶體驗。Activity 應僅顯示視頻播放控件。在 Activity 進入畫中畫模式之前移除其他界面元素，并在 Activity 再次變為全屏時恢復這些元素：

@Override public void onPictureInPictureModeChanged (boolean isInPictureInPictureMode, Configuration newConfig) { if (isInPictureInPictureMode) { // Hide the full-screen UI (controls, etc.) while in picture-in-picture mode. } else { // Restore the full-screen UI. ... } }添加控件

畫中畫窗口會在用戶打開窗口菜單（通過點按移動設備上的窗口或使用電視遙控器選擇菜單）時顯示控件。

如果應用有一個活躍的媒體會話，則窗口會顯示播放、暫停、下一個和上一個控件。

您還可以通過在進入畫中畫模式之前構建 PictureInPictureParams（使用 PictureInPictureParams.Builder.setActions()）來明確指定自定義操作，并使用 enterPictureInPictureMode(android.app.PictureInPictureParams) 或 setPictureInPictureParams(android.app.PictureInPictureParams) 在進入畫中畫模式時傳遞這些參數。請注意，如果您嘗試添加的控件數量超過 getMaxNumPictureInPictureActions()，則系統只會添加上限數量的控件。

在畫中畫模式下繼續播放視頻

當您的 Activity 切換到畫中畫模式時，系統會將該 Activity 置于暫停狀態并調用 Activity 的 onPause() 方法。如果該 Activity 在畫中畫模式下暫停，則視頻播放不得暫停，而應繼續播放。

在 Android 7.0 及更高版本中，當系統調用 Activity 的 onStop() 時，您應暫停視頻播放；當系統調用 Activity 的 onStart() 時，您應恢復視頻播放。這樣一來，您就無需在 onPause() 中檢查應用是否處于畫中畫模式，只需繼續播放視頻即可。

如果您必須在 onPause() 實現中暫停播放，請通過調用 isInPictureInPictureMode() 檢查畫中畫模式并相應地處理播放情況，例如：

@Override public void onPause() { // If called while in PIP mode, do not pause playback if (isInPictureInPictureMode()) { // Continue playback ... } else { // Use existing playback logic for paused Activity behavior. ... } }

當您的 Activity 從畫中畫模式切換回全屏模式時，系統會恢復您的 Activity 并調用 onResume() 方法。

對單個播放 Activity 使用畫中畫模式

在您的應用中，用戶可能會在主屏幕上瀏覽內容時選擇新的視頻，同時還有一個視頻播放 Activity 正處于畫中畫模式。應以全屏模式在現有的播放 Activity 中播放新的視頻，而不是啟動可能會令用戶感到困惑的新 Activity。

要確保將單個 Activity 用于視頻播放請求并根據需要進入或退出畫中畫模式，請在清單中將 Activity 的 android:launchMode 設置為 singleTask：

<activity android:name='VideoActivity' ... android:supportsPictureInPicture='true' android:launchMode='singleTask' ...

在您的 Activity 中，替換 onNewIntent() 并處理新的視頻，從而根據需要停止任何現有的視頻播放。

最佳做法

低內存設備可能無法使用畫中畫模式。在應用使用畫中畫之前，請務必通過調用 hasSystemFeature(PackageManager.FEATURE_PICTURE_IN_PICTURE) 進行檢查以確保可以使用畫中畫。

畫中畫旨在用于播放全屏視頻的 Activity。將 Activity 切換到畫中畫模式時，請避免顯示視頻內容以外的任何內容。跟蹤您的 Activity 何時進入畫中畫模式及隱藏界面元素，如在畫中畫期間處理界面中所述。

由于畫中畫窗口在屏幕的一角顯示為浮動窗口，因此您應避免在主屏幕中可能被畫中畫窗口遮蓋的任何區域內顯示重要信息。

當 Activity 進入畫中畫模式后，它默認沒有獲得輸入焦點。要在畫中畫模式下接收輸入事件，請使用 MediaSession.setCallback()。如需詳細了解如何使用 setCallback()，請參閱顯示“正在播放”卡片。

當您的應用處于畫中畫模式時，畫中畫窗口中的視頻播放可能會對其他應用（例如，音樂播放器應用或語音搜索應用）造成音頻干擾。為避免出現此問題，請在開始播放視頻時請求音頻焦點，并處理音頻焦點更改通知，如管理音頻焦點中所述。如果您在處于畫中畫模式時收到音頻焦點丟失通知，請暫停或停止視頻播放。

到此這篇關于Android 畫中畫模式的實現示例的文章就介紹到這了,更多相關Android 畫中畫內容請搜索好吧啦網以前的文章或繼續瀏覽下面的相關文章希望大家以后多多支持好吧啦網！