Condividi tramite


Notification Classe

Definizione

Classe che rappresenta la modalità di presentazione di una notifica permanente all'utente tramite .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
Ereditarietà
Notification
Attributi
Implementazioni

Commenti

Classe che rappresenta la modalità di presentazione di una notifica permanente all'utente tramite .android.app.NotificationManager

L'oggetto Notification.Builder Notification.Builder è stato aggiunto per semplificare la creazione di notifiche.

<div class="special reference"><h3>Developer Guides</h3>

Per una guida alla creazione di notifiche, leggere la guida per gli sviluppatori delle notifiche della barra di stato.

</Div>

Documentazione java per android.app.Notification.

Le parti di questa pagina sono modifiche basate sul lavoro creato e condiviso dal Android e usato in base ai termini descritti in 2.5 Attribution License Creative Commons 2.5 Attribution License.

Costruttori

Notification()

Costruisce un oggetto Notification con valori predefiniti.

Notification(Int32, ICharSequence)

Costruisce un Notification oggetto con le informazioni necessarie per avere un'icona della barra di stato senza la visualizzazione espansa standard.

Notification(Int32, ICharSequence, Int64)
Obsoleti.

Costruisce un oggetto Notification con le informazioni necessarie per avere un'icona della barra di stato senza la visualizzazione espansa standard.

Notification(Int32, String)

Costruisce un Notification oggetto con le informazioni necessarie per avere un'icona della barra di stato senza la visualizzazione espansa standard.

Notification(Int32, String, Int64)

Costruisce un oggetto Notification con le informazioni necessarie per avere un'icona della barra di stato senza la visualizzazione espansa standard.

Notification(IntPtr, JniHandleOwnership)

Costruttore utilizzato durante la creazione di rappresentazioni gestite di oggetti JNI; chiamato dal runtime.

Notification(Parcel)

Sgonfia la notifica da un pacco.

Campi

CategoryAlarm

Categoria di notifica: allarme o timer.

CategoryCall

Categoria di notifica: chiamata in ingresso (voce o video) o richiesta di comunicazione sincrona simile.

CategoryEmail

Categoria di notifica: messaggio bulk asincrono (posta elettronica).

CategoryError

Categoria di notifica: errore nell'operazione in background o nello stato di autenticazione.

CategoryEvent

Categoria di notifica: evento del calendario.

CategoryLocationSharing

Categoria di notifica: posizione di condivisione temporanea.

CategoryMessage

