.NET Maui 如何以编程方式修改显示超时时间？

阿华AIGC实验室

2026-4-8

您好！我来帮您解答这个问题。首先要明确的是：.NET Maui 并没有提供跨平台的统一API来修改系统级的显示超时设置，因为这类操作涉及到系统权限和不同平台的限制，得针对Android和iOS分别处理，而且iOS这边还有严格的限制。

Android 平台实现方式

Android允许APP修改系统显示超时，但需要获取特殊权限，并且得引导用户手动授权。具体步骤如下：

添加权限
在Android项目的AndroidManifest.xml中添加WRITE_SETTINGS权限：

<uses-permission android:name="android.permission.WRITE_SETTINGS" />

创建跨平台接口
在共享项目中定义一个接口，用来统一调用：

public interface IDisplayTimeoutService
{
    // 设置显示超时时间（单位：毫秒）
    bool SetScreenTimeout(int milliseconds);
    // 检查是否有修改设置的权限
    bool HasWriteSettingsPermission();
    // 跳转到权限授权页面
    void RequestWriteSettingsPermission();
}

Android 原生实现
在Android项目中实现这个接口：

[assembly: Dependency(typeof(DisplayTimeoutService))]
namespace YourAppName.Droid.Services
{
    public class DisplayTimeoutService : IDisplayTimeoutService
    {
        public bool SetScreenTimeout(int milliseconds)
        {
            if (!HasWriteSettingsPermission())
                return false;
            
            try
            {
                Settings.System.PutInt(Android.App.Application.Context.ContentResolver, 
                    Settings.System.ScreenOffTimeout, milliseconds);
                return true;
            }
            catch (Exception)
            {
                return false;
            }
        }

        public bool HasWriteSettingsPermission()
        {
            return Settings.System.CanWrite(Android.App.Application.Context);
        }

        public void RequestWriteSettingsPermission()
        {
            Intent intent = new Intent(Settings.ActionManageWriteSettings);
            intent.SetData(Android.Net.Uri.Parse("package:" + Android.App.Application.Context.PackageName));
            intent.AddFlags(ActivityFlags.NewTask);
            Android.App.Application.Context.StartActivity(intent);
        }
    }
}

在共享项目中调用
比如在页面的按钮点击事件里使用：

var service = DependencyService.Get<IDisplayTimeoutService>();
if (service != null)
{
    if (!service.HasWriteSettingsPermission())
    {
        // 提示用户需要授权
        await DisplayAlert("提示", "需要获取修改系统设置的权限，请在跳转的页面中允许", "确定");
        service.RequestWriteSettingsPermission();
    }
    else
    {
        // 设置为5分钟（300000毫秒）
        bool success = service.SetScreenTimeout(300000);
        if (success)
            await DisplayAlert("成功", "显示超时已设置为5分钟", "确定");
        else
            await DisplayAlert("失败", "无法修改显示超时", "确定");
    }
}