多視窗支援

Android N 新增一次顯示多個應用程式的支援。 在手持式裝置上,兩個應用程式可以在「分割畫面」模式中並排或上下排列。 在電視裝置上,應用程式能使用「子母畫面」模式,在使用者與另一個應用程式互動時持續播放影片。

如使用 N Preview SDK 建置應用程式,您可以設定應用程式處理多視窗顯示的方式。 例如,您可以指定活動的最小可允許尺寸。 您也可以停用應用程式的多視窗顯示,確保系統只會以全螢幕模式顯示您的應用程式。

總覽

Android N 允許多個應用程式同時分享螢幕。例如,使用者可以分割畫面,在左邊檢視網頁,同時在右邊撰寫電子郵件。 使用者體驗依裝置而異:

  • 執行 Android N 的手持式裝置可提供分割畫面模式。 處於此模式時,系統會以並排或上下排列的方式顯示兩個應用程式,將螢幕填滿。 使用者可以拖曳將畫面一分為二的分隔線,加大一邊的應用程式,就會縮小另一邊。
  • 在執行 Android N 的 Nexus Player 上,當使用者瀏覽其他應用程式或與其互動時,應用程式會將本身放入子母畫面模式以持續顯示內容。
  • 較大型裝置的製造商可選擇啟用自由形式模式,讓使用者自由調整每個活動的大小。 若製造商啟用此功能,裝置除了分割畫面模式外,還會提供自由形式模式。

圖 1. 在分割畫面模式中並排執行的兩個應用程式。

使用者可以透過下列方式來切換多視窗模式:

  • 如果使用者開啟總覽畫面並長按活動標題,就可以將該標題拖曳到畫面醒目提示的部分,將活動放入多視窗模式。
  • 如果使用者長按「總覽」按鈕,裝置會將目前的活動放入多視窗模式,並開啟總覽畫面,讓使用者選擇要分享螢幕的另一個活動。

使用者可以在活動分享螢幕時,將一個活動中的資料拖放到另一個活動。 (之前,使用者只能在單一活動內拖放資料)。

多視窗生命週期

多視窗模式不會變更活動生命週期

在多視窗模式中,特定時間只有最近與使用者互動的活動才會處於使用中。 這會視為「最上層」活動。 即使能看到所有其他活動,但也處於暫停狀態。 然而,相較於看不到的活動,系統會給予這類暫停但可看見的活動較高的優先順序。 若使用者改與其中一個暫停的活動互動,該活動就會恢復,使先前的最上層活動變成暫停。

注意:在多視窗模式中,使用者仍能見到處於暫停狀態的應用程式。 即使處於暫停,應用程式仍需要進行其活動。 例如,處於暫停模式但仍可以看見的影片播放應用程式,應會持續顯示其影片。 因此,建議您在播放影片的活動 onPause() 處理常式中,「不要」暫停影片。 應該改為在 onStop(), and resume playback in onStart() 中暫停影片。

當使用者將應用程式放入多視窗模式時,系統會通知活動發生設定變更,如處理執行階段變更所指定。 基本上,此變更的活動生命週期和系統通知應用程式,裝置從垂直模式切換為水平模式時的生命週期相當,差別在於裝置尺寸會改變,而不只是切換。 如處理執行階段變更中所述,您的活動能自行處理設定變更,或會允許系統終結活動並以新的尺寸重新建立。

如果使用者調整視窗大小並加大長或寬的尺寸,系統會根據使用者動作來調整活動大小,並視需要發出執行階段變更。 若應用程式在新公開的區域中繪製發生延遲,系統會暫時使用 windowBackground 所指定的色彩或預設的 windowBackgroundFallback 樣式屬性,填滿那些區域。

針對多視窗模式設定應用程式

您的應用程式若以 Android N 為目標,您可以設定應用程式的活動是否支援多視窗顯示以及支援的方式。 您可以在宣示說明中設定屬性,同時控制大小與版面配置。 根活動的屬性設定會套用到它工作堆疊內的所有活動。

注意:如果您使用 Android N 以下的 SDK 版本建置多螢幕方向應用程式,而且使用者會在多視窗模式中使用該應用程式,系統會強制調整應用程式大小。 系統會顯示對話方塊向使用者警告應用程式行為異常。 系統「不會」調整螢幕方向固定的應用程式大小,如使用者嘗試在多視窗模式下開啟螢幕方向固定的應用程式,應用程式會佔滿整個螢幕。

android:resizeableActivity

在宣示說明的 <activity><application> 節點中,設定此屬性以啟用或停用多視窗顯示:

android:resizeableActivity=["true" | "false"]

