NotificationChannel 類別

定義

命名空間:: Android.App

組件:: Mono.Android.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

一個設定的表示，適用於一組相似主題的通知集合。

[Android.Runtime.Register("android/app/NotificationChannel", ApiSince=26, DoNotGenerateAcw=true)]
public sealed class NotificationChannel : Java.Lang.Object, Android.OS.IParcelable, IDisposable

[<Android.Runtime.Register("android/app/NotificationChannel", ApiSince=26, DoNotGenerateAcw=true)>]
type NotificationChannel = class
    inherit Object
    interface IParcelable
    interface IJavaObject
    interface IDisposable
    interface IJavaPeerable

繼承: Object

JavaObject

Object
NotificationChannel

屬性: RegisterAttribute

實作: IParcelable IJavaObject IJavaPeerable IDisposable

備註

一個設定的表示，適用於一組相似主題的通知集合。

Android 參考資料。android.app.NotificationChannel

本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。

建構函式

名稱	Description
NotificationChannel(String, ICharSequence, NotificationImportance)	建立通知頻道。
NotificationChannel(String, String, NotificationImportance)	建立通知頻道。

欄位

名稱	Description
DefaultChannelId	應用程式預設頻道的 ID。
EditConversation	額外值。`Settings#EXTRA_CHANNEL_FILTER_LIST`
EditImportance	額外值。`Settings#EXTRA_CHANNEL_FILTER_LIST`
EditLauncher	額外值。`Settings#EXTRA_CHANNEL_FILTER_LIST`
EditLockedDevice	額外值。`Settings#EXTRA_CHANNEL_FILTER_LIST`
EditSound	額外值。`Settings#EXTRA_CHANNEL_FILTER_LIST`
EditVibration	額外值。`Settings#EXTRA_CHANNEL_FILTER_LIST`
EditZen	額外值。`Settings#EXTRA_CHANNEL_FILTER_LIST`

屬性

名稱	Description
AudioAttributes	回傳通知中播放的音訊屬性。
Blockable	回傳該頻道是否總是可封鎖，即使應用程式被「固定」為不可封鎖。 -或- 允許使用者阻擋透過此通道傳送的通知，前提是該通道屬於原本會「固定」啟用通知的套件。
Class	回傳此 `Object`的執行時類別。 (繼承來源 Object)
ConversationId	如果該對話與某個對話相關聯，則回傳 `ShortcutInfo#getId() id` 支持該頻道的對話。
Creator
Description	回傳使用者對此頻道的可見描述。 -或- 設定使用者對此頻道的可見描述。
Group	回傳該頻道所屬的群組。 -或- 設定此頻道屬於哪個群組。
Handle	底層 Android 實例的帳號。 (繼承來源 Object)
HasUserSetImportance	無論使用者是否選擇了該頻道的重要性，無論是確認應用程式的初始選擇，還是將其調整為更高或更低，都會回傳。
HasUserSetSound	回傳使用者是否選擇了該頻道的聲音。
Id	回傳此頻道的 ID。
Importance	回傳使用者指定的重要性，例如 -或- 設定此通知通道的中斷程度。
IsConversation	這個頻道是否代表一場對話。
IsDemoted	回傳使用者是否決定此頻道不代表對話。
IsImportantConversation	這段對話中的通知是否被視為重要。
JniIdentityHashCode	取得由互通執行時指派給此 Java 對等端的身份雜湊碼。 (繼承來源 Object)
JniManagedPeerState	一個設定的表示，適用於一組相似主題的通知集合。 (繼承來源 JavaObject)
JniPeerMembers	提供 Android.App.NotificationChannel 的 JNI 綁定基礎架構。
LightColor	回傳此頻道所發布通知的通知燈顏色。 -或- 設定該頻道通知燈的顏色，前提是該頻道有 `#enableLights(boolean) enabled` 燈光且裝置支援此功能。
LockscreenVisibility	無論本頻道發布的通知是否完整或遮蔽後顯示於鎖定畫面。 -或- 設定該頻道發布的通知是否會出現在鎖定畫面，若顯示，是否以塗黑形式呈現。
Name
NameFormatted	回傳此頻道的使用者可見名稱。 -或- 設定此頻道的使用者可見名稱。
OriginalImportance	在用戶修改前，回傳應用程式定義的頻道重要性。
ParentChannelId	如果是與對話相關的頻道，則會將父通知頻道的訊息 `#getId() id` 回傳到這個頻道。
PeerReference	取得這個 Java 節點的 JNI 物件參考。 (繼承來源 Object)
Sound	回傳此頻道的通知音。
ThresholdClass	此 API 支援 Mono for Android 基礎架構，並非直接從你的程式碼中使用。 (繼承來源 Object)
ThresholdType	此 API 支援 Mono for Android 基礎架構，並非直接從你的程式碼中使用。 (繼承來源 Object)
VibrationEffect	回傳 `VibrationEffect` 本頻道已發布的通知。 -或- 設定 a `VibrationEffect` 來接收此頻道的通知。

方法

