鴻蒙OS NotificationRequest

NotificationRequest

java.lang.Object

|---ohos.event.notification.NotificationRequest

public final class NotificationRequest
extends Object
implements Sequenceable

攜帶通知。

在通知發(fā)布方面，需要分別調(diào)用 setContent(ohos.event.notification.NotificationRequest.NotificationContent) 方法指定通知內(nèi)容，調(diào)用 setDeliveryTime(long) 方法設(shè)置通知的發(fā)送時(shí)間。 NotificationRequest 在 NotificationHelper#publishNotification(NotificationRequest) 方法中用作輸入?yún)?shù)以發(fā)布通知。 在通知訂閱方面，可以繼承 NotificationSubscriber 類，重寫回調(diào)方法 NotificationSubscriber#onConsumed(NotificationRequest) 和 NotificationSubscriber#onCanceled(NotificationRequest)。 接收或刪除的通知可以存儲(chǔ)在 NotificationRequest 對(duì)象中。

Since:

1

嵌套類摘要

修飾符和類型	類	描述
static class	NotificationRequest.NotificationContent	設(shè)置要傳遞給 NotificationRequest#setContent(NotificationRequest.NotificationContent) 方法的通知內(nèi)容。
static class	NotificationRequest.NotificationConversationalContent	構(gòu)造一個(gè)類似對(duì)話的通知，其中包括多個(gè)用戶之間的消息通信。
static class	NotificationRequest.NotificationLongTextContent	構(gòu)造包含長(zhǎng)文本的通知。
static class	NotificationRequest.NotificationMediaContent	構(gòu)造一個(gè)可以與關(guān)聯(lián)的音頻會(huì)話交互的媒體播放通知。
static class	NotificationRequest.NotificationMultiLineContent	構(gòu)造一個(gè)包含多行文本的通知。
static class	NotificationRequest.NotificationNormalContent	構(gòu)造基本通知。
static class	NotificationRequest.NotificationPictureContent	構(gòu)造包含圖片附件的通知。

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

字段摘要

修飾符和類型	字段	描述
static int	BADGE_STYLE_BIG	表示此通知的標(biāo)記顯示為大圖標(biāo)。
static int	BADGE_STYLE_LITTLE	表示此通知的標(biāo)記顯示為一個(gè)小圖標(biāo)。
static int	BADGE_STYLE_NONE	表示此通知的標(biāo)記僅顯示數(shù)字。
static String	CLASSIFICATION_ALARM	指示警報(bào)或定時(shí)器的通知分類。
static String	CLASSIFICATION_CALL	指示傳入呼叫或類似同步通信請(qǐng)求的通知分類。
static String	CLASSIFICATION_EMAIL	指示電子郵件通知的分類。
static String	CLASSIFICATION_ERROR	指示在后臺(tái)操作或身份驗(yàn)證過程中發(fā)生的錯(cuò)誤通知的分類。
static String	CLASSIFICATION_EVENT	指示日歷事件的通知分類。
static String	CLASSIFICATION_MESSAGE	指示短消息或即時(shí)消息的通知分類。
static String	CLASSIFICATION_NAVIGATION	表示地圖導(dǎo)航通知的分類。
static String	CLASSIFICATION_PROGRESS	表示長(zhǎng)時(shí)間在后臺(tái)運(yùn)行的進(jìn)程的通知分類。
static String	CLASSIFICATION_PROMO	表示廣告或促銷信息通知的分類。
static String	CLASSIFICATION_RECOMMENDATION	指示特定交易的具體及時(shí)建議的通知分類。
static String	CLASSIFICATION_REMINDER	指示用戶先前設(shè)置的提醒的通知分類。
static String	CLASSIFICATION_SERVICE	指示正在進(jìn)行的后臺(tái)服務(wù)的通知分類。
static String	CLASSIFICATION_SOCIAL	指示社交網(wǎng)絡(luò)或共享更新通知的分類。
static String	CLASSIFICATION_STATUS	指示有關(guān)設(shè)備和上下文狀態(tài)的持續(xù)信息的通知分類。
static String	CLASSIFICATION_SYSTEM	指示系統(tǒng)或設(shè)備狀態(tài)更新通知的分類。
static String	CLASSIFICATION_TRANSPORT	表示播放過程中媒體傳輸控制的通知分類。
static int	COLOR_DEFAULT	表示默認(rèn)通知背景顏色，即不顯示顏色。
static String	EXTRA_USER_INPUT_HISTORY	getAdditionalData() 鍵：這是用戶輸入歷史記錄，提供給 setNotificationUserInputHistory(java.util.List)。
static int	GROUP_ALERT_TYPE_ALL	通知組警報(bào)類型，如果為關(guān)聯(lián)的 NotificationSlot 對(duì)象啟用聲音或振動(dòng)，則指示組中的所有通知都有聲音或振動(dòng)。
static int	GROUP_ALERT_TYPE_CHILD	通知組警報(bào)類型，指示子通知有聲音或振動(dòng)，但如果為關(guān)聯(lián)的 NotificationSlot 對(duì)象啟用聲音或振動(dòng)，則組中的概覽通知會(huì)靜音（無聲音或振動(dòng)）。
static int	GROUP_ALERT_TYPE_OVERVIEW	通知組警報(bào)類型，指示概覽通知有聲音或振動(dòng)，但如果為關(guān)聯(lián)的 NotificationSlot 對(duì)象啟用聲音或振動(dòng)，則組中的子通知將靜音（無聲音或振動(dòng)）。
static Sequenceable.ProducerNotificationRequest	PRODUCER	從 Parcel 創(chuàng)建 NotificationRequest 實(shí)例。
static int	VISIBLENESS_TYPE_NO_OVERRIDE	表示未通過setVisibleness(int)設(shè)置通知顯示效果。
static int	VISIBLENESS_TYPE_PRIVATE	表示鎖屏上只顯示應(yīng)用程序圖標(biāo)、應(yīng)用程序名稱等基本信息。
static int	VISIBLENESS_TYPE_PUBLIC	表示通知的內(nèi)容顯示在鎖定屏幕上。
static int	VISIBLENESS_TYPE_SECRET	表示通知不顯示在鎖定屏幕上。

構(gòu)造函數(shù)摘要

構(gòu)造函數(shù)	描述
NotificationRequest()	用于創(chuàng)建 NotificationRequest 實(shí)例的默認(rèn)構(gòu)造函數(shù)。
NotificationRequest(int notificationId)	一個(gè)構(gòu)造函數(shù)，用于創(chuàng)建一個(gè) NotificationRequest 實(shí)例，并傳遞了輸入?yún)?shù) notificationId。
NotificationRequest(Context context, int notificationId)	用于根據(jù)指定的上下文和通知 ID 創(chuàng)建 NotificationRequest 實(shí)例的構(gòu)造函數(shù)。
NotificationRequest(NotificationRequest request)	用于通過從現(xiàn)有參數(shù)復(fù)制參數(shù)來創(chuàng)建 NotificationRequest 實(shí)例的構(gòu)造函數(shù)。

方法總結(jié)

