建議做法

適用於摺疊式和多螢幕裝置的應用程式

一般來說,應用程式不應仰賴靜態 ID 或取決於某些螢幕 ID 的邏輯。在大多數情況下,應用程式應調整大小並在不同螢幕上運作,而系統應控管應用程式的放置位置。舉例來說,您可以為摺疊式裝置打造獨特的新體驗,並在裝置摺疊時,於外部螢幕啟動特殊應用程式。

在這種情況下,SystemUI (或其他系統元件) 應偵測摺疊狀態、判斷是否適合執行動作,然後啟動目標活動,並將外部螢幕 ID 指定為啟動目標。應用程式不應偵測這項動作或執行任何回應動作,然後在特定螢幕上啟動。換句話說,請勿假設某部裝置適用的做法也適用於其他裝置。簡而言之,裝置專用程式碼會增加片段化。

限制螢幕存取權

如果裝置設定需要限制對一或多個螢幕的存取權,建議使用 Display#FLAG_PRIVATE 標記將這類螢幕指定為「私人」。這樣一來,只有擁有者能將內容新增至螢幕,其他人則無法。如果不是擁有者嘗試啟動活動或新增視窗,系統會傳回 SecurityException。如果系統擁有螢幕,系統可以新增視窗及啟動活動。

此外,放置在螢幕上的實體一律可以存取該螢幕。 如果擁有者在螢幕上啟動活動,該活動就能在該螢幕上啟動其他活動。因此,擁有者有責任限制存取權,允許信任的應用程式存取。

此外,虛擬螢幕也新增了更多限制,因為任何應用程式都能建立虛擬螢幕,但不會向使用者顯示。如果虛擬螢幕不屬於系統,則只允許使用 allowEmbedded,且呼叫端應具備 ACTIVITY_EMBEDDING 權限。

詳情請參閱:

  • ActivityStackSupervisor#isCallerAllowedToLaunchOnDisplay()
  • ActivityDisplay#isUidPresent()
  • DisplayManagerService#isUidPresentOnDisplay()

如要有條件地控制活動啟動,請使用 LaunchParamsController,攔截所有活動啟動作業,並允許系統元件修改用於啟動作業的參數。這項功能適用於 system_server

設定顯示視窗設定和系統裝飾

您可以在 DisplayWindowSettings 中設定每個螢幕的系統裝飾項目。裝置實作項目可以在 /data/system/display_settings.xml 中提供預設設定。

這個值會決定系統裝飾項目 (啟動器、桌布、導覽列和其他裝飾視窗) 和輸入法編輯器是否會顯示在螢幕上。詳情請參閱「DisplayWindowSettings#shouldShowSystemDecorsLocked()」和「DisplayWindowSettings#shouldShowImeLocked()」。

如要識別螢幕,請使用專屬 ID (預設使用 DisplayInfo#uniqueId) 或硬體螢幕的實體連接埠 ID (請參閱 DisplayInfo#address)。

舉例來說,下列螢幕設定範例會在模擬螢幕上啟用系統裝飾項目和 IME:

<?xml version='1.0' encoding='utf-8' standalone='yes' ?>
<display-settings>
<config identifier="0" />
<display
  name="overlay:1"
  shouldShowSystemDecors="true"
  shouldShowIme="true" />
</display-settings>

在上述範例中,uniqueId 用於名稱屬性中的顯示器識別,模擬顯示器則為 overlay:1。如果是內建螢幕,範例值可能是 "local:45354385242535243453"。 另一種做法是使用硬體連接埠資訊,將 identifier="1" 對應至 DisplayWindowSettings#IDENTIFIER_PORT,然後更新名稱以使用 "port:<port_id>" 格式:

<?xmlversion='1.0' encoding='utf-8' standalone='yes' ?>
<display-settings>
<config identifier="1" />
<display
  name="port:12345"
  shouldShowSystemDecors="true"
  shouldShowIme="true" />
</display-settings>

詳情請參閱「靜態顯示 ID」。

詳情請參閱: