Notification クラス

定義

NotificationManager を使用してユーザーに永続的な通知を表示する方法を表すクラス。

[Android.Runtime.Register("android/app/Notification", DoNotGenerateAcw=true)]
public class Notification : Java.Lang.Object, Android.OS.IParcelable, IDisposable
[<Android.Runtime.Register("android/app/Notification", DoNotGenerateAcw=true)>]
type Notification = class
    inherit Object
    interface IParcelable
    interface IJavaObject
    interface IDisposable
    interface IJavaPeerable
継承
Notification
属性
実装

注釈

NotificationManager を使用してユーザーに永続的な通知を表示する方法を表すクラス。 Notification.Builder が追加され、通知の作成が容易になりました。

通知を作成するためのガイドについては、ステータス バーの通知開発者ガイドを参照してください。

android.app.Notificationの Android リファレンス。

このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。

コンストラクター

名前 説明
Notification()

既定値を使用して Notification オブジェクトを構築します。

Notification(Int32, ICharSequence, Int64)
古い.

このコンストラクターは非推奨です。

Notification(Int32, ICharSequence)

標準の展開ビューを使用せずにステータス バー アイコンを表示するために必要な情報を含む Notification オブジェクトを構築します。

Notification(Int32, String, Int64)

このコンストラクターは非推奨です。

Notification(Int32, String)

標準の展開ビューを使用せずにステータス バー アイコンを表示するために必要な情報を含む Notification オブジェクトを構築します。

Notification(IntPtr, JniHandleOwnership)

既存の Java Native Interface オブジェクトのマネージド表現を初期化します。

Notification(Parcel)

パーセルからの通知のフラット化を解除します。

フィールド

名前 説明
CategoryAlarm

通知カテゴリ: アラームまたはタイマー。

CategoryCall

通知カテゴリ: 着信通話 (音声またはビデオ) または同様の同期通信要求。

CategoryEmail

通知カテゴリ: 非同期一括メッセージ (電子メール)。

CategoryError

通知カテゴリ: バックグラウンド操作または認証の状態でエラーが発生しました。

CategoryEvent

通知カテゴリ: カレンダー イベント。

CategoryLocationSharing

通知カテゴリ: 一時的に場所を共有します。

CategoryMessage

通知カテゴリ: 受信ダイレクト メッセージ (SMS、インスタント メッセージなど)。

CategoryMissedCall

通知カテゴリ: 不在着信。

CategoryNavigation

通知カテゴリ: ターンバイターン ナビゲーションをマップします。

CategoryProgress

通知カテゴリ: 実行時間の長いバックグラウンド操作の進行状況。

CategoryPromo

通知カテゴリ: プロモーションまたは広告。

CategoryRecommendation

通知カテゴリ: 1 つの項目に対する特定のタイムリーな推奨事項。

CategoryReminder

通知カテゴリ: ユーザーがスケジュールしたアラーム。

CategoryService

通知カテゴリ: バックグラウンド サービスの実行を示します。

CategorySocial

通知カテゴリ: ソーシャル ネットワークまたは共有の更新。

CategoryStatus

通知カテゴリ: デバイスまたはコンテキストの状態に関する継続的な情報。

CategoryStopwatch

通知カテゴリ: ストップウォッチを実行しています。

CategorySystem

通知カテゴリ: システムまたはデバイスの状態の更新。

CategoryTransport

通知カテゴリ: 再生用のメディア トランスポート コントロール。

CategoryVoicemail

通知カテゴリ: ボイスメール。

CategoryWorkout

通知カテゴリ: ユーザーのトレーニングを追跡します。

ColorDefault

特別な色でこの要素を装飾しないようにシステムに指示する色の特別な値 (ただし、代わりに既定のシステムカラーを使用します)。

ExtraAnswerColor

extras キー: Notification.CallStyle 通知の [応答] アクション ボタンのヒントとして使用される色。

ExtraAnswerIntent

extras キー: ユーザーが Notification.CallStyle 通知に応答したときに送信される意図。

