支持劉海屏

劉海屏是指某些設(shè)備顯示屏上的一個(gè)區(qū)域延伸到顯示面，這樣既能為用戶提供全面屏體驗(yàn)，又能為設(shè)備正面的重要傳感器留出空間。Android 在搭載 Android 9（API 級(jí)別 28）及更高版本的設(shè)備上正式支持劉海屏。請(qǐng)注意，設(shè)備制造商也可以選擇在搭載 Android 8.1 或更低版本的設(shè)備上支持劉海屏。

創(chuàng)新互聯(lián)公司是工信部頒發(fā)資質(zhì)IDC服務(wù)器商，為用戶提供優(yōu)質(zhì)的四川電信科技城機(jī)房服務(wù)

本主題介紹如何實(shí)現(xiàn)對(duì)帶劉海屏的設(shè)備的支持，包括如何處理“劉海區(qū)域”，即顯示面上包含劉海的無邊框矩形。

在帶劉海屏的設(shè)備上有什么要求

為了確保一致性和應(yīng)用兼容性，搭載 Android 9 的設(shè)備必須確保以下劉海行為：

• 一條邊緣最多只能包含一個(gè)劉海。
• 一臺(tái)設(shè)備不能有兩個(gè)以上的劉海。
• 設(shè)備的兩條較長(zhǎng)邊緣上不能有劉海。
• 在未設(shè)置特殊標(biāo)志的豎屏模式下，狀態(tài)欄的高度必須至少與劉海的高度持平。
• 默認(rèn)情況下，在全屏模式或橫屏模式下，整個(gè)劉海區(qū)域必須顯示黑邊。

選擇您的應(yīng)用如何處理劉海區(qū)域

如果不希望您的內(nèi)容與劉海區(qū)域重疊，請(qǐng)確保您的內(nèi)容不與狀態(tài)欄和導(dǎo)航欄重疊，這樣做一般就足夠了。如果您要將內(nèi)容呈現(xiàn)到劉海區(qū)域中，則可以使用 WindowInsets.getDisplayCutout() 來檢索 DisplayCutout 對(duì)象，該對(duì)象包含每個(gè)劉海區(qū)域的安全邊襯區(qū)和邊界框。您可以使用這些 API 來檢查您的內(nèi)容是否與劉海區(qū)域重疊，以便根據(jù)需要重新放置。

注意：要在多個(gè) API 級(jí)別管理劉海實(shí)現(xiàn)，您還可以使用 AndroidX 庫（可通過 SDK 管理器獲得）中的 DisplayCutoutCompat。

Android 還允許您控制是否在劉海區(qū)域內(nèi)顯示內(nèi)容。窗口布局屬性 layoutInDisplayCutoutMode 控制您的內(nèi)容如何呈現(xiàn)在劉海區(qū)域中。您可以將 layoutInDisplayCutoutMode 設(shè)為以下某個(gè)值：

• LAYOUT_IN_DISPLAY_CUTOUT_MODE_DEFAULT - 這是默認(rèn)行為，如上所述。在豎屏模式下，內(nèi)容會(huì)呈現(xiàn)到劉海區(qū)域中；但在橫屏模式下，內(nèi)容會(huì)顯示黑邊。
• LAYOUT_IN_DISPLAY_CUTOUT_MODE_SHORT_EDGES - 在豎屏模式和橫屏模式下，內(nèi)容都會(huì)呈現(xiàn)到劉海區(qū)域中。
• LAYOUT_IN_DISPLAY_CUTOUT_MODE_NEVER - 內(nèi)容從不呈現(xiàn)到劉海區(qū)域中。

您可以通過編程或在 Activity 中設(shè)置樣式來設(shè)置劉海模式。以下示例定義了一種樣式，您可以使用它將 LAYOUT_IN_DISPLAY_CUTOUT_MODE_SHORT_EDGES 屬性應(yīng)用到 Activity。

  <style name="ActivityTheme">
   <item name="android:windowLayoutInDisplayCutoutMode">
    shortEdges <!-- default, shortEdges, never -->
   </item>
  </style>
 

下面幾部分更詳細(xì)地介紹了不同的劉海模式。

默認(rèn)行為

