鴻蒙OS ReminderRequest

2022-10-13 09:47 更新

ReminderRequest

java.lang.Object

|---ohos.event.notification.ReminderRequest

public abstract class ReminderRequest
extends Object
implements Sequenceable, Comparable<ReminderRequest>

讓后臺代理代表第三方應(yīng)用程序發(fā)布提醒的基類。

第三方應(yīng)用程序可以使用此類來創(chuàng)建計劃提醒,包括用于倒計時、日歷事件和活動鬧鐘的提醒。

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

Since:

6

嵌套類摘要

從接口 ohos.utils.Sequenceable 繼承的嵌套類/接口
Sequenceable.ProducerT

字段摘要

修飾符和類型 字段 描述
static int ACTION_BUTTON_TYPE_CLOSE ActionButton 類型,表示該動作按鈕用于關(guān)閉提醒的通知。
static int ACTION_BUTTON_TYPE_SNOOZE ActionButton 類型,表示該動作按鈕用于打盹提醒。

方法總結(jié)

修飾符和類型 方法 描述
int compareTo(ReminderRequest other) 按 triggerTime(RTC) 的升序排序。
boolean equals(Object obj) 指示其他對象是否“等于”這個對象。
String getContent() 獲取本次提醒的內(nèi)容。
String getExpiredContent() 獲取該提醒過期時顯示的擴展內(nèi)容。
int getNotificationId() 獲取此提醒使用的通知 ID。
long getRingDuration() 獲取為此提醒配置的響鈴或振動持續(xù)時間。
String getSlotId() 獲取本次提醒使用的槽位ID。
String getSnoozeContent() 獲取該提醒打盹時顯示的擴展內(nèi)容。
int getSnoozeTimes() 獲取此提醒將被自動延后的次數(shù)。
long getTimeInterval() 獲取本次提醒的貪睡間隔。
String getTitle() 獲取此提醒的標題。
int hashCode() 返回對象的哈希碼值。
boolean marshalling(Parcel out) 將此 Sequenceable 對象編組為 Parcel。
ReminderRequest setActionButton(String title, int type) 在此提醒的彈出通知屏幕中添加一個 NotificationActionButton。
ReminderRequest setContent(String content) 設(shè)置此提醒的內(nèi)容。
ReminderRequest setExpiredContent(String expiredContent) 設(shè)置此提醒到期時顯示的擴展內(nèi)容。
ReminderRequest setIntentAgent(String pkgName, String abilityName) 設(shè)置有關(guān)在用戶點擊為此提醒顯示的通知后重定向到的目標能力的信息。
ReminderRequest setMaxScreenIntentAgent(String pkgName, String abilityName) 設(shè)置在設(shè)備不使用時根據(jù)給定的 maxScreenIntentAgent 啟動的能力,而不是在狀態(tài)欄中顯示此提醒的通知。
ReminderRequest setNotificationId(int notificationId) 設(shè)置此提醒的通知 ID。
ReminderRequest setRingDuration(long ringDurationInSeconds) 設(shè)置此提醒的響鈴或振動持續(xù)時間,以秒為單位。
ReminderRequest setSlotId(String slotId) 設(shè)置此提醒的槽 ID。
ReminderRequest setSnoozeContent(String snoozeContent) 設(shè)置此提醒暫停時顯示的擴展內(nèi)容。
ReminderRequest setSnoozeTimes(int snoozeTimes) 設(shè)置此提醒的貪睡次數(shù)。v
ReminderRequest setTimeInterval(long timeIntervalInSeconds) 設(shè)置此提醒的貪睡間隔,以秒為單位。
ReminderRequest setTitle(String title) 設(shè)置此提醒的標題。
String toString() 返回對象的字符串表示形式。
boolean unmarshalling(Parcel in) 從 Parcel 中解組此 Sequenceable 對象。
從類 java.lang.Object 繼承的方法
clone, finalize, getClass, notify, notifyAll, wait, wait, wait
從接口 ohos.utils.Sequenceable 繼承的方法
hasFileDescriptor

字段詳細信息

ACTION_BUTTON_TYPE_CLOSE

public static final int ACTION_BUTTON_TYPE_CLOSE

ActionButton 類型,表示該動作按鈕用于關(guān)閉提醒的通知。 無論應(yīng)用程序當時是否正在運行,它總是運行良好。

ACTION_BUTTON_TYPE_SNOOZE

public static final int ACTION_BUTTON_TYPE_SNOOZE

ActionButton 類型,表示該動作按鈕用于打盹提醒。 無論應(yīng)用程序當時是否正在運行,它總是運行良好。

方法詳情

getRingDuration

public long getRingDuration()

獲取為此提醒配置的響鈴或振動持續(xù)時間。

返回:

返回振鈴或振動持續(xù)時間,以秒為單位。

Since:

6

setRingDuration

public ReminderRequest setRingDuration(long ringDurationInSeconds)

設(shè)置此提醒的響鈴或振動持續(xù)時間,以秒為單位。

參數(shù):

參數(shù)名稱 參數(shù)描述
ringDurationInSeconds 指示要設(shè)置的警報持續(xù)時間。 默認持續(xù)時間為 1 秒。如果 ringDuration 的值小于 0,則設(shè)置不生效,使用默認值 1。如果 ringDuration 的值大于 0,設(shè)備會一直響鈴或振動 指定的秒數(shù)。

返回:

返回此 ReminderRequest 實例。

Since:

6

getSnoozeTimes

public int getSnoozeTimes()

獲取此提醒將被自動延后的次數(shù)。

返回:

返回貪睡的次數(shù)。

Since:

6

setSnoozeTimes

public ReminderRequest setSnoozeTimes(int snoozeTimes)

設(shè)置此提醒的貪睡次數(shù)。

  • 如果 snoozeTimes 的值小于等于 0,則本次提醒為一次性提醒,不會被打盹。
  • 如果 snoozeTimes 的值大于 0,例如 3,則本次提醒在第一次鬧鐘響起后會被貪睡 3 次,即本次提醒會被觸發(fā) 4 次。
  • 此方法對倒計時提醒無效。

參數(shù):

參數(shù)名稱 參數(shù)描述
snoozeTimes 指示提醒將被延后的次數(shù)。

返回:

返回此 ReminderRequest 實例。

Since:

6

getTimeInterval

public long getTimeInterval()

獲取本次提醒的貪睡間隔。

返回:

返回貪睡間隔,以秒為單位。

Since:

6

setTimeInterval

public ReminderRequest setTimeInterval(long timeIntervalInSeconds)

設(shè)置此提醒的貪睡間隔,以秒為單位。 默認值為 0。

  1. 最小貪睡間隔為 5 分鐘。 如果貪睡間隔設(shè)置為大于 0 且小于 5 分鐘的值,系統(tǒng)默認將其轉(zhuǎn)換為 5 分鐘。
  2. 該方法對 ReminderRequestTimer 不生效
以上內(nèi)容是否對您有幫助:
在線筆記
App下載
App下載

掃描二維碼

下載編程獅App

公眾號
微信公眾號

編程獅公眾號