ExtraAudioContentsUri

extras キー: この通知のオーディオコンテンツ。

ExtraBackgroundImageUri

extras キー: 通知が選択されたときにバックグラウンドで表示できる画像を指すコンテンツ URI のフラットな文字列表現。

ExtraBigText

extras キー: これは、BigTextStyle.bigText(CharSequence) に指定された BigTextStyle 通知の拡張形式で表示される長いテキストです。

ExtraCallIsVideo

extras キー: Notification.CallStyle 通知が、応答時にビデオをアクティブにする通話用かどうか。

ExtraCallPerson

extras キー: Notification.CallStyle 通知の呼び出しとして表示されるユーザー。

ExtraCallType

extras キー: Notification.CallStyle 通知によって表される呼び出しの種類。

ExtraChannelGroupId

INTENT_CATEGORY_NOTIFICATION_PREFERENCESの省略可能な追加。

ExtraChannelId

INTENT_CATEGORY_NOTIFICATION_PREFERENCESの省略可能な追加。

ExtraChronometerCountDown

extras キー: 通知に設定されたクロノメーターをカウントアップするのではなく、カウントダウンする必要があるかどうか。

ExtraColorized

extras キー: 通知を Builder.setColorized(boolean) に指定された色付けする必要があるかどうか。

ExtraCompactActions

extras キー: MediaStyle.setShowActionsInCompactView(int... など) に指定されたコンパクト ビューに表示されるアクションのインデックス。

ExtraConversationTitle

extras キー: Notification.MessagingStyle で表される会話のタイトルとして表示される CharSequence

ExtraDeclineColor

extras キー: Notification.CallStyle 通知の [辞退] または [ハングアップ] アクション ボタンのヒントとして使用される色。

ExtraDeclineIntent

extras キー: ユーザーが Notification.CallStyle 通知を拒否したときに送信される意図。

ExtraHangUpIntent

extras キー: ユーザーが Notification.CallStyle 通知をハングアップしたときに送信される意図。

ExtraHistoricMessages

extras キー: Notification.MessagingStyle 通知によって提供される、過去の Notification.MessagingStyle.Message バンドルの配列。

ExtraInfoText

extras キー: これは Builder.setContentInfo(CharSequence) に提供される追加テキストの小さな部分です。

ExtraIsGroupConversation

extras キー: Notification.MessagingStyle 通知がグループの会話を表すかどうか。

ExtraLargeIcon

この定数は、API レベル 26 では非推奨になりました。

ExtraLargeIconBig

extras キー: これは、通知が BigPictureStyle.bigLargeIcon(android.graphics.Bitmap) に提供される拡張形式で表示されるときに、Builder.setLargeIcon(android.graphics.Bitmap) のビットマップの代わりに使用されるビットマップです。

ExtraMediaSession

extras キー: Notification.MediaStyle 通知に関連付けられている MediaSession.Token。

ExtraMessages

extras キー: Notification.MessagingStyle 通知によって提供される Notification.MessagingStyle.Message バンドルの配列。

ExtraMessagingPerson

extras キー: 直接応答 Notification.MessagingStyle 通知を含む、ユーザーによって送信されたすべてのメッセージに対して表示されるユーザー。

ExtraNotificationId

INTENT_CATEGORY_NOTIFICATION_PREFERENCESの省略可能な追加。

ExtraNotificationTag

INTENT_CATEGORY_NOTIFICATION_PREFERENCESの省略可能な追加。

ExtraPeople

この定数は、API レベル 28 では非推奨になりました。

ExtraPeopleList

extras キー: この通知が関連するユーザーを含む Person オブジェクトの arrayList。

ExtraPicture

extras キー: これは、BigPictureStyle.bigPicture(android.graphics.Bitmap) に提供される BigPictureStyle 拡張通知に表示されるビットマップです。

ExtraPictureContentDescription

extras key: これは、BigPictureStyle.setContentDescription(CharSequence) に提供される BigPictureStyle.bigPicture(Bitmap) から提供される全体像の内容の説明です。

