使用通知气泡显示对话

对话泡让用户可以轻松查看并参与对话。

图 1. 聊天气泡。

它们浮动在其他应用内容上层，用户可以展开气泡以显示应用内容并与之互动，还可以在不使用时收起气泡。

当设备处于已锁定状态或“显示屏始终保持开启状态”处于活动状态时，气泡就会像往常的通知那样显示。

对话泡由用户启用。用户可以通过点按支持气泡的通知上的气泡按钮来启用对话泡。这样，该特定聊天就会始终显示为气泡。在设置中，用户可以调整已显示为气泡的聊天，或修改整个应用的设置。

用户可以执行以下操作：

  • 屏蔽来自您的应用的所有对话泡。通知不会被屏蔽，但永远不会显示为气泡。
  • 允许显示来自您的应用的所选对话泡。使用气泡按钮显示为气泡的通知属于“所选”通知。
  • 允许显示来自您的应用的所有对话泡。通过 BubbleMetadata 发送的所有通知都会显示为气泡。

Notification Bubble API

对话泡是使用通知 API 创建的。如果您希望让通知显示为气泡，请为其附加一些额外的数据。

气泡的展开视图是根据您选择的 activity 创建的。 配置 activity 以使其正确显示为气泡。此 activity 必须 可调整大小且 可嵌入。如果它不满足其中任何要求，系统便会改为显示为通知。

以下代码演示了如何实现气泡：

<activity
  android:name=".bubbles.BubbleActivity"
  android:theme="@style/AppTheme.NoActionBar"
  android:label="@string/title_activity_bubble"
  android:allowEmbedded="true"
  android:resizeableActivity="true"
/>

如果您的应用显示多个相同类型的气泡（例如与不同联系人的多个聊天对话），则此 activity 必须能够启动多个实例。在搭载 Android 10 及更低版本的设备上， 除非您将 documentLaunchMode明确设置为 "always"，否则通知不会显示为气泡。从 Android 11 开始，您无需明确 设置此值，因为系统会自动将所有对话的 documentLaunchMode设置为"always"。

如需发送通知气泡，请按照以下步骤操作：

  1. 像往常一样 创建通知。
  2. 调用 BubbleMetadata.Builder(PendingIntent, Icon) 或 BubbleMetadata.Builder(String) 以创建 BubbleMetadata 对象。
  3. 使用 setBubbleMetadata() 将元数据添加到通知中。
  4. 如果以 Android 11 或更高版本为目标平台，请确保对话泡元数据或通知引用分享快捷键。
  5. 修改您的应用，使其不会 取消显示为气泡的通知。 如需检查通知 activity 是否作为气泡启动，请调用 Activity#isLaunchedFromBubble()。 取消通知会从屏幕中移除气泡。打开气泡会自动隐藏与其关联的通知。

这些步骤如以下示例所示：

Kotlin

// Create a bubble intent.
val target = Intent(context, BubbleActivity::class.java)
val bubbleIntent = PendingIntent.getActivity(context, 0, target, 0 /* flags */)
val category = "com.example.category.IMG_SHARE_TARGET"

val chatPartner = Person.Builder()
    .setName("Chat partner")
    .setImportant(true)
    .build()

// Create a sharing shortcut.
val shortcutId = generateShortcutId()
val shortcut =
   ShortcutInfo.Builder(mContext, shortcutId)
       .setCategories(setOf(category))
       .setIntent(Intent(Intent.ACTION_DEFAULT))
       .setLongLived(true)
       .setShortLabel(chatPartner.name)
       .build()

// Create a bubble metadata.
val bubbleData = Notification.BubbleMetadata.Builder(bubbleIntent,
            Icon.createWithResource(context, R.drawable.icon))
    .setDesiredHeight(600)
    .build()

// Create a notification, referencing the sharing shortcut.
val builder = Notification.Builder(context, CHANNEL_ID)
    .setContentIntent(contentIntent)
    .setSmallIcon(smallIcon)
    .setBubbleMetadata(bubbleData)
    .setShortcutId(shortcutId)
    .addPerson(chatPartner)

Java

// Create a bubble intent.
Intent target = new Intent(mContext, BubbleActivity.class);
PendingIntent bubbleIntent =
    PendingIntent.getActivity(mContext, 0, target, 0 /* flags */);

private val CATEGORY_TEXT_SHARE_TARGET =
    "com.example.category.IMG_SHARE_TARGET"

Person chatPartner = new Person.Builder()
        .setName("Chat partner")
        .setImportant(true)
        .build();

