创建通知

通知在您的应用未使用时提供有关事件的简短、及时的信息。本文档向您展示如何使用各种功能创建通知。有关通知在 Android 上如何显示的介绍，请参阅通知概述。有关使用通知的示例代码，请参阅 GitHub 上的人员示例。

此页面中的代码使用来自 AndroidX 库的NotificationCompat API。这些 API 允许您添加仅在更新版本的 Android 上可用的功能，同时仍提供向后兼容性到 Android 9（API 级别 28）。但是，某些功能（例如内联回复操作）在早期版本上会导致无操作。

添加 AndroidX Core 库

虽然大多数使用 Android Studio 创建的项目都包含使用NotificationCompat所需的依赖项，但请验证您的模块级build.gradle文件是否包含以下依赖项

Groovy

dependencies {
    implementation "androidx.core:core:2.2.0"
}

Kotlin

dependencies {
    implementation("androidx.core:core-ktx:2.2.0")
}

创建基本通知

通知以其最基本和最紧凑的形式（也称为折叠形式）显示图标、标题和少量文本内容。本节介绍如何创建用户可以点击以在您的应用中启动活动的通知。

图 1. 带有图标、标题和一些文本的通知。

有关通知每个部分的更多详细信息，请阅读有关通知结构。

声明运行时权限

Android 13（API 级别 33）及更高版本支持用于从应用发布非豁免（包括前台服务 (FGS)）通知的运行时权限。

您需要在应用清单文件中声明的权限显示在以下代码片段中

<manifest ...>
    <uses-permission android:name="android.permission.POST_NOTIFICATIONS"/>
    <application ...>
        ...
    </application>
</manifest>

有关运行时权限的更多详细信息，请参阅通知运行时权限。

设置通知内容

首先，使用NotificationCompat.Builder对象设置通知的内容和渠道。以下示例显示如何创建具有以下内容的通知

一个小图标，由setSmallIcon()设置。这是唯一必需的用户可见内容。
标题，由setContentTitle()设置。
正文文本，由setContentText()设置。
通知优先级，由setPriority()设置。优先级决定了 Android 7.1 及更早版本上通知的侵入性。对于 Android 8.0 及更高版本，请改为设置渠道重要性，如下一节所示。

Kotlin

var builder = NotificationCompat.Builder(this, CHANNEL_ID)
        .setSmallIcon(R.drawable.notification_icon)
        .setContentTitle(textTitle)
        .setContentText(textContent)
        .setPriority(NotificationCompat.PRIORITY_DEFAULT)

Java

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）及更高版本兼容性的要求，但在早期版本中会被忽略。

默认情况下，通知的文本内容会被截断以适应一行。您可以通过创建可扩展通知来显示其他信息。

图 2. 可扩展通知及其折叠和展开形式。

如果希望您的通知更长，则可以通过使用setStyle()添加样式模板来启用可扩展通知。例如，以下代码创建了一个更大的文本区域

Kotlin

var builder = NotificationCompat.Builder(this, CHANNEL_ID)
        .setSmallIcon(R.drawable.notification_icon)
        .setContentTitle("My notification")
        .setContentText("Much longer text that cannot fit one line...")
        .setStyle(NotificationCompat.BigTextStyle()
                .bigText("Much longer text that cannot fit one line..."))
        .setPriority(NotificationCompat.PRIORITY_DEFAULT)

Java

NotificationCompat.Builder builder = new NotificationCompat.Builder(this, CHANNEL_ID)
        .setSmallIcon(R.drawable.notification_icon)
        .setContentTitle("My notification")
        .setContentText("Much longer text that cannot fit one line...")
        .setStyle(new NotificationCompat.BigTextStyle()
                .bigText("Much longer text that cannot fit one line..."))
        .setPriority(NotificationCompat.PRIORITY_DEFAULT);

有关其他大型通知样式的更多信息，包括如何添加图像和媒体播放控件，请参阅创建可扩展通知。