修飾符和類型	方法	描述
NotificationRequest	addActionButton(NotificationActionButton actionButton)	向此通知添加 NotificationActionButton。
NotificationRequest	addMessageUser(MessageUser messageUser)	添加一個(gè) MessageUser 對(duì)象并將其與此通知相關(guān)聯(lián)。
ListNotificationActionButton	getActionButtons()	獲取包含在此通知中的所有 NotificationActionButton 對(duì)象的列表。
IntentParams	getAdditionalData()	獲取通知中設(shè)置的 IntentParams 對(duì)象。
long	getAutoDeletedTime()	獲取通知被刪除的時(shí)間。
int	getBadgeIconStyle()	獲取該通知的徽章圖標(biāo)樣式。
int	getBadgeNumber()	獲取要為此通知顯示的編號(hào)。
PixelMap	getBigIcon()	獲取該通知的大圖標(biāo)。
String	getClassification()	獲取此通知的分類。
int	getColor()	獲取此通知的背景顏色。
NotificationRequest.NotificationContent	getContent()	調(diào)用setContent(ohos.event.notification.NotificationRequest.NotificationContent)方法獲取通知內(nèi)容集。
long	getCreateTime()	已棄用。 此更改從 API 版本 2 開始生效。初始化 NotificationRequest 的時(shí)間對(duì)公眾是不可訪問的。 要獲取發(fā)送通知的時(shí)間，請(qǐng)調(diào)用 getDeliveryTime() 方法。
String	getCreatorBundleName()	獲取通知?jiǎng)?chuàng)建者的包名。
int	getCreatorPid()	獲取通知?jiǎng)?chuàng)建者的PID。
int	getCreatorUid()	獲取通知?jiǎng)?chuàng)建者的 UID。
ComponentProvider	getCustomBigView()	獲取定義此通知展開時(shí)要顯示的自定義視圖的 ComponentProvider 對(duì)象。
ComponentProvider	getCustomFloatView()	獲取定義當(dāng)此通知顯示為屏幕頂部的浮動(dòng)窗口時(shí)要顯示的自定義視圖的 ComponentProvider 對(duì)象。
ComponentProvider	getCustomView()	獲取定義此通知中設(shè)置的自定義視圖的 ComponentProvider 對(duì)象。
long	getDeliveryTime()	獲取通知下發(fā)的時(shí)間。
int	getGroupAlertType()	獲取該通知的群組告警類型。
String	getGroupValue()	獲取本次通知的組信息。
IntentAgent	getIntentAgent()	獲取此通知中包含的 IntentAgent。
String	getLabel()	獲取此通知的標(biāo)簽。
PixelMap	getLittleIcon()	獲取通知的圖標(biāo)。
IntentAgent	getMaxScreenIntentAgent()	調(diào)用setMaxScreenIntentAgent(ohos.event.intentagent.IntentAgent)獲取全屏IntentAgent集合。
ListMessageUser	getMessageUsers()	獲取與此通知關(guān)聯(lián)的所有 MessageUser 對(duì)象。
String	getNotificationHashCode()	獲取當(dāng)前應(yīng)用中通知的唯一哈希碼。
int	getNotificationId()	獲取通知ID，在當(dāng)前應(yīng)用中是唯一的。
int	getNotificationType()	獲取通知類型。
String	getOwnerBundleName()	獲取通知所有者的捆綁包名稱。
int	getProgressMax()	獲取此通知的進(jìn)度條顯示的最大值。
int	getProgressValue()	獲取此通知的進(jìn)度條顯示的當(dāng)前值。
IntentAgent	getRemovalIntentAgent()	獲取用戶顯式移除此通知時(shí)觸發(fā)的 IntentAgent 對(duì)象。
String	getSettingsText()	獲取將顯示為應(yīng)用程序設(shè)置鏈接的文本。
String	getShortcutId()	獲取與此通知關(guān)聯(lián)的快捷方式 ID。
String	getSlotId()	通過調(diào)用setSlotId(java.lang.String)方法獲取通知集的槽位ID。
String	getSortingKey()	獲取用于對(duì)來自同一應(yīng)用程序包的通知進(jìn)行排序的密鑰。
String	getStatusBarText()	獲取收到此通知時(shí)將在狀態(tài)欄中顯示的滾動(dòng)文本。
int	getVisibleness()	獲取該通知在鎖屏?xí)r的顯示效果。
boolean	isAlertOneTime()	檢查此通知是否設(shè)置為僅提醒一次，這意味著在更新具有相同 ID 的通知時(shí)將不再播放聲音或振動(dòng)。
boolean	isColorEnabled()	檢查是否為此通知啟用了背景顏色。
boolean	isCountdownTimer()	檢查通知?jiǎng)?chuàng)建時(shí)間是否顯示為倒計(jì)時(shí)。
boolean	isFloatingIcon()	檢查此通知是否顯示為屏幕頂部的浮動(dòng)圖標(biāo)。
boolean	isGroupOverview()	檢查此通知是否為組概覽。
boolean	isInProgress()	檢查此通知是否正在進(jìn)行中。
boolean	isOnlyLocal()	檢查此通知是否僅與本地設(shè)備相關(guān)，不能在遠(yuǎn)程設(shè)備上顯示。
boolean	isPermitSystemGeneratedContextualActionButtons()	檢查是否允許平臺(tái)為此通知生成上下文 NotificationActionButton 對(duì)象。檢查是否允許平臺(tái)為此通知生成上下文 NotificationActionButton 對(duì)象。
boolean	isProgressIndeterminate()	檢查此通知的進(jìn)度條是否不確定。
boolean	isShowCreateTime()	已棄用。 此更改從 API 版本 2 開始生效。請(qǐng)改用 isShowDeliveryTime()。 通知顯示它的發(fā)送時(shí)間，而不是它的創(chuàng)建時(shí)間。
boolean	isShowDeliveryTime()	檢查是否顯示此通知的通知傳遞時(shí)間。
boolean	isShowStopwatch()	檢查通知?jiǎng)?chuàng)建時(shí)間是否顯示為秒表。
boolean	isTapDismissed()	檢查當(dāng)前通知是否會(huì)在被點(diǎn)擊后自動(dòng)關(guān)閉。
boolean	isUnremovable()	檢查此通知是否不可刪除。
boolean	marshalling(Parcel out)	將 NotificationRequest 對(duì)象編組到 Parcel 中。
NotificationRequest	setAdditionalData(IntentParams extras)	設(shè)置存儲(chǔ)為通知的鍵值對(duì)的額外參數(shù)。
NotificationRequest	setAlertOneTime(boolean isAlertOnce)	設(shè)置是否只有一次通知提醒。
NotificationRequest	setAutoDeletedTime(long time)	設(shè)置刪除通知的時(shí)間。
NotificationRequest	setBadgeIconStyle(int badgeIconStyle)	設(shè)置此通知的徽章圖標(biāo)樣式。
NotificationRequest	setBadgeNumber(int number)	設(shè)置要為此通知顯示的數(shù)字。
NotificationRequest	setBigIcon(PixelMap bigIcon)	設(shè)置此通知的大圖標(biāo)，通常顯示在通知的右側(cè)。
NotificationRequest	setClassification(String classification)	設(shè)置此通知的分類，描述此通知的用途。
NotificationRequest	setColor(int color)	設(shè)置此通知的背景顏色。
NotificationRequest	setColorEnabled(boolean colorEnabled)	設(shè)置是否為此通知啟用背景顏色。
NotificationRequest	setContent(NotificationRequest.NotificationContent content)	將通知內(nèi)容類型設(shè)置為 NotificationRequest.NotificationNormalContent、NotificationRequest.NotificationLongTextContent 或 NotificationRequest.NotificationPictureContent。
NotificationRequest	setCountdownTimer(boolean isCountDown)	設(shè)置是否將通知?jiǎng)?chuàng)建時(shí)間顯示為倒計(jì)時(shí)。
NotificationRequest	setCreateTime(long createTime)	已棄用。 此更改從 API 版本 2 開始生效。 createTime 在初始化 NotificationRequest 時(shí)占用系統(tǒng)時(shí)間。
NotificationRequest	setCustomBigView(ComponentProvider view)	設(shè)置展開此通知時(shí)要顯示的自定義視圖。
NotificationRequest	setCustomFloatView(ComponentProvider view)	設(shè)置當(dāng)此通知顯示為屏幕頂部的浮動(dòng)窗口時(shí)要顯示的自定義視圖。
NotificationRequest	setCustomView(ComponentProvider view)	設(shè)置此通知的自定義視圖。
NotificationRequest	setDeliveryTime(long deliveryTime)	設(shè)置發(fā)送通知的時(shí)間。
NotificationRequest	setGroupAlertType(int groupAlertType)	設(shè)置此通知的組警報(bào)類型，這決定了組概述和組中其他通知的發(fā)布方式。
NotificationRequest	setGroupOverview(boolean groupOverview)	設(shè)置是否將此通知用作其組的概述。
NotificationRequest	setGroupValue(String groupValue)	設(shè)置此通知的組信息。
NotificationRequest	setInProgress(boolean isOngoing)	設(shè)置此通知是否正在進(jìn)行中。
NotificationRequest	setIntentAgent(IntentAgent agent)	向此通知添加 IntentAgent。
NotificationRequest	setLittleIcon(PixelMap littleIcon)	設(shè)置通知的小圖標(biāo)。
NotificationRequest	setMaxScreenIntentAgent(IntentAgent maxScreenIntentAgent)	將 IntentAgent 設(shè)置為在設(shè)備未使用時(shí)啟動(dòng)，而不是在狀態(tài)欄中顯示此通知。
NotificationRequest	setNotificationId(int notificationId)	設(shè)置當(dāng)前通知 ID 以唯一標(biāo)識(shí)應(yīng)用程序中的通知。
NotificationRequest	setNotificationUserInputHistory(ListString text)	設(shè)置已通過此通知發(fā)送的最新 NotificationUserInput 記錄。
NotificationRequest	setOnlyLocal(boolean flag)	設(shè)置此通知是否僅與本地設(shè)備相關(guān)，而不能在遠(yuǎn)程設(shè)備上顯示。
NotificationRequest	setPermitSystemGeneratedContextualActionButtons(boolean permitted)	設(shè)置是否允許平臺(tái)為此通知生成上下文 NotificationActionButton 對(duì)象。
NotificationRequest	setProgressBar(int progress, int progressMax, boolean indeterminate)	設(shè)置此通知的進(jìn)度條顯示方式。
NotificationRequest	setPublicNotification(NotificationRequest request)	為此通知設(shè)置要在鎖定屏幕上顯示的替代通知。
NotificationRequest	setRemovalIntentAgent(IntentAgent removalIntentAgent)	設(shè)置當(dāng)用戶顯式刪除此通知時(shí)觸發(fā)的 IntentAgent 對(duì)象。
NotificationRequest	setSettingsText(String text)	設(shè)置將顯示為應(yīng)用程序設(shè)置鏈接的文本。
NotificationRequest	setShortcutId(String shortcutId)	設(shè)置此通知的快捷方式 ID。
NotificationRequest	setShowCreateTime(boolean showCreateTime)	已棄用。 此更改從 API 版本 2 開始生效。通知顯示的是交付時(shí)間，而不是創(chuàng)建時(shí)間。 請(qǐng)改用 setShowDeliveryTime(boolean)。
NotificationRequest	setShowDeliveryTime(boolean showDeliveryTime)	設(shè)置是否顯示此通知的通知傳遞時(shí)間。
NotificationRequest	setShowStopwatch(boolean isStopwatch)	設(shè)置是否將通知?jiǎng)?chuàng)建時(shí)間顯示為秒表。
NotificationRequest	setSlotId(String slotId)	設(shè)置通知的槽 ID 以綁定創(chuàng)建的 NotificationSlot 對(duì)象。
NotificationRequest	setSortingKey(String key)	設(shè)置用于對(duì)來自同一應(yīng)用程序包的通知進(jìn)行排序的鍵。
NotificationRequest	setStatusBarText(String statusBarText)	設(shè)置收到此通知時(shí)在狀態(tài)欄中顯示的滾動(dòng)文本。
NotificationRequest	setTapDismissed(boolean tapDismissed)	設(shè)置是否在被點(diǎn)擊后自動(dòng)關(guān)閉通知。
NotificationRequest	setUnremovable(boolean isUnremovable)	設(shè)置此通知是否不可刪除。
NotificationRequest	setVisibleness(int visibleness)	設(shè)置通知顯示效果，包括是否在鎖屏上顯示該通知，以及顯示后如何呈現(xiàn)。
String	toString()	返回對(duì)象的字符串表示形式。
boolean	unmarshalling(Parcel in)	從 Parcel 中解組 NotificationRequest 對(duì)象。

