如何阻止Android屏保显示MAUI前台服务的文本框？

核心思路 #

Android前台服务必须绑定通知才能保持运行，要在屏保激活时隐藏通知文本，可通过两种方式实现：一是设置通知的可见性属性，让其在锁屏/屏保状态下隐藏内容；二是监听屏保激活状态，动态更新通知内容。

实现方案 #

方案一：设置通知可见性（快速解决） #

在Android项目的前台服务通知构建逻辑中，添加可见性配置，让通知在屏保/锁屏时不显示文本内容：

// 构建前台服务通知
var notificationBuilder = new NotificationCompat.Builder(this, "your_channel_id")
    .SetSmallIcon(Resource.Drawable.ic_your_notification_icon)
    .SetContentTitle("正常状态的标题")
    .SetContentText("正常状态的文本")
    // 屏保/锁屏时完全隐藏通知内容（仅保留小图标，若不需要可设置透明图标）
    .SetVisibility(NotificationCompat.VisibilitySecret)
    // 禁止在锁屏/屏保时显示通知
    .SetShowWhenLocked(false);

// 针对Android 13+（API 33），可设置仅在前台显示
if (Build.VERSION.SdkInt >= BuildVersionCodes.Tiramisu)
{
    notificationBuilder.SetShowInForegroundOnly(true);
}

// 启动前台服务
StartForeground(1001, notificationBuilder.Build());

方案二：监听屏保状态动态更新通知（精准控制） #

如果需要在屏保激活时完全清空通知文本，关闭时恢复原内容，可通过注册广播接收器监听屏保状态变化：

1. 在前台服务类中注册广播接收器：

private ScreenSaverStatusReceiver _screenSaverReceiver;
private const int NotificationId = 1001;
private const string ChannelId = "your_channel_id";

public override void OnCreate()
{
    base.OnCreate();
    // 初始化并注册屏保状态接收器
    _screenSaverReceiver = new ScreenSaverStatusReceiver(this);
    var intentFilter = new IntentFilter();
    intentFilter.AddAction(Intent.ActionScreenSaverActivated);
    intentFilter.AddAction(Intent.ActionScreenSaverDeactivated);
    RegisterReceiver(_screenSaverReceiver, intentFilter);
}

public override void OnDestroy()
{
    // 销毁时注销接收器
    UnregisterReceiver(_screenSaverReceiver);
    base.OnDestroy();
}

2. 实现自定义广播接收器：

private class ScreenSaverStatusReceiver : BroadcastReceiver
{
    private readonly Service _hostService;

    public ScreenSaverStatusReceiver(Service hostService)
    {
        _hostService = hostService;
    }

    public override void OnReceive(Context context, Intent intent)
    {
        NotificationCompat.Builder builder = null;
        switch (intent.Action)
        {
            case Intent.ActionScreenSaverActivated:
                // 屏保激活，构建空白内容的通知
                builder = new NotificationCompat.Builder(_hostService, ChannelId)
                    .SetSmallIcon(Resource.Drawable.ic_your_notification_icon)
                    .SetVisibility(NotificationCompat.VisibilitySecret)
                    .SetContentTitle("")
                    .SetContentText("");
                break;
            case Intent.ActionScreenSaverDeactivated:
                // 屏保关闭，恢复原通知内容
                builder = new NotificationCompat.Builder(_hostService, ChannelId)
                    .SetSmallIcon(Resource.Drawable.ic_your_notification_icon)
                    .SetContentTitle("前台服务运行中")
                    .SetContentText("当前状态正常")
                    .SetVisibility(NotificationCompat.VisibilityPublic);
                break;
        }

        if (builder != null)
        {
            // 更新前台服务通知
            _hostService.StartForeground(NotificationId, builder.Build());
        }
    }
}

注意事项 #

• 确保已在Android项目中创建通知通道（Android 8.0+要求），否则通知无法正常显示。
• 若不需要小图标，可使用透明图标替换，实现屏保时完全无显示的效果。

内容的提问来源于stack exchange，提问作者Marc George