创建渠道并设置重要性

在 Android 8.0 及更高版本上传递通知之前，请通过将NotificationChannel的实例传递给createNotificationChannel()向系统注册应用的通知渠道。以下代码由SDK_INT版本上的条件阻止

Kotlin

private fun createNotificationChannel() {
    // Create the NotificationChannel, but only on API 26+ because
    // the NotificationChannel class is not in the Support Library.
    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
        val name = getString(R.string.channel_name)
        val descriptionText = getString(R.string.channel_description)
        val importance = NotificationManager.IMPORTANCE_DEFAULT
        val channel = NotificationChannel(CHANNEL_ID, name, importance).apply {
            description = descriptionText
        }
        // Register the channel with the system.
        val notificationManager: NotificationManager =
            getSystemService(Context.NOTIFICATION_SERVICE) as NotificationManager
        notificationManager.createNotificationChannel(channel)
    }
}

Java

private void createNotificationChannel() {
    // Create the NotificationChannel, but only on API 26+ because
    // the NotificationChannel class is not in the Support Library.
    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
        CharSequence name = getString(R.string.channel_name);
        String description = getString(R.string.channel_description);
        int importance = NotificationManager.IMPORTANCE_DEFAULT;
        NotificationChannel channel = new NotificationChannel(CHANNEL_ID, name, importance);
        channel.setDescription(description);
        // Register the channel with the system; you can't change the importance
        // or other notification behaviors after this.
        NotificationManager notificationManager = getSystemService(NotificationManager.class);
        notificationManager.createNotificationChannel(channel);
    }
}

因为您必须在 Android 8.0 及更高版本上发布任何通知之前创建通知渠道，所以请在应用启动后立即执行此代码。重复调用此代码是安全的，因为创建现有通知渠道不会执行任何操作。

NotificationChannel构造函数需要一个importance，使用来自NotificationManager类的常量之一。此参数确定如何中断属于此渠道的任何通知的用户。使用setPriority()设置优先级以支持 Android 7.1 及更早版本，如前面的示例所示。

尽管您必须如以下示例所示设置通知重要性或优先级，但系统并不保证您获得的警报行为。在某些情况下，系统可能会根据其他因素更改重要性级别，用户始终可以重新定义给定渠道的重要性级别。

有关不同级别含义的更多信息，请阅读有关通知重要性级别。

设置通知的点击操作

每个通知都必须响应点击，通常是打开应用中与通知相对应的活动。为此，请指定使用PendingIntent对象定义的内容意图，并将其传递给setContentIntent()。

以下代码片段显示如何创建基本意图，以便在用户点击通知时打开活动

Kotlin

// Create an explicit intent for an Activity in your app.
val intent = Intent(this, AlertDetails::class.java).apply {
    flags = Intent.FLAG_ACTIVITY_NEW_TASK or Intent.FLAG_ACTIVITY_CLEAR_TASK
}
val pendingIntent: PendingIntent = PendingIntent.getActivity(this, 0, intent, PendingIntent.FLAG_IMMUTABLE)

val builder = NotificationCompat.Builder(this, CHANNEL_ID)
        .setSmallIcon(R.drawable.notification_icon)
        .setContentTitle("My notification")
        .setContentText("Hello World!")
        .setPriority(NotificationCompat.PRIORITY_DEFAULT)
        // Set the intent that fires when the user taps the notification.
        .setContentIntent(pendingIntent)
        .setAutoCancel(true)

Java

// Create an explicit intent for an Activity in your app.
Intent intent = new Intent(this, AlertDetails.class);
intent.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK | Intent.FLAG_ACTIVITY_CLEAR_TASK);
PendingIntent pendingIntent = PendingIntent.getActivity(this, 0, intent, PendingIntent.FLAG_IMMUTABLE);