從類 java.lang.Object 繼承的方法
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

從接口 ohos.utils.Sequenceable 繼承的方法
hasFileDescriptor

字段詳細(xì)信息

BADGE_STYLE_BIG

public static final int BADGE_STYLE_BIG

表示此通知的標(biāo)記顯示為大圖標(biāo)。

Since:

4

BADGE_STYLE_LITTLE

public static final int BADGE_STYLE_LITTLE

表示此通知的標(biāo)記顯示為一個(gè)小圖標(biāo)。

Since:

4

BADGE_STYLE_NONE

public static final int BADGE_STYLE_NONE

表示此通知的標(biāo)記僅顯示數(shù)字。

Since:

4

CLASSIFICATION_ALARM

public static final String CLASSIFICATION_ALARM

指示警報(bào)或定時(shí)器的通知分類。

Since:

3

CLASSIFICATION_CALL

public static final String CLASSIFICATION_CALL

指示傳入呼叫或類似同步通信請(qǐng)求的通知分類。

Since:

3

CLASSIFICATION_EMAIL

public static final String CLASSIFICATION_EMAIL

指示電子郵件通知的分類。

Since:

3

CLASSIFICATION_ERROR

public static final String CLASSIFICATION_ERROR

指示在后臺(tái)操作或身份驗(yàn)證過程中發(fā)生的錯(cuò)誤通知的分類。

Since:

3

CLASSIFICATION_EVENT

public static final String CLASSIFICATION_EVENT

表示日歷事件通知的分類。表示日歷事件的通知分類。

Since:

3

CLASSIFICATION_MESSAGE

public static final String CLASSIFICATION_MESSAGE

指示短消息或即時(shí)消息的通知分類。

Since:

3

CLASSIFICATION_NAVIGATION

public static final String CLASSIFICATION_NAVIGATION

表示地圖導(dǎo)航通知的分類。

Since:

3

CLASSIFICATION_PROGRESS

public static final String CLASSIFICATION_PROGRESS

表示長(zhǎng)時(shí)間在后臺(tái)運(yùn)行的進(jìn)程的通知分類。

Since:

3

CLASSIFICATION_PROMO

public static final String CLASSIFICATION_PROMO

表示廣告或促銷信息通知的分類。

Since:

3

CLASSIFICATION_RECOMMENDATION

public static final String CLASSIFICATION_RECOMMENDATION

指示特定交易的具體及時(shí)建議的通知分類。

Since:

3

CLASSIFICATION_REMINDER

public static final String CLASSIFICATION_REMINDER

指示用戶先前設(shè)置的提醒的通知分類。

Since:

3

CLASSIFICATION_SERVICE

public static final String CLASSIFICATION_SERVICE

指示正在進(jìn)行的后臺(tái)服務(wù)的通知分類。

Since:

3

CLASSIFICATION_SOCIAL

public static final String CLASSIFICATION_SOCIAL

指示社交網(wǎng)絡(luò)或共享更新通知的分類。

Since:

3

CLASSIFICATION_STATUS

public static final String CLASSIFICATION_STATUS

指示有關(guān)設(shè)備和上下文狀態(tài)的持續(xù)信息的通知分類。

Since:

3

CLASSIFICATION_SYSTEM

public static final String CLASSIFICATION_SYSTEM

指示系統(tǒng)或設(shè)備狀態(tài)更新通知的分類。

Since:

3

CLASSIFICATION_TRANSPORT

public static final String CLASSIFICATION_TRANSPORT

表示播放過程中媒體傳輸控制的通知分類。

Since:

3

COLOR_DEFAULT

public static final int COLOR_DEFAULT

表示默認(rèn)通知背景顏色，即不顯示顏色。

Since:

3

EXTRA_USER_INPUT_HISTORY

public static final String EXTRA_USER_INPUT_HISTORY

getAdditionalData() 鍵：這是用戶輸入歷史記錄，提供給 setNotificationUserInputHistory(java.util.List)。

Since:

3

GROUP_ALERT_TYPE_ALL

public static final int GROUP_ALERT_TYPE_ALL

通知組警報(bào)類型，如果為關(guān)聯(lián)的 NotificationSlot 對(duì)象啟用聲音或振動(dòng)，則指示組中的所有通知都有聲音或振動(dòng)。

Since:

3

GROUP_ALERT_TYPE_CHILD

public static final int GROUP_ALERT_TYPE_CHILD

通知組警報(bào)類型，指示子通知有聲音或振動(dòng)，但如果為關(guān)聯(lián)的 NotificationSlot 對(duì)象啟用聲音或振動(dòng)，則組中的概覽通知會(huì)靜音（無聲音或振動(dòng)）。

Since:

3

GROUP_ALERT_TYPE_OVERVIEW

public static final int GROUP_ALERT_TYPE_OVERVIEW

通知組警報(bào)類型，指示概覽通知有聲音或振動(dòng)，但如果為關(guān)聯(lián)的 NotificationSlot 對(duì)象啟用聲音或振動(dòng)，則組中的子通知將靜音（無聲音或振動(dòng)）。

Since:

3

PRODUCER

public static final Sequenceable.ProducerNotificationRequest PRODUCER

從 Parcel 創(chuàng)建 NotificationRequest 實(shí)例。

Since:

4

VISIBLENESS_TYPE_NO_OVERRIDE

public static final int VISIBLENESS_TYPE_NO_OVERRIDE

表示未通過setVisibleness(int)設(shè)置通知顯示效果。 這種方法通常不使用。

Since:

3

VISIBLENESS_TYPE_PRIVATE

public static final int VISIBLENESS_TYPE_PRIVATE

表示鎖屏上只顯示應(yīng)用程序圖標(biāo)、應(yīng)用程序名稱等基本信息。

Since:

3

VISIBLENESS_TYPE_PUBLIC

public static final int VISIBLENESS_TYPE_PUBLIC

表示通知的內(nèi)容顯示在鎖定屏幕上。

Since:

3

VISIBLENESS_TYPE_SECRET

public static final int VISIBLENESS_TYPE_SECRET

表示通知不顯示在鎖定屏幕上。

Since:

3

構(gòu)造函數(shù)詳細(xì)信息

NotificationRequest

public NotificationRequest(NotificationRequest request)

