MAUI怎么实现全屏显示 MAUI沉浸式模式教程-C#.Net教程-PHP中文网

MAUI怎么实现全屏显示 MAUI沉浸式模式教程

煙雲

发布： 2025-12-22 12:43:56

原创

303人浏览过

MAUI实现沉浸式全屏需分平台处理：Android可隐藏状态栏和导航栏，iOS仅能隐藏状态栏；需配合布局Padding、SafeArea适配及平台服务封装，注意手势、键盘与横竖屏兼容性。

maui怎么实现全屏显示 maui沉浸式模式教程

MAUI 实现全屏显示（即“沉浸式模式”）主要通过平台特定代码控制状态栏和导航栏的可见性，Android 和 iOS 的实现方式不同，Windows/macOS 不支持传统意义上的沉浸式全屏。核心思路是：隐藏系统 UI（状态栏、导航栏），让应用内容铺满整个屏幕，同时避免内容被系统栏遮挡。

Android：隐藏状态栏 + 导航栏（真正沉浸）

在 MAUI 中需通过 Android 平台专属代码设置 Window 的 DecorView 系统 UI 标志：

在 Platforms/Android/MainActivity.cs 的 OnCreate 方法中（确保在 base.OnCreate(savedInstanceState) 之后）添加：

if (Build.VERSION.SdkInt >= BuildVersionCodes.R)
{
    Window.InsetsController?.Hide(WindowInsets.Type.StatusBars() | WindowInsets.Type.NavigationBars());
    Window.InsetsController?.SystemBarsBehavior = Android.Graphics.Insets.SystemBarsBehavior.ShowTransientBarsBySwipe;
}
else
{
    var decorView = Window.DecorView;
    decorView.SystemUiVisibility = (StatusBarVisibility)(SystemUiFlags.Fullscreen
        | SystemUiFlags.HideNavigation
        | SystemUiFlags.ImmersiveSticky
        | SystemUiFlags.LayoutFullscreen
        | SystemUiFlags.LayoutHideNavigation);
}

登录后复制

为防止内容被隐藏的系统栏“顶上去”，需在页面根布局（如 ContentPage）设置：Padding="0"，并确保容器（如 Grid 或 ScrollView）不自动预留系统栏空间；
若需动态切换沉浸模式（如点击按钮进入/退出），可封装上述逻辑为方法，并在需要时调用。

iOS：隐藏状态栏（有限沉浸）

iOS 不允许隐藏底部安全区域（Home Indicator），仅能隐藏顶部状态栏：

腾讯智影

腾讯推出的在线智能视频创作平台

341

查看详情

在 Platforms/iOS/AppDelegate.cs 中重写 GetStatusBarHidden：

public override bool GetStatusBarHidden(UIApplication application) => true;

登录后复制

同时在 Info.plist 中添加键 UIViewControllerBasedStatusBarAppearance，值设为 YES（确保状态栏控制权交由 ViewController）；
iOS 页面内容默认会避开安全区域，如需延伸到底部，请对关键视图（如背景 Frame）设置：IgnoreSafeArea="True"（MAUI 8+ 支持）或使用 SafeAreaEffect 手动处理。

跨平台统一入口（推荐封装）

为便于管理，可在共享项目中定义接口，再由各平台实现：

新建 IPlatformFullScreenService 接口，含 EnterImmersiveMode() 和 ExitImmersiveMode()；
Android 实现调用前述 Window 控制逻辑；iOS 实现调用 UIApplication.SharedApplication.SetStatusBarHidden；
在 MauiProgram.cs 中注册服务：builder.Services.AddSingleton<iplatformfullscreenservice androidfullscreenservice>()</iplatformfullscreenservice>（按平台条件注册）；
页面中通过依赖注入调用，实现逻辑与平台解耦。