NotificationCompat.Builder builder = new NotificationCompat.Builder(this, CHANNEL_ID)
        .setSmallIcon(R.drawable.notification_icon)
        .setContentTitle("My notification")
        .setContentText("Hello World!")
        .setPriority(NotificationCompat.PRIORITY_DEFAULT)
        // Set the intent that fires when the user taps the notification.
        .setContentIntent(pendingIntent)
        .setAutoCancel(true);

此代码调用setAutoCancel()，该方法会在用户点击通知时自动删除通知。

前面的示例中显示的setFlags()方法保留了用户使用通知打开您的应用后预期的导航体验。您可能需要根据要启动的活动类型使用它，它可以是以下之一

专门用于响应通知的活动。用户在正常使用应用期间没有理由导航到此活动，因此活动会启动一个新任务，而不是添加到应用的现有任务和返回堆栈中。这是前面示例中创建的意图类型。
存在于应用常规应用流程中的活动。在这种情况下，启动活动会创建一个返回堆栈，以便保留用户对后退和向上按钮的期望。

有关配置通知意图的不同方法的更多信息，请参阅从通知启动活动。

显示通知

要使通知显示，请调用NotificationManagerCompat.notify()，并向其传递通知的唯一 ID 和NotificationCompat.Builder.build()的结果。这在以下示例中显示

Kotlin

with(NotificationManagerCompat.from(this)) {
    if (ActivityCompat.checkSelfPermission(
            this@MainActivity,
            Manifest.permission.POST_NOTIFICATIONS
        ) != PackageManager.PERMISSION_GRANTED
    ) {
        // TODO: Consider calling
        // ActivityCompat#requestPermissions
        // here to request the missing permissions, and then overriding
        // public fun onRequestPermissionsResult(requestCode: Int, permissions: Array<out String>,
        //                                        grantResults: IntArray)
        // to handle the case where the user grants the permission. See the documentation
        // for ActivityCompat#requestPermissions for more details.

        return@with
    }
    // notificationId is a unique int for each notification that you must define.
    notify(NOTIFICATION_ID, builder.build())
}

Java

with(NotificationManagerCompat.from(this)) {
   if (ActivityCompat.checkSelfPermission(
           this@MainActivity,
           Manifest.permission.POST_NOTIFICATIONS
       ) != PackageManager.PERMISSION_GRANTED
   ) {
       // TODO: Consider calling
       // ActivityCompat#requestPermissions
       // here to request the missing permissions, and then overriding
       // public void onRequestPermissionsResult(int requestCode, String[] permissions,
       //                                        int[] grantResults)
       // to handle the case where the user grants the permission. See the documentation
       // for ActivityCompat#requestPermissions for more details.

       return
   }
   // notificationId is a unique int for each notification that you must define.
   notify(NOTIFICATION_ID, builder.build())
}

保存传递给NotificationManagerCompat.notify()的通知 ID，因为当您想要更新或删除通知时需要它。

此外，为了测试运行在 Android 13 及更高版本设备上的基本通知，请手动开启通知或创建一个对话框来请求通知权限。

添加操作按钮

通知最多可以提供三个操作按钮，让用户快速做出响应，例如延迟提醒或回复短信。但这些操作按钮不得重复用户点击通知时执行的操作。

图 3. 带有一个操作按钮的通知。

要添加操作按钮，请将一个PendingIntent传递给addAction()方法。这就像设置通知的默认点击操作一样，只不过您无需启动 Activity，而是可以执行其他操作，例如启动一个BroadcastReceiver，它在后台执行一项任务，从而避免操作打断已打开的应用。

例如，以下代码演示了如何向特定接收器发送广播

Kotlin

val ACTION_SNOOZE = "snooze"

val snoozeIntent = Intent(this, MyBroadcastReceiver::class.java).apply {
    action = ACTION_SNOOZE
    putExtra(EXTRA_NOTIFICATION_ID, 0)
}
val snoozePendingIntent: PendingIntent =
    PendingIntent.getBroadcast(this, 0, snoozeIntent, 0)