用于通過從現(xiàn)有參數(shù)復(fù)制參數(shù)來創(chuàng)建 NotificationRequest 實(shí)例的構(gòu)造函數(shù)。

參數(shù)：

參數(shù)名稱	參數(shù)描述
request	指示現(xiàn)有的 NotificationRequest 對(duì)象。

Since:

1

NotificationRequest

public NotificationRequest()

用于創(chuàng)建 NotificationRequest 實(shí)例的默認(rèn)構(gòu)造函數(shù)。

Since:

1

NotificationRequest

public NotificationRequest(int notificationId)

一個(gè)構(gòu)造函數(shù)，用于創(chuàng)建一個(gè) NotificationRequest 實(shí)例，并傳遞了輸入?yún)?shù) notificationId。

參數(shù)：

參數(shù)名稱	參數(shù)描述
notificationId	通知ID，必須唯一。 您可以將其設(shè)置為任何 int 值。

Since:

1

NotificationRequest

public NotificationRequest(Context context, int notificationId)

用于根據(jù)指定的上下文和通知 ID 創(chuàng)建 NotificationRequest 實(shí)例的構(gòu)造函數(shù)。 要使用自定義視圖發(fā)布通知，您必須使用指定的 Context 調(diào)用此類構(gòu)造函數(shù)。

參數(shù)：

參數(shù)名稱	參數(shù)描述
context	指示當(dāng)前應(yīng)用程序或能力的上下文。 如果要發(fā)布帶有自定義視圖的通知，此參數(shù)不能為空。
notificationId	通知ID，必須唯一。 您可以將其設(shè)置為任何 int 值。

Since:

3

方法詳情

setCustomView

public NotificationRequest setCustomView(ComponentProvider view)

設(shè)置此通知的自定義視圖。

參數(shù)：

參數(shù)名稱	參數(shù)描述
view	表示定義自定義視圖的 ComponentProvider 對(duì)象。

返回:

返回具有自定義視圖的 NotificationRequest 對(duì)象。

Since:

3

getCustomView

public ComponentProvider getCustomView()

獲取定義此通知中設(shè)置的自定義視圖的 ComponentProvider 對(duì)象。 ComponentProvider 對(duì)象在 setCustomView(ohos.agp.components.ComponentProvider) 中設(shè)置。

返回:

返回定義自定義視圖的 ComponentProvider 對(duì)象。

Since:

3

setCustomBigView

public NotificationRequest setCustomBigView(ComponentProvider view)

設(shè)置展開此通知時(shí)要顯示的自定義視圖。

參數(shù)：

參數(shù)名稱	參數(shù)描述
view	表示定義自定義視圖的 ComponentProvider 對(duì)象。

返回:

返回具有自定義視圖的 NotificationRequest 對(duì)象。

Since:

3

getCustomBigView

public ComponentProvider getCustomBigView()

獲取定義此通知展開時(shí)要顯示的自定義視圖的 ComponentProvider 對(duì)象。 ComponentProvider 對(duì)象在 setCustomBigView(ohos.agp.components.ComponentProvider) 中設(shè)置。

返回:

返回定義自定義視圖的 ComponentProvider 對(duì)象。

Since:

3

setCustomFloatView

public NotificationRequest setCustomFloatView(ComponentProvider view)

設(shè)置當(dāng)此通知顯示為屏幕頂部的浮動(dòng)窗口時(shí)要顯示的自定義視圖。

參數(shù)：

參數(shù)名稱	參數(shù)描述
view	表示定義自定義視圖的 ComponentProvider 對(duì)象。

返回:

返回具有自定義視圖的 NotificationRequest 對(duì)象。

Since:

3

getCustomFloatView

public ComponentProvider getCustomFloatView()

獲取定義當(dāng)此通知顯示為屏幕頂部的浮動(dòng)窗口時(shí)要顯示的自定義視圖的 ComponentProvider 對(duì)象。 ComponentProvider 對(duì)象在 setCustomFloatView(ohos.agp.components.ComponentProvider) 中設(shè)置。

返回:

返回定義自定義視圖的 ComponentProvider 對(duì)象。

Since:

3

setOnlyLocal

public NotificationRequest setOnlyLocal(boolean flag)

設(shè)置此通知是否僅與本地設(shè)備相關(guān)，而不能在遠(yuǎn)程設(shè)備上顯示。 該方法僅對(duì)調(diào)用 NotificationHelper#publishNotification(NotificationRequest) 或 NotificationHelper#publishNotification(String, NotificationRequest) 發(fā)布的通知生效。 在分布式系統(tǒng)中使用 NotificationHelper#publishNotification(NotificationRequest, String) 發(fā)布的通知不會(huì)受到影響。

參數(shù)：

參數(shù)名稱	參數(shù)描述
flag	指定此通知是否只能在本地設(shè)備上顯示。 true 表示只能在本地設(shè)備上顯示，false 表示也可以在遠(yuǎn)程設(shè)備上顯示。

返回:

返回具有指定標(biāo)志的 NotificationRequest 對(duì)象。

Since:

3

isOnlyLocal

public boolean isOnlyLocal()

檢查此通知是否僅與本地設(shè)備相關(guān)，不能在遠(yuǎn)程設(shè)備上顯示。

返回:

如果此通知僅與本地設(shè)備相關(guān)，則返回 true； 否則返回 false。

Since:

3

setSortingKey

public NotificationRequest setSortingKey(String key)

設(shè)置用于對(duì)來自同一應(yīng)用程序包的通知進(jìn)行排序的鍵。

參數(shù)：

參數(shù)名稱	參數(shù)描述
key	表示要設(shè)置的鍵。

返回:

返回具有指定鍵的 NotificationRequest 對(duì)象。

Since:

3

getSortingKey

public String getSortingKey()

獲取用于對(duì)來自同一應(yīng)用程序包的通知進(jìn)行排序的密鑰。

返回:

返回排序通知的鍵。

Since:

3

getAutoDeletedTime

public long getAutoDeletedTime()

獲取通知被刪除的時(shí)間。

返回:

返回以毫秒為單位的周期。

Since:

1

getNotificationHashCode

public String getNotificationHashCode()

獲取當(dāng)前應(yīng)用中通知的唯一哈希碼。

要獲取有效的哈希碼，您必須已訂閱并收到通知。 有效的通知哈希碼是由多個(gè)屬性組成的字符串，由下劃線 (_) 分隔，包括通知 ID、創(chuàng)建者捆綁包名稱、創(chuàng)建者 UID 和所有者捆綁包名稱。

返回:

返回通知的哈希碼。

Since:

1

setLittleIcon

public NotificationRequest setLittleIcon(PixelMap littleIcon)

設(shè)置通知的小圖標(biāo)。

參數(shù)：

參數(shù)名稱	參數(shù)描述
littleIcon	表示通知的圖標(biāo)。

返回:

返回具有指定圖標(biāo)的 NotificationRequest 對(duì)象。

Since:

1

getLittleIcon

public PixelMap getLittleIcon()

獲取通知的圖標(biāo)。

返回:

返回通知圖標(biāo)。

Since:

1

setBigIcon

public NotificationRequest setBigIcon(PixelMap bigIcon)

設(shè)置此通知的大圖標(biāo)，通常顯示在通知的右側(cè)。

參數(shù)：

參數(shù)名稱	參數(shù)描述
bigIcon	表示要設(shè)置的大圖標(biāo)。 它必須是一個(gè) PixelMap 對(duì)象。

返回:

返回具有指定 bigIcon 設(shè)置的 NotificationRequest 對(duì)象。

Since:

3

getBigIcon

public PixelMap getBigIcon()

獲取該通知的大圖標(biāo)。

返回:

返回此通知的大圖標(biāo)。

Since:

3

setAutoDeletedTime

public NotificationRequest setAutoDeletedTime(long time)

設(shè)置刪除通知的時(shí)間。

參數(shù)：

參數(shù)名稱	參數(shù)描述
time	以毫秒為單位表示時(shí)間。 默認(rèn)值為0，表示不會(huì)自動(dòng)刪除通知。 要使通知自動(dòng)刪除，請(qǐng)將此參數(shù)設(shè)置為大于0的整數(shù)。

返回:

返回指定時(shí)間的 NotificationRequest 對(duì)象。

Since:

1

isTapDismissed

public boolean isTapDismissed()

檢查當(dāng)前通知是否會(huì)在被點(diǎn)擊后自動(dòng)關(guān)閉。

返回:

如果通知將被自動(dòng)關(guān)閉，則返回 true； 否則返回 false。

Since:

1

setTapDismissed

public NotificationRequest setTapDismissed(boolean tapDismissed)

設(shè)置是否在被點(diǎn)擊后自動(dòng)關(guān)閉通知。

