鸿蒙OS NotificationSubscriber

NotificationSubscriber

java.lang.Object

|---ohos.event.notification.NotificationSubscriber

public abstract class NotificationSubscriber
extends Object

提供当订阅者收到新通知或通知被取消时将被回调的方法。

NotificationSubscriber 是一个抽象类。 如果你想在你的应用程序中监听通知，你必须首先继承这个类并实现相关的方法。 例如，如果您想在收到通知时收到通知，请覆盖 onConsumed(ohos.event.notification.NotificationRequest); 如果您想在取消通知时收到通知，请覆盖 onCanceled(ohos.event.notification.NotificationRequest) 方法。 请注意，您的应用程序必须具有系统级权限才能订阅通知。

Since:

1

构造函数摘要

构造函数	描述
NotificationSubscriber()

方法总结

修饰符和类型	方法	描述
abstract void	onCanceled(NotificationRequest request)	取消通知时回调。
abstract void	onCanceled(NotificationRequest request, NotificationSortingMap sortingMap, int deleteReason)	取消通知时回调。
abstract void	onConnected()	当订阅者连接到高级通知服务 (ANS) 时回调。
abstract void	onConsumed(NotificationRequest request)	当订阅者收到新通知时回调。
abstract void	onConsumed(NotificationRequest request, NotificationSortingMap sortingMap)	当订阅者收到新通知时回调。
abstract void	onDied()	当与 ANS 的连接中断时回调。
abstract void	onDisConnect()	当订阅者与 ANS 断开连接时回调。
abstract void	onDisturbModeChanged(int disturbMode)	当请勿打扰模式类型更改时调用。
abstract void	onUpdate(NotificationSortingMap sortingMap)	当前通知的排名信息发生变化时回调。

从类 java.lang.Object 继承的方法
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

构造函数详细信息

NotificationSubscriber

public NotificationSubscriber()

方法详情

onConsumed

public abstract void onConsumed(NotificationRequest request)

当订阅者收到新通知时回调。

您需要继承 NotificationSubscriber 类并重写该方法来订阅和接收通知。

参数：

参数名称	参数描述
request	表示接收到的 NotificationRequest 对象。

Since:

1

onConsumed

public abstract void onConsumed(NotificationRequest request, NotificationSortingMap sortingMap)

当订阅者收到新通知时回调。

您需要继承 NotificationSubscriber 类并重写该方法来订阅和接收通知。

参数：

参数名称	参数描述
request	表示接收到的 NotificationRequest 对象。
sortingMap	表示当前订阅者获取通知排名信息所使用的排序图。

Since:

2

onCanceled

public abstract void onCanceled(NotificationRequest request, NotificationSortingMap sortingMap, int deleteReason)

取消通知时回调。

如果要在取消通知时收到通知，则需要继承 NotificationSubscriber 类并重写此方法。

参数：

参数名称	参数描述
request	表示已取消的 NotificationRequest 对象。
sortingMap	表示当前订阅者获取通知排名信息所使用的排序图。
deleteReason	表示删除的原因。

Since:

2

onCanceled

public abstract void onCanceled(NotificationRequest request)

取消通知时回调。

如果要在取消通知时收到通知，则需要继承 NotificationSubscriber 类并重写此方法。

参数：

参数名称	参数描述
request	表示已取消的 NotificationRequest 对象。

Since:

1

onUpdate

public abstract void onUpdate(NotificationSortingMap sortingMap)

当前通知的排名信息发生变化时回调。

参数：

参数名称	参数描述
sortingMap	表示用于获取通知排名信息的排序图。

Since:

1

onConnected

public abstract void onConnected()

当订阅者连接到高级通知服务 (ANS) 时回调。

Since:

1

onDisConnect

public abstract void onDisConnect()

当订阅者与 ANS 断开连接时回调。

Since:

1

onDied

public abstract void onDied()

当与 ANS 的连接中断时回调。

Since:

1

onDisturbModeChanged

public abstract void onDisturbModeChanged(int disturbMode)

当请勿打扰模式类型更改时调用。

参数：

参数名称	参数描述
disturbMode	指示当前的请勿打扰模式类型。

Since:

4