Notification Classe

Definição

Uma classe que representa como uma notificação persistente deve ser apresentada ao usuário usando o 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
Herança
Notification
Atributos
Implementações

Comentários

Uma classe que representa como uma notificação persistente deve ser apresentada ao usuário usando o NotificationManager. O Notification.Builder foi adicionado para facilitar a construção de notificações.

Para obter um guia sobre como criar notificações, leia o guia do desenvolvedor de Notificações da Barra de Status.

Referência do Android para android.app.Notification.

Partes desta página são modificações baseadas no trabalho criado e compartilhado pelo Project Open Source do Open Source e usadas de acordo com os termos descritos na Creative Commons 2.5.

Construtores

Nome Description
Notification()

Constrói um objeto Notification com valores padrão.

Notification(Int32, ICharSequence, Int64)
Obsoleto.

Este construtor foi preterido.

Notification(Int32, ICharSequence)

Constrói um Notification objeto com as informações necessárias para ter um ícone de barra de status sem o modo de exibição expandido padrão.

Notification(Int32, String, Int64)

Este construtor foi preterido.

Notification(Int32, String)

Constrói um Notification objeto com as informações necessárias para ter um ícone de barra de status sem o modo de exibição expandido padrão.

Notification(IntPtr, JniHandleOwnership)

Inicializa uma representação gerenciada de um objeto de interface nativa Java existente.

Notification(Parcel)

Remova a notificação de uma parcela.

Campos

Nome Description
CategoryAlarm

Categoria de notificação: alarme ou temporizador.

CategoryCall

Categoria de notificação: chamada de entrada (voz ou vídeo) ou solicitação de comunicação síncrona semelhante.

CategoryEmail

Categoria de notificação: mensagem em massa assíncrona (email).

CategoryError

Categoria de notificação: erro na operação em segundo plano ou status de autenticação.

CategoryEvent

Categoria de notificação: evento de calendário.

CategoryLocationSharing

Categoria de notificação: local de compartilhamento temporário.

CategoryMessage

Categoria de notificação: mensagem direta de entrada (SMS, mensagem instantânea etc.).

CategoryMissedCall

Categoria de notificação: chamada perdida.

CategoryNavigation

Categoria de notificação: mapear navegação turno a turno.

CategoryProgress

Categoria de notificação: progresso de uma operação em segundo plano de execução prolongada.

CategoryPromo

Categoria de notificação: promoção ou anúncio.

CategoryRecommendation

Categoria de notificação: uma recomendação específica e oportuna para uma única coisa.

CategoryReminder

Categoria de notificação: lembrete agendado pelo usuário.

CategoryService

Categoria de notificação: indicação de execução do serviço em segundo plano.

CategorySocial

Categoria de notificação: rede social ou atualização de compartilhamento.

CategoryStatus

Categoria de notificação: informações contínuas sobre o dispositivo ou o status contextual.

CategoryStopwatch

Categoria de notificação: executando o cronômetro.

CategorySystem

Categoria de notificação: atualização de status do sistema ou do dispositivo.

CategoryTransport

Categoria de notificação: controle de transporte de mídia para reprodução.

CategoryVoicemail

Categoria de notificação: caixa postal.

CategoryWorkout

Categoria de notificação: acompanhamento do treino de um usuário.

ColorDefault

Valor especial de cor informando ao sistema para não decorar esse elemento com qualquer cor especial (mas, em vez disso, usar cores padrão do sistema).

ExtraAnswerColor

tecla extras: a cor usada como uma dica para o botão de ação Responder de uma notificação Notification.CallStyle.

ExtraAnswerIntent

chave extras: a intenção de ser enviada quando os usuários responderem a uma notificação Notification.CallStyle.

ExtraAudioContentsUri

chave extras: o conteúdo de áudio desta notificação.

ExtraBackgroundImageUri

chave extras: representação de cadeia de caracteres simples de um URI de conteúdo apontando para uma imagem que pode ser exibida em segundo plano quando a notificação é selecionada.

ExtraBigText

