通知的桥接选项

默认情况下，通知会从手机上的应用桥接到任何配对的手表，或与其共享。如果您构建了一个手表应用，并且您的应用也存在于配对的手机上，用户可能会收到重复的通知 - 一个由手机应用生成并桥接，另一个由手表应用生成。Wear OS 包含用于控制如何以及何时桥接通知的功能。

避免重复通知

当您从外部来源（例如，来自 Firebase Cloud Messaging）创建通知时，您的移动应用和可穿戴应用都可以在手表上显示其自己的通知。为避免此类重复，请在可穿戴应用中以编程方式禁用桥接。

使用桥接标签

如果您希望将移动应用上创建的一些通知桥接到手表，前提是已安装可穿戴应用，则需要设置桥接标签。

可以使用 setBridgeTag(String) 方法在通知上设置桥接标签，如下面的代码示例所示

val notification = NotificationCompat.Builder(context, channelId)
    // ... set other fields ...
    .extend(
        NotificationCompat.WearableExtender()
            .setBridgeTag("tagOne")
    )
    .build()

禁用桥接

您可以禁用某些通知或所有通知的桥接。建议您有选择地禁用桥接。

禁用某些通知的桥接

您可以动态禁用桥接，并根据标签选择性地允许某些通知通过。例如，要禁用除标记为 tagOne、tagTwo 或 tagThree 的通知之外的所有通知的桥接，请使用 BridgingConfig 对象，如下例所示

BridgingManager.fromContext(context).setConfig(
    BridgingConfig.Builder(context, false)
        .addExcludedTags(listOf("tagOne", "tagTwo", "tagThree"))
        .build()
)

禁用所有通知的桥接（不建议）

注意：不建议禁用所有通知的桥接，因为清单中设置的桥接配置会在安装手表应用后立即生效。如果用户需要在收到通知之前打开并设置手表应用，这可能会导致通知丢失。

要阻止来自手机应用的所有通知的桥接，请在手表应用的清单文件中使用 <meta-data> 条目，如下例所示

<application>
...
  <!-- Beware, this can have unintended consqequences before the user is signed-in -->
  <meta-data
    android:name="com.google.android.wearable.notificationBridgeMode"
    android:value="NO_BRIDGING" />
...
</application>

注意：在运行时指定桥接配置会覆盖 Android 清单文件中与桥接相关的设置。

设置关闭 ID 以同步类似的通知

当您使用桥接模式功能阻止桥接时，通知的关闭操作不会在用户的设备之间同步。

但是，如果在移动设备和手表上都创建了类似的通知，则希望当用户关闭其中一个通知时，这两个通知都关闭。

在 NotificationCompat.WearableExtender 中，您可以设置一个全局唯一 ID，以便当通知关闭时，配对手表上具有相同 ID 的其他通知也会关闭。

NotificationCompat.WearableExtender 类具有允许您使用关闭 ID 的方法，如下面的示例所示

fun setDismissalId(dismissalId: String): WearableExtender
fun getDismissalId(): String

要同步关闭操作，请使用 setDismissalId() 方法。对于每个通知，在调用 setDismissalId() 方法时，传递一个全局唯一的 ID 作为字符串。

当通知关闭时，手表和手机上所有其他具有相同关闭 ID 的通知都会关闭。要检索关闭 ID，请使用 getDismissalId()

在以下示例中，为新通知指定了一个全局唯一的 ID，因此关闭操作已同步

val notification = NotificationCompat.Builder(context, channelId)
    // Set other fields ...
    .extend(
        NotificationCompat.WearableExtender()
            .setDismissalId("abc123")
    )
    .build()

注意：如果手表与 Android 手机配对，则关闭 ID 有效，但如果手表与 iPhone 配对，则无效。

当通知未桥接时

以下类型的通知不会桥接

桥接通知的最佳实践

将桥接通知推送到可穿戴设备或从设备中删除需要时间。在设计通知时，请确保避免由此延迟引起的意外行为。以下准则有助于确保您的桥接通知与异步通知配合使用

  • 如果您在手机上取消通知，则取消手表上相应的通知可能需要一些时间。在此期间，用户可能会发送该通知上的挂起意图之一。因此，请继续从应用中已取消的通知接收挂起意图：在取消通知时，请使这些通知的挂起意图接收器保持有效。
  • 不要一次取消并重新触发整个通知堆栈。仅修改或删除实际已修改的通知。这避免了更新可穿戴设备的延迟，并减少了应用对电池寿命的影响。

设计注意事项

Wear OS 通知有其自己的设计指南。有关更多信息，请查看 Wear OS 设计指南。