如將此屬性設定為 true,就能以分割畫面和自由形式模式來啟動活動。 如將屬性設定為 false,活動會不支援多視窗模式。 如果此值為 false,而使用者嘗試以多視窗模式啟動活動,該活動會佔滿整個螢幕。

您的應用程式如以 Android N 為目標,但您並未指定此屬性的值,屬性的預設值為 true。

android:supportsPictureInPicture

在宣示說明的 <activity> 節點中,設定此屬性以指出活動是否支援子母畫面顯示: 如果 android:resizeableActivity 為 false,則會忽略此屬性。

android:supportsPictureInPicture=["true" | "false"]

版面配置屬性

使用 Android N,<layout> 宣示說明元素支援的數個屬性會影響多視窗模式中的活動行為。

android:defaultWidth
以自由形式模式啟動活動時的預設寬度。
android:defaultHeight
以自由形式模式啟動活動時的預設高度。
android:gravity
以自由形式模式啟動活動時的初始放置位置。請參閱 Gravity 參考資料以查看適當的值。
android:minimalSize
在分割畫面與自由形式模式中,活動的最小高度與最小寬度。 如果使用者在分割畫面模式中移動分隔,而使活動小於指定的最小值,系統會將活動裁剪為使用者要求的大小。

例如,在自由形式模式中顯示活動時,下列程式碼顯示如何指定活動的預設大小與位置以及它的最小大小:

<activity android:name=".MyActivity">
    <layout android:defaultHeight="500dp"
          android:defaultWidth="600dp"
          android:gravity="top|end"
          android:minimalSize="450dp" />
</activity>

在多視窗模式中執行應用程式

Android N 提供的新功能支援在多視窗模式中執行應用程式。

可在多視窗模式中停用的功能

當裝置處於多視窗模式時,有些功能無法用於會與其他活動或應用程式分享裝置螢幕的活動,因此會加以停用或忽略。 這類功能包括:

  • 有些系統 UI 自訂選項會停用。例如,不以全螢幕模式執行就無法隱藏狀態列的應用程式。
  • 系統會忽略對 android:screenOrientation 屬性的變更。

多視窗變更通知與查詢

已將下列可支援多視窗顯示的新方法新增至 Activity 類別。如需每個方法的詳細資訊,請參閱 N Preview SDK 參考資料

Activity.inMultiWindow()
呼叫即可知道活動是否處於多視窗模式。
Activity.inPictureInPicture()
呼叫即可知道活動是否處於子母畫面模式。

注意:子母畫面模式為多視窗模式的特殊情況。 如果 myActivity.inPictureInPicture() 傳回 true,那麼 myActivity.inMultiWindow() 也會傳回 true。

Activity.onMultiWindowChanged()
每當活動進入或離開多視窗模式,系統就會呼叫這個方法。 如果活動正在進入多視窗模式,系統會將 true 的值傳遞給方法,若活動正要離開多視窗模式,則會傳遞 false。
Activity.onPictureInPictureChanged()
每當活動進入或離開子母畫面模式,系統就會呼叫這個方法。 如果活動正在進入子母畫面模式,系統會將 true 的值傳遞給方法,若活動正要離開子母畫面模式,則會傳遞 false。

上述的每一個方法也都有 Fragment 版本,例如 Fragment.inMultiWindow()

進入子母畫面模式

呼叫新方法 Activity.enterPictureInPicture(),即可將活動放入子母畫面模式。如果裝置不支援子母畫面模式,這個方法就沒有作用。 如需詳細資訊,請參閱子母畫面文件。

在多視窗模式中啟動新活動

當您啟動新活動,可以提示系統應儘可能在目前活動的旁邊顯示新的活動。 如要這樣做,請使用旗標 Intent.FLAG_ACTIVITY_LAUNCH_TO_ADJACENT。 傳遞此旗標會要求下列行為:

  • 如果裝置處於分割畫面模式中,系統會嘗試在啟動新活動的活動旁邊建立該活動,讓兩個活動分享螢幕。 系統不保證一定能這樣做,但會儘可能讓活動相鄰。
  • 如果裝置未處於分割畫面模式,這個旗標就沒有作用。

如果裝置處於自由形式模式,而您正在啟動新的活動,您可以呼叫 ActivityOptions.setLaunchBounds(),指定新活動的尺寸與畫面位置。 如果裝置未處於多視窗模式,這個方法就沒有作用。

注意:如果您在工作堆疊內啟動活動,該活動就會取代畫面上的活動,繼承它的所有多視窗屬性。 如果您想要在多視窗模式中,以個別的視窗啟動活動,您必須在新的工作堆疊中啟動該活動。

支援拖放功能

