当前位置：首页 > article >正文

Android 刘海屏适配指南

article 2025/1/11 20:59:54

如果您不希望您的内容与刘海区域重叠，以确保您的内容不会与状态栏及导航栏。如果您要呈现在刘海区域中，请使用 WindowInsetsCompat.getDisplayCutout() 检索 DisplayCutout 对象包含每个刘海屏的安全边衬区和边界框。借助这些 API 您需要检查视频内容是否与刘海屏重叠并根据需要调整位置。

您还可以确定内容是否布置在刘海区域之后。通过 layoutInDisplayCutoutMode 窗口布局属性用于控制您的内容在刘海区域中的绘制方式。您可以将 layoutInDisplayCutoutMode 设置为以下值之一：

LAYOUT_IN_DISPLAY_CUTOUT_MODE_DEFAULT: 当刘海屏包含在系统栏。否则，窗口不会与刘海屏重叠；用于例如，在横屏模式下显示内容时，内容可能会进入信箱模式。如果您的应用以 SDK 35 为目标平台，则对于非浮动广告，系统会解读为 ALWAYS 窗口。
LAYOUT_IN_DISPLAY_CUTOUT_MODE_ALWAYS: 始终允许将内容延伸至刘海屏区域。如果您的应用面向 SDK 35 且在 Android 15 设备上运行，则这是唯一允许的模式非浮动窗口，以确保无边框显示。
LAYOUT_IN_DISPLAY_CUTOUT_MODE_SHORT_EDGES: 在竖屏和横屏模式下，内容都会呈现到刘海区域中。错误做法用于浮动窗口如果您的应用以 SDK 35 为目标平台，则会被解读为 ALWAYS，适用于非浮动窗口。
LAYOUT_IN_DISPLAY_CUTOUT_MODE_NEVER: 但内容绝不会呈现到刘海区域中。如果您的应用以 SDK 35 为目标平台，则此参数为对于非浮动窗口，解释为 ALWAYS。

您可以通过编程方式或通过设置刘海屏模式来设置刘海模式 style。
以下示例定义了一个样式，以应用 LAYOUT_IN_DISPLAY_CUTOUT_MODE_SHORT_EDGES 属性。

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

如果选择在代码中进行指定，只需要在Activity中加入如下代码即可：

if (Build.VERSION.SDK_INT >= 28) {
    WindowManager.LayoutParams params = getWindow().getAttributes();
    params.layoutInDisplayCutoutMode = WindowManager.LayoutParams.LAYOUT_IN_DISPLAY_CUTOUT_MODE_SHORT_EDGES;
    getWindow().setAttributes(params);
}