val builder = NotificationCompat.Builder(this, CHANNEL_ID)
        .setSmallIcon(R.drawable.notification_icon)
        .setContentTitle("My notification")
        .setContentText("Hello World!")
        .setPriority(NotificationCompat.PRIORITY_DEFAULT)
        .setContentIntent(pendingIntent)
        .addAction(R.drawable.ic_snooze, getString(R.string.snooze),
                snoozePendingIntent)

Java

String ACTION_SNOOZE = "snooze"

Intent snoozeIntent = new Intent(this, MyBroadcastReceiver.class);
snoozeIntent.setAction(ACTION_SNOOZE);
snoozeIntent.putExtra(EXTRA_NOTIFICATION_ID, 0);
PendingIntent snoozePendingIntent =
        PendingIntent.getBroadcast(this, 0, snoozeIntent, 0);

NotificationCompat.Builder builder = new NotificationCompat.Builder(this, CHANNEL_ID)
        .setSmallIcon(R.drawable.notification_icon)
        .setContentTitle("My notification")
        .setContentText("Hello World!")
        .setPriority(NotificationCompat.PRIORITY_DEFAULT)
        .setContentIntent(pendingIntent)
        .addAction(R.drawable.ic_snooze, getString(R.string.snooze),
                snoozePendingIntent);

有关构建BroadcastReceiver以运行后台任务的更多信息，请参阅广播概述。

如果您尝试构建一个带有媒体播放按钮的通知（例如暂停和跳过曲目），请参阅如何创建带有媒体控件的通知。

添加直接回复操作

直接回复操作（在 Android 7.0（API 级别 24）中引入）允许用户直接在通知中输入文本。然后，文本将在不打开 Activity 的情况下传递到您的应用。例如，您可以使用直接回复操作让用户回复短信或从通知中更新任务列表。

图 4. 点击“回复”按钮将打开文本输入框。

直接回复操作在通知中显示为一个额外的按钮，点击该按钮会打开一个文本输入框。当用户完成输入后，系统会将文本回复附加到您为通知操作指定的 Intent，并将该 Intent 发送到您的应用。

添加回复按钮

要创建支持直接回复的通知操作，请按照以下步骤操作

创建一个RemoteInput.Builder的实例，您可以将其添加到您的通知操作中。此类的构造函数接受一个字符串，系统将其用作文本输入的键。您的应用稍后将使用该键检索输入的文本。

Kotlin

  // Key for the string that's delivered in the action's intent.
  private val KEY_TEXT_REPLY = "key_text_reply"
  var replyLabel: String = resources.getString(R.string.reply_label)
  var remoteInput: RemoteInput = RemoteInput.Builder(KEY_TEXT_REPLY).run {
      setLabel(replyLabel)
      build()
  }

Java

  // Key for the string that's delivered in the action's intent.
  private static final String KEY_TEXT_REPLY = "key_text_reply";

  String replyLabel = getResources().getString(R.string.reply_label);
  RemoteInput remoteInput = new RemoteInput.Builder(KEY_TEXT_REPLY)
          .setLabel(replyLabel)
          .build();

为回复操作创建一个PendingIntent。

Kotlin

  // Build a PendingIntent for the reply action to trigger.
  var replyPendingIntent: PendingIntent =
      PendingIntent.getBroadcast(applicationContext,
          conversation.getConversationId(),
          getMessageReplyIntent(conversation.getConversationId()),
          PendingIntent.FLAG_UPDATE_CURRENT)

Java

  // Build a PendingIntent for the reply action to trigger.
  PendingIntent replyPendingIntent =
          PendingIntent.getBroadcast(getApplicationContext(),
                  conversation.getConversationId(),
                  getMessageReplyIntent(conversation.getConversationId()),
                  PendingIntent.FLAG_UPDATE_CURRENT);