ExtraPictureIcon

extras キー: これは、BigPictureStyle.bigPicture(Icon) に提供される BigPictureStyle 拡張通知に表示されるイメージのアイコンです。

ExtraProgress

extras キー: これは Builder.setProgress(int,int,boolean) に指定された進行状況の値です。

ExtraProgressIndeterminate

extras キー: 進行状況バーが不確定かどうか、Builder.setProgress(int,int,boolean) に渡されます。

ExtraProgressMax

extras キー: これは Builder.setProgress(int,int,boolean) に指定された最大値です。

ExtraRemoteInputDraft

ユーザーが RemoteInput をクリックしたときに通知に未送信の下書きが含まれていた場合は、このキーを使用して、下書きを文字列として contentIntent に追加します。

ExtraRemoteInputHistory

extras キー: これは、Builder.setRemoteInputHistory(CharSequence[]) に提供されるリモート入力履歴です。

ExtraRequestPromotedOngoing

NotificationManager を使用してユーザーに永続的な通知を表示する方法を表すクラス。

ExtraSelfDisplayName

この定数は、API レベル 28 では非推奨になりました。

ExtraShowBigPictureWhenCollapsed

extras キー: これは、BigPictureStyle 通知の折りたたまれた状態で全体像が表示されることを示すブール値です。

ExtraShowChronometer

extras キー: Builder.setUsesChronometer(boolean) に指定されたタイムスタンプではなく、カウントアップ タイマー (具体的には Chronometer) として表示する必要があるタイミングかどうか。

ExtraShowWhen

extras キー: Builder.setShowWhen(boolean) に指定されたとおりに、いつ表示するかを指定します。

ExtraSmallIcon

この定数は、API レベル 26 では非推奨になりました。

ExtraSubText

extras キー: Builder.setSubText(CharSequence) に指定された 3 行目のテキストです。

ExtraSummaryText