默認(rèn)情況下，在未設(shè)置特殊標(biāo)志的豎屏模式下，在帶劉海屏的設(shè)備上，狀態(tài)欄的大小會(huì)調(diào)整為至少與劉海一樣高，而您的內(nèi)容會(huì)顯示在下方區(qū)域。在橫屏模式或全屏模式下，您的應(yīng)用窗口會(huì)顯示黑邊，因此您的任何內(nèi)容都不會(huì)顯示在劉海區(qū)域中。

將內(nèi)容呈現(xiàn)在短邊劉海區(qū)域中

對(duì)于某些內(nèi)容（如視頻、照片、地圖和游戲），呈現(xiàn)在劉海區(qū)域中是一種很好的方法，這樣能夠?yàn)橛脩籼峁┏两懈鼜?qiáng)的全面屏體驗(yàn)。如果設(shè)置了 LAYOUT_IN_DISPLAY_CUTOUT_MODE_SHORT_EDGES，則在豎屏模式和橫屏模式下，內(nèi)容都會(huì)延伸到顯示屏的短邊上的劉海區(qū)域，而不管系統(tǒng)欄處于隱藏還是可見狀態(tài)。請(qǐng)注意，窗口無法延伸到屏幕的長(zhǎng)邊上的劉海區(qū)域。使用此模式時(shí)，請(qǐng)確保沒有重要內(nèi)容與劉海區(qū)域重疊。

請(qǐng)注意，Android 可能不允許內(nèi)容視圖與系統(tǒng)欄重疊。要替換此行為并強(qiáng)制內(nèi)容延伸到劉海區(qū)域，請(qǐng)通過 View.setSystemUiVisibility(int) 方法將以下任一標(biāo)志應(yīng)用于視圖可見性：

• SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN
• SYSTEM_UI_FLAG_LAYOUT_HIDE_NAVIGATION
• SYSTEM_UI_FLAG_LAYOUT_STABLE

下面是一些 LAYOUT_IN_DISPLAY_CUTOUT_MODE_SHORT_EDGES 示例：

請(qǐng)注意，邊角處的劉?？傻韧谠诙踢吷?，因此適用同樣的行為：

從不將內(nèi)容呈現(xiàn)在劉海區(qū)域中

如果設(shè)置了 LAYOUT_IN_DISPLAY_CUTOUT_MODE_NEVER，則不允許窗口與劉海區(qū)域重疊。

此模式應(yīng)該用于暫時(shí)設(shè)置 View.SYSTEM_UI_FLAG_FULLSCREEN 或 View.SYSTEM_UI_FLAG_HIDE_NAVIGATION 的窗口，以避免在設(shè)置或清除了該標(biāo)志時(shí)執(zhí)行另一種窗口布局。

請(qǐng)查看下面的 LAYOUT_IN_DISPLAY_CUTOUT_MODE_NEVER 示例：

特殊模式

某些搭載 Android 8.1（API 級(jí)別 27）或更低版本的設(shè)備支持一種特殊模式，可讓用戶將顯示黑邊的全屏或橫屏應(yīng)用延伸到劉海區(qū)域。此模式通常使用導(dǎo)航欄中的切換開關(guān)來控制，在延伸屏幕之前會(huì)顯示一個(gè)對(duì)話框，要求用戶進(jìn)行確認(rèn)。

支持劉海屏的最佳做法

使用劉海屏?xí)r，請(qǐng)務(wù)必考慮以下幾點(diǎn)：

• 不要讓劉海區(qū)域遮蓋任何重要的文本、控件或其他信息。
• 不要將任何需要精細(xì)輕觸識(shí)別的交互式元素放置或延伸到劉海區(qū)域。劉海區(qū)域中的輕觸靈敏度可能要比其他區(qū)域低一些。

• 避免對(duì)狀態(tài)欄高度進(jìn)行硬編碼，因?yàn)檫@樣做可能會(huì)導(dǎo)致內(nèi)容重疊或被切斷。如有可能，請(qǐng)使用 WindowInsetsCompat 檢索狀態(tài)欄高度，并確定要對(duì)您的內(nèi)容應(yīng)用的適當(dāng)內(nèi)邊距。

  