chave extras: este é o texto mais longo mostrado na forma expandida de uma notificação BigTextStyle, conforme fornecido para BigTextStyle.bigText(CharSequence).

ExtraCallIsVideo

chave extras: se a notificação Notification.CallStyle é para uma chamada que ativará o vídeo quando atendida.

ExtraCallPerson

chave extras: a pessoa a ser exibida como chamada para a notificação Notification.CallStyle.

ExtraCallType

chave extras: o tipo de chamada representado pela notificação Notification.CallStyle.

ExtraChannelGroupId

Extra opcional para INTENT_CATEGORY_NOTIFICATION_PREFERENCES.

ExtraChannelId

Extra opcional para INTENT_CATEGORY_NOTIFICATION_PREFERENCES.

ExtraChronometerCountDown

chave extras: se o cronômetro definido na notificação deve contar para baixo em vez de contar para cima.

ExtraColorized

chave extras: se a notificação deve ser colorada conforme fornecido para Builder.setColorized(boolean).

ExtraCompactActions

chave extras: os índices de ações a serem mostrados na exibição compacta, conforme fornecido para (por exemplo) MediaStyle.setShowActionsInCompactView(int...).

ExtraConversationTitle

chave extras: um CharSequence a ser exibido como o título para uma conversa representada por um Notification.MessagingStyle

ExtraDeclineColor

tecla extras: a cor usada como uma dica para o botão de ação Recusar ou Desligar de uma notificação Notification.CallStyle.

ExtraDeclineIntent

chave extras: a intenção de ser enviada quando os usuários recusarem uma notificação Notification.CallStyle.

ExtraHangUpIntent

chave extras: a intenção de ser enviada quando os usuários desligarem uma notificação Notification.CallStyle.

ExtraHistoricMessages

chave extras: uma matriz de pacotes históricos Notification.MessagingStyle.Message fornecidos por uma notificação Notification.MessagingStyle.

ExtraInfoText

chave extras: esta é uma pequena parte do texto adicional, conforme fornecido para Builder.setContentInfo(CharSequence).

ExtraIsGroupConversation

chave extras: se a notificação Notification.MessagingStyle representa uma conversa em grupo.

ExtraLargeIcon

Essa constante foi preterida no nível 26 da API.

ExtraLargeIconBig

chave extras: este é um bitmap a ser usado em vez do de Builder.setLargeIcon(android.graphics.Bitmap) quando a notificação é mostrada em sua forma expandida, conforme fornecido para BigPictureStyle.bigLargeIcon(android.graphics.Bitmap).

ExtraMediaSession

chave extras: Um MediaSession.Token associado a uma notificação Notification.MediaStyle.

ExtraMessages

chave extras: uma matriz de pacotes Notification.MessagingStyle.Message fornecidos por uma notificação Notification.MessagingStyle.

ExtraMessagingPerson

chave extras: a pessoa a ser exibida para todas as mensagens enviadas pelo usuário, incluindo notificação notification.MessagingStyle de respostas diretas.

ExtraNotificationId

Extra opcional para INTENT_CATEGORY_NOTIFICATION_PREFERENCES.

ExtraNotificationTag

Extra opcional para INTENT_CATEGORY_NOTIFICATION_PREFERENCES.

ExtraPeople

Essa constante foi preterida no nível 28 da API.

ExtraPeopleList

chave extras: uma arrayList de objetos person que contêm as pessoas às quais essa notificação se relaciona.

ExtraPicture

chave extras: este é um bitmap a ser mostrado em notificações expandidas do BigPictureStyle, fornecidas para BigPictureStyle.bigPicture(android.graphics.Bitmap).

ExtraPictureContentDescription

chave extras: esta é uma descrição de conteúdo do quadro geral fornecido de BigPictureStyle.bigPicture(Bitmap), fornecido para BigPictureStyle.setContentDescription(CharSequence).

ExtraPictureIcon

chave extras: este é um ícone de uma imagem a ser mostrada nas notificações expandidas do BigPictureStyle, fornecidas para BigPictureStyle.bigPicture(Icon).

ExtraProgress