如果將 tapDismissed 設(shè)置為 true，則必須調(diào)用 setIntentAgent(ohos.event.intentagent.IntentAgent) 方法才能使設(shè)置生效。

參數(shù)：

參數(shù)名稱	參數(shù)描述
tapDismissed	指定是否在點(diǎn)擊后自動(dòng)關(guān)閉通知。 true 表示已關(guān)閉，false 表示未關(guān)閉。

返回:

返回具有指定的 tapDismissed 設(shè)置的 NotificationRequest 對(duì)象。

Since:

1

getCreateTime

@Deprecated public long getCreateTime()

已棄用。 此更改從 API 版本 2 開始生效。初始化 NotificationRequest 的時(shí)間對(duì)公眾是不可訪問的。 要獲取發(fā)送通知的時(shí)間，請(qǐng)調(diào)用 getDeliveryTime() 方法。

獲取創(chuàng)建通知的時(shí)間。

返回:

返回以毫秒為單位的時(shí)間。

Since:

1

setCreateTime

@Deprecated public NotificationRequest setCreateTime(long createTime)

已棄用。 此更改從 API 版本 2 開始生效。 createTime 在初始化 NotificationRequest 時(shí)占用系統(tǒng)時(shí)間。

設(shè)置創(chuàng)建通知的時(shí)間。初始化的 NotificationRequest 中的默認(rèn)時(shí)間是初始化的時(shí)間。

參數(shù)：

參數(shù)名稱	參數(shù)描述
createTime	以毫秒為單位表示時(shí)間。

返回:

返回具有指定 createTime 的 NotificationRequest 對(duì)象。

Since:

1

isShowCreateTime

@Deprecated public boolean isShowCreateTime()

已棄用。 此更改從 API 版本 2 開始生效。請(qǐng)改用 isShowDeliveryTime()。 通知顯示它的發(fā)送時(shí)間，而不是它的創(chuàng)建時(shí)間。

檢查是否顯示此通知的通知?jiǎng)?chuàng)建時(shí)間。

返回:

如果顯示時(shí)間，則返回 true； 否則返回 false。

Since:

1

setShowCreateTime

@Deprecated public NotificationRequest setShowCreateTime(boolean showCreateTime)

已棄用。 此更改從 API 版本 2 開始生效。通知顯示的是交付時(shí)間，而不是創(chuàng)建時(shí)間。 請(qǐng)改用 setShowDeliveryTime(boolean)。

設(shè)置是否顯示此通知的通知?jiǎng)?chuàng)建時(shí)間。 此方法僅在通過調(diào)用 setCreateTime(long) 設(shè)置通知?jiǎng)?chuàng)建時(shí)間時(shí)有效。

參數(shù)：

參數(shù)名稱	參數(shù)描述
showCreateTime	指定是否顯示通知?jiǎng)?chuàng)建時(shí)間。 true 表示顯示，false 表示不顯示。

返回:

返回具有指定 showCreateTime 設(shè)置的 NotificationRequest 對(duì)象。

Since:

1

isShowDeliveryTime

public boolean isShowDeliveryTime()

檢查是否顯示此通知的通知傳遞時(shí)間。

返回:

如果顯示時(shí)間，則返回 true； 否則返回 false。

Since:

4

setShowDeliveryTime

public NotificationRequest setShowDeliveryTime(boolean showDeliveryTime)

設(shè)置是否顯示此通知的通知傳遞時(shí)間。 該方法僅在調(diào)用 setDeliveryTime(long) 設(shè)置了通知發(fā)送時(shí)間時(shí)有效。

參數(shù)：

參數(shù)名稱	參數(shù)描述
showDeliveryTime	指定是否顯示通知傳遞時(shí)間。 true 表示顯示，false 表示不顯示。

返回:

返回具有指定 showDeliveryTime 設(shè)置的 NotificationRequest 對(duì)象。

Since:

4

getDeliveryTime

public long getDeliveryTime()

獲取通知下發(fā)的時(shí)間。

返回:

返回以毫秒為單位的時(shí)間。

Since:

1

setDeliveryTime

public NotificationRequest setDeliveryTime(long deliveryTime)

設(shè)置發(fā)送通知的時(shí)間。

參數(shù)：

參數(shù)名稱	參數(shù)描述
deliveryTime	以毫秒為單位表示時(shí)間。

返回:

返回具有指定交付時(shí)間的 NotificationRequest 對(duì)象。

Since:

1

getIntentAgent

public IntentAgent getIntentAgent()

獲取此通知中包含的 IntentAgent。

返回:

返回此通知中包含的 IntentAgent。

Since:

3

setIntentAgent

public NotificationRequest setIntentAgent(IntentAgent agent)

向此通知添加 IntentAgent。

一個(gè)通知被點(diǎn)擊后，后續(xù)的操作，如能力和普通事件，將按照 IntentAgent 的設(shè)置觸發(fā)。

參數(shù)：

參數(shù)名稱	參數(shù)描述
agent	表示點(diǎn)擊通知觸發(fā)的操作，可以通過IntentAgent設(shè)置。

返回:

返回具有指定代理的 NotificationRequest 對(duì)象。

Since:

3

getNotificationId

public int getNotificationId()

獲取通知ID，在當(dāng)前應(yīng)用中是唯一的。

返回:

返回通知 ID。

Since:

1

getSlotId

public String getSlotId()

通過調(diào)用setSlotId(java.lang.String)方法獲取通知集的槽位ID。

返回:

返回通知槽 ID。

Since:

1

setNotificationId

public NotificationRequest setNotificationId(int notificationId)

設(shè)置當(dāng)前通知 ID 以唯一標(biāo)識(shí)應(yīng)用程序中的通知。

收到通知后，通過 getNotificationId() 方法獲取其 ID。

參數(shù)：

參數(shù)名稱	參數(shù)描述
notificationId	表示要設(shè)置的通知的ID。 您可以將其設(shè)置為任何 int 值。

返回:

返回具有指定 notificationId 的 NotificationRequest 對(duì)象。

Since:

1

setSlotId

public NotificationRequest setSlotId(String slotId)

設(shè)置通知的槽 ID 以綁定創(chuàng)建的 NotificationSlot 對(duì)象。

您可以使用 NotificationSlot 創(chuàng)建一個(gè) slot 對(duì)象，然后設(shè)置通知振動(dòng)和鎖屏顯示，并使用 current 方法綁定 slot。

參數(shù)：

參數(shù)名稱	參數(shù)描述
slotId	NotificationSlot 對(duì)象的唯一標(biāo)識(shí)。 該值必須是現(xiàn)有 NotificationSlot 對(duì)象的 ID。 否則，此方法不生效。

返回:

返回具有指定 slotId 的 NotificationRequest 對(duì)象。

Since:

1

getContent

public NotificationRequest.NotificationContent getContent()

調(diào)用setContent(ohos.event.notification.NotificationRequest.NotificationContent)方法獲取通知內(nèi)容集。

返回:

返回通知內(nèi)容。

Since:

1

setContent

public NotificationRequest setContent(NotificationRequest.NotificationContent content)

將通知內(nèi)容類型設(shè)置為 NotificationRequest.NotificationNormalContent、NotificationRequest.NotificationLongTextContent 或 NotificationRequest.NotificationPictureContent。

每個(gè)內(nèi)容類型表示一個(gè)特定的通知內(nèi)容。

參數(shù)：

參數(shù)名稱	參數(shù)描述
content	指示通知內(nèi)容類型。

返回:

返回具有指定內(nèi)容的 NotificationRequest 對(duì)象。

Since:

1

setAdditionalData

public NotificationRequest setAdditionalData(IntentParams extras)

設(shè)置存儲(chǔ)為通知的鍵值對(duì)的額外參數(shù)。

參數(shù)：

參數(shù)名稱	參數(shù)描述
extras	表示包含鍵值對(duì)格式的額外參數(shù)的 IntentParams 對(duì)象。

返回:

返回包含由 extras 指定的額外參數(shù)的 NotificationRequest 對(duì)象。

Since:

2

getAdditionalData

public IntentParams getAdditionalData()

獲取通知中設(shè)置的 IntentParams 對(duì)象。

返回:

返回 IntentParams 對(duì)象。

Since:

2

setSettingsText

public NotificationRequest setSettingsText(String text)

設(shè)置將顯示為應(yīng)用程序設(shè)置鏈接的文本。

如果通過 setContent(ohos.event.notification.NotificationRequest.NotificationContent) 在 NotificationRequest 對(duì)象中將通知內(nèi)容類型設(shè)置為 NotificationRequest.NotificationLongTextContent 或 NotificationRequest.NotificationPictureContent，則調(diào)用該方法無效。

參數(shù)：

