MAUI怎么控制屏幕常亮不熄灭 MAUI DeviceDisplay KeepScreenOn

来源:这里教程网 时间:2026-02-21 17:39:40 作者:

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

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

相关推荐