chave extras: esse é o valor de progresso fornecido para Builder.setProgress(int, int,boolean).

ExtraProgressIndeterminate

chave extras: se a barra de progresso é indeterminada, fornecida para Builder.setProgress(int,int,booleano).

ExtraProgressMax

chave extras: esse é o valor máximo fornecido para Builder.setProgress(int,int,boolean).

ExtraRemoteInputDraft

Se a notificação contiver um rascunho não relacionado para um RemoteInput quando o usuário clicou nele, estamos adicionando o rascunho como um extra de cadeia de caracteres ao contentIntent usando essa chave.

ExtraRemoteInputHistory

chave extras: este é o histórico de entrada remoto, conforme fornecido para Builder.setRemoteInputHistory(CharSequence[]).

ExtraRequestPromotedOngoing

Uma classe que representa como uma notificação persistente deve ser apresentada ao usuário usando o NotificationManager.

ExtraSelfDisplayName

Essa constante foi preterida no nível 28 da API.

ExtraShowBigPictureWhenCollapsed

chave extras: este é um booliano para indicar que o quadro geral deve ser mostrado no estado recolhido de uma notificação BigPictureStyle.

ExtraShowChronometer

chave extras: se quando deve ser mostrado como um temporizador de contagem (especificamente um Cronômetro) em vez de um carimbo de data/hora, conforme fornecido para Builder.setUsesChronometer(booleano).

ExtraShowWhen

chave extras: se quando deve ser mostrado, conforme fornecido para Builder.setShowWhen(boolean).

ExtraSmallIcon

Essa constante foi preterida no nível 26 da API.

ExtraSubText

chave extras: esta é uma terceira linha de texto, conforme fornecido para Builder.setSubText(CharSequence).

ExtraSummaryText

chave extras: esta é uma linha de informações resumidas que devem ser mostradas junto com notificações expandidas, conforme fornecido para (por exemplo) BigTextStyle.setSummaryText(CharSequence).

ExtraTemplate

chave extras: uma cadeia de caracteres que representa o nome do Notification.Style específico usado para criar essa notificação.

ExtraText

chave extras: essa é a carga de texto principal, conforme fornecido para Builder.setContentText(CharSequence).

ExtraTextLines

chave extras: uma matriz de CharSequences para mostrar no InboxStyle notificações expandidas, cada uma das quais foi fornecida para InboxStyle.addLine(CharSequence).

ExtraTitle

chave extras: este é o título da notificação, conforme fornecido para Builder.setContentTitle(CharSequence).

ExtraTitleBig

chave extras: esse é o título da notificação quando mostrado no formulário expandido, por exemplo,

ExtraVerificationIcon

tecla extras: o ícone a ser exibido como um status de verificação do chamador em uma notificação Notification.CallStyle.

ExtraVerificationText

chave extras: o texto a ser exibido como um status de verificação do chamador em uma notificação Notification.CallStyle.

FlagPromotedOngoing
Obsoleto.

Bit a ser bit a bit-ORed no campo sinalizadores que deve ser definido pelo sistema se essa notificação for uma notificação contínua promovida, tanto porque tem HasPromotableCharacteristics() e o usuário não desabilitou o recurso para este aplicativo.

ForegroundServiceDefault
Obsoleto.

Se a Notificação associada ao início de um serviço em primeiro plano tiver sido criada usando Notification.Builder.setForegroundServiceBehavior(int) com esse comportamento, a exibição da notificação geralmente será suprimida por um curto período de tempo para evitar distúrbios visuais para o usuário.

ForegroundServiceDeferred
Obsoleto.

Se a Notificação associada ao início de um serviço em primeiro plano tiver sido criada usando Notification.Builder.setForegroundServiceBehavior(int) com esse comportamento, a exibição da notificação geralmente será suprimida por um curto período de tempo para evitar distúrbios visuais para o usuário.

ForegroundServiceImmediate
Obsoleto.

Se a Notificação associada ao início de um serviço em primeiro plano tiver sido criada usando Notification.Builder.setForegroundServiceBehavior(int) com esse comportamento, a exibição da notificação será imediata mesmo se o comportamento padrão for adiar a visibilidade por um curto período de tempo.