extras キー: これは、(例: BigTextStyle.setSummaryText(CharSequence) に提供される拡張通知と共に表示されることを意図した概要情報の行です。

ExtraTemplate

extras キー: この通知の作成に使用される特定の Notification.Style の名前を表す文字列。

ExtraText

extras キー: これは、Builder.setContentText(CharSequence) に提供されるメイン テキスト ペイロードです。

ExtraTextLines

extras キー: InboxStyle 拡張通知に表示する CharSequences の配列。各通知は InboxStyle.addLine(CharSequence) に提供されました。

ExtraTitle

extras キー: これは、Builder.setContentTitle(CharSequence) に提供される通知のタイトルです。

ExtraTitleBig

extras キー: これは、展開された形式で表示された場合の通知のタイトルです(例:

ExtraVerificationIcon

extras キー: Notification.CallStyle 通知で呼び出し元の確認状態として表示されるアイコン。

ExtraVerificationText

extras キー: Notification.CallStyle 通知で呼び出し元の確認状態として表示されるテキスト。

FlagPromotedOngoing
古い.

この通知が昇格された継続的な通知である場合、システムによって設定されるフラグ フィールドにビットごとの ORed になるビット。これは、hasPromotableCharacteristics() があり、ユーザーがこのアプリの機能を無効にしていないためです。

ForegroundServiceDefault
古い.

フォアグラウンド サービスの開始に関連付けられている通知がこの動作で Notification.Builder.setForegroundServiceBehavior(int) を使用してビルドされている場合、通常、通知の表示は、ユーザーに対する視覚的な乱れを避けるために短時間抑制されます。

ForegroundServiceDeferred
古い.

フォアグラウンド サービスの開始に関連付けられている通知がこの動作で Notification.Builder.setForegroundServiceBehavior(int) を使用してビルドされている場合、通常、通知の表示は、ユーザーに対する視覚的な乱れを避けるために短時間抑制されます。

ForegroundServiceImmediate
古い.

この動作で Notification.Builder.setForegroundServiceBehavior(int) を使用してフォアグラウンド サービスの開始に関連付けられている通知がビルドされている場合、既定の動作が短時間の可視性を延期する場合でも、通知の表示はすぐに行われます。

IntentCategoryNotificationPreferences

含まれているアプリケーションの通知設定を調整するためのユーザー インターフェイスを提供するアクティビティ。

PriorityDefault

この定数は、API レベル 26 では非推奨になりました。

PriorityHigh

この定数は、API レベル 26 では非推奨になりました。

PriorityLow

この定数は、API レベル 26 では非推奨になりました。

PriorityMax

この定数は、API レベル 26 では非推奨になりました。

PriorityMin

この定数は、API レベル 26 では非推奨になりました。

プロパティ

名前 説明
Actions

Builder.addAction(int,CharSequence,PendingIntent) によってこの通知にアタッチされているすべての Action 構造体の配列。

AllowSystemGeneratedContextualActions

プラットフォームがこの通知のコンテキスト アクションを生成することを (アプリ開発者が) 許可するかどうかを返します。

AudioAttributes

このフィールドは、API レベル 26 では非推奨になりました。

AudioAttributesDefault

audioAttributes の既定値。

AudioStreamType
古い.

このフィールドは、API レベル 21 では非推奨になりました。

BadgeIconType

バーディングをサポートするランチャーに表示されている場合に、この通知に表示するアイコンを返します。

BigContentView

ContentView の大きな形式のバージョン。展開すると通知により詳細が表示されます。

Category

この通知を最もよく説明する定義済みの通知カテゴリの 1 つ (CATEGORY_* 定数を参照)。

ChannelId

この通知が投稿するチャネルの ID を返します。

Class

この Objectのランタイム クラスを返します。

(継承元 Object)
Color

この通知を表示するときに標準のスタイル テンプレートによって適用されるアクセント カラー (Color の定数のような ARGB 整数)。

ContentIntent

展開された状態エントリがクリックされたときに実行する意図。

ContentView

通知一覧でこの通知を表すビュー (ステータス バーから下にプルされます)。

ContextualActions

この通知のアクションのうち、コンテキスト (つまり、通知の内容が原因で推奨される) アクションを返します。

Creator

Notification オブジェクトをインスタンス化する Parcelable.Creator

Defaults

このフィールドは、API レベル 26 では非推奨になりました。

DeleteIntent

[すべてクリア] ボタンを使用するか、個別にスワイプして、ユーザーが通知を明示的に閉じるときに実行する意図。

Extras

この通知で引き継ぐ追加のセマンティック データ。

Flags

NotificationManager を使用してユーザーに永続的な通知を表示する方法を表すクラス。

FullScreenIntent

ステータス バーに通知を投稿する代わりに起動する意図。

Group

このようなレンダリングをサポートするデバイス上の他の通知と共に、この通知をクラスターまたはスタックにグループ化するために使用するキーを取得します。

GroupAlertBehavior

グループ内のどの種類の通知がユーザーに通知するかを示すメッセージを返します。

Handle

基になる Android インスタンスへのハンドル。

(継承元 Object)
HasImage

NotificationManager を使用してユーザーに永続的な通知を表示する方法を表すクラス。

HasPromotableCharacteristics

通知がFLAG_PROMOTED_ONGOINGの対象となるすべての特性を持っているかどうかを返します。

HasSummarizedContent

NotificationManager を使用してユーザーに永続的な通知を表示する方法を表すクラス。

HeadsUpContentView

ContentView の中形式バージョン。通知に contentView にアクション ボタンを追加する機会を提供します。

Icon

このフィールドは、API レベル 23 では非推奨になりました。

IconLevel

ステータス バーのアイコンに複数のレベルがある場合は、これを設定できます。

IsRequestPromotedOngoing

NotificationManager を使用してユーザーに永続的な通知を表示する方法を表すクラス。

JniIdentityHashCode

相互運用ランタイムによってこのJava ピアに割り当てられた ID ハッシュ コードを取得します。

(継承元 Object)
JniManagedPeerState

NotificationManager を使用してユーザーに永続的な通知を表示する方法を表すクラス。

(継承元 JavaObject)
JniPeerMembers

Android.App.Notification 用の JNI バインディング インフラストラクチャを提供します。

LargeIcon

このフィールドは、API レベル 23 では非推奨になりました。

LedARGB

このフィールドは、API レベル 26 では非推奨になりました。

LedOffMS

このフィールドは、API レベル 26 では非推奨になりました。

LedOnMS

このフィールドは、API レベル 26 では非推奨になりました。

LocusId

この通知に関連付けられている値を取得します。

Number

この通知が表すイベントの数。

PeerReference

このJava ピアの JNI オブジェクト参照を取得します。

(継承元 Object)
Priority

このフィールドは、API レベル 26 では非推奨になりました。

PublicVersion

セキュリティで保護されたキーガードの上など、セキュリティで保護されていないコンテキストでコンテンツが表示される、この通知の置換バージョン。

SettingsText

NotificationManager を使用してユーザーに永続的な通知を表示する方法を表すクラス。

SettingsTextFormatted

Builder.setSettingsText(CharSequence) に指定された設定テキストを返します。

ShortCriticalText

通知に含まれる最も重要な情報を要約した非常に短いテキストを返します。このフィールドが設定されていない場合は null を返します。

ShortcutId

この通知が置き換える ID (ある場合) を返します。

SmallIcon

ステータス バーのこの通知を表す小さなアイコン。

SortKey

同じパッケージからの他の通知の中でこの通知を並べ替える並べ替えキーを取得します。

Sound

このフィールドは、API レベル 26 では非推奨になりました。

ThresholdClass

Android.App.Notification 用の JNI バインディング インフラストラクチャを提供します。

ThresholdType

Android.App.Notification 用の JNI バインディング インフラストラクチャを提供します。

TickerText

アクセシビリティ サービスのこの通知を要約したテキスト。

TickerView
古い.

以前は、tickerText を示すビューです。

TimeoutAfter

この通知がまだ取り消されていない場合は、この通知を取り消す必要がある投稿からの期間を返します。

Vibrate

このフィールドは、API レベル 26 では非推奨になりました。

Visibility

この通知の可視性の範囲。これは、信頼されていない状況 (つまり、セキュリティで保護されたロック画面と画面共有中) に SystemUI が通知の存在と内容を表示する方法とタイミングに影響します。

When

エポックからのミリ秒単位で、この通知に関連するタイムスタンプ。

メソッド

名前 説明
Clone()

このオブジェクトのコピーを作成して返します。

Construct(JniObjectReference, JniObjectReferenceOptions)

NotificationManager を使用してユーザーに永続的な通知を表示する方法を表すクラス。

(継承元 JavaObject)
DescribeContents()

この Parcelable インスタンスのマーシャリングされた表現に含まれる特殊なオブジェクトの種類について説明します。

Dispose()

このJava ピアによって保持されているリソースを解放します。

(継承元 Object)
Dispose(Boolean)

このJava ピアによって保持されているリソースを解放します。

(継承元 Object)
DisposeUnlessReferenced()

NotificationManager を使用してユーザーに永続的な通知を表示する方法を表すクラス。

(継承元 JavaObject)
Equals(Object)

NotificationManager を使用してユーザーに永続的な通知を表示する方法を表すクラス。

(継承元 JavaObject)
Equals(Object)

他のオブジェクトがこのオブジェクトと "等しい" かどうかを示します。

(継承元 Object)
FindRemoteInputActionPair(Boolean)

リモート入力とそれに対応するアクションを検索して返します。

GetBubbleMetadata()

既存のフォアグラウンド アクティビティのフローティング ウィンドウにアプリコンテンツを表示するために使用されるバブル メタデータを返します。

GetHashCode()

オブジェクトのハッシュ コード値を返します。

(継承元 Object)
GetLargeIcon()

この通知のコンテンツ ビューに表示される大きなアイコン。

JavaFinalize()

オブジェクトへの参照がなくなったとガベージ コレクションによって判断されたときに、オブジェクトのガベージ コレクターによって呼び出されます。

(継承元 Object)
Notify()

このオブジェクトのモニターで待機している 1 つのスレッドを起動します。

(継承元 Object)
NotifyAll()

このオブジェクトのモニターで待機しているすべてのスレッドを起動します。

(継承元 Object)
SetHandle(IntPtr, JniHandleOwnership)

Handle プロパティを設定します。

(継承元 Object)
SetLatestEventInfo(Context, ICharSequence, ICharSequence, PendingIntent)
古い.

#contentView フィールドを標準の "最新イベント" レイアウトのビューに設定します。

SetLatestEventInfo(Context, String, String, PendingIntent)
古い.

#contentView フィールドを標準の "最新イベント" レイアウトのビューに設定します。

SetPeerReference(JniObjectReference, JniObjectReferenceOptions)

NotificationManager を使用してユーザーに永続的な通知を表示する方法を表すクラス。

(継承元 JavaObject)
ToArray<T>()

このJava配列ラッパーからマネージド配列を作成します。

(継承元 Object)
ToString()

オブジェクトの文字列形式を返します。

(継承元 Object)
UnregisterFromRuntime()

相互運用ランタイムからこのJava ピアの登録を解除します。

(継承元 Object)
Wait()

現在のスレッドが起動するまで待機します。通常は、 <em>notified</em> または <em>interrupted</em>。

(継承元 Object)
Wait(Int64, Int32)

現在のスレッドは、通常、 <em>notified</em> または <em>interrupted</em>、または一定のリアルタイムが経過するまで、起動されるまで待機します。

(継承元 Object)
Wait(Int64)

現在のスレッドは、通常、 <em>notified</em> または <em>interrupted</em>、または一定のリアルタイムが経過するまで、起動されるまで待機します。

(継承元 Object)
WriteToParcel(Parcel, ParcelableWriteFlags)

この通知をパーセルにフラット化します。

明示的なインターフェイスの実装

名前 説明
IJavaPeerable.Disposed()

NotificationManager を使用してユーザーに永続的な通知を表示する方法を表すクラス。

(継承元 JavaObject)
IJavaPeerable.Finalized()

NotificationManager を使用してユーザーに永続的な通知を表示する方法を表すクラス。

(継承元 JavaObject)
IJavaPeerable.JniObjectReferenceControlBlock

NotificationManager を使用してユーザーに永続的な通知を表示する方法を表すクラス。

(継承元 JavaObject)
IJavaPeerable.SetJniIdentityHashCode(Int32)

NotificationManager を使用してユーザーに永続的な通知を表示する方法を表すクラス。

(継承元 JavaObject)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)

NotificationManager を使用してユーザーに永続的な通知を表示する方法を表すクラス。

(継承元 JavaObject)
IJavaPeerable.SetPeerReference(JniObjectReference)

NotificationManager を使用してユーザーに永続的な通知を表示する方法を表すクラス。

(継承元 JavaObject)
IJavaPeerable.UnregisterFromRuntime()

NotificationManager を使用してユーザーに永続的な通知を表示する方法を表すクラス。

拡張メソッド

名前 説明
GetJniTypeName(IJavaPeerable)

インスタンス selfの型の JNI 名を取得します。

JavaAs<TResult>(IJavaPeerable)

selfを強制的にTResult入力し、強制型がJava側で有効であることを確認します。

JavaCast<TResult>(IJavaObject)

Android ランタイムチェック型変換を実行します。

JavaCast<TResult>(IJavaObject)

NotificationManager を使用してユーザーに永続的な通知を表示する方法を表すクラス。

TryJavaCast<TResult>(IJavaPeerable, TResult)

selfを強制的にTResult入力し、強制型がJava側で有効であることを確認します。

適用対象