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
相关产品推荐
相关产品推荐