注意：如果您重用PendingIntent，用户可能会回复与他们预期不同的对话。您必须为每个对话提供不同的请求代码，或者提供一个在您对任何其他对话的回复 Intent 调用equals()时不会返回true的 Intent。对话 ID 通常作为 Intent 的额外数据包的一部分传递，但在您调用equals()时会被忽略。

使用addRemoteInput()将RemoteInput对象附加到操作。

Kotlin

  // Create the reply action and add the remote input.
  var action: NotificationCompat.Action =
      NotificationCompat.Action.Builder(R.drawable.ic_reply_icon,
          getString(R.string.label), replyPendingIntent)
          .addRemoteInput(remoteInput)
          .build()

Java

  // Create the reply action and add the remote input.
  NotificationCompat.Action action =
          new NotificationCompat.Action.Builder(R.drawable.ic_reply_icon,
                  getString(R.string.label), replyPendingIntent)
                  .addRemoteInput(remoteInput)
                  .build();

将操作应用于通知并发出通知。

Kotlin

  // Build the notification and add the action.
  val newMessageNotification = Notification.Builder(context, CHANNEL_ID)
          .setSmallIcon(R.drawable.ic_message)
          .setContentTitle(getString(R.string.title))
          .setContentText(getString(R.string.content))
          .addAction(action)
          .build()

  // Issue the notification.
  with(NotificationManagerCompat.from(this)) {
      notificationManager.notify(notificationId, newMessageNotification)
  }

Java

  // Build the notification and add the action.
  Notification newMessageNotification = new Notification.Builder(context, CHANNEL_ID)
          .setSmallIcon(R.drawable.ic_message)
          .setContentTitle(getString(R.string.title))
          .setContentText(getString(R.string.content))
          .addAction(action)
          .build();

  // Issue the notification.
  NotificationManagerCompat notificationManager = NotificationManagerCompat.from(this);
  notificationManager.notify(notificationId, newMessageNotification);

当用户触发通知操作时，系统会提示用户输入响应，如图 4 所示。

从回复中检索用户输入

要接收来自通知回复 UI 的用户输入，请调用RemoteInput.getResultsFromIntent()，并将您的BroadcastReceiver接收到的Intent传递给它。

Kotlin

private fun getMessageText(intent: Intent): CharSequence? {
    return RemoteInput.getResultsFromIntent(intent)?.getCharSequence(KEY_TEXT_REPLY)
}

Java

private CharSequence getMessageText(Intent intent) {
    Bundle remoteInput = RemoteInput.getResultsFromIntent(intent);
    if (remoteInput != null) {
        return remoteInput.getCharSequence(KEY_TEXT_REPLY);
    }
    return null;
 }

处理完文本后，通过使用相同的 ID 和标签（如果使用）调用NotificationManagerCompat.notify()来更新通知。这对于隐藏直接回复 UI 并向用户确认其回复已正确接收和处理是必要的。

Kotlin

// Build a new notification, which informs the user that the system
// handled their interaction with the previous notification.
val repliedNotification = Notification.Builder(context, CHANNEL_ID)
        .setSmallIcon(R.drawable.ic_message)
        .setContentText(getString(R.string.replied))
        .build()

// Issue the new notification.
NotificationManagerCompat.from(this).apply {
    notificationManager.notify(notificationId, repliedNotification)
}

Java

// Build a new notification, which informs the user that the system
// handled their interaction with the previous notification.
Notification repliedNotification = new Notification.Builder(context, CHANNEL_ID)
        .setSmallIcon(R.drawable.ic_message)
        .setContentText(getString(R.string.replied))
        .build();

// Issue the new notification.
NotificationManagerCompat notificationManager = NotificationManagerCompat.from(this);
notificationManager.notify(notificationId, repliedNotification);

在处理此新通知时，请使用传递到接收器的onReceive()方法的上下文。

通过调用setRemoteInputHistory()将回复追加到通知底部。但是，如果您正在构建消息应用，请创建一个消息样式通知并将新消息追加到对话中。

