android气泡组件,气泡

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

气泡内置于“通知”系统中。它们浮动在其他应用内容上层，并会跟随用户转到任意位置。气泡可以展开以显示应用功能和信息，并可在不使用时收起。

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

气泡是一种可以选择停用的功能。在应用显示其第一个气泡时，系统会显示一个权限对话框，其中提供两个选项：

屏蔽来自您的应用的所有气泡 - 通知不会被屏蔽，但永远不会显示为气泡

允许来自您的应用的所有气泡 - 通过 BubbleMetaData 发送的所有通知都会显示为气泡

Bubble API

气泡是通过 Notification 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"。

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

Kotlin

// Create bubble intent

val target = Intent(context, BubbleActivity::class.java)

val bubbleIntent = PendingIntent.getActivity(context, 0, target, 0 /* flags */)

// Create bubble metadata

val bubbleData = Notification.BubbleMetadata.Builder(bubbleIntent,

Icon.createWithResource(context, R.drawable.icon))

.setDesiredHeight(600)

.build()

// Create notification

val chatPartner = Person.Builder()

.setName("Chat partner")

.setImportant(true)

.build()

val builder = Notification.Builder(context, CHANNEL_ID)

.setContentIntent(contentIntent)

.setSmallIcon(smallIcon)

.setBubbleMetadata(bubbleData)

.addPerson(chatPartner)Java

// Create bubble intent

Intent target = new Intent(mContext, BubbleActivity.class);

PendingIntent bubbleIntent =

PendingIntent.getActivity(mContext, 0, target, 0 /* flags */);

// Create bubble metadata

Notification.BubbleMetadata bubbleData =

new Notification.BubbleMetadata.Builder(bubbleIntent,

Icon.createWithResource(context, R.drawable.icon))

.setDesiredHeight(600)

.build();

// Create notification

Person chatPartner = new Person.Builder()

.setName("Chat partner")

.setImportant(true)

.build();

Notification.Builder builder =

new Notification.Builder(mContext, CHANNEL_ID)

.setContentIntent(contentIntent)

.setSmallIcon(smallIcon)

.setBubbleMetadata(bubbleData)

.addPerson(chatPartner);

注意：首次发送显示气泡的通知时，您必须使用具有 IMPORTANCE_MIN 或更高级别的通知渠道。

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

创建展开的气泡

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

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 中替换 onBackPressed 时调用 super.onBackPressed；否则，气泡可能会无法正常运行。

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

示例应用

People 示例应用是一个使用气泡的简单对话式应用。出于演示目的，此应用使用聊天机器人。在真实的应用中，气泡应仅用于人类发送的消息，而不用于聊天机器人发送的消息。