窗口沉浸式效果接入技能（hmos-window-immersive）

本技能覆盖鸿蒙（HarmonyOS/OpenHarmony）应用窗口沉浸式效果的接入与适配，基于 Stage 模型 + ArkTS（@ohos.window）+ ArkUI 组件属性，提供组件级与窗口级两套沉浸式方案。

沉浸式效果概述

概念澄清：沉浸式布局（setWindowLayoutFullScreen）≠ 隐藏状态栏和导航条。沉浸式布局是指布局范围从安全区扩展到整个窗口（包括状态栏和导航条区域），但状态栏和导航条仍然可见，只是布局不再避让它们。隐藏系统栏是另一个独立操作（setSpecificSystemBarEnabled），两者可以配合使用但不是一回事。很多开发者误以为"沉浸式"就是状态栏和导航条都隐藏，实际上沉浸式布局下系统栏仍然显示，需要手动做避让处理。

典型应用全屏窗口的 UI 元素包括：顶部状态栏、应用界面、底部导航区域（导航条或三键导航）。状态栏和导航区域在沉浸式布局下称为避让区，避让区之外的区域称为安全区。

沉浸式效果通过将应用页面延伸至状态栏和导航区域，实现：

• 视觉统一：应用页面与避让区色调统一，避免界面割裂
• 布局扩展：充分利用屏幕可视区域
• 沉浸体验：游戏、视频等场景隐藏系统元素，提供无干扰全屏体验

三种沉浸式方案（核心，优先阅读）