Share via


Notification 類別

定義

類別,表示如何使用 向使用者 android.app.NotificationManager 呈現永續性通知。

[Android.Runtime.Register("android/app/Notification", DoNotGenerateAcw=true)]
public class Notification : Java.Lang.Object, Android.OS.IParcelable, IDisposable, Java.Interop.IJavaPeerable
[<Android.Runtime.Register("android/app/Notification", DoNotGenerateAcw=true)>]
type Notification = class
    inherit Object
    interface IParcelable
    interface IJavaObject
    interface IDisposable
    interface IJavaPeerable
繼承
Notification
屬性
實作

備註

類別,表示如何使用 向使用者 android.app.NotificationManager 呈現永續性通知。

已新增 , Notification.Builder Notification.Builder 可讓您更輕鬆地建構通知。

<div class=「special reference」 >< h3 > Developer Guides < /h3>

如需建立通知的指南,請參閱 狀態列通知 開發人員指南。

</Div>

android.app.Notification JAVA 檔。

此頁面的部分是根據 原始碼專案所建立和共用的工作進行修改,並根據中所述的詞彙使用。

建構函式

Notification()

建構具有預設值的 Notification 物件。

Notification(Int32, ICharSequence)

Notification建構物件,其中包含具有狀態列圖示而不需要標準展開檢視的資訊。

Notification(Int32, ICharSequence, Int64)
已淘汰.

建構 Notification 物件,其中包含具有狀態列圖示而不需要標準展開檢視的資訊。

Notification(Int32, String)

Notification建構物件,其中包含具有狀態列圖示而不需要標準展開檢視的資訊。

Notification(Int32, String, Int64)

建構 Notification 物件,其中包含具有狀態列圖示而不需要標準展開檢視的資訊。

Notification(IntPtr, JniHandleOwnership)

建立 JNI 物件的 Managed 標記法時所使用的建構函式;由執行時間呼叫。

Notification(Parcel)

解除通知的擴大。

欄位

CategoryAlarm

通知類別:警示或計時器。

CategoryCall

通知類別:來電 (語音或視訊) 或類似的同步通訊要求。

CategoryEmail

通知類別:非同步大量訊息 (電子郵件) 。

CategoryError

通知類別:背景作業或驗證狀態的錯誤。

CategoryEvent

通知類別:行事曆事件。

CategoryLocationSharing

通知類別:暫時共用位置。

CategoryMessage

