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

MAUI 没有内置的 DeviceDisplay.KeepScreenOn 这样的跨平台 API。截至 2025 年底,MAUI 官方仍未提供统一的屏幕常亮(Keep Screen On)跨平台封装,必须通过平台特定代码实现。
Android:用 WindowManagerFlags 保持常亮
在 Android 上最可靠的方式是直接操作 Activity 的 Window 标志:
- 打开
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,但两段原生代码 + 一层封装,就能稳稳控制住。










