创建通知
创建基本通知
最基本、精简形式(也称为折叠形式)的通知会显示一个图标、一个标题和少量内容文本。在本节中,您将学习如何创建用户单击后可在应用中启动 Activity 的通知。
图 1. 带有标题和文本的通知
设置通知内容
首先,您需要使用 NotificationCompat.Builder
对象设置通知内容和渠道。以下示例显示了如何创建包含下列内容的通知:
- 小图标,通过
setSmallIcon()
设置。这是所必需的唯一一个用户可见内容。 - 标题,通过
setContentTitle()
设置。 - 正文文本,通过
setContentText()
设置。 - 通知优先级,通过
setPriority()
设置。优先级确定通知在 Android 7.1 和更低版本上的干扰程度。(对于 Android 8.0 和更高版本,必须设置渠道重要性,如下一节中所示。)
NotificationCompat.Builder builder = new NotificationCompat.Builder(this, CHANNEL_ID)
.setSmallIcon(R.drawable.notification_icon)
.setContentTitle(textTitle)
.setContentText(textContent)
.setPriority(NotificationCompat.PRIORITY_DEFAULT);
请注意,NotificationCompat.Builder
构造函数要求您提供渠道 ID。这是兼容 Android 8.0(API 级别 26)及更高版本所必需的,但会被较旧版本忽略。
默认情况下,通知的文字内容会被截断以放在一行。如果您想要更长的通知,可以使用 setStyle()
添加样式模板来启用可展开的通知。例如,以下代码会创建更大的文本区