通知類別:傳入直接訊息 (SMS、立即訊息等。

CategoryMissedCall

通知類別:未接聽的通話。

CategoryNavigation

通知類別:地圖回合導覽。

CategoryProgress

通知類別:長時間執行背景作業的進度。

CategoryPromo

通知類別:促銷或廣告。

CategoryRecommendation

通知類別:單一專案的特定及時建議。

CategoryReminder

通知類別:使用者排程提醒。

CategoryService

通知類別:指示執行背景服務。

CategorySocial

通知類別:社交網路或共用更新。

CategoryStatus

通知類別:關於裝置或內容狀態的持續資訊。

CategoryStopwatch

通知類別:執行停止監看式。

CategorySystem

通知類別:系統或裝置狀態更新。

CategoryTransport

通知類別:用於播放的媒體傳輸控制項。

CategoryWorkout

通知類別:追蹤使用者的運動。

ColorDefault

的特殊值 #color ,告知系統不要以任何特殊色彩裝飾此通知,而是在呈現此通知時改用預設色彩。

ExtraAnswerColor

#extras 索引鍵:用來作為通知之 [回應] 動作按鈕提示的 android.app.Notification.CallStyle 色彩。

ExtraAnswerIntent

#extras 機碼:使用者回答 android.app.Notification.CallStyle 通知時要傳送的意圖。

ExtraAudioContentsUri

#extras 機碼:此通知的音訊內容。

ExtraBackgroundImageUri

#extras 索引鍵:指向在選取通知時可在背景中顯示的影像的一般 String 表示 android.content.ContentUris content URI 法。

ExtraBigText

#extras 機碼:這是以通知大 BigTextStyle 形式顯示的較長文字,如 提供給 BigTextStyle#bigText(CharSequence)

ExtraCallIsVideo

#extras 機碼:通知是否 android.app.Notification.CallStyle 適用于在接聽時啟動視訊的通話。

ExtraCallPerson

#extras 機碼:要顯示為通知呼叫 android.app.Notification.CallStyle 的人員。

ExtraCallType

#extras 機碼:通知所 android.app.Notification.CallStyle 代表的呼叫類型。

ExtraChannelGroupId

的選擇性額外專案 #INTENT_CATEGORY_NOTIFICATION_PREFERENCES

ExtraChannelId

的選擇性額外專案 #INTENT_CATEGORY_NOTIFICATION_PREFERENCES

ExtraChronometerCountDown

#extras 機碼:通知上設定的計時計是否應該倒數,而不是倒數。

ExtraColorized

#extras 機碼:是否應該將通知標示為提供給 Builder#setColorized(boolean)

ExtraCompactActions

#extras 索引鍵:要顯示在精簡檢視中的動作索引,如提供給 e (所示。

ExtraConversationTitle

#extras 機碼: CharSequence 要顯示為 由 代表之交談標題的 android.app.Notification.MessagingStyle

ExtraDeclineColor

#extras 索引鍵:用來作為通知之 [拒絕] 或 [停止回應] 動作按鈕提示的 android.app.Notification.CallStyle 色彩。

ExtraDeclineIntent

#extras 機碼:當使用者拒絕 android.app.Notification.CallStyle 通知時要傳送的意圖。

ExtraHangUpIntent

#extras 機碼:當使用者停止 android.app.Notification.CallStyle 通知時要傳送的意圖。

ExtraHistoricMessages

#extras索引鍵:通知所提供的 android.app.Notification.MessagingStyle 套件組合陣列。 android.app.Notification.MessagingStyle#addHistoricMessage historicandroid.app.Notification.MessagingStyle.Message

ExtraInfoText

#extras 索引鍵:這是提供給 的一小部分額外文字 Builder#setContentInfo(CharSequence)

ExtraIsGroupConversation

#extras 機碼:通知是否 android.app.Notification.MessagingStyle 代表群組交談。

ExtraLargeIcon

#extras機碼:這是在顯示通知承載時要使用的點陣圖,而不是顯示通知承載時所使用的點陣圖。 Builder#setLargeIcon(android.graphics.Bitmap)

ExtraLargeIconBig

#extras 機碼:這是一個點陣圖,而不是 Builder#setLargeIcon(android.graphics.Bitmap) 當通知以展開形式顯示時所使用的點陣圖,如 提供給 BigPictureStyle#bigLargeIcon(android.graphics.Bitmap)

ExtraMediaSession

#extras 索引鍵: android.media.session.MediaSession.Token 與通知相關聯的 android.app.Notification.MediaStyle

ExtraMessages

#extras索引鍵:通知所提供的 android.app.Notification.MessagingStyle 套件組合陣列 android.app.Notification.MessagingStyle.Message

ExtraMessagingPerson

#extras 機碼:要針對使用者傳送的所有訊息顯示的人員,包括直接回復 android.app.Notification.MessagingStyle 通知。

ExtraNotificationId

的選擇性額外專案 #INTENT_CATEGORY_NOTIFICATION_PREFERENCES

ExtraNotificationTag

的選擇性額外專案 #INTENT_CATEGORY_NOTIFICATION_PREFERENCES

ExtraPeople

#extras 索引鍵:字串陣列,其中包含此通知與相關的人員,每個陣列都提供給 Builder#addPerson(String)

ExtraPeopleList

#extras 索引鍵:物件的 arrayList Person ,其中包含此通知與此通知相關的人員。

ExtraPicture

#extras 機碼:這是要顯示在展開通知中的 BigPictureStyle 點陣圖,提供給 BigPictureStyle#bigPicture(android.graphics.Bitmap)

ExtraPictureContentDescription

#extras 索引鍵:這是提供自 BigPictureStyle#bigPicture(Bitmap)BigPictureStyle#setContentDescription(CharSequence) 提供之大圖片的內容描述。

ExtraPictureIcon

#extras 機碼:這是 Icon 顯示在擴充通知中 BigPictureStyle ,提供給 的 BigPictureStyle#bigPicture(Icon) 影像。

ExtraProgress

#extras 索引鍵:這是提供給 的 Builder#setProgress(int, int, boolean) 進度值。

ExtraProgressIndeterminate

#extras 索引鍵:進度列是否不確定,是否提供給 Builder#setProgress(int, int, boolean)

ExtraProgressMax

#extras 索引鍵:這是提供給 的 Builder#setProgress(int, int, boolean) 最大值。

ExtraRemoteInputDraft

如果使用者按一下 RemoteInput 時,通知包含 RemoteInput 的未傳送草稿,我們會使用此金鑰將草稿新增為 #contentIntent 字串。

ExtraRemoteInputHistory

#extras 機碼:這是提供給 Builder#setRemoteInputHistory(CharSequence[]) 的遠端輸入歷程記錄。

ExtraSelfDisplayName

#extras 機碼:要針對使用者傳送的所有訊息顯示的使用者名稱,包括直接回復 android.app.Notification.MessagingStyle 通知。

ExtraShowBigPictureWhenCollapsed

#extras 機碼:這是布林值,表示 BigPictureStyle#bigPicture(Bitmap) big picture 要以通知的折迭狀態 BigPictureStyle 顯示 。

ExtraShowChronometer

#extras 機碼:是否 #when 應該顯示為計數計時器, (特別 android.widget.Chronometer) 而非時間戳記,如 提供給 Builder#setUsesChronometer(boolean)

ExtraShowWhen

#extras 機碼:是否 #when 應該顯示 ,如 提供給 Builder#setShowWhen(boolean)

ExtraSmallIcon

#extras 機碼:這是通知主要小型圖示的資源識別碼,如 提供給 Builder#setSmallIcon(int)

ExtraSubText

#extras 索引鍵:這是提供給 Builder#setSubText(CharSequence) 的第三行文字。

ExtraSummaryText

#extras 索引鍵:這是一行摘要資訊,其目的是要與展開的通知一起顯示,如提供給 e (所示。

ExtraTemplate

#extras 機碼:字串,表示用來建立此通知的特定 android.app.Notification.Style 名稱。

ExtraText

#extras 機碼:這是提供給 的主要文字承載 Builder#setContentText(CharSequence)

ExtraTextLines

#extras 機碼:要顯示在展開通知中的 InboxStyle CharSequences 陣列,每個通知都提供給 InboxStyle#addLine(CharSequence)

ExtraTitle

#extras 機碼:這是通知的標題,提供給 Builder#setContentTitle(CharSequence)

ExtraTitleBig

#extras 索引鍵:這是以展開格式顯示時通知的標題, e.

ExtraVerificationIcon

#extras 機碼:要在通知上 android.app.Notification.CallStyle 顯示為呼叫端驗證狀態的圖示。

ExtraVerificationText

#extras 機碼:要在通知上 android.app.Notification.CallStyle 顯示為呼叫端驗證狀態的文字。

ForegroundServiceDefault
已淘汰.

如果使用 setForegroundServiceBehavior () 來建置與啟動前景服務的通知,則顯示通知通常會短暫地隱藏,以避免對使用者顯示視覺干擾。

ForegroundServiceDeferred
已淘汰.

如果使用 setForegroundServiceBehavior () 來建置與啟動前景服務的通知,則顯示通知通常會短暫地隱藏,以避免對使用者顯示視覺干擾。

ForegroundServiceImmediate
已淘汰.

如果使用 setForegroundServiceBehavior () 來建置與啟動前景服務的通知,則即使預設行為會短暫延遲可見度,也會立即顯示通知。

IntentCategoryNotificationPreferences

活動,提供使用者介面來調整其包含應用程式的通知喜好設定。

PriorityDefault

預設通知 #priority

PriorityHigh

較高的 #priority ,適用于更重要的通知或警示。

PriorityLow

較低 #priority ,對於較不重要的專案。

PriorityMax

最高 #priority ,適用于您的應用程式最重要的專案,需要使用者的提示注意或輸入。

PriorityMin

最低 #priority ;這些專案可能不會向使用者顯示,除非有特殊情況,例如詳細的通知記錄。

屬性

Actions

依 附加至此通知 Builder#addAction(int, CharSequence, PendingIntent) 的所有 Action 結構陣列。

AllowSystemGeneratedContextualActions

傳回應用程式開發人員是否允許平臺 (,) 產生此通知的內容動作。

AudioAttributes

AudioAttributes audio attributes播放音效時要使用的 。

AudioAttributesDefault

#audioAttributes 的預設值。

AudioStreamType
已淘汰.

播放音效時要使用的音訊資料流程類型。

BadgeIconType

如果啟動器中顯示支援錯誤的啟動器,則傳回此通知應該顯示的圖示。

BigContentView

的大型格式版本 #contentView ,讓通知有機會顯示更多詳細資料。

Category

其中一個預先定義的通知類別 (查看 CATEGORY_* 最能描述此通知的常數) 。

ChannelId

傳回此通知張貼至之通道的識別碼。

Class

傳回這個 Object 的執行時間類別。

(繼承來源 Object)
Color

輔色 (ARGB 整數,例如在呈現此通知時,標準 Style 範本所要套用的常數 android.graphics.Color) 。

ContentIntent

按一下展開狀態專案時所要執行的意圖。

ContentView

在通知清單中代表此通知的檢視, (從狀態列下拉) 。

ContextualActions

傳回內容相關 (的動作,也就是因為通知的內容) 此通知中的動作而建議。

Creator

可互換。

Defaults

指定應該取自預設值的值。

DeleteIntent

當使用者明確關閉通知時,使用 [全部清除] 按鈕或個別撥動通知時,要執行的意圖。

Extras

要與此通知一起處理的其他語意資料。

Flags
FullScreenIntent

啟動的意圖,而不是將通知張貼到狀態列。

Group

取得用來將此通知分組到叢集或堆疊的金鑰,以及支援這類轉譯之裝置上的其他通知。

GroupAlertBehavior

傳回群組中哪些類型的通知負責警示使用者。

Handle

基礎 Android 實例的控制碼。

(繼承來源 Object)
HasImage

類別,表示如何使用 向使用者 android.app.NotificationManager 呈現永續性通知。

HeadsUpContentView

的中格式版本 #contentView ,提供通知將動作按鈕新增至 contentView 的機會。

Icon

要當做狀態列中圖示使用的可繪製資源識別碼。

IconLevel

如果狀態列中的圖示是有多個層級,您可以設定此專案。

JniIdentityHashCode

類別,表示如何使用 向使用者 android.app.NotificationManager 呈現永續性通知。

(繼承來源 Object)
JniPeerMembers

類別,表示如何使用 向使用者 android.app.NotificationManager 呈現永續性通知。

LargeIcon

要顯示在通知內容區域中的大型點陣圖。

LedARGB

led 的色彩。

LedOffMS

LED 在閃爍時關閉的毫秒數。

LedOnMS

LED 在閃爍時要開啟的毫秒數。

LocusId

LocusId取得與此通知相關聯的 。

Number

此通知所代表的事件數目。

PeerReference

類別,表示如何使用 向使用者 android.app.NotificationManager 呈現永續性通知。

(繼承來源 Object)
Priority

此通知的相對優先順序。

PublicVersion

取代此通知的版本,其內容會顯示在不安全的內容中,例如安全 Keyguard。

SettingsText

類別,表示如何使用 向使用者 android.app.NotificationManager 呈現永續性通知。

SettingsTextFormatted

傳回提供給 Builder#setSettingsText(CharSequence) 的設定文字。

ShortcutId

ShortcutInfo#getId() id傳回這個通知會取代的 ,如果有的話。

SmallIcon

在狀態列和內容檢視中代表此通知的小型圖示。

SortKey

取得排序索引鍵,排序此通知與其他來自相同套件的通知。

Sound

要播放的音效。

ThresholdClass

此 API 支援 Mono for Android 基礎結構,並不適合直接從您的程式碼使用。

ThresholdType

此 API 支援 Mono for Android 基礎結構,並不適合直接從您的程式碼使用。

TickerText

摘要說明協助工具服務的此通知的文字。

TickerView
已淘汰.

先前是顯示 的 #tickerText 檢視。

TimeoutAfter

傳回張貼期間,如果尚未取消,系統應該取消此通知。

Vibrate

要震動的模式。

Visibility

此通知的可見度,這會影響 SystemUI 在不安全的鎖定畫面上顯示通知是否存在和內容的方式和時機 (,也就是安全鎖定畫面) 。

When

與這個通知相關的時間戳記,自 epoch 起以毫秒為單位。

方法

Clone()

建立並傳回這個 Object 的複本。

DescribeContents()

描述這個可封送處理標記法中包含的特殊物件種類。

Dispose()

類別,表示如何使用 向使用者 android.app.NotificationManager 呈現永續性通知。

(繼承來源 Object)
Dispose(Boolean)

類別,表示如何使用 向使用者 android.app.NotificationManager 呈現永續性通知。

(繼承來源 Object)
Equals(Object)

指出其他物件是否「等於」這個物件。

(繼承來源 Object)
FindRemoteInputActionPair(Boolean)

尋找並傳回遠端輸入及其對應的動作。

GetBubbleMetadata()

傳回泡泡中繼資料,用來在現有前景活動的浮動視窗中顯示應用程式內容。

GetHashCode()

傳回此物件的雜湊碼值。

(繼承來源 Object)
GetLargeIcon()

此通知內容檢視中顯示的大型圖示。

JavaFinalize()

當垃圾收集判斷物件沒有其他參考時,由物件上的垃圾收集行程呼叫。

(繼承來源 Object)
Notify()

喚醒正在等候此物件的監視器的單一線程。

(繼承來源 Object)
NotifyAll()

喚醒正在等候此物件監視器的所有線程。

(繼承來源 Object)
SetHandle(IntPtr, JniHandleOwnership)

設定 Handle 屬性。

(繼承來源 Object)
SetLatestEventInfo(Context, ICharSequence, ICharSequence, PendingIntent)
已淘汰.

#contentView 欄位設定為具有標準「最新事件」版面配置的檢視。

SetLatestEventInfo(Context, String, String, PendingIntent)
已淘汰.

#contentView 欄位設定為具有標準「最新事件」版面配置的檢視。

ToArray<T>()

類別,表示如何使用 向使用者 android.app.NotificationManager 呈現永續性通知。

(繼承來源 Object)
ToString()

傳回物件的字串表示。

(繼承來源 Object)
UnregisterFromRuntime()

類別,表示如何使用 向使用者 android.app.NotificationManager 呈現永續性通知。

(繼承來源 Object)
Wait()

讓目前的執行緒等到喚醒為止,通常是藉由 < em > notified < /em > 或 < em > interrupted < /em > 來喚醒。

(繼承來源 Object)
Wait(Int64)

讓目前的執行緒等到喚醒為止,通常是 < 透過 em > notified < /em 或 em > interrupted < /em >> ,或 < 直到經過一定數量的即時為止。

(繼承來源 Object)
Wait(Int64, Int32)

讓目前的執行緒等到喚醒為止,通常是 < 透過 em > notified < /em 或 em > interrupted < /em >> ,或 < 直到經過一定數量的即時為止。

(繼承來源 Object)
WriteToParcel(Parcel, ParcelableWriteFlags)

將此通知壓平合併成一個包裹。

明確介面實作

IJavaPeerable.Disposed()

類別,表示如何使用 向使用者 android.app.NotificationManager 呈現永續性通知。

(繼承來源 Object)
IJavaPeerable.DisposeUnlessReferenced()

類別,表示如何使用 向使用者 android.app.NotificationManager 呈現永續性通知。

(繼承來源 Object)
IJavaPeerable.Finalized()

類別,表示如何使用 向使用者 android.app.NotificationManager 呈現永續性通知。

(繼承來源 Object)
IJavaPeerable.JniManagedPeerState

類別,表示如何使用 向使用者 android.app.NotificationManager 呈現永續性通知。

(繼承來源 Object)
IJavaPeerable.SetJniIdentityHashCode(Int32)

類別,表示如何使用 向使用者 android.app.NotificationManager 呈現永續性通知。

(繼承來源 Object)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)

類別,表示如何使用 向使用者 android.app.NotificationManager 呈現永續性通知。

(繼承來源 Object)
IJavaPeerable.SetPeerReference(JniObjectReference)

類別,表示如何使用 向使用者 android.app.NotificationManager 呈現永續性通知。

(繼承來源 Object)

擴充方法

JavaCast<TResult>(IJavaObject)

執行 Android 執行時間檢查的類型轉換。

JavaCast<TResult>(IJavaObject)

類別,表示如何使用 向使用者 android.app.NotificationManager 呈現永續性通知。

GetJniTypeName(IJavaPeerable)

類別,表示如何使用 向使用者 android.app.NotificationManager 呈現永續性通知。

適用於