Android 14通知权限：Seal的通知请求流程-优快云博客

Android 14通知权限：Seal的通知请求流程

【免费下载链接】Seal 🦭 Video/Audio Downloader for Android, based on yt-dlp, designed with Material You 项目地址: https://gitcode.com/gh_mirrors/se/Seal

你是否曾在使用视频下载应用时错过下载完成提醒？Android 14引入的通知权限机制要求应用明确请求发送通知的权限，Seal作为基于yt-dlp的Android音视频下载器，已针对这一变化优化了通知请求流程。本文将详解Seal如何在Android 14上请求通知权限，确保你不会错过任何下载进度提醒。

权限声明与基础配置

Seal在AndroidManifest.xml中已声明通知权限，针对Android 13及以上系统：

<uses-permission 
    android:name="android.permission.POST_NOTIFICATIONS"
    android:minSdkVersion="33" />

权限声明位置

通知功能核心配置在NotificationUtil.kt中，通过创建专用通知渠道确保系统兼容性：

fun createNotificationChannel() {
    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
        val channel = NotificationChannel(
            CHANNEL_ID,
            context.getString(R.string.channel_name),
            NotificationManager.IMPORTANCE_DEFAULT
        ).apply {
            description = context.getString(R.string.channel_description)
        }
        notificationManager.createNotificationChannel(channel)
    }
}

渠道创建代码

权限请求触发场景

Seal在两个关键场景触发通知权限请求：

1. 设置页面主动授权

在通用下载设置页面，用户可找到"下载通知"开关，当首次点击启用时会触发权限请求：

相关实现位于GeneralDownloadPreferences.kt：

PreferenceSwitch(
    title = stringResource(id = R.string.download_notification),
    description = stringResource(
        id = if (isNotificationPermissionGranted) 
            R.string.download_notification_desc 
        else R.string.permission_denied
    ),
    isChecked = downloadNotification && isNotificationPermissionGranted,
    onClick = {
        if (notificationPermission?.status is PermissionStatus.Denied) {
            showNotificationDialog = true
        } else if (isNotificationPermissionGranted) {
            downloadNotification = !downloadNotification
            PreferenceUtil.updateValue(NOTIFICATION, downloadNotification)
        }
    }
)

设置页面实现

2. 下载任务启动前检查

当用户首次发起下载且未授予通知权限时，Seal会在下载前弹出权限请求对话框：

val checkPermissionOrDownload = {
    if (NOTIFICATION.getBoolean() && notificationPermission?.status?.isGranted == false) {
        showNotificationDialog = true
    } else {
        // 继续下载流程
    }
}

下载权限检查

权限请求对话框设计

Seal使用符合Material You设计规范的对话框请求权限，包含清晰的说明文字和操作按钮：

NotificationPermissionDialog(
    onDismissRequest = { showNotificationDialog = false },
    onPermissionGranted = { 
        notificationPermission?.launchPermissionRequest()
        NOTIFICATION.updateBoolean(true)
    }
)

对话框实现

对话框包含以下核心元素：

标题："启用通知？"
说明文本："应用需要权限发送下载状态和进度通知"
操作按钮："仅一次"、"始终允许"、"不允许"

权限请求文案

权限状态处理逻辑

Seal通过状态管理确保权限变更即时生效：

权限授予后的处理

if (notificationPermission?.status is PermissionStatus.Granted) {
    downloadNotification = true
    PreferenceUtil.updateValue(NOTIFICATION, true)
    // 发送测试通知确认功能正常
    sendTestNotification()
}