參數(shù)名稱	參數(shù)描述
text	指示要包含的文本。 您可以將其設(shè)置為任何有效的鏈接。

返回:

返回具有指定文本的 NotificationRequest 對(duì)象。

Since:

2

getSettingsText

public String getSettingsText()

獲取將顯示為應(yīng)用程序設(shè)置鏈接的文本。

返回:

返回顯示為應(yīng)用程序設(shè)置鏈接的文本。

Since:

2

getNotificationType

public int getNotificationType()

獲取通知類型。

返回:

返回當(dāng)前通知的類型，可以是 NotificationContent#NOTIFICATION_CONTENT_BASIC_TEXT、NotificationContent#NOTIFICATION_CONTENT_LONG_TEXT、NotificationContent#NOTIFICATION_CONTENT_PICTURE、NotificationContent#NOTIFICATION_CONTENT_CONVERSATION、NotificationContent#NOTIFICATION_CONTENT_MULTILINE 或 NotificationContent#NOTIFICATION_CONTENT_MEDIA。

Since:

2

getCreatorBundleName

public String getCreatorBundleName()

獲取通知?jiǎng)?chuàng)建者的包名。

通知?jiǎng)?chuàng)建者是指發(fā)布通知的應(yīng)用程序。

返回:

返回通知?jiǎng)?chuàng)建者的包名稱。

Since:

2

getOwnerBundleName

public String getOwnerBundleName()

獲取通知所有者的捆綁包名稱。

通知所有者是指訂閱通知的應(yīng)用程序。

返回:

返回通知所有者的包名稱。

Since:

2

getCreatorPid

public int getCreatorPid()

獲取通知?jiǎng)?chuàng)建者的PID。

通知?jiǎng)?chuàng)建者是指發(fā)布通知的應(yīng)用程序。

返回:

返回通知?jiǎng)?chuàng)建者的 PID。

Since:

2

getCreatorUid

public int getCreatorUid()

獲取通知?jiǎng)?chuàng)建者的 UID。

通知?jiǎng)?chuàng)建者是指發(fā)布通知的應(yīng)用程序。

返回:

返回通知?jiǎng)?chuàng)建者的 UID。

Since:

2

getGroupValue

public String getGroupValue()

獲取本次通知的組信息。

返回:

返回有關(guān)此通知的組信息。

Since:

3

setGroupValue

public NotificationRequest setGroupValue(String groupValue)

設(shè)置此通知的組信息。

如果沒有為通知設(shè)置組，來自同一應(yīng)用程序的所有通知將在通知欄中顯示為一個(gè)堆棧，并顯示堆棧的通知數(shù)量。 如果通知被分組并且有多個(gè)由不同 groupValue 標(biāo)識(shí)的組，則具有不同 groupValue 的通知將出現(xiàn)在不同的堆棧中。

請(qǐng)注意，必須通過調(diào)用 setGroupOverview(boolean) 將組中的一個(gè)通知設(shè)置為其組的概覽，其他通知視為子通知。 否則，即使通過調(diào)用 setGroupValue(java.lang.String) 為它們分配了相同的 groupValue，通知也不會(huì)顯示為一組。

參數(shù)：

參數(shù)名稱	參數(shù)描述
groupValue	指示要為此通知設(shè)置的組值。

返回:

返回具有指定 groupValue 的 NotificationRequest 對(duì)象。

Since:

3

getGroupAlertType

public int getGroupAlertType()

獲取該通知的群組告警類型。

返回:

返回此通知的組警報(bào)類型。

Since:

3

setGroupAlertType

public NotificationRequest setGroupAlertType(int groupAlertType)

設(shè)置此通知的組警報(bào)類型，這決定了組概述和組中其他通知的發(fā)布方式。

必須通過調(diào)用 setGroupValue(java.lang.String) 設(shè)置組信息。 否則，此方法不生效。

參數(shù)：

參數(shù)名稱	參數(shù)描述
groupAlertType	指示要設(shè)置的組警報(bào)類型，可以是 GROUP_ALERT_TYPE_ALL（默認(rèn)值）、GROUP_ALERT_TYPE_OVERVIEW 或 GROUP_ALERT_TYPE_CHILD。

返回:

返回具有指定 groupAlertType 的 NotificationRequest 對(duì)象。

Since:

3

isGroupOverview

public boolean isGroupOverview()

檢查此通知是否為組概覽。

返回:

如果此通知是組概述，則返回 true； 否則返回 false。

Since:

3

setGroupOverview

public NotificationRequest setGroupOverview(boolean groupOverview)

設(shè)置是否將此通知用作其組的概述。 此方法通過調(diào)用 setGroupValue(java.lang.String) 作為通知欄中的一個(gè)堆棧來幫助顯示分配了相同組值的通知。

每個(gè)組只需要一個(gè)組概覽。 將通知設(shè)置為組概覽后，如果同一組中的另一個(gè)通知發(fā)布，則該通知將變?yōu)椴豢梢姟?/p>

參數(shù)：

參數(shù)名稱	參數(shù)描述
groupOverview	指定是否將此通知設(shè)置為組概覽。 值 true 表示它是組概覽，值 false 表示不是。

返回:

返回具有指定 groupOverview 設(shè)置的 NotificationRequest 對(duì)象。

Since:

3

getRemovalIntentAgent

public IntentAgent getRemovalIntentAgent()

獲取用戶顯式移除此通知時(shí)觸發(fā)的 IntentAgent 對(duì)象。

返回:

返回要觸發(fā)的 IntentAgent 對(duì)象。

Since:

3

setRemovalIntentAgent

public NotificationRequest setRemovalIntentAgent(IntentAgent removalIntentAgent)

設(shè)置當(dāng)用戶顯式刪除此通知時(shí)觸發(fā)的 IntentAgent 對(duì)象。

參數(shù)：

參數(shù)名稱	參數(shù)描述
removalIntentAgent	指示要觸發(fā)的 IntentAgent 對(duì)象。

返回:

返回具有指定removingIntentAgent 的NotificationRequest 對(duì)象。

Since:

3

getClassification

public String getClassification()

獲取此通知的分類。

返回:

返回此通知的分類。

Since:

3

setClassification

public NotificationRequest setClassification(String classification)

設(shè)置此通知的分類，描述此通知的用途。 通知分類用于過濾和排序通知。

參數(shù)：

參數(shù)名稱	參數(shù)描述
classification	表示系統(tǒng)預(yù)定義的通知分類，如CLASSIFICATION_CALL或CLASSIFICATION_NAVIGATION。

返回:

返回具有指定分類的 NotificationRequest 對(duì)象。

Since:

3

getMaxScreenIntentAgent

public IntentAgent getMaxScreenIntentAgent()

調(diào)用setMaxScreenIntentAgent(ohos.event.intentagent.IntentAgent)獲取全屏IntentAgent集合。

返回:

返回全屏 IntentAgent。

Since:

3

setMaxScreenIntentAgent

public NotificationRequest setMaxScreenIntentAgent(IntentAgent maxScreenIntentAgent)

將 IntentAgent 設(shè)置為在設(shè)備未使用時(shí)啟動(dòng)，而不是在狀態(tài)欄中顯示此通知。

設(shè)備在使用時(shí)，系統(tǒng)UI會(huì)彈出通知，而不是啟動(dòng)maxScreenIntentAgent指定的IntentAgent。

您的應(yīng)用程序必須具有 ohos.permission.USE_WHOLE_SCREEN 權(quán)限才能使用此方法。

參數(shù)：

參數(shù)名稱	參數(shù)描述
maxScreenIntentAgent	指示 IntentAgent 對(duì)象，其中包含有關(guān)使用 Page 模板的待啟動(dòng)能力的信息。

返回:

返回具有指定 maxScreenIntentAgent 的 NotificationRequest 對(duì)象。

Since:

3

getColor

public int getColor()

獲取此通知的背景顏色。

返回值除默認(rèn)顏色COLOR_DEFAULT外，為0xFF000000與setColor(int)設(shè)置的ARGB值的按位或運(yùn)算結(jié)果。

返回:

返回此通知的背景顏色。

Since:

3

setColor

public NotificationRequest setColor(int color)

設(shè)置此通知的背景顏色。 此方法僅在通過調(diào)用 setColorEnabled(boolean) 啟用背景顏色時(shí)有效。

參數(shù)：

參數(shù)名稱	參數(shù)描述
color	指示要設(shè)置的背景顏色。

返回:

返回具有指定顏色的 NotificationRequest 對(duì)象。

Since:

3

isColorEnabled

public boolean isColorEnabled()

檢查是否為此通知啟用了背景顏色。

返回:

如果啟用背景顏色，則返回 true； 否則返回 false。

Since:

3

setColorEnabled