• 不要假定應(yīng)用會(huì)占據(jù)整個(gè)窗口，而應(yīng)使用 View.getLocationInWindow() 來確認(rèn)應(yīng)用的位置。不要使用 View.getLocationOnScreen()。

• 務(wù)必妥善處理進(jìn)入或退出全屏模式。請(qǐng)閱讀這篇 Android 開發(fā)者博文。

• 對(duì)于豎屏模式下的默認(rèn)劉海行為，如果劉海區(qū)域位于頂部邊緣，并且窗口未設(shè)置 FLAG_FULLSCREEN 或 View.SYSTEM_UI_FLAG_FULLSCREEN，則窗口可以延伸到劉海區(qū)域。同樣，如果劉海區(qū)域位于底部邊緣，并且窗口未設(shè)置 View.SYSTEM_UI_FLAG_HIDE_NAVIGATION，則窗口可以延伸到劉海區(qū)域。在全屏模式或橫屏模式下，窗口的布局方式應(yīng)確保其不與劉海區(qū)域重疊。

• 如果您的應(yīng)用需要進(jìn)入和退出全屏模式，請(qǐng)使用 shortEdges 或 never 劉海模式。默認(rèn)劉海行為可導(dǎo)致應(yīng)用中的內(nèi)容在全屏模式轉(zhuǎn)換過程中上下移動(dòng)，如下圖所示：

  

• 在全屏模式下，在使用窗口坐標(biāo)與屏幕坐標(biāo)時(shí)應(yīng)保持謹(jǐn)慎，因?yàn)樵陲@示黑邊的情況下，您的應(yīng)用不會(huì)占據(jù)整個(gè)屏幕。由于顯示黑邊，因此根據(jù)屏幕原點(diǎn)得到的坐標(biāo)與根據(jù)窗口原點(diǎn)得到的坐標(biāo)不再相同。您可以根據(jù)需要使用 getLocationOnScreen() 將屏幕坐標(biāo)轉(zhuǎn)換為視圖坐標(biāo)。下圖展示了內(nèi)容顯示黑邊時(shí)這兩種坐標(biāo)有何不同：

  

  處理 MotionEvent 時(shí)，請(qǐng)使用 MotionEvent.getX() 和 MotionEvent.getY() 來避免類似的坐標(biāo)問題。不要使用 MotionEvent.getRawX() 或 MotionEvent.getRawY()。

測(cè)試您的內(nèi)容如何呈現(xiàn)

請(qǐng)務(wù)必測(cè)試應(yīng)用的所有屏幕和體驗(yàn)。如有可能，在具有不同類型劉海屏的設(shè)備上進(jìn)行測(cè)試。如果您沒有帶劉海屏的設(shè)備，可以在搭載 Android 9 的任意設(shè)備或模擬器上模擬一些常見的劉海配置，具體操作步驟如下：

1. 啟用開發(fā)者選項(xiàng)。
2. 在開發(fā)者選項(xiàng)屏幕中，向下滾動(dòng)到繪制部分，然后選擇模擬劉海屏。
3. 選擇劉海類型。

其他資源

當(dāng)前文章：Android復(fù)習(xí)(五)設(shè)備兼容—&gt;支持劉海屏-創(chuàng)新互聯(lián)
URL標(biāo)題：http://jinyejixie.com/article48/gepep.html

成都網(wǎng)站建設(shè)公司_創(chuàng)新互聯(lián)，為您提供靜態(tài)網(wǎng)站、搜索引擎優(yōu)化、電子商務(wù)、網(wǎng)站改版、網(wǎng)站維護(hù)、網(wǎng)站設(shè)計(jì)

廣告

聲明：本網(wǎng)站發(fā)布的內(nèi)容（圖片、視頻和文字）以用戶投稿、用戶轉(zhuǎn)載內(nèi)容為主，如果涉及侵權(quán)請(qǐng)盡快告知，我們將會(huì)在第一時(shí)間刪除。文章觀點(diǎn)不代表本網(wǎng)站立場(chǎng)，如需處理請(qǐng)聯(lián)系客服。電話：028-86922220；郵箱：631063699@qq.com。內(nèi)容未經(jīng)允許不得轉(zhuǎn)載，或轉(zhuǎn)載時(shí)需注明來源： 創(chuàng)新互聯(lián)