劉海屏是指某些設備顯示屏上的一個區(qū)域延伸到顯示面，這樣既能為用戶提供全面屏體驗，又能為設備正面的重要傳感器留出空間。Android 在搭載 Android 9（API 級別 28）及更高版本的設備上正式支持劉海屏。請注意，設備制造商也可以選擇在搭載 Android 8.1 或更低版本的設備上支持劉海屏。
本主題介紹如何實現(xiàn)對帶劉海屏的設備的支持，包括如何處理“劉海區(qū)域”，即顯示面上包含劉海的無邊框矩形。
為了確保一致性和應用兼容性，搭載 Android 9 的設備必須確保以下劉海行為：
如果不希望您的內容與劉海區(qū)域重疊，請確保您的內容不與狀態(tài)欄和導航欄重疊，這樣做一般就足夠了。如果您要將內容呈現(xiàn)到劉海區(qū)域中，則可以使用 WindowInsets.getDisplayCutout() 來檢索 DisplayCutout 對象，該對象包含每個劉海區(qū)域的安全邊襯區(qū)和邊界框。您可以使用這些 API 來檢查您的內容是否與劉海區(qū)域重疊，以便根據需要重新放置。
注意：要在多個 API 級別管理劉海實現(xiàn)，您還可以使用 AndroidX 庫（可通過 SDK 管理器獲得）中的 DisplayCutoutCompat。Android 還允許您控制是否在劉海區(qū)域內顯示內容。窗口布局屬性 layoutInDisplayCutoutMode 控制您的內容如何呈現(xiàn)在劉海區(qū)域中。您可以將 layoutInDisplayCutoutMode 設為以下某個值：
您可以通過編程或在 Activity 中設置樣式來設置劉海模式。以下示例定義了一種樣式，您可以使用它將 LAYOUT_IN_DISPLAY_CUTOUT_MODE_SHORT_EDGES 屬性應用到 Activity。
下面幾部分更詳細地介紹了不同的劉海模式。
默認情況下，在未設置特殊標志的豎屏模式下，在帶劉海屏的設備上，狀態(tài)欄的大小會調整為至少與劉海一樣高，而您的內容會顯示在下方區(qū)域。在橫屏模式或全屏模式下，您的應用窗口會顯示黑邊，因此您的任何內容都不會顯示在劉海區(qū)域中。
對于某些內容（如視頻、照片、地圖和游戲），呈現(xiàn)在劉海區(qū)域中是一種很好的方法，這樣能夠為用戶提供沉浸感更強的全面屏體驗。如果設置了 LAYOUT_IN_DISPLAY_CUTOUT_MODE_SHORT_EDGES，則在豎屏模式和橫屏模式下，內容都會延伸到顯示屏的短邊上的劉海區(qū)域，而不管系統(tǒng)欄處于隱藏還是可見狀態(tài)。請注意，窗口無法延伸到屏幕的長邊上的劉海區(qū)域。使用此模式時，請確保沒有重要內容與劉海區(qū)域重疊。
請注意，Android 可能不允許內容視圖與系統(tǒng)欄重疊。要替換此行為并強制內容延伸到劉海區(qū)域，請通過 View.setSystemUiVisibility(int) 方法將以下任一標志應用于視圖可見性：
下面是一些 LAYOUT_IN_DISPLAY_CUTOUT_MODE_SHORT_EDGES 示例：
請注意，邊角處的劉海可等同于在短邊上，因此適用同樣的行為：
如果設置了 LAYOUT_IN_DISPLAY_CUTOUT_MODE_NEVER，則不允許窗口與劉海區(qū)域重疊。
此模式應該用于暫時設置 View.SYSTEM_UI_FLAG_FULLSCREEN 或 View.SYSTEM_UI_FLAG_HIDE_NAVIGATION 的窗口，以避免在設置或清除了該標志時執(zhí)行另一種窗口布局。
請查看下面的 LAYOUT_IN_DISPLAY_CUTOUT_MODE_NEVER 示例：
某些搭載 Android 8.1（API 級別 27）或更低版本的設備支持一種特殊模式，可讓用戶將顯示黑邊的全屏或橫屏應用延伸到劉海區(qū)域。此模式通常使用導航欄中的切換開關來控制，在延伸屏幕之前會顯示一個對話框，要求用戶進行確認。
使用劉海屏時，請務必考慮以下幾點：
避免對狀態(tài)欄高度進行硬編碼，因為這樣做可能會導致內容重疊或被切斷。如有可能，請使用 WindowInsetsCompat 檢索狀態(tài)欄高度，并確定要對您的內容應用的適當內邊距。
不要假定應用會占據整個窗口，而應使用 View.getLocationInWindow() 來確認應用的位置。不要使用 View.getLocationOnScreen()。
務必妥善處理進入或退出全屏模式。請閱讀這篇 Android 開發(fā)者博文。
對于豎屏模式下的默認劉海行為，如果劉海區(qū)域位于頂部邊緣，并且窗口未設置 FLAG_FULLSCREEN 或 View.SYSTEM_UI_FLAG_FULLSCREEN，則窗口可以延伸到劉海區(qū)域。同樣，如果劉海區(qū)域位于底部邊緣，并且窗口未設置 View.SYSTEM_UI_FLAG_HIDE_NAVIGATION，則窗口可以延伸到劉海區(qū)域。在全屏模式或橫屏模式下，窗口的布局方式應確保其不與劉海區(qū)域重疊。
如果您的應用需要進入和退出全屏模式，請使用 shortEdges 或 never 劉海模式。默認劉海行為可導致應用中的內容在全屏模式轉換過程中上下移動，如下圖所示：
在全屏模式下，在使用窗口坐標與屏幕坐標時應保持謹慎，因為在顯示黑邊的情況下，您的應用不會占據整個屏幕。由于顯示黑邊，因此根據屏幕原點得到的坐標與根據窗口原點得到的坐標不再相同。您可以根據需要使用 getLocationOnScreen() 將屏幕坐標轉換為視圖坐標。下圖展示了內容顯示黑邊時這兩種坐標有何不同：
處理 MotionEvent 時，請使用 MotionEvent.getX() 和 MotionEvent.getY() 來避免類似的坐標問題。不要使用 MotionEvent.getRawX() 或 MotionEvent.getRawY()。
請務必測試應用的所有屏幕和體驗。如有可能，在具有不同類型劉海屏的設備上進行測試。如果您沒有帶劉海屏的設備，可以在搭載 Android 9 的任意設備或模擬器上模擬一些常見的劉海配置，具體操作步驟如下：
重慶分公司
重慶分公司