使用者可以在兩個活動分享螢幕時,將一個活動中的資料拖放到另一個活動。 (之前,使用者只能在單一活動內拖放資料)。 因此,若您的應用程式目前不支援拖曳功能,建議您將該功能新增至應用程式。

N Preview SDK 擴充 android.view 套件,支援跨應用程式的拖放功能。如需下列類別與方法的詳細資訊,請參閱 N Preview SDK 參考資料

android.view.DropPermissions
語彙基元物件負責指定權限,授予給放下接收者應用程式。
View.startDragAndDrop()
View.startDrag() 的新別名。傳遞新旗標 View.DRAG_FLAG_GLOBAL,就可以啟用跨活動的拖放功能。 如果您需要將 URI 權限授予接收者活動,請視需要傳遞新旗標 View.DRAG_FLAG_GLOBAL_URI_READView.DRAG_FLAG_GLOBAL_URI_WRITE
View.cancelDragAndDrop()
取消目前進行中的拖曳操作。只能由產生拖曳操作的應用程式呼叫。
View.updateDragShadow()
取代目前所進行拖曳操作的拖曳陰影。只能由產生拖曳操作的應用程式呼叫。
Activity.requestDropPermissions()
針對利用 DragEvent 中包含的 ClipData 傳遞的內容 URI,要求權限。

測試應用程式的多視窗支援

不論您是否針對 Android N 更新您的應用程式,都應該確認應用程式在多視窗模式中的行為為何,以免使用者試圖在執行 Android N 的裝置上以多視窗模式啟動應用程式。

設定測試裝置

如果您在裝置上安裝 Android N,即自動支援分割畫面模式。

應用程式若非以 N Preview SDK 建置

若您並非以 N Preview SDK 建置應用程式,而且使用者會試圖在多視窗模式中使用該應用程式,除非應用程式宣告螢幕方向固定,否則系統會強制調整應用程式大小。

若您的應用程式並未宣告螢幕方向固定,您應該在執行 Android N 的裝置上啟動應用程式,並嘗試將應用程式放入分割畫面模式。 確認強制調整應用程式大小時的使用者體驗可以接受。

若您的應用程式宣告螢幕方向固定,您應該嘗試將應用程式放入多視窗模式。 確認您這樣做時,應用程式依然會處於全螢幕模式。

若您支援多視窗模式

如果您以 N Preview SDK 建置應用程式且未停用多視窗支援,請在分割畫面與自由形式模式下,確認下列行為:

  • 以全螢幕模式啟動應用程式,然後長按 [總覽] 按鈕以切換到多視窗模式。 確認應用程式可以正確切換。
  • 以多視窗模式直接啟動應用程式,並確認應用程式可以正確啟動。 您可以按下 [總覽] 按鈕,然後長按應用程式的標題欄,再拖曳到螢幕上其中一個醒目提示的區域,即可以多視窗模式啟動應用程式。
  • 在分割畫面模式中拖曳分隔線調整應用程式的大小。 確認可以調整應用程式大小而不會當機,同時可以看見必要的 UI 元素。
  • 如果您已指定應用程式的最小尺寸,請嘗試將應用程式的大小調整到低於指定的尺寸。 確認您無法將應用程式的大小調整到小於指定的最小值。
  • 經由所有測試確認應用程式的效能可以接受。例如,確認在調整應用程式大小之後,不會遲遲不更新 UI。

測試檢查清單

若要確認應用程式在多視窗模式中的效能,請嘗試下列操作。 除非另外註明,否則您應該在分割畫面與多視窗模式中嘗試這些操作。

  • 進入和離開多視窗模式。
  • 從您的應用程式切換到另一個應用程式,並確認當應用程式不在使用中但可看見時,能正常運作。 例如,如果是播放影片的應用程式,請確認當使用者與另一個應用程式互動時,影片會持續播放。
  • 在分割畫面模式中,嘗試移動分隔列以加大和縮小應用程式。 在並排與上下排列設定都要嘗試這些操作。 確認應用程式不會當機,可以看見基本功能,而且不會花太長的時間完成調整大小操作。
  • 快速連續執行數次調整大小操作。確認應用程式不會因此當機或流失記憶體。 如需檢查應用程式記憶體使用量的詳細資訊,請參閱調查 RAM 使用狀況
  • 以數個不同的視窗設定正常使用您的應用程式,並確認應用程式都能正常運作。 確認文字可以閱讀,而且 UI 元素不會太小而無法與之互動。

若已停用多視窗支援

若您已設定 android:resizableActivity="false" 來停用多視窗支援,您應該在執行 Android N 的裝置上啟動應用程式,並嘗試將應用程式放入自由形式與分割畫面模式。 確認您這樣做時,應用程式依然會處於全螢幕模式。