IntentCategoryNotificationPreferences

Uma atividade que fornece uma interface do usuário para ajustar as preferências de notificação para seu aplicativo que contém.

PriorityDefault

Essa constante foi preterida no nível 26 da API.

PriorityHigh

Essa constante foi preterida no nível 26 da API.

PriorityLow

Essa constante foi preterida no nível 26 da API.

PriorityMax

Essa constante foi preterida no nível 26 da API.

PriorityMin

Essa constante foi preterida no nível 26 da API.

Propriedades

Nome Description
Actions

Matriz de todas as estruturas de ação anexadas a essa notificação por Builder.addAction(int,CharSequence,PendingIntent).

AllowSystemGeneratedContextualActions

Retorna se a plataforma é permitida (pelo desenvolvedor do aplicativo) para gerar ações contextuais para essa notificação.

AudioAttributes

Esse campo foi preterido no nível 26 da API.

AudioAttributesDefault

O valor padrão de audioAttributes.

AudioStreamType
Obsoleto.

Esse campo foi preterido no nível 21 da API.

BadgeIconType

Retorna qual ícone deve ser mostrado para essa notificação se ela estiver sendo exibida em um Iniciador que dá suporte à falsificação.

BigContentView

Uma versão em formato grande do contentView, dando à Notificação a oportunidade de mostrar mais detalhes quando expandida.

Category

Uma das categorias de notificação predefinidas (consulte as constantes CATEGORY_*) que melhor descreve essa Notificação.

ChannelId

Retorna a ID do canal para a qual esta notificação é postada.

Class

Retorna a classe de runtime deste Object.

(Herdado de Object)
Color

Cor de ênfase (um inteiro ARGB como as constantes em Cor) a ser aplicado pelos modelos de estilo padrão ao apresentar essa notificação.

ContentIntent

A intenção de executar quando a entrada de status expandida é clicada.

ContentView

A exibição que representará essa notificação na lista de notificação (que é retirada da barra de status).

ContextualActions

Retorna as ações contextuais (ou seja, sugeridas devido ao conteúdo da notificação) das ações nesta notificação.

Creator

Parcelable.Creator que cria uma instância de objetos de notificação

Defaults

Esse campo foi preterido no nível 26 da API.

DeleteIntent

A intenção de executar quando a notificação é explicitamente ignorada pelo usuário, seja com o botão "Limpar Tudo" ou deslizando-a individualmente.

Extras

Dados semânticos adicionais a serem transportados com esta Notificação.

Flags

Uma classe que representa como uma notificação persistente deve ser apresentada ao usuário usando o NotificationManager.

FullScreenIntent

Uma intenção de iniciar em vez de postar a notificação na barra de status.

Group

Obtenha a chave usada para agrupar essa notificação em um cluster ou pilha com outras notificações em dispositivos que dão suporte a essa renderização.

GroupAlertBehavior

Retorna qual tipo de notificações em um grupo é responsável por alertar audivelmente o usuário.

Handle

O identificador para a instância subjacente do Android.

(Herdado de Object)
HasImage

Uma classe que representa como uma notificação persistente deve ser apresentada ao usuário usando o NotificationManager.

HasPromotableCharacteristics

Retorna se a notificação tem todas as características que a tornam qualificada para FLAG_PROMOTED_ONGOING.

HasSummarizedContent

Uma classe que representa como uma notificação persistente deve ser apresentada ao usuário usando o NotificationManager.

HeadsUpContentView

Uma versão de formato médio do contentView, fornecendo à Notificação uma oportunidade de adicionar botões de ação ao contentView.

Icon

Esse campo foi preterido no nível 23 da API.

IconLevel

Se o ícone na barra de status tiver mais de um nível, você poderá definir isso.

IsRequestPromotedOngoing

Uma classe que representa como uma notificação persistente deve ser apresentada ao usuário usando o NotificationManager.

JniIdentityHashCode

Obtém o código de hash de identidade atribuído a esse par Java pelo runtime de interoperabilidade.