// Create a sharing shortcut.
private String shortcutId = generateShortcutId();
ShortcutInfo shortcut =
   new ShortcutInfo.Builder(mContext, shortcutId)
       .setCategories(Collections.singleton(CATEGORY_TEXT_SHARE_TARGET))
       .setIntent(Intent(Intent.ACTION_DEFAULT))
       .setLongLived(true)
       .setShortLabel(chatPartner.getName())
       .build();

// Create a bubble metadata.
Notification.BubbleMetadata bubbleData =
    new Notification.BubbleMetadata.Builder(bubbleIntent,
            Icon.createWithResource(context, R.drawable.icon))
        .setDesiredHeight(600)
        .build();

// Create a notification, referencing the sharing shortcut.
Notification.Builder builder =
    new Notification.Builder(mContext, CHANNEL_ID)
        .setContentIntent(contentIntent)
        .setSmallIcon(smallIcon)
        .setBubbleMetadata(bubbleData)
        .setShortcutId(shortcutId)
        .addPerson(chatPartner);

如果您的应用在发送气泡时位于前台，则系统会忽略重要程度，并始终会显示相应气泡，除非用户屏蔽了来自您应用中的气泡或通知。

创建展开的气泡

您可以将气泡配置为自动以展开状态显示。我们建议您仅在用户执行会导致显示气泡的操作（例如点按按钮以开始新的聊天）时才使用此功能。在这种情况下，还有必要禁止显示在创建气泡时发送的初始通知。

您可以使用以下方法设置启用这些行为的标志： setAutoExpandBubble() 和 setSuppressNotification()。

以下示例展示了如何将气泡配置为自动以展开状态显示：

Kotlin

val bubbleMetadata = Notification.BubbleMetadata.Builder()
    .setDesiredHeight(600)
    .setIntent(bubbleIntent)
    .setAutoExpandBubble(true)
    .setSuppressNotification(true)
    .build()

Java

Notification.BubbleMetadata bubbleData =
    new Notification.BubbleMetadata.Builder()
        .setDesiredHeight(600)
        .setIntent(bubbleIntent)
        .setAutoExpandBubble(true)
        .setSuppressNotification(true)
        .build();

气泡内容生命周期

如果展开气泡，内容 activity 会完成常规 进程 生命周期，这会使 应用成为前台进程（如果应用尚未在前台运行）。

如果收起或关闭气泡，系统会销毁此 activity。这可能导致系统缓存此进程，然后将其终止，具体取决于应用是否有正在运行的其他前台组件。

何时显示气泡

为减少对用户的干扰，气泡仅在特定情况下显示。

如果应用以 Android 11 或更高版本为目标平台，那么除非通知符合对话要求，否则将不会显示为气泡。如果应用以 Android 10 或更低版本为目标平台，那么仅在满足以下一个或多个条件时，通知才会显示为气泡：

如果上述条件均不满足，系统就会显示通知而不显示气泡。

从气泡启动 activity

当气泡启动新的 activity 时，新的 activity 将在同一任务和同一气泡窗口内启动，或在全屏模式下启动新任务，并收起启动它的气泡。

如需在与气泡相同的任务中启动新的 activity，请执行以下操作： 1. 启动 intent 时使用 activity 上下文， activity.startActivity(intent)，以及 1. 请勿在 intent 上设置 FLAG_ACTIVITY_NEW_TASK 标志。

否则，新的 activity 将在新任务中启动，并且气泡会收起。

请注意，气泡代表特定的对话，因此在气泡内启动的 activity 应与该对话相关。此外，在气泡内启动 activity 会增加气泡的任务堆栈，并可能会使用户体验复杂化，尤其是在导航方面。

最佳做法

  • 仅当非常需要显示气泡（例如进行中的通信）或用户明确要求为某些内容显示气泡时，才将通知发送为气泡。气泡会占用屏幕空间并遮盖其他应用内容。
  • 确保您的气泡通知也可以作为一般通知使用。当用户停用气泡时，气泡通知会显示为一般通知。
  • 在气泡 activity 中替换 onBackPressed时，调用super.onBackPressed。否则，您的气泡可能无法正常运行。

当气泡在收起后收到更新的消息时，气泡会显示一个标志图标，表示有未读消息。当用户在关联的应用中打开消息时，请按以下步骤操作：

示例应用

SociaLite 示例应用是一款使用气泡的对话应用。出于演示目的，此应用使用聊天机器人。在真实的应用中，请使用气泡来显示人类发送的消息。