有关消息应用通知的更多建议，请参阅有关消息应用最佳实践的部分。

添加进度条

通知可以包含一个动画进度指示器，向用户显示正在进行的操作的状态。

图 5. 操作期间的进度条。

如果您可以随时估算操作完成的进度，请使用指示器的“确定”形式（如图 5 所示），方法是调用setProgress(max, progress, false)。第一个参数是“完成”值，例如 100。第二个参数是已完成的进度。最后一个参数表示这是一个确定性进度条。

随着操作的进行，请使用progress的更新值连续调用setProgress(max, progress, false)并重新发布通知，如下例所示。

Kotlin

val builder = NotificationCompat.Builder(this, CHANNEL_ID).apply {
    setContentTitle("Picture Download")
    setContentText("Download in progress")
    setSmallIcon(R.drawable.ic_notification)
    setPriority(NotificationCompat.PRIORITY_LOW)
}
val PROGRESS_MAX = 100
val PROGRESS_CURRENT = 0
NotificationManagerCompat.from(this).apply {
    // Issue the initial notification with zero progress.
    builder.setProgress(PROGRESS_MAX, PROGRESS_CURRENT, false)
    notify(notificationId, builder.build())

    // Do the job that tracks the progress here.
    // Usually, this is in a worker thread.
    // To show progress, update PROGRESS_CURRENT and update the notification with:
    // builder.setProgress(PROGRESS_MAX, PROGRESS_CURRENT, false);
    // notificationManager.notify(notificationId, builder.build());

    // When done, update the notification once more to remove the progress bar.
    builder.setContentText("Download complete")
            .setProgress(0, 0, false)
    notify(notificationId, builder.build())
}

Java

...
NotificationManagerCompat notificationManager = NotificationManagerCompat.from(this);
NotificationCompat.Builder builder = new NotificationCompat.Builder(this, CHANNEL_ID);
builder.setContentTitle("Picture Download")
        .setContentText("Download in progress")
        .setSmallIcon(R.drawable.ic_notification)
        .setPriority(NotificationCompat.PRIORITY_LOW);

// Issue the initial notification with zero progress.
int PROGRESS_MAX = 100;
int PROGRESS_CURRENT = 0;
builder.setProgress(PROGRESS_MAX, PROGRESS_CURRENT, false);
notificationManager.notify(notificationId, builder.build());

// Do the job that tracks the progress here.
// Usually, this is in a worker thread.
// To show progress, update PROGRESS_CURRENT and update the notification with:
// builder.setProgress(PROGRESS_MAX, PROGRESS_CURRENT, false);
// notificationManager.notify(notificationId, builder.build());

// When done, update the notification once more to remove the progress bar.
builder.setContentText("Download complete")
        .setProgress(0,0,false);
notificationManager.notify(notificationId, builder.build());

在操作结束时，progress必须等于max。您可以保留进度条以显示操作已完成，也可以将其删除。无论哪种情况，都需要更新通知文本以显示操作已完成。要删除进度条，请调用setProgress(0, 0, false)。

要显示不确定性进度条（一个不指示完成百分比的条形），请调用setProgress(0, 0, true)。结果是一个指示器，其样式与前面的进度条相同，但它是一个持续的动画，不指示完成。进度动画将持续运行，直到您调用setProgress(0, 0, false)，然后更新通知以删除活动指示器。

请记住更改通知文本以指示操作已完成。

设置系统范围的类别

Android 使用预定义的系统范围类别来确定当用户启用请勿打扰模式时，是否应使用给定通知打扰用户。

如果您的通知属于NotificationCompat中定义的通知类别之一（例如CATEGORY_ALARM、CATEGORY_REMINDER、CATEGORY_EVENT或CATEGORY_CALL），请通过将相应的类别传递给setCategory()来声明它。

Kotlin