(Herdado de Object)
JniManagedPeerState

Uma classe que representa como uma notificação persistente deve ser apresentada ao usuário usando o NotificationManager.

(Herdado de JavaObject)
JniPeerMembers

Fornece infraestrutura de associação JNI para Android.App.Notification.

LargeIcon

Esse campo foi preterido no nível 23 da API.

LedARGB

Esse campo foi preterido no nível 26 da API.

LedOffMS

Esse campo foi preterido no nível 26 da API.

LedOnMS

Esse campo foi preterido no nível 26 da API.

LocusId

Obtém o LocusId associado a esta notificação.

Number

O número de eventos que essa notificação representa.

PeerReference

Obtém a referência de objeto JNI para este par Java.

(Herdado de Object)
Priority

Esse campo foi preterido no nível 26 da API.

PublicVersion

Versão de substituição dessa notificação cujo conteúdo será mostrado em um contexto inseguro, como em cima de um chave-chave seguro.

SettingsText

Uma classe que representa como uma notificação persistente deve ser apresentada ao usuário usando o NotificationManager.

SettingsTextFormatted

Retorna o texto de configurações fornecido para Builder.setSettingsText(CharSequence).

ShortCriticalText

Retorna o texto muito curto resumindo as informações mais críticas contidas na notificação ou nulo se esse campo não foi definido.

ShortcutId

Retorna a ID que essa notificação substitui, se houver.

SmallIcon

O pequeno ícone que representa essa notificação na barra de status.

SortKey

Obtenha uma chave de classificação que ordena essa notificação entre outras notificações do mesmo pacote.

Sound

Esse campo foi preterido no nível 26 da API.

ThresholdClass

Fornece infraestrutura de associação JNI para Android.App.Notification.

ThresholdType

Fornece infraestrutura de associação JNI para Android.App.Notification.

TickerText

Texto que resume essa notificação para serviços de acessibilidade.

TickerView
Obsoleto.

Anteriormente, uma exibição mostrando o tickerText.

TimeoutAfter

Retorna a duração da postagem após a qual essa notificação deve ser cancelada pelo sistema, caso ainda não tenha sido cancelada.

Vibrate

Esse campo foi preterido no nível 26 da API.

Visibility

Esfera de visibilidade dessa notificação, que afeta como e quando o SystemUI revela a presença e o conteúdo da notificação em situações não confiáveis (ou seja, na tela de bloqueio segura e durante o compartilhamento de tela).

When

Um carimbo de data/hora relacionado a essa notificação, em milissegundos desde a época.

Métodos

Nome Description
Clone()

Cria e retorna uma cópia desse objeto.

Construct(JniObjectReference, JniObjectReferenceOptions)

Uma classe que representa como uma notificação persistente deve ser apresentada ao usuário usando o NotificationManager.

(Herdado de JavaObject)
DescribeContents()

Descreva os tipos de objetos especiais contidos na representação em marshaled desta instância parcelável.

Dispose()

Libera os recursos mantidos por esse par Java.

(Herdado de Object)
Dispose(Boolean)

Libera os recursos mantidos por esse par Java.

(Herdado de Object)
DisposeUnlessReferenced()

Uma classe que representa como uma notificação persistente deve ser apresentada ao usuário usando o NotificationManager.

(Herdado de JavaObject)
Equals(Object)

Uma classe que representa como uma notificação persistente deve ser apresentada ao usuário usando o NotificationManager.

(Herdado de JavaObject)
Equals(Object)

Indica se algum outro objeto é "igual a" este.

(Herdado de Object)
FindRemoteInputActionPair(Boolean)

Localiza e retorna uma entrada remota e sua ação correspondente.

GetBubbleMetadata()

Retorna os metadados de bolha que serão usados para exibir o conteúdo do aplicativo em uma janela flutuante sobre a atividade de primeiro plano existente.

GetHashCode()

Retorna um valor de código hash para o objeto.

(Herdado de Object)
GetLargeIcon()

O ícone grande mostrado no modo de exibição de conteúdo desta notificação.

JavaFinalize()

