管理通知栏

​

通知栏中的通知生命周期

​

点击和清除行为

​

恢复的通知（Android）

​

徽章行为

​

以编程方式清除通知

• 内容消费同步：用户打开了通知指向的界面（收件箱、消息中心或动态流），这些通知因此变得多余。清除所有通知，或者如果只有部分内容被消费，则使用定向方法。
• 登出：清除所有内容，使上一个用户的通知不会被下一个用户看到。

​

clearAllNotifications()

​

removeNotification() 和 removeGroupedNotifications()（Android）

​

延迟后自动清除通知

• Android 8.0（API 26）及更新版本：在通知服务扩展中使用 setTimeoutAfter() 设置超时。超时到期后，Android 会将通知从通知栏中移除。在低于 API 26 的设备上，该调用会被忽略，通知会保留到用户与其交互为止。
• iOS：不支持。iOS 无法让已投递的通知自动过期。最接近的选择是通过 collapse_id 用更新的通知替换它，或在收到后续推送时通过 Notification Service Extension 使用 Apple 的 removeDeliveredNotifications(withIdentifiers:) 移除它。

class NotificationServiceExtension : INotificationServiceExtension {
    override fun onNotificationReceived(event: INotificationReceivedEvent) {
        event.notification.setExtender { builder ->
            // 10 分钟后将此通知从通知栏中移除（仅限 API 26+）
            builder.setTimeoutAfter(10 * 60 * 1000L)
        }
    }
}

public class NotificationServiceExtension implements INotificationServiceExtension {
    @Override
    public void onNotificationReceived(INotificationReceivedEvent event) {
        event.getNotification().setExtender(builder ->
            // 10 分钟后将此通知从通知栏中移除（仅限 API 26+）
            builder.setTimeoutAfter(10 * 60 * 1000L)
        );
    }
}

​

使用服务扩展自定义通知

• 在 Android 上，实现 INotificationServiceExtension 并使用 setExtender() 更改 NotificationCompat 选项，或调用 event.preventDefault() 抑制显示。
• 在 iOS 上，使用 UNNotificationServiceExtension（设置期间创建的 OneSignalNotificationServiceExtension）实现富媒体、徽章递增和确认投递。

​

常见问题

​

为什么在 Android 上打开应用时旧通知会重新出现？

​

TTL 过期后会将通知从通知栏中移除吗？

​

我可以在不清空通知栏的情况下清除徽章吗？

​

有用户清除通知时的监听器吗？