var builder = NotificationCompat.Builder(this, CHANNEL_ID)
        .setSmallIcon(R.drawable.notification_icon)
        .setContentTitle("My notification")
        .setContentText("Hello World!")
        .setPriority(NotificationCompat.PRIORITY_DEFAULT)
        .setCategory(NotificationCompat.CATEGORY_MESSAGE)

Java

NotificationCompat.Builder builder = new NotificationCompat.Builder(this, CHANNEL_ID)
        .setSmallIcon(R.drawable.notification_icon)
        .setContentTitle("My notification")
        .setContentText("Hello World!")
        .setPriority(NotificationCompat.PRIORITY_DEFAULT)
        .setCategory(NotificationCompat.CATEGORY_MESSAGE);

系统使用有关通知类别的这些信息来决定在设备处于请勿打扰模式时是否显示您的通知。但是，您不需要设置系统范围的类别。仅当您的通知与NotificationCompat中定义的类别之一匹配时才这样做。

显示紧急消息

您的应用可能需要显示紧急的、时间敏感的消息，例如来电或响铃闹钟。在这些情况下，您可以将全屏 Intent 与您的通知相关联。

调用通知时，用户会看到以下内容之一，具体取决于设备的锁定状态

如果用户的设备已锁定，则会显示一个全屏 Activity，覆盖锁屏。
如果用户的设备已解锁，则通知会以展开的形式显示，其中包含处理或关闭通知的选项。

以下代码片段演示了如何将通知与全屏 Intent 相关联

Kotlin

val fullScreenIntent = Intent(this, ImportantActivity::class.java)
val fullScreenPendingIntent = PendingIntent.getActivity(this, 0,
    fullScreenIntent, PendingIntent.FLAG_UPDATE_CURRENT)

var builder = NotificationCompat.Builder(this, CHANNEL_ID)
        .setSmallIcon(R.drawable.notification_icon)
        .setContentTitle("My notification")
        .setContentText("Hello World!")
        .setPriority(NotificationCompat.PRIORITY_DEFAULT)
        .setFullScreenIntent(fullScreenPendingIntent, true)

Java

Intent fullScreenIntent = new Intent(this, ImportantActivity.class);
PendingIntent fullScreenPendingIntent = PendingIntent.getActivity(this, 0,
        fullScreenIntent, PendingIntent.FLAG_UPDATE_CURRENT);

NotificationCompat.Builder builder = new NotificationCompat.Builder(this, CHANNEL_ID)
        .setSmallIcon(R.drawable.notification_icon)
        .setContentTitle("My notification")
        .setContentText("Hello World!")
        .setPriority(NotificationCompat.PRIORITY_DEFAULT)
        .setFullScreenIntent(fullScreenPendingIntent, true);

设置锁屏可见性

要控制锁屏通知中显示的详细信息级别，请调用 setVisibility() 并指定以下值之一

VISIBILITY_PUBLIC：通知的完整内容将在锁屏上显示。
VISIBILITY_SECRET：通知的任何部分都不会在锁屏上显示。
VISIBILITY_PRIVATE：只有基本信息（例如通知的图标和内容标题）才会在锁屏上显示。通知的完整内容不会显示。

当您设置 VISIBILITY_PRIVATE 时，您还可以提供通知内容的替代版本，以隐藏某些详细信息。例如，短信应用可能会显示一条通知，显示“您有 3 条新短信”，但隐藏短信内容和发件人。要提供此替代通知，首先使用 NotificationCompat.Builder 像往常一样创建替代通知。然后，使用 setPublicVersion() 将替代通知附加到普通通知。

请记住，用户始终拥有最终控制权，可以决定其通知是否在锁屏上可见，并且可以根据您应用的通知渠道来控制它们。

更新通知

要在发出通知后更新通知，请再次调用 NotificationManagerCompat.notify()，并传递之前使用的相同 ID。如果先前的通知被驳回，则会创建一个新的通知。

您可以选择调用 setOnlyAlertOnce()，以便您的通知仅在通知首次出现时中断用户（使用声音、振动或视觉提示），而不是在后续更新时中断用户。