Chamado pelo coletor de lixo em um objeto quando a coleta de lixo determina que não há mais referências ao objeto.

(Herdado de Object)
Notify()

Ativa um único thread que está aguardando no monitor deste objeto.

(Herdado de Object)
NotifyAll()

Ativa todos os threads que estão aguardando no monitor deste objeto.

(Herdado de Object)
SetHandle(IntPtr, JniHandleOwnership)

Define a propriedade Handle

(Herdado de Object)
SetLatestEventInfo(Context, ICharSequence, ICharSequence, PendingIntent)
Obsoleto.

Define o #contentView campo como um modo de exibição com o layout padrão "Evento Mais Recente".

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

Define o #contentView campo como um modo de exibição com o layout padrão "Evento Mais Recente".

SetPeerReference(JniObjectReference, JniObjectReferenceOptions)

Uma classe que representa como uma notificação persistente deve ser apresentada ao usuário usando o NotificationManager.

(Herdado de JavaObject)
ToArray<T>()

Cria uma matriz gerenciada com base nesse wrapper de matriz Java.

(Herdado de Object)
ToString()

Retorna uma representação de cadeia de caracteres do objeto.

(Herdado de Object)
UnregisterFromRuntime()

Cancela o registro desse par Java do runtime de interoperabilidade.

(Herdado de Object)
Wait()

Faz com que o thread atual aguarde até ser despertado, normalmente por ser <notificado/em> ou <em>interrompido</em>.<>

(Herdado de Object)
Wait(Int64, Int32)

Faz com que o thread atual aguarde até que ele seja despertado, normalmente por ser <>notificado</em> ou <em>interrompido</em>, ou até que uma determinada quantidade de tempo real tenha decorrido.

(Herdado de Object)
Wait(Int64)

Faz com que o thread atual aguarde até que ele seja despertado, normalmente por ser <>notificado</em> ou <em>interrompido</em>, ou até que uma determinada quantidade de tempo real tenha decorrido.

(Herdado de Object)
WriteToParcel(Parcel, ParcelableWriteFlags)

Nivele essa notificação em uma parcela.

Implantações explícitas de interface

Nome Description
IJavaPeerable.Disposed()

Uma classe que representa como uma notificação persistente deve ser apresentada ao usuário usando o NotificationManager.

(Herdado de JavaObject)
IJavaPeerable.Finalized()

Uma classe que representa como uma notificação persistente deve ser apresentada ao usuário usando o NotificationManager.

(Herdado de JavaObject)
IJavaPeerable.JniObjectReferenceControlBlock

Uma classe que representa como uma notificação persistente deve ser apresentada ao usuário usando o NotificationManager.

(Herdado de JavaObject)
IJavaPeerable.SetJniIdentityHashCode(Int32)

Uma classe que representa como uma notificação persistente deve ser apresentada ao usuário usando o NotificationManager.

(Herdado de JavaObject)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)

Uma classe que representa como uma notificação persistente deve ser apresentada ao usuário usando o NotificationManager.

(Herdado de JavaObject)
IJavaPeerable.SetPeerReference(JniObjectReference)

Uma classe que representa como uma notificação persistente deve ser apresentada ao usuário usando o NotificationManager.

(Herdado de JavaObject)
IJavaPeerable.UnregisterFromRuntime()

Uma classe que representa como uma notificação persistente deve ser apresentada ao usuário usando o NotificationManager.

Métodos de Extensão

Nome Description
GetJniTypeName(IJavaPeerable)

Obtém o nome JNI do tipo da instância self.

JavaAs<TResult>(IJavaPeerable)

Tente coagir a digitar selfTResult, verificando se a coerção é válida no lado Java.

JavaCast<TResult>(IJavaObject)

Executa uma conversão de tipo marcada por runtime do Android.

JavaCast<TResult>(IJavaObject)

Uma classe que representa como uma notificação persistente deve ser apresentada ao usuário usando o NotificationManager.

TryJavaCast<TResult>(IJavaPeerable, TResult)

Tente coagir a digitar selfTResult, verificando se a coerção é válida no lado Java.

Aplica-se a