Categoria di notifica: messaggio diretto in arrivo (SMS, messaggio istantaneo e così via.

CategoryMissedCall

Categoria di notifica: chiamata non riuscita.

CategoryNavigation

Categoria di notifica: navigazione a turni della mappa.

CategoryProgress

Categoria di notifica: stato di un'operazione in background a esecuzione prolungata.

CategoryPromo

Categoria di notifica: promozione o annuncio pubblicitario.

CategoryRecommendation

Categoria di notifica: una raccomandazione specifica e tempestiva per un'unica cosa.

CategoryReminder

Categoria di notifica: promemoria pianificato dall'utente.

CategoryService

Categoria di notifica: indicazione dell'esecuzione del servizio in background.

CategorySocial

Categoria di notifica: aggiornamento di social network o condivisione.

CategoryStatus

Categoria di notifica: informazioni in corso sullo stato del dispositivo o contestuale.

CategoryStopwatch

Categoria di notifica: esecuzione del controllo di arresto.

CategorySystem

Categoria di notifica: aggiornamento dello stato del sistema o del dispositivo.

CategoryTransport

Categoria di notifica: controllo del trasporto multimediale per la riproduzione.

CategoryWorkout

Categoria di notifica: monitoraggio dell'allenamento di un utente.

ColorDefault

Valore speciale per #color indicare al sistema di non decorare questa notifica con un colore speciale, ma usare invece i colori predefiniti durante la presentazione di questa notifica.

ExtraAnswerColor

#extras key: il colore usato come hint per il pulsante Azione di risposta di una android.app.Notification.CallStyle notifica.

ExtraAnswerIntent

#extras key: la finalità da inviare quando gli utenti rispondono a una android.app.Notification.CallStyle notifica.

ExtraAudioContentsUri

#extras key: il contenuto audio di questa notifica.

ExtraBackgroundImageUri

#extras chiave: rappresentazione piatta String di un'immagine android.content.ContentUris content URI che può essere visualizzata in background quando viene selezionata la notifica.

ExtraBigText

#extras chiave: questo è il testo più lungo mostrato nella forma grande di una BigTextStyle notifica, come fornito a BigTextStyle#bigText(CharSequence).

ExtraCallIsVideo

#extras chiave: indica se la android.app.Notification.CallStyle notifica è relativa a una chiamata che attiverà il video quando risponde.

ExtraCallPerson

#extras chiave: la persona da visualizzare come chiamata per la android.app.Notification.CallStyle notifica.

ExtraCallType

#extras key: tipo di chiamata rappresentata dalla android.app.Notification.CallStyle notifica.

ExtraChannelGroupId

Facoltativo aggiuntivo per #INTENT_CATEGORY_NOTIFICATION_PREFERENCES.

ExtraChannelId

Facoltativo aggiuntivo per #INTENT_CATEGORY_NOTIFICATION_PREFERENCES.

ExtraChronometerCountDown

#extras key: indica se il tempo cronologico impostato nella notifica deve essere conteggiato invece di contare.

ExtraColorized

#extras key: indica se la notifica deve essere colorata come specificato a Builder#setColorized(boolean).

ExtraCompactActions

#extras chiave: gli indici delle azioni da visualizzare nella visualizzazione compatta, come specificato a (e.

ExtraConversationTitle

#extras key: oggetto CharSequence da visualizzare come titolo in una conversazione rappresentata da un android.app.Notification.MessagingStyle

ExtraDeclineColor

#extras key: il colore usato come suggerimento per il pulsante di azione Rifiuta o Blocca di una android.app.Notification.CallStyle notifica.

ExtraDeclineIntent

#extras chiave: la finalità da inviare quando gli utenti rifiutano una android.app.Notification.CallStyle notifica.

ExtraHangUpIntent

#extras chiave: la finalità da inviare quando gli utenti si bloccano una android.app.Notification.CallStyle notifica.

ExtraHistoricMessages

#extras key: matrice di android.app.Notification.MessagingStyle#addHistoricMessage historicandroid.app.Notification.MessagingStyle.Message bundle forniti da una android.app.Notification.MessagingStyle notifica.

ExtraInfoText

#extras key: si tratta di una piccola parte di testo aggiuntivo, come fornito a Builder#setContentInfo(CharSequence).

ExtraIsGroupConversation

#extras chiave: indica se la android.app.Notification.MessagingStyle notifica rappresenta una conversazione di gruppo.

ExtraLargeIcon

#extras key: si tratta di una bitmap da usare invece dell'icona piccola quando viene visualizzato il payload della notifica, come specificato a Builder#setLargeIcon(android.graphics.Bitmap).

ExtraLargeIconBig

#extras key: si tratta di una bitmap da usare invece di quella da Builder#setLargeIcon(android.graphics.Bitmap) quando la notifica viene visualizzata nel formato espanso, come specificato a BigPictureStyle#bigLargeIcon(android.graphics.Bitmap).

ExtraMediaSession

#extras key: android.media.session.MediaSession.Token oggetto associato a una android.app.Notification.MediaStyle notifica.

ExtraMessages

#extras key: matrice di android.app.Notification.MessagingStyle.Message bundle forniti da una android.app.Notification.MessagingStyle notifica.

ExtraMessagingPerson

#extras key: la persona da visualizzare per tutti i messaggi inviati dall'utente, inclusa la notifica di risposta android.app.Notification.MessagingStyle diretta.

ExtraNotificationId

Facoltativo aggiuntivo per #INTENT_CATEGORY_NOTIFICATION_PREFERENCES.

ExtraNotificationTag

Facoltativo aggiuntivo per #INTENT_CATEGORY_NOTIFICATION_PREFERENCES.

ExtraPeople

#extras key: matrice di stringhe contenente le persone a cui è correlata la notifica, ognuna delle quali è stata fornita a Builder#addPerson(String).

ExtraPeopleList

#extras key: matriceList di Person oggetti contenenti le persone a cui si riferisce questa notifica.

ExtraPicture

#extras key: si tratta di una bitmap da visualizzare nelle BigPictureStyle notifiche espanse, fornite a BigPictureStyle#bigPicture(android.graphics.Bitmap).

ExtraPictureContentDescription

#extras key: si tratta di una descrizione del contenuto dell'immagine generale fornita da BigPictureStyle#bigPicture(Bitmap), fornita a BigPictureStyle#setContentDescription(CharSequence).

ExtraPictureIcon

#extras chiave: si tratta di un'immagine Icon da visualizzare nelle BigPictureStyle notifiche espanse, fornite a BigPictureStyle#bigPicture(Icon).

ExtraProgress

#extras key: si tratta del valore di stato fornito a Builder#setProgress(int, int, boolean).

ExtraProgressIndeterminate

#extras chiave: indica se l'indicatore di stato è indeterminato, fornito a Builder#setProgress(int, int, boolean).

ExtraProgressMax

#extras key: valore massimo fornito a Builder#setProgress(int, int, boolean).

ExtraRemoteInputDraft

Se la notifica contiene una bozza non inviata per remoteInput quando l'utente ha fatto clic su di esso, la bozza verrà aggiunta come stringa aggiuntiva all'uso #contentIntent di questa chiave.

ExtraRemoteInputHistory

#extras chiave: si tratta della cronologia di input remoto, come fornito a Builder#setRemoteInputHistory(CharSequence[]).

ExtraSelfDisplayName

#extras key: nome utente da visualizzare per tutti i messaggi inviati dall'utente, inclusa la notifica di risposta android.app.Notification.MessagingStyle diretta.

ExtraShowBigPictureWhenCollapsed

#extras key: si tratta di un valore booleano che indica che BigPictureStyle#bigPicture(Bitmap) big picture deve essere visualizzato nello stato compresso di una BigPictureStyle notifica.

ExtraShowChronometer

#extras key: indica se #when deve essere visualizzato come timer di conteggio (in particolare un android.widget.Chronometer) invece di un timestamp, come specificato a Builder#setUsesChronometer(boolean).

ExtraShowWhen

#extras key: indica se #when deve essere visualizzato, come specificato a Builder#setShowWhen(boolean).

ExtraSmallIcon

#extras chiave: si tratta dell'ID risorsa dell'icona piccola principale della notifica, come fornito a Builder#setSmallIcon(int).

ExtraSubText

#extras key: si tratta di una terza riga di testo, come specificato a Builder#setSubText(CharSequence).

ExtraSummaryText

#extras chiave: si tratta di una riga di informazioni di riepilogo che deve essere visualizzata insieme alle notifiche espanse, come fornito a (e.

ExtraTemplate

#extras key: stringa che rappresenta il nome dell'oggetto specifico android.app.Notification.Style utilizzato per creare questa notifica.

ExtraText

#extras key: si tratta del payload di testo principale, come fornito a Builder#setContentText(CharSequence).

ExtraTextLines

#extras key: matrice di caratteri da visualizzare nelle InboxStyle notifiche espanse, ognuna delle quali è stata fornita a InboxStyle#addLine(CharSequence).

ExtraTitle

#extras chiave: si tratta del titolo della notifica, come specificato a Builder#setContentTitle(CharSequence).

ExtraTitleBig

#extras chiave: questo è il titolo della notifica quando viene visualizzato in formato espanso, e.

ExtraVerificationIcon

#extras key: l'icona da visualizzare come stato di verifica del chiamante in una android.app.Notification.CallStyle notifica.

ExtraVerificationText

#extras key: il testo da visualizzare come stato di verifica del chiamante in una android.app.Notification.CallStyle notifica.

ForegroundServiceDefault
Obsoleti.

Se la notifica associata all'avvio di un servizio in primo piano è stata compilata usando setForegroundServiceBehavior() con questo comportamento, la visualizzazione della notifica verrà in genere eliminata per un breve periodo di tempo per evitare disturbi visivi all'utente.

ForegroundServiceDeferred
Obsoleti.

Se la notifica associata all'avvio di un servizio in primo piano è stata compilata usando setForegroundServiceBehavior() con questo comportamento, la visualizzazione della notifica verrà in genere eliminata per un breve periodo di tempo per evitare disturbi visivi all'utente.

ForegroundServiceImmediate
Obsoleti.

Se la notifica associata all'avvio di un servizio in primo piano è stata compilata usando setForegroundServiceBehavior() con questo comportamento, la visualizzazione della notifica sarà immediata anche se il comportamento predefinito sarebbe rinviare la visibilità per un breve periodo di tempo.

IntentCategoryNotificationPreferences

Attività che fornisce un'interfaccia utente per regolare le preferenze di notifica per l'applicazione che lo contiene.

PriorityDefault

Notifica #prioritypredefinita.

PriorityHigh

Superiore #priority, per notifiche o avvisi più importanti.

PriorityLow

Inferiore #priorityper gli elementi meno importanti.

PriorityMax

Massimo #priority, per gli elementi più importanti dell'applicazione che richiedono l'attenzione o l'input dell'utente.

PriorityMin

Minimo #priority. Questi elementi potrebbero non essere visualizzati all'utente, ad eccezione di circostanze particolari, ad esempio i log di notifica dettagliati.

Proprietà

Actions

Matrice di tutte le Action strutture associate a questa notifica da Builder#addAction(int, CharSequence, PendingIntent).

AllowSystemGeneratedContextualActions

Restituisce un valore che indica se la piattaforma è consentita (dallo sviluppatore di app) per generare azioni contestuali per questa notifica.

AudioAttributes

Oggetto AudioAttributes audio attributes da utilizzare durante la riproduzione del suono.

AudioAttributesDefault

Valore predefinito di #audioAttributes.

AudioStreamType
Obsoleti.

Tipo di flusso audio da usare durante la riproduzione del suono.

BadgeIconType

Restituisce l'icona che deve essere visualizzata per questa notifica se viene visualizzata in un utilità di avvio che supporta il badging.

BigContentView

Una versione in formato grande di #contentView, che offre alla notifica l'opportunità di visualizzare altri dettagli.

Category

Una delle categorie di notifica predefinite (vedere le CATEGORY_* costanti) che descrive meglio questa notifica.

ChannelId

Restituisce l'ID del canale a cui viene inviata la notifica.

Class

Restituisce la classe di runtime di questo Objectoggetto .

(Ereditato da Object)
Color

Colore principale (numero intero ARGB come le costanti in android.graphics.Color) da applicare ai modelli di stile standard durante la presentazione di questa notifica.

ContentIntent

Finalità da eseguire quando si fa clic sulla voce di stato espansa.

ContentView

Visualizzazione che rappresenterà questa notifica nell'elenco di notifiche , che viene trascinata verso il basso dalla barra di stato.

ContextualActions

Restituisce le azioni contestuali, ovvero suggerite a causa del contenuto della notifica, dalle azioni in questa notifica.

Creator

Particellabile.

Defaults

Specifica quali valori devono essere ricavati dalle impostazioni predefinite.

DeleteIntent

Finalità da eseguire quando la notifica viene ignorata in modo esplicito dall'utente, con il pulsante "Cancella tutto" o scorrendo la notifica singolarmente.

Extras

Dati semantici aggiuntivi da trasportare con questa notifica.

Flags
FullScreenIntent

Intento di avviare invece di pubblicare la notifica sulla barra di stato.

Group

Ottenere la chiave usata per raggruppare questa notifica in un cluster o in uno stack con altre notifiche nei dispositivi che supportano tale rendering.

GroupAlertBehavior

Restituisce il tipo di notifiche in un gruppo responsabile dell'invio di avvisi udibili all'utente.

Handle

Handle per l'istanza di Android sottostante.

(Ereditato da Object)
HasImage

Classe che rappresenta la modalità di presentazione di una notifica permanente all'utente tramite .android.app.NotificationManager

HeadsUpContentView

Versione in formato medio di #contentView, che fornisce la notifica un'opportunità per aggiungere pulsanti di azione a contentView.

Icon

ID risorsa di un oggetto drawable da usare come icona nella barra di stato.

IconLevel

Se l'icona nella barra di stato deve avere più di un livello, è possibile impostarla.

JniIdentityHashCode

Classe che rappresenta la modalità di presentazione di una notifica permanente all'utente tramite .android.app.NotificationManager

(Ereditato da Object)
JniPeerMembers

Classe che rappresenta la modalità di presentazione di una notifica permanente all'utente tramite .android.app.NotificationManager

LargeIcon

Bitmap di grandi dimensioni da visualizzare nell'area del contenuto di notifica.

LedARGB

Colore del led.

LedOffMS

Numero di millisecondi per cui il LED deve essere spento mentre lampeggia.

LedOnMS

Numero di millisecondi in cui il LED deve essere acceso mentre lampeggia.

LocusId

Ottiene l'oggetto LocusId associato a questa notifica.

Number

Numero di eventi rappresentato da questa notifica.

PeerReference

Classe che rappresenta la modalità di presentazione di una notifica permanente all'utente tramite .android.app.NotificationManager

(Ereditato da Object)
Priority

Priorità relativa per questa notifica.

PublicVersion

Versione sostitutiva di questa notifica il cui contenuto verrà visualizzato in un contesto non sicuro, ad esempio in cima a una protezione della chiave.

SettingsText

Classe che rappresenta la modalità di presentazione di una notifica permanente all'utente tramite .android.app.NotificationManager

SettingsTextFormatted

Restituisce il testo delle impostazioni fornito a Builder#setSettingsText(CharSequence).

ShortcutId

Restituisce l'oggetto ShortcutInfo#getId() id che la notifica sostituisce, se presente.

SmallIcon

Icona piccola che rappresenta questa notifica nella barra di stato e nella visualizzazione contenuto.

SortKey

Ottenere una chiave di ordinamento che ordina questa notifica tra le altre notifiche dello stesso pacchetto.

Sound

Suono da riprodurre.

ThresholdClass

Questa API supporta l'infrastruttura Mono per Android e non deve essere usata direttamente dal codice.

ThresholdType

Questa API supporta l'infrastruttura Mono per Android e non deve essere usata direttamente dal codice.

TickerText

Testo che riepiloga questa notifica per i servizi di accessibilità.

TickerView
Obsoleti.

In precedenza, una visualizzazione che mostra l'oggetto #tickerText.

TimeoutAfter

Restituisce la durata della pubblicazione dopo la quale la notifica deve essere annullata dal sistema, se non è già annullata.

Vibrate

Motivo con cui vibrare.

Visibility

Sfera di visibilità di questa notifica, che influisce su come e quando SystemUI rivela la presenza e il contenuto della notifica in situazioni non attendibili (in genere, sulla schermata di blocco sicura).

When

Timestamp correlato a questa notifica, espresso in millisecondi dall'epoca.

Metodi

Clone()

Crea e restituisce una copia dell'oggetto Object.

DescribeContents()

Descrivere i tipi di oggetti speciali contenuti nella rappresentazione di marshalling di questo oggetto Parcelable.

Dispose()

Classe che rappresenta la modalità di presentazione di una notifica permanente all'utente tramite .android.app.NotificationManager

(Ereditato da Object)
Dispose(Boolean)

Classe che rappresenta la modalità di presentazione di una notifica permanente all'utente tramite .android.app.NotificationManager

(Ereditato da Object)
Equals(Object)

Indica se un altro oggetto è "uguale a" questo.

(Ereditato da Object)
FindRemoteInputActionPair(Boolean)

Trova e restituisce un input remoto e l'azione corrispondente.

GetBubbleMetadata()

Restituisce i metadati delle bolle che verranno usati per visualizzare il contenuto dell'app in una finestra mobile sull'attività in primo piano esistente.

GetHashCode()

Restituisce un valore del codice hash per l'oggetto.

(Ereditato da Object)
GetLargeIcon()

Icona grande visualizzata nella visualizzazione contenuto della notifica.

JavaFinalize()

Chiamato dal Garbage Collector su un oggetto quando Garbage Collection determina che non sono presenti altri riferimenti all'oggetto .

(Ereditato da Object)
Notify()

Riattiva un singolo thread in attesa del monitor dell'oggetto.

(Ereditato da Object)
NotifyAll()

Riattiva tutti i thread in attesa del monitoraggio di questo oggetto.

(Ereditato da Object)
SetHandle(IntPtr, JniHandleOwnership)

Imposta la proprietà Handle.

(Ereditato da Object)
SetLatestEventInfo(Context, ICharSequence, ICharSequence, PendingIntent)
Obsoleti.

Imposta il #contentView campo come visualizzazione con il layout standard "Latest Event".

SetLatestEventInfo(Context, String, String, PendingIntent)
Obsoleti.

Imposta il #contentView campo come visualizzazione con il layout standard "Latest Event".

ToArray<T>()

Classe che rappresenta la modalità di presentazione di una notifica permanente all'utente tramite .android.app.NotificationManager

(Ereditato da Object)
ToString()

Restituisce una rappresentazione in formato stringa dell'oggetto.

(Ereditato da Object)
UnregisterFromRuntime()

Classe che rappresenta la modalità di presentazione di una notifica permanente all'utente tramite .android.app.NotificationManager

(Ereditato da Object)
Wait()

Fa sì che il thread corrente attenda finché non viene risvegliato, in genere eseguendo <una>notifica</em> o <em>interrotto</em>.

(Ereditato da Object)
Wait(Int64)

Fa sì che il thread corrente attenda finché non viene risvegliato, in genere eseguendo <una notifica</>em> o <em>interrotto</em> o fino a quando non è trascorsa una certa quantità di tempo reale.

(Ereditato da Object)
Wait(Int64, Int32)

Fa sì che il thread corrente attenda finché non viene risvegliato, in genere eseguendo <una notifica</>em> o <em>interrotto</em> o fino a quando non è trascorsa una certa quantità di tempo reale.

(Ereditato da Object)
WriteToParcel(Parcel, ParcelableWriteFlags)

Rendere flat questa notifica in un pacco.

Implementazioni dell'interfaccia esplicita

IJavaPeerable.Disposed()

Classe che rappresenta la modalità di presentazione di una notifica permanente all'utente tramite .android.app.NotificationManager

(Ereditato da Object)
IJavaPeerable.DisposeUnlessReferenced()

Classe che rappresenta la modalità di presentazione di una notifica permanente all'utente tramite .android.app.NotificationManager

(Ereditato da Object)
IJavaPeerable.Finalized()

Classe che rappresenta la modalità di presentazione di una notifica permanente all'utente tramite .android.app.NotificationManager

(Ereditato da Object)
IJavaPeerable.JniManagedPeerState

Classe che rappresenta la modalità di presentazione di una notifica permanente all'utente tramite .android.app.NotificationManager

(Ereditato da Object)
IJavaPeerable.SetJniIdentityHashCode(Int32)

Classe che rappresenta la modalità di presentazione di una notifica permanente all'utente tramite .android.app.NotificationManager

(Ereditato da Object)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)

Classe che rappresenta la modalità di presentazione di una notifica permanente all'utente tramite .android.app.NotificationManager

(Ereditato da Object)
IJavaPeerable.SetPeerReference(JniObjectReference)

Classe che rappresenta la modalità di presentazione di una notifica permanente all'utente tramite .android.app.NotificationManager

(Ereditato da Object)

Metodi di estensione

JavaCast<TResult>(IJavaObject)

Esegue una conversione del tipo verificato dal runtime Android.

JavaCast<TResult>(IJavaObject)

Classe che rappresenta la modalità di presentazione di una notifica permanente all'utente tramite .android.app.NotificationManager

GetJniTypeName(IJavaPeerable)

Classe che rappresenta la modalità di presentazione di una notifica permanente all'utente tramite .android.app.NotificationManager

Si applica a