鴻蒙OS ReminderHelper

ReminderHelper

java.lang.Object

|---ohos.event.notification.ReminderHelper

public class ReminderHelper
extends Object

提供管理提醒的靜態(tài)方法，包括發(fā)布或取消提醒、添加或刪除通知槽、獲取或取消當(dāng)前應(yīng)用的所有提醒。

Since:

6

方法總結(jié)

方法詳情

publishReminder

public static int publishReminder(ReminderRequest reminderReq) throws ReminderManager.AppLimitExceedsException, ReminderManager.SysLimitExceedsException, RemoteException

發(fā)布計(jì)劃提醒。

第三方應(yīng)用可以調(diào)用該方法發(fā)布定時(shí)提醒。調(diào)用此方法后，調(diào)用應(yīng)用程序的定時(shí)和彈出通知功能將由系統(tǒng)服務(wù)代理在后臺(tái)執(zhí)行，即使應(yīng)用程序被凍結(jié)或退出。您可以調(diào)用 ReminderRequest#setIntentAgent(String, String) 方法來指定是否在錄制彈出通知后啟動(dòng)應(yīng)用程序。

后臺(tái)代理維護(hù)所有第三方應(yīng)用程序的有序提醒列表。該列表根據(jù)每個(gè)提醒的預(yù)定觸發(fā)時(shí)間進(jìn)行更新。系統(tǒng)一次僅啟動(dòng)一個(gè)最近的預(yù)定提醒。如果添加了觸發(fā)時(shí)間較近的提醒，則新的預(yù)定提醒將放在列表頂部。只有在當(dāng)前提醒完成后才會(huì)觸發(fā)下一個(gè)提醒。

一個(gè)應(yīng)用最多可以創(chuàng)建30個(gè)有效提醒，系統(tǒng)有效提醒總數(shù)不能超過2000個(gè)。提醒的最小貪睡間隔為5分鐘。

權(quán)限：ohos.permission.PUBLISH_AGENT_REMINDER

參數(shù)：

返回:

返回唯一的提醒 ID。

Throws:

Since:

6

addNotificationSlot

public static void addNotificationSlot(NotificationSlot slot) throws RemoteException

創(chuàng)建一個(gè) NotificationSlot。 您可以調(diào)用 ReminderRequest#setSlotId(String) 方法來綁定用于發(fā)布提醒的槽。

當(dāng)應(yīng)用程序被卸載時(shí)，所有與應(yīng)用程序相關(guān)的通知槽都將被刪除。

參數(shù)：

Throws:

Since:

6

cancelReminder

public static void cancelReminder(int reminderId) throws RemoteException

取消指定的提醒。

參數(shù)：

Throws:

Since:

6

removeNotificationSlot

public static void removeNotificationSlot(String slotId) throws RemoteException

刪除提醒使用的 NotificationSlot 實(shí)例。

參數(shù)：

Throws:

Since:

6

getValidReminders

public static ListReminderRequest getValidReminders() throws RemoteException

獲取當(dāng)前應(yīng)用設(shè)置的所有有效提醒通知，即以后仍會(huì)觸發(fā)的提醒。 如果不再觸發(fā)提醒，則不視為有效提醒。

返回:

返回一個(gè)數(shù)組列表，其中包含當(dāng)前應(yīng)用程序設(shè)置的所有有效提醒通知。

Throws:

Since:

6

cancelAllReminders

public static void cancelAllReminders() throws RemoteException

取消當(dāng)前第三方申請(qǐng)的所有提醒

Throws:

Since:

6