You need to enable JavaScript to run this app. Android(Kotlin)中如何设置全屏模式?使用FLAG_FULLSCREEN代码后刘海被隐藏
优惠活动
大模型
产品
解决方案
定价
更多

Android(Kotlin)中如何设置全屏模式?使用FLAG_FULLSCREEN代码后刘海被隐藏

Kotlin Android 无黑边保留刘海显示的全屏实现方案

你当前代码的核心问题

  • 写法本身存在语法缺陷:你贴的setFlags调用既没有用位或运算符拼接参数,也没有传递合法的掩码参数,本身就无法正常完成配置
  • 强制使用过时的FLAG_FULLSCREEN带来的副作用:这个标识是Android 4.4时代的全屏兼容方案,系统检测到该标识后,会自动为了规避刘海显示冲突,把整个页面内容向下偏移,刘海区域填充为纯黑,最终表现成“刘海被隐藏”的效果

正确的分版本适配实现

通用基础配置(所有Android版本兼容)

  • 移除原来所有关于FLAG_FULLSCREEN的强制设置,替换为现代窗口适配逻辑:
// 允许窗口内容延伸到状态栏、导航栏所在的系统区域,不再自动给系统栏预留占位边距
WindowCompat.setDecorFitsSystemWindows(window, false)
  • 针对Android 9.0(API 28)及以上的刘海屏机型,必须主动声明窗口在刘海区域的展示规则,否则系统会默认在刘海位置填充黑边:
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.P) {
    val windowAttr = window.attributes
    // 允许内容延伸到刘海、屏幕圆角区域展示,不触发系统留黑边的兜底逻辑
    windowAttr.layoutInDisplayCutoutMode = WindowManager.LayoutParams.LAYOUT_IN_DISPLAY_CUTOUT_MODE_SHORT_EDGES
    window.attributes = windowAttr
}

按需配置真正的沉浸式全屏

如果需要实现无系统栏遮挡的纯全屏效果(比如视频播放、游戏启动页),不要再用老的setFlags方式,改用系统提供的Insets控制器配置:

WindowCompat.getInsetsController(window, window.decorView).apply {
    // 隐藏状态栏、导航栏
    hide(WindowInsetsCompat.Type.systemBars())
    // 配置系统栏唤出逻辑:从屏幕边缘滑动即可临时显示系统栏,不打断用户操作
    systemBarsBehavior = WindowInsetsControllerCompat.BEHAVIOR_SHOW_TRANSIENT_BARS_BY_SWIPE
}

避坑提醒

  • 不要同时叠加过时的FLAG_FULLSCREEN和新的刘海屏适配配置,两者的兼容逻辑互相冲突,会直接触发系统的黑边兜底规则,回到你之前遇到的问题
  • 对于有交互内容的页面,需要通过监听窗口Insets变化,给根布局动态设置对应方向的padding,避免关键操作按钮被系统栏、刘海区域遮挡

内容的提问来源于stack exchange,提问作者Verlyn Luna

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.13 07:15:07