public NotificationRequest setColorEnabled(boolean colorEnabled)

設(shè)置是否為此通知啟用背景顏色。

如果 colorEnabled 設(shè)置為 true，則此方法僅在通過 NotificationRequest#setContent(NotificationContent) 將 NotificationRequest 對(duì)象中的通知內(nèi)容類型設(shè)置為 NotificationRequest.NotificationMediaContent 并且已通過 NotificationMediaContent#setAVToken( AVToken）。

參數(shù)：

參數(shù)名稱	參數(shù)描述
colorEnabled	指定是否啟用背景顏色。 值 true 表示將啟用背景顏色，值 false 表示不啟用。

返回:

返回具有指定 colorEnabled 設(shè)置的 NotificationRequest 對(duì)象。

Since:

3

getBadgeNumber

public int getBadgeNumber()

獲取要為此通知顯示的編號(hào)。

返回:

返回要為此通知顯示的數(shù)字。

Since:

3

setBadgeNumber

public NotificationRequest setBadgeNumber(int number)

設(shè)置要為此通知顯示的數(shù)字。

參數(shù)：

參數(shù)名稱	參數(shù)描述
number	表示要設(shè)置的數(shù)字。

返回:

返回具有指定編號(hào)的 NotificationRequest 對(duì)象。

Since:

3

isAlertOneTime

public boolean isAlertOneTime()

檢查此通知是否設(shè)置為僅提醒一次，這意味著在更新具有相同 ID 的通知時(shí)將不再播放聲音或振動(dòng)。

返回:

如果此通知設(shè)置為僅提醒一次，則返回 true； 否則返回 false。

Since:

3

setAlertOneTime

public NotificationRequest setAlertOneTime(boolean isAlertOnce)

設(shè)置是否只有一次通知提醒。 如果一個(gè)通知只提醒一次，同一個(gè) ID 的通知在發(fā)布后更新時(shí)將不再播放聲音或振動(dòng)。

參數(shù)：

參數(shù)名稱	參數(shù)描述
isAlertOnce	指定是否只有一次通知警報(bào)。 值 true 表示該通知將只提示一次，值 false 表示不會(huì)。

返回:

返回具有指定 isAlertOnce 設(shè)置的 NotificationRequest 對(duì)象。

Since:

3

isShowStopwatch

public boolean isShowStopwatch()

檢查通知?jiǎng)?chuàng)建時(shí)間是否顯示為秒表。

返回:

如果時(shí)間顯示為秒表，則返回 true； 否則返回 false。

Since:

3

setShowStopwatch

public NotificationRequest setShowStopwatch(boolean isStopwatch)

設(shè)置是否將通知?jiǎng)?chuàng)建時(shí)間顯示為秒表。 此方法僅在通過調(diào)用 setDeliveryTime(long) 設(shè)置通知?jiǎng)?chuàng)建時(shí)間時(shí)有效。

當(dāng)通知?jiǎng)?chuàng)建時(shí)間設(shè)置為顯示為秒表時(shí)，當(dāng)前時(shí)間與 setDeliveryTime(long) 設(shè)置的創(chuàng)建時(shí)間之間的時(shí)間間隔以分鐘：秒格式動(dòng)態(tài)顯示此通知。 如果間隔時(shí)間超過 60 分鐘，將以小時(shí)：分鐘：秒格式顯示。 如果該方法和setShowDeliveryTime(boolean)都設(shè)置為true，則只有該方法生效，即通知?jiǎng)?chuàng)建時(shí)間會(huì)顯示為秒表。

參數(shù)：

參數(shù)名稱	參數(shù)描述
isStopwatch	指定是否將通知?jiǎng)?chuàng)建時(shí)間顯示為秒表。 值 true 表示它顯示為秒表，值 false 表示不顯示。

返回:

返回具有指定 isStopwatch 設(shè)置的 NotificationRequest 對(duì)象。

Since:

3

isCountdownTimer

public boolean isCountdownTimer()

檢查通知?jiǎng)?chuàng)建時(shí)間是否顯示為倒計(jì)時(shí)。

返回:

如果時(shí)間顯示為倒數(shù)計(jì)時(shí)器，則返回 true； 否則返回 false。

Since:

3

setCountdownTimer

public NotificationRequest setCountdownTimer(boolean isCountDown)

設(shè)置是否將通知?jiǎng)?chuàng)建時(shí)間顯示為倒計(jì)時(shí)。 此方法僅在 setShowStopwatch(boolean) 設(shè)置為 true 時(shí)有效。

參數(shù)：

參數(shù)名稱	參數(shù)描述
isCountDown	指定是否將通知?jiǎng)?chuàng)建時(shí)間顯示為倒計(jì)時(shí)。 值 true 表示它顯示為倒數(shù)計(jì)時(shí)器，值 false 表示不顯示。

返回:

返回具有指定 isCountDown 設(shè)置的 NotificationRequest 對(duì)象。

Since:

3

isInProgress

public boolean isInProgress()

檢查此通知是否正在進(jìn)行中。

返回:

如果此通知正在進(jìn)行，則返回 true； 否則返回 false。

Since:

3

setInProgress

public NotificationRequest setInProgress(boolean isOngoing)

設(shè)置此通知是否正在進(jìn)行中。

用戶不能直接關(guān)閉正在進(jìn)行的通知，因?yàn)樗鼈兺ǔ０恍┱谶M(jìn)行的后臺(tái)服務(wù)，例如音樂播放。

參數(shù)：

參數(shù)名稱	參數(shù)描述
isOngoing	指定此通知是否正在進(jìn)行中。 值 true 表示通知正在進(jìn)行中，值 false 表示沒有。

返回:

返回具有指定 isOngoing 設(shè)置的 NotificationRequest 對(duì)象。

Since:

3

getVisibleness

public int getVisibleness()

獲取該通知在鎖屏?xí)r的顯示效果。

返回:

返回此通知在鎖屏?xí)r的顯示效果。

Since:

3

setVisibleness

public NotificationRequest setVisibleness(int visibleness)

設(shè)置通知顯示效果，包括是否在鎖屏上顯示該通知，以及顯示后如何呈現(xiàn)。

如果為NotificationRequest對(duì)象及其關(guān)聯(lián)的NotificationSlot對(duì)象設(shè)置了鎖屏顯示效果，則以NotificationRequest對(duì)象中設(shè)置的顯示效果為準(zhǔn)。

參數(shù)：

參數(shù)名稱	參數(shù)描述
visibleness	表示鎖屏上的通知顯示效果，可設(shè)置為VISIBLENESS_TYPE_PUBLIC、VISIBLENESS_TYPE_PRIVATE、VISIBLENESS_TYPE_SECRET或VISIBLENESS_TYPE_NO_OVERRIDE。

返回:

返回具有指定可見性的 NotificationRequest 對(duì)象。

Since:

3

getProgressValue

public int getProgressValue()

獲取此通知的進(jìn)度條顯示的當(dāng)前值。

返回:

返回通知進(jìn)度條的當(dāng)前值。

Since:

3

getProgressMax

public int getProgressMax()

獲取此通知的進(jìn)度條顯示的最大值。

返回:

返回通知進(jìn)度條的最大值。

Since:

3

isProgressIndeterminate

public boolean isProgressIndeterminate()

檢查此通知的進(jìn)度條是否不確定。

返回:

如果通知進(jìn)度條不確定，則返回 true； 否則返回 false。

Since:

3

setProgressBar

public NotificationRequest setProgressBar(int progress, int progressMax, boolean indeterminate)

設(shè)置此通知的進(jìn)度條顯示方式。

進(jìn)度條通常用于下載等通知場(chǎng)景。

參數(shù)：

參數(shù)名稱	參數(shù)描述
progress	指示通知進(jìn)度條顯示的當(dāng)前值。
progressMax	表示通知進(jìn)度條顯示的最大值。
indeterminate	指定進(jìn)度條是否不確定。 值 true 表示進(jìn)度條是不確定的，用戶看不到它的當(dāng)前值和最大值。

返回:

返回具有指定進(jìn)度、progressMax 和不確定設(shè)置的 NotificationRequest 對(duì)象。

Since:

3

getStatusBarText

public String getStatusBarText()

獲取收到此通知時(shí)將在狀態(tài)欄中顯示的滾動(dòng)文本。

返回:

返回滾動(dòng)通知文本。

Since:

3

setStatusBarText

public NotificationRequest setStatusBarText(String statusBarText)

設(shè)置收到此通知時(shí)在狀態(tài)欄中顯示的滾動(dòng)文本。

參數(shù)：

參數(shù)名稱	參數(shù)描述
statusBarText	指示要顯示的滾動(dòng)文本。

返回:

返回具有指定 statusBarText 的 NotificationRequest 對(duì)象。