删除通知

通知将保持可见，直到发生以下情况之一

用户驳回通知。
如果在创建通知时调用了 setAutoCancel()，则用户点击通知。
您为特定通知 ID 调用 cancel()。此方法还会删除正在进行的通知。
您调用 cancelAll()，这会删除您之前发出的所有通知。
如果在创建通知时使用 setTimeoutAfter() 设置了超时时间，则指定的持续时间到期。如果需要，您可以在指定的超时持续时间到期之前取消通知。

消息应用的最佳实践

在为您的消息和聊天应用创建通知时，请考虑此处列出的最佳实践。

使用 MessagingStyle

从 Android 7.0（API 级别 24）开始，Android 提供了一个专门用于消息内容的通知样式模板。使用 NotificationCompat.MessagingStyle 类，您可以更改通知上显示的几个标签，包括对话标题、其他消息以及通知的内容视图。

以下代码片段演示了如何使用 MessagingStyle 类自定义通知的样式。

Kotlin

val user = Person.Builder()
    .setIcon(userIcon)
    .setName(userName)
    .build()

val notification = NotificationCompat.Builder(this, CHANNEL_ID)
    .setContentTitle("2 new messages with $sender")
    .setContentText(subject)
    .setSmallIcon(R.drawable.new_message)
    .setStyle(NotificationCompat.MessagingStyle(user)
        .addMessage(messages[1].getText(), messages[1].getTime(), messages[1].getPerson())
        .addMessage(messages[2].getText(), messages[2].getTime(), messages[2].getPerson())
    )
    .build()

Java

Person user = new Person.Builder()
    .setIcon(userIcon)
    .setName(userName)
    .build();

Notification notification = new NotificationCompat.Builder(this, CHANNEL_ID)
    .setContentTitle("2 new messages with " + sender)
    .setContentText(subject)
    .setSmallIcon(R.drawable.new_message)
    .setStyle(new NotificationCompat.MessagingStyle(user)
        .addMessage(messages[1].getText(), messages[1].getTime(), messages[1].getPerson())
        .addMessage(messages[2].getText(), messages[2].getTime(), messages[2].getPerson())
    )
    .build();

从 Android 9.0（API 级别 28）开始，还需要使用 Person 类才能获得通知及其头像的最佳呈现效果。

使用 NotificationCompat.MessagingStyle 时，请执行以下操作

调用 MessagingStyle.setConversationTitle() 为包含两人以上的人员的群聊设置标题。一个好的对话标题可能是群聊的名称，或者如果没有名称，则可能是对话参与者的列表。如果没有此项，该消息可能会被误认为属于与对话中最近消息的发件人的一对一对话。
使用 MessagingStyle.setData() 方法包含媒体消息（例如图像）。支持 image/* 模式的 MIME 类型。

使用直接回复

直接回复允许用户内联回复消息。

用户使用内联回复操作回复后，使用 MessagingStyle.addMessage() 更新 MessagingStyle 通知，并且不要撤回或取消通知。不取消通知可以让用户从通知中发送多条回复。
要使内联回复操作与 Wear OS 兼容，请调用 Action.WearableExtender.setHintDisplayInlineAction(true)。
使用 addHistoricMessage() 方法通过向通知中添加历史消息为直接回复对话提供上下文。

启用智能回复

要启用智能回复，请在回复操作上调用 setAllowGeneratedResponses(true)。这会导致在将通知桥接到 Wear OS 设备时，用户可以使用智能回复。智能回复由完全在手表上的机器学习模型使用 NotificationCompat.MessagingStyle 通知提供的上下文生成，并且不会将任何数据上传到互联网以生成回复。

添加通知元数据

分配通知元数据以告知系统如何在设备处于 勿扰模式 时处理您的应用通知。例如，使用 addPerson() 或 setCategory(Notification.CATEGORY_MESSAGE) 方法来覆盖勿扰模式。