名稱	Description
CanBubble()	回傳該頻道發布的通知是否允許顯示在通知欄外，在其他應用程式上方的浮動視窗中。
CanBypassDnd()	當啟用政策允許優先頻道繞過通知過濾時，發布到此頻道的通知是否能繞過請勿打擾 `NotificationManager#INTERRUPTION_FILTER_PRIORITY` 模式。
CanShowBadge()	回傳此頻道發布的通知是否能以啟動器應用程式的徽章形式出現。
Clone()	建立並回傳此物件的副本。 (繼承來源 Object)
Construct(JniObjectReference, JniObjectReferenceOptions)	一個設定的表示，適用於一組相似主題的通知集合。 (繼承來源 JavaObject)
DescribeContents()	描述此 Parcelable 實例的分組表示中包含的特殊物件種類。
Dispose()	釋放該 Java 節點所持有的資源。 (繼承來源 Object)
Dispose(Boolean)	釋放該 Java 節點所持有的資源。 (繼承來源 Object)
DisposeUnlessReferenced()	一個設定的表示，適用於一組相似主題的通知集合。 (繼承來源 JavaObject)
EnableLights(Boolean)	設定該頻道發布的通知是否應該在支援此功能的裝置上亮起通知燈。
EnableVibration(Boolean)	設定此頻道發布的通知是否應該震動。
Equals(Object)	一個設定的表示，適用於一組相似主題的通知集合。 (繼承來源 JavaObject)
Equals(Object)	表示是否有其他物體「等同」於此物。 (繼承來源 Object)
GetHashCode()	回傳物件的雜湊碼值。 (繼承來源 Object)
GetVibrationPattern()	回傳此頻道發布通知的振動模式。
JavaFinalize()	已淘汰. 當垃圾回收判定該物件不再有相關參考時，由垃圾回收器呼叫。 (繼承來源 Object)
Notify()	喚醒一個正在該物件監視器上等待的執行緒。 (繼承來源 Object)
NotifyAll()	喚醒所有等待該物件監視器的執行緒。 (繼承來源 Object)
SetAllowBubbles(Boolean)	自 Android 11 起，這個價值已不再被尊重。
SetBypassDnd(Boolean)	設定該頻道發布的通知是否會中斷使用者在 `android.app.NotificationManager#INTERRUPTION_FILTER_PRIORITY` 模式下的行為。
SetConversationId(String, String)	這讓這個頻道以討論為中心。
SetHandle(IntPtr, JniHandleOwnership)	設定 Handle 屬性。 (繼承來源 Object)
SetPeerReference(JniObjectReference, JniObjectReferenceOptions)	一個設定的表示，適用於一組相似主題的通知集合。 (繼承來源 JavaObject)
SetShowBadge(Boolean)	設定此頻道發布的通知是否能以啟動器中的應用程式圖示徽章形式出現。
SetSound(Uri, AudioAttributes)	設定該頻道通知應播放的音效及其音訊屬性。
SetVibrationPattern(Int64[])	設定此頻道通知的振動模式。
ShouldShowLights()	回傳此頻道發布的通知是否會觸發通知燈。
ShouldVibrate()	回傳本頻道發布的通知是否總是震動。
ToArray<T>()	從這個 Java 陣列包裝器建立一個受管理陣列。 (繼承來源 Object)
ToString()	回傳物件的字串表示。 (繼承來源 Object)
UnregisterFromRuntime()	將此 Java 節點從互通執行時中取消註冊。 (繼承來源 Object)
Wait()	導致目前執行緒等待被喚醒，通常是透過 <em>通知</><em 或 em>中斷</em> 來喚醒。 (繼承來源 Object)
Wait(Int64, Int32)	會讓目前執行緒等待喚醒，通常是透過 <em>通知</><em 或 em>中斷</em>，或是經過一定的真實時間。 (繼承來源 Object)
Wait(Int64)	會讓目前執行緒等待喚醒，通常是透過 <em>通知</><em 或 em>中斷</em>，或是經過一定的真實時間。 (繼承來源 Object)
WriteToParcel(Parcel, ParcelableWriteFlags)	把這個物體壓扁成一個包裹。

明確介面實作

名稱	Description
IJavaPeerable.Disposed()	一個設定的表示，適用於一組相似主題的通知集合。 (繼承來源 JavaObject)
IJavaPeerable.Finalized()	一個設定的表示，適用於一組相似主題的通知集合。 (繼承來源 JavaObject)
IJavaPeerable.JniObjectReferenceControlBlock	一個設定的表示，適用於一組相似主題的通知集合。 (繼承來源 JavaObject)
IJavaPeerable.SetJniIdentityHashCode(Int32)	一個設定的表示，適用於一組相似主題的通知集合。 (繼承來源 JavaObject)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	一個設定的表示，適用於一組相似主題的通知集合。 (繼承來源 JavaObject)
IJavaPeerable.SetPeerReference(JniObjectReference)	一個設定的表示，適用於一組相似主題的通知集合。 (繼承來源 JavaObject)
IJavaPeerable.UnregisterFromRuntime()	一個設定的表示，適用於一組相似主題的通知集合。

擴充方法

名稱	Description
GetJniTypeName(IJavaPeerable)	取得實例 `self`類型的 JNI 名稱。
JavaAs<TResult>(IJavaPeerable)	試著強制`self`輸入 `TResult`，檢查強制在 Java 端是否有效。
JavaCast<TResult>(IJavaObject)	執行 Android 執行時檢查型別轉換。
JavaCast<TResult>(IJavaObject)	一個設定的表示，適用於一組相似主題的通知集合。
TryJavaCast<TResult>(IJavaPeerable, TResult)	試著強制`self`輸入 `TResult`，檢查強制在 Java 端是否有效。

適用於