Since:

3

isUnremovable

public boolean isUnremovable()

檢查此通知是否不可刪除。

返回:

如果此通知不可移除，則返回 true； 否則返回 false。

Since:

3

setUnremovable

public NotificationRequest setUnremovable(boolean isUnremovable)

設(shè)置此通知是否不可刪除。

如果設(shè)置為不可移除，則用戶無法移除。

參數(shù)：

參數(shù)名稱	參數(shù)描述
isUnremovable	指定此通知是否不可刪除。 true 表示不可移除，false 表示可移除。

返回:

返回具有指定 isUnremovable 設(shè)置的 NotificationRequest 對(duì)象。

Since:

3

isFloatingIcon

public boolean isFloatingIcon()

檢查此通知是否顯示為屏幕頂部的浮動(dòng)圖標(biāo)。

返回:

如果此通知顯示為浮動(dòng)圖標(biāo)，則返回 true； 否則返回 false。

Since:

3

addActionButton

public NotificationRequest addActionButton(NotificationActionButton actionButton)

向此通知添加 NotificationActionButton。 系統(tǒng)通常會(huì)在通知內(nèi)容旁邊放置操作按鈕。

每個(gè)操作按鈕必須包含一個(gè)圖標(biāo)、一個(gè)標(biāo)題和一個(gè) IntentAgent。 展開通知時(shí)，最多可以按添加順序從左到右顯示三個(gè)操作按鈕。 折疊通知時(shí)，不會(huì)顯示任何操作按鈕。

參數(shù)：

參數(shù)名稱	參數(shù)描述
actionButton	指示要添加的 NotificationActionButton 對(duì)象。

返回:

返回具有指定 actionButton 的 NotificationRequest 對(duì)象。

Since:

3

getActionButtons

public ListNotificationActionButton getActionButtons()

獲取包含在此通知中的所有 NotificationActionButton 對(duì)象的列表。

返回:

返回 NotificationActionButton 對(duì)象的列表。

Since:

3

setPublicNotification

public NotificationRequest setPublicNotification(NotificationRequest request)

為此通知設(shè)置要在鎖定屏幕上顯示的替代通知。 顯示效果（是否以及如何顯示此替代通知）取決于 NotificationSlot#setLockscreenVisibleness(int) 中的配置。

參數(shù)：

參數(shù)名稱	參數(shù)描述
request	指示要在鎖定屏幕上顯示的替代通知。

返回:

返回具有指定請(qǐng)求的 NotificationRequest 對(duì)象。

Since:

3

setPermitSystemGeneratedContextualActionButtons

public NotificationRequest setPermitSystemGeneratedContextualActionButtons(boolean permitted)

設(shè)置是否允許平臺(tái)為此通知生成上下文 NotificationActionButton 對(duì)象。

參數(shù)：

參數(shù)名稱	參數(shù)描述
permitted	指定是否允許平臺(tái)生成上下文 NotificationActionButton 對(duì)象。 默認(rèn)值 true 表示允許平臺(tái)生成上下文操作按鈕，值 false 表示不允許。

返回:

返回具有指定允許設(shè)置的 NotificationRequest 對(duì)象。

Since:

3

isPermitSystemGeneratedContextualActionButtons

public boolean isPermitSystemGeneratedContextualActionButtons()

檢查是否允許平臺(tái)為此通知生成上下文 NotificationActionButton 對(duì)象。

返回:

如果允許平臺(tái)生成上下文 NotificationActionButton 對(duì)象，則返回 true； 否則返回 false。

Since:

3

setNotificationUserInputHistory

public NotificationRequest setNotificationUserInputHistory(ListString text)

設(shè)置已通過此通知發(fā)送的最新 NotificationUserInput 記錄。

最近的輸入必須存儲(chǔ)在索引 0 中，第二最近的輸入必須存儲(chǔ)在索引 1 中，依此類推。 系統(tǒng)最多顯示五個(gè)輸入。

參數(shù)：

參數(shù)名稱	參數(shù)描述
text	指示要設(shè)置的輸入列表。

返回:

返回具有指定文本的 NotificationRequest 對(duì)象。

Since:

3

getMessageUsers

public ListMessageUser getMessageUsers()

獲取與此通知關(guān)聯(lián)的所有 MessageUser 對(duì)象。

返回:

返回與此通知關(guān)聯(lián)的 MessageUser 對(duì)象列表。

Since:

3

addMessageUser

public NotificationRequest addMessageUser(MessageUser messageUser)

添加一個(gè) MessageUser 對(duì)象并將其與此通知相關(guān)聯(lián)。

參數(shù)：

參數(shù)名稱	參數(shù)描述
messageUser	指示要添加的 MessageUser 對(duì)象。

返回:

返回具有指定 messageUser 的 NotificationRequest 對(duì)象。

Since:

3

getLabel

public String getLabel()

獲取此通知的標(biāo)簽。

標(biāo)簽是通過 NotificationHelper#publishNotification(String, NotificationRequest) 設(shè)置的。 如果沒有為此通知設(shè)置特定標(biāo)簽，則此方法返回 null。

返回:

返回此通知的標(biāo)簽。

Since:

4

setBadgeIconStyle

public NotificationRequest setBadgeIconStyle(int badgeIconStyle)

設(shè)置此通知的徽章圖標(biāo)樣式。

如果主屏幕不支持徽章圖標(biāo)，此方法無效。

參數(shù)：

參數(shù)名稱	參數(shù)描述
badgeIconStyle	指示要為此通知顯示的徽章圖標(biāo)的類型。 該值必須是 BADGE_STYLE_NONE、BADGE_STYLE_LITTLE 或 BADGE_STYLE_BIG。

返回:

返回具有指定 badgeIconStyle 的 NotificationRequest 對(duì)象。

Since:

4

getBadgeIconStyle

public int getBadgeIconStyle()

獲取該通知的徽章圖標(biāo)樣式。

返回:

返回此通知的徽章圖標(biāo)樣式。

Since:

4

setShortcutId

public NotificationRequest setShortcutId(String shortcutId)

設(shè)置此通知的快捷方式 ID。

為通知設(shè)置快捷ID后，該通知將與相應(yīng)的主屏幕快捷方式關(guān)聯(lián)，當(dāng)Home應(yīng)用顯示通知的徽章或內(nèi)容時(shí)，該快捷方式將被隱藏。

參數(shù)：

參數(shù)名稱	參數(shù)描述
shortcutId	表示要設(shè)置的快捷方式ID。

返回:

返回具有指定快捷方式Id 的 NotificationRequest 對(duì)象。

Since:

4

getShortcutId

public String getShortcutId()

獲取與此通知關(guān)聯(lián)的快捷方式 ID。

返回:

返回此通知的快捷方式 ID。

Since:

4

marshalling

public boolean marshalling(Parcel out)

將 NotificationRequest 對(duì)象編組到 Parcel 中。

進(jìn)程可以調(diào)用 unmarshalling(ohos.utils.Parcel) 方法從 Parcel 中解組 NotificationRequest 對(duì)象，以實(shí)現(xiàn)進(jìn)程間通信 (IPC)。

指定者：

接口 Sequenceable 中的編組

參數(shù)：

參數(shù)名稱	參數(shù)描述
out	指示用于編組的 MessageParcel 對(duì)象。 MessageParcel 是 Parcel 的子類。

返回:

如果編組成功，則返回 true； 否則返回 false。

Since:

1

unmarshalling

public boolean unmarshalling(Parcel in)

從 Parcel 中解組 NotificationRequest 對(duì)象。

指定者：

在接口 Sequenceable 中解組

參數(shù)：

參數(shù)名稱	參數(shù)描述
in	指示用于編組的 MessageParcel 對(duì)象。 MessageParcel 是 Parcel 的子類。

返回:

如果解組成功，則返回 true； 否則返回 false。

Since:

1

toString

public String toString()

從類復(fù)制的描述：對(duì)象

返回對(duì)象的字符串表示形式。 通常，toString 方法返回一個(gè)“以文本方式表示”該對(duì)象的字符串。 結(jié)果應(yīng)該是一個(gè)簡(jiǎn)潔但信息豐富的表示，易于人們閱讀。 建議所有子類重寫此方法。

Object 類的 toString 方法返回一個(gè)字符串，該字符串由對(duì)象作為其實(shí)例的類的名稱、at 符號(hào)字符“@”和對(duì)象哈希碼的無符號(hào)十六進(jìn)制表示形式組成。 換句話說，此方法返回一個(gè)等于以下值的字符串：

 getClass().getName() + '@' + Integer.toHexString(hashCode()) 

覆蓋：

類 Object 中的 toString

返回:

對(duì)象的字符串表示形式。

Since:

4