17370845950

MAUI 无内置跨平台 KeepScreenOn API，需平台特定实现：Android 用 WindowManagerFlags.KeepScreenOn，iOS 用 IdleTimerDisabled；须声明权限、适配定制系统并防范烧屏风险。

MAUI 没有内置的 DeviceDisplay.KeepScreenOn 这样的跨平台 API。截至 2025 年底，MAUI 官方仍未提供统一的屏幕常亮（Keep Screen On）跨平台封装，必须通过平台特定代码实现。

Android：用 WindowManagerFlags 保持常亮

在 Android 上最可靠的

• 打开 Platforms/Android/MainActivity.cs
• 在 OnCreate 方法中调用：
  Window.AddFlags(WindowManagerFlags.KeepScreenOn);
• 该设置仅对当前 Activity 生效；若切换页面或弹出新 Activity，需确保它们也设置了该标志
• 如需动态关闭（比如退出某页面后恢复自动熄屏），可用：
  Window.ClearFlags(WindowManagerFlags.KeepScreenOn);

iOS：禁用空闲计时器

iOS 不支持“强制常亮”，但可通过禁用系统空闲计时器来防止锁屏：

• 在 Platforms/iOS/AppDelegate.cs 中的 OnActivated 或 FinishedLaunching 里添加：
  UIApplication.SharedApplication.IdleTimerDisabled = true;
• 注意：此设置全局生效，建议在不需要时设为 false，例如在页面离开或应用退至后台时还原
• 不建议在 App 启动时就永久开启，否则可能被 App Store 审核拒绝（尤其无合理场景时）

推荐封装成可切换的服务

为便于管理，建议自己封装一个跨平台接口：

• 定义接口：IScreenKeepService，含 Enable() 和 Disable() 方法
• Android 实现类调用 Window.AddFlags/ClearFlags
• iOS 实现类控制 IdleTimerDisabled
• 在 MauiProgram.cs 中注册为 Singleton，并通过依赖注入使用

注意事项和常见问题

这些细节容易忽略但很关键：

• Android 必须声明权限：，写入 AndroidManifest.xml，且需重新打包才生效
• MIUI/HarmonyOS 等定制系统可能限制常亮行为，尤其在省电模式下会强制关闭，需提示用户手动关闭省电策略
• OLED 屏幕长期静止显示有烧屏风险，建议搭配动态内容（如时钟、滚动文字）或仅在必要场景启用
• App 进入后台时，系统通常会自动解除常亮状态，无需额外处理；但若使用前台服务等特殊逻辑，需自行协调生命周期

基本上就这些。没有银弹 API，但两段原生代码 + 一层封装，就能稳稳控制住。