Android畫中畫

一 背景

市面上的一些視頻類應用,比如愛奇藝,嗶哩嗶哩等都有小窗功能;為了提供更好的用戶體驗,那咱也有必要對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()方法,并處理新的視頻請求,如果需要的話停止任何正在播放的現有視頻。

最后編輯于
?著作權歸作者所有,轉載或內容合作請聯系作者
  • 序言:七十年代末,一起剝皮案震驚了整個濱河市,隨后出現的幾起案子,更是在濱河造成了極大的恐慌,老刑警劉巖,帶你破解...
    沈念sama閱讀 227,283評論 6 530
  • 序言:濱河連續發生了三起死亡事件,死亡現場離奇詭異,居然都是意外死亡,警方通過查閱死者的電腦和手機,發現死者居然都...
    沈念sama閱讀 97,947評論 3 413
  • 文/潘曉璐 我一進店門,熙熙樓的掌柜王于貴愁眉苦臉地迎上來,“玉大人,你說我怎么就攤上這事。” “怎么了?”我有些...
    開封第一講書人閱讀 175,094評論 0 373
  • 文/不壞的土叔 我叫張陵,是天一觀的道長。 經常有香客問我,道長,這世上最難降的妖魔是什么? 我笑而不...
    開封第一講書人閱讀 62,485評論 1 308
  • 正文 為了忘掉前任,我火速辦了婚禮,結果婚禮上,老公的妹妹穿的比我還像新娘。我一直安慰自己,他們只是感情好,可當我...
    茶點故事閱讀 71,268評論 6 405
  • 文/花漫 我一把揭開白布。 她就那樣靜靜地躺著,像睡著了一般。 火紅的嫁衣襯著肌膚如雪。 梳的紋絲不亂的頭發上,一...
    開封第一講書人閱讀 54,817評論 1 321
  • 那天,我揣著相機與錄音,去河邊找鬼。 笑死,一個胖子當著我的面吹牛,可吹牛的內容都是我干的。 我是一名探鬼主播,決...
    沈念sama閱讀 42,906評論 3 440
  • 文/蒼蘭香墨 我猛地睜開眼,長吁一口氣:“原來是場噩夢啊……” “哼!你這毒婦竟也來了?” 一聲冷哼從身側響起,我...
    開封第一講書人閱讀 42,039評論 0 285
  • 序言:老撾萬榮一對情侶失蹤,失蹤者是張志新(化名)和其女友劉穎,沒想到半個月后,有當地人在樹林里發現了一具尸體,經...
    沈念sama閱讀 48,551評論 1 331
  • 正文 獨居荒郊野嶺守林人離奇死亡,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內容為張勛視角 年9月15日...
    茶點故事閱讀 40,502評論 3 354
  • 正文 我和宋清朗相戀三年,在試婚紗的時候發現自己被綠了。 大學時的朋友給我發了我未婚夫和他白月光在一起吃飯的照片。...
    茶點故事閱讀 42,662評論 1 366
  • 序言:一個原本活蹦亂跳的男人離奇死亡,死狀恐怖,靈堂內的尸體忽然破棺而出,到底是詐尸還是另有隱情,我是刑警寧澤,帶...
    沈念sama閱讀 38,188評論 5 356
  • 正文 年R本政府宣布,位于F島的核電站,受9級特大地震影響,放射性物質發生泄漏。R本人自食惡果不足惜,卻給世界環境...
    茶點故事閱讀 43,907評論 3 345
  • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧,春花似錦、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 34,304評論 0 25
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽。三九已至,卻和暖如春,著一層夾襖步出監牢的瞬間,已是汗流浹背。 一陣腳步聲響...
    開封第一講書人閱讀 35,563評論 1 281
  • 我被黑心中介騙來泰國打工, 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留,地道東北人。 一個月前我還...
    沈念sama閱讀 51,255評論 3 389
  • 正文 我出身青樓,卻偏偏與公主長得像,于是被迫代替她去往敵國和親。 傳聞我的和親對象是個殘疾皇子,可洞房花燭夜當晚...
    茶點故事閱讀 47,637評論 2 370

推薦閱讀更多精彩內容