一起来规范Android应用通知渠道吧!
共 25206字,需浏览 51分钟
·
2021-03-31 22:45
Android
加入安卓技术群
作者:椎锋陷陈
https://www.jianshu.com/u/9bfd80e684ad
前言
你有强迫症吗?
作为用户的你,有没有试过这样的经历,常常会被一款APP的频繁推送烦扰,但又因为怕错过其中的重要信息,而不敢一刀切地将该APP的通知功能禁用掉?
而作为开发者的你,又有没有遇到这样的需求,要求应用内的有些通知能让用户立即看到(如@提醒消息),而有些通知却只要求佛性地在抽屉通知栏躺着(如下载进度通知)?
如果你有以上的痛苦,那么这篇文章就是你的解苦良药。
假如给你展示以下两张图,哪一张会让你看起来感觉更舒爽?
以上「类别」下的选项即是Android 8引入的通知渠道(Notification Channel)。
做过Android 8系统适配工作的人可能知道,以Android 8(API 级别 26)及更高版本为平台的应用,如果没有为所有通知分配渠道,则会显示不了通知。然而,大部分开发者都是知其然而不知其所以然,并不清楚Android 8引入这个机制的初衷是什么,于是就出现了图二这种莫名其妙的表现。也难怪,「通知渠道」这个名称确实不太好理解,用「通知场景」来描述,可能就清晰准确得多。
场景剖析
什么是通知场景呢?以一款即时通讯APP为例,可能包含系统通知、聊天消息、@提醒消息、音视频通话等多种场景类型下的消息,不同类型的消息要求对用户的提醒程度不一样,具体就体现在对用户视觉、听觉上的干扰程度上。
举个栗子,对于系统通知类的推送(比如谁加了我好友),可能并不需要用户立即处理,所以只需要在状态栏显示一个小图标,并在抽屉式通知栏显示一条通知,让用户知道有这件事即可。
而对于聊天消息,由于可能包含用户关心的内容,除了以上两个手段,常常还需要辅以提示音和震动以加强提醒。
至于@提醒消息和音视频消息,一般都是有针对性地推送,是需要用户立即处理的,要求能以浮动通知的形式显示,并且此时如果处于息屏状态,还需要能够唤醒屏幕,并在锁屏页面显示通知,音视频消息还可能需要自定义提示音以及持续震动,才能达到强提醒的目的。
此处总结为一张表格:
那么,具体如何用通知渠道来实现呢?接下来,就让我们在本文的引领下,一扫之前应用内通知混乱无章的局面,重新整理出应用通知渠道的规范吧。
知识储备
NotificationChannel
代表一个「通知渠道」对象,该类的构造函数中包含了3个最重要的属性,即:唯一渠道 ID、用户可见名称和重要性级别。
唯一渠道 ID
通知渠道的唯一标识,我们可以通过该标识查询特定的渠道设置,打开通知渠道的系统设置或删除特定的通知渠道。
用户可见名称
即打开通知管理界面后最能直观看到的通知渠道名称。
重要性级别
渠道重要性会影响在渠道中发布的所有通知的干扰级别,即上文所提及的提示音、状态栏显示、抽屉式通知栏显示以及浮动通知等。
如需支持 Android 7.1(API 级别 25)或更低版本的平台,还需调用NotificationCompat 类中的 setPriority()方法,针对每条通知设置对应的优先级常量。
渠道重要性级别及其对应的干扰级别如下:
需要注意的是,当我们创建好通知渠道并提交后,便无法再更改通知行为,此时用户拥有完全控制权,用户可以随时可以在通知设置页更改他们对应用渠道的偏好设置。
我们能做的,仅仅包括以下几个方面:
更改现有渠道的名称和说明
读取现有通知渠道的不良设置,从而建议用户更改该设置
删除现有通知渠道
有了这些知识储备后,我们就可以着手开始代码实践了。
代码实践
首先,我们定义一个数据类Channel,用以描述某个通知渠道的具体设置:
/**
* 通知渠道
*/
data class Channel(
val channelId: String, // 唯一渠道ID
val name: CharSequence, // 用户可见名称
val importance: Int, // 重要性级别
val description: String? = null, // 描述
@NotificationCompat.NotificationVisibility
val lockScreenVisibility: Int = NotificationCompat.VISIBILITY_SECRET, // 锁定屏幕公开范围
val vibrate: LongArray? = null, // 震动模式
val sound: Uri? = null // 声音
)
为什么不直接用NotificationChannel?
因为NotificationChannel是API 26才引入的对象,参考NotificationCompat类的设计,为了对客户端屏蔽版本兼容的细节,所以采用了自定义的数据类 。
接着,我们定义一个通知工具类,用以封装创建通知、创建通知渠道、发布通知、取消通知等公用方法以隔离具体业务,并处理好版本兼容工作。其中,createNotificationBuilder方法会返回创建通知的Builder对象,以允许业务方根据需要进一步扩展通知表现形式。
/**
* 通知兼容工具类
*
* 本类中的代码使用Android支持库中的NotificationCompatAPI。
* 这些API允许您添加仅在较新版本Android上可用的功能,同时仍向后兼容Android4.0(API级别14)。
* 但是,诸如内嵌回复操作等部分新功能在较旧版本上会导致发生空操作。
*/
class NotificationCompatUtil {
companion object {
/**
* 创建通知
* @param context 上下文
* @param channel 通知渠道
* @param title 标题
* @param text 正文文本
* @param intent 对点按操作做出响应意图
* @return
*/
fun createNotificationBuilder(
context: Context,
channel: Channel,
title: CharSequence? = null,
text: CharSequence? = null,
intent: Intent? = null
): NotificationCompat.Builder {
// 必须先创建通知渠道,然后才能在Android 8.0及更高版本上发布任何通知
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
createChannel(context, channel)
}
val builder =
NotificationCompat.Builder(context, channel.channelId)
.setPriority(getLowVersionPriority(channel)) // 通知优先级,优先级确定通知在Android7.1和更低版本上的干扰程度。
.setVisibility(channel.lockScreenVisibility) // 锁定屏幕公开范围
.setVibrate(channel.vibrate) // 震动模式
.setSound(channel.sound ?: Settings.System.DEFAULT_NOTIFICATION_URI) // 声音
.setOnlyAlertOnce(true) // 设置通知只会在通知首次出现时打断用户(通过声音、振动或视觉提示),而之后更新则不会再打断用户。
// 标题,此为可选内容
if (!TextUtils.isEmpty(title)) builder.setContentTitle(title)
// 正文文本,此为可选内容
if (!TextUtils.isEmpty(text)) builder.setContentText(text)
// 设置通知的点按操作,每个通知都应该对点按操作做出响应,通常是在应用中打开对应于该通知的Activity。
if (intent != null) {
val pendingIntent =
PendingIntent.getActivity(context, 0, intent, PendingIntent.FLAG_UPDATE_CURRENT)
builder.setContentIntent(pendingIntent)
.setAutoCancel(true) // 在用户点按通知后自动移除通知
if(NotificationManager.IMPORTANCE_HIGH == channel.importance) builder.setFullScreenIntent(pendingIntent, false)
}
return builder
}
/**
* 获取低版本的优先级
* 要支持搭载 Android 7.1(API 级别 25)或更低版本的设备,
* 您还必须使用 NotificationCompat 类中的优先级常量针对每条通知调用 setPriority()。
* @param channel
* @return
*/
private fun getLowVersionPriority(channel: Channel): Int {
return when (channel.importance) {
NotificationManager.IMPORTANCE_HIGH -> NotificationCompat.PRIORITY_HIGH
NotificationManager.IMPORTANCE_LOW -> NotificationCompat.PRIORITY_LOW
NotificationManager.IMPORTANCE_MIN -> NotificationCompat.PRIORITY_MIN
else -> NotificationCompat.PRIORITY_DEFAULT
}
}
/**
* 创建通知渠道
* <p>
* 反复调用这段代码也是安全的,因为创建现有通知渠道不会执行任何操作。
* 注意:创建通知渠道后,您便无法更改通知行为,此时用户拥有完全控制权。不过,您仍然可以更改渠道的名称和说明。
* @param context 上下文
* @param channel 通知渠道
*/
@RequiresApi(api = Build.VERSION_CODES.O)
private fun createChannel(
context: Context,
channel: Channel
) {
val notificationChannel =
NotificationChannel(channel.channelId, channel.name, channel.importance)
notificationChannel.description = channel.description // 描述
notificationChannel.vibrationPattern = channel.vibrate // 震动模式
notificationChannel.setSound(channel.sound ?: Settings.System.DEFAULT_NOTIFICATION_URI, notificationChannel.audioAttributes) // 声音
val notificationManager =
context.getSystemService(Context.NOTIFICATION_SERVICE) as NotificationManager
notificationManager.createNotificationChannel(notificationChannel)
}
/**
* 显示通知
*
*
* 请记得保存您传递到 NotificationManagerCompat.notify() 的通知 ID,因为如果之后您想要更新或移除通知,将需要使用这个 ID。
* @param context 上下文
* @param id 通知的唯一ID
* @param notification 通知
*/
fun notify(
context: Context,
id: Int,
notification: Notification?
) {
val notificationManager =
context.getSystemService(Context.NOTIFICATION_SERVICE) as NotificationManager
notificationManager.notify(id, notification)
}
/**
* 取消通知
* @param context 上下文
* @param id 通知的唯一ID
*/
fun cancel(context: Context, id: Int) {
val notificationManager =
context.getSystemService(Context.NOTIFICATION_SERVICE) as NotificationManager
notificationManager.cancel(id)
}
/**
* 取消所有通知
* @param context 上下文
*/
fun cancelAll(context: Context) {
val notificationManager =
context.getSystemService(Context.NOTIFICATION_SERVICE) as NotificationManager
notificationManager.cancelAll()
}
}
}
然后,在业务模块定义一个推送通知管理类,用于管理具体业务场景下的通知,分为两个部分,渠道对象和通知方法。
渠道对象
由于前面在定义Channel类时已经做好部分属性的默认值设置,所以这里我们只需按需配置Channel对象的属性,以这种编码形式能够很直观地将Channel对象映射到通知设置里对应的通知渠道配置。
// PushNotificationHelper.kt
/** 通知渠道-聊天消息(重要性级别-高:发出声音) */
private val MESSAGE = NotificationCompatUtil.Channel(
channelId = "MESSAGE",
name = BaseApplication.getContext().getString(R.string.channel_message),
importance = NotificationManager.IMPORTANCE_DEFAULT
)
/** 通知渠道-@提醒消息(重要性级别-紧急:发出提示音,并以浮动通知的形式显示 & 锁屏显示 & 振动0.25s )*/
private val MENTION = NotificationCompatUtil.Channel(
channelId = "MENTION",
name = BaseApplication.getContext().getString(R.string.channel_mention),
importance = NotificationManager.IMPORTANCE_HIGH,
lockScreenVisibility = NotificationCompat.VISIBILITY_PUBLIC,
vibrate = longArrayOf(0, 250)
)
/** 通知渠道-系统通知(重要性级别-中:无提示音) */
private val NOTICE = NotificationCompatUtil.Channel(
channelId = "NOTICE",
name = BaseApplication.getContext().getString(R.string.channel_notice),
importance = NotificationManager.IMPORTANCE_LOW
)
/** 通知渠道-音视频通话(重要性级别-紧急:发出提示音,并以浮动通知的形式显示 & 锁屏显示 & 振动4s停2s再振动4s ) */
private val CALL = NotificationCompatUtil.Channel(
channelId = "CALL",
name = BaseApplication.getContext().getString(R.string.channel_call),
importance = NotificationManager.IMPORTANCE_HIGH,
lockScreenVisibility = NotificationCompat.VISIBILITY_PUBLIC,
vibrate = longArrayOf(0, 4000, 2000, 4000),
sound = Uri.parse("android.resource://" + BaseApplication.getContext().packageName + "/" + R.raw.iphone)
)
通知方法
即具体业务场景下的推送逻辑实现,每种方法都必须指定一个通知渠道,调用NotificationCompatUtil类的createNotificationBuilder方法获取创建通知的Builder之后,可以根据需要丰富通知的表现形式:
// PushNotificationHelper.kt
/**
* 显示聊天消息
* @param context 上下文
* @param id 通知的唯一ID
* @param title 标题
* @param text 正文文本
*/
fun notifyMessage(
context: Context,
id: Int,
title: String?,
text: String?
) {
val intent = Intent(context, MainActivity::class.java)
val builder = NotificationCompatUtil.createNotificationBuilder(
context,
MESSAGE,
title,
text,
intent
)
// 默认情况下,通知的文字内容会被截断以放在一行。如果您想要更长的通知,可以使用 setStyle() 添加样式模板来启用可展开的通知。
builder.setStyle(
NotificationCompat.BigTextStyle()
.bigText(text)
)
NotificationCompatUtil.notify(context, id, buildDefaultConfig(builder));
}
/**
* 显示@提醒消息
* @param context 上下文
* @param id 通知的唯一ID
* @param title 标题
* @param text 正文文本
*/
fun notifyMention(
context: Context,
id: Int,
title: String?,
text: String?
) {
val intent = Intent(context, MainActivity::class.java)
val builder = NotificationCompatUtil.createNotificationBuilder(
context,
MENTION,
title,
text,
intent
)
// 默认情况下,通知的文字内容会被截断以放在一行。如果您想要更长的通知,可以使用 setStyle() 添加样式模板来启用可展开的通知。
builder.setStyle(
NotificationCompat.BigTextStyle()
.bigText(text)
)
NotificationCompatUtil.notify(context, id, buildDefaultConfig(builder));
}
/**
* 显示系统通知
* @param context 上下文
* @param id 通知的唯一ID
* @param title 标题
* @param text 正文文本
*/
fun notifyNotice(
context: Context,
id: Int,
title: String?,
text: String?
) {
val intent = Intent(context, MainActivity::class.java)
val builder = NotificationCompatUtil.createNotificationBuilder(
context,
NOTICE,
title,
text,
intent
)
NotificationCompatUtil.notify(context, id, buildDefaultConfig(builder));
}
/**
* 显示音视频通话
* @param context 上下文
* @param id 通知的唯一ID
* @param title 标题
* @param text 正文文本
*/
fun notifyCall(
context: Context,
id: Int,
title: String?,
text: String?
) {
val intent = Intent(context, MainActivity::class.java)
val builder = NotificationCompatUtil.createNotificationBuilder(
context,
CALL,
title,
text,
intent
)
NotificationCompatUtil.notify(context, id, buildDefaultConfig(builder));
}
/**
* 构建应用通知的默认配置
* @param builder 构建器
*/
private fun buildDefaultConfig(builder: NotificationCompat.Builder): Notification {
builder.setSmallIcon(R.drawable.ic_launcher_foreground)
return builder.build()
}
至此,我们便完成了通知方法→渠道对象→通知渠道三者间的映射关系,建立了通知渠道的使用规范,在分别推送了各自渠道下的通知之后,我们可以在通知设置里看到:
具体的Demo已经上传到GitHub(https://github.com/madchan/NotificationChannelLib)
总结
在我看来,规范使用「通知渠道」的好处可以概括为:
更细粒度地划分应用内通知的场景,可以单独控制每种场景对用户的干扰程度,降低对用户的打扰,从而提高用户体验。
幸运的是,很多APP已经意识到了这个好处并付诸实践,但仍有更多APP的通知管理仍处于很混乱的状态,因此希望这部文章能够起到一定指导作用 ,帮助他们建立规范。
推荐阅读
• 耗时2年,Android进阶三部曲第三部《Android进阶指北》出版!
• 『BATcoder』做了多年安卓还没编译过源码?一个视频带你玩转!
BATcoder技术群,让一部分人先进大厂
你好,我是刘望舒,百度百科收录的腾讯云TVP,著有畅销书《Android进阶之光》《Android进阶解密》《Android进阶指北》,蝉联四届电子工业出版社年度优秀作者,谷歌开发者社区特邀讲师。
前华为面试官,现大厂技术负责人。
欢迎添加我的微信 henglimogan ,备注:BATcoder,加入BATcoder技术群。
为了防止失联,欢迎关注我的小号
赞+在看,皇叔感恩❤️