Most visited

Recently visited

Added in API level 1

Notification

public class Notification
extends Object implements Parcelable

java.lang.Object
   ↳ android.app.Notification


一个类,它表示如何使用 NotificationManager向用户呈现持久通知。

已添加 Notification.Builder以便更容易地构建通知。

Developer Guides

有关创建通知的指导,请阅读 Status Bar Notifications开发人员指南。

Summary

Nested classes

class Notification.Action

结构来封装可作为此通知的一部分显示的命名操作。

class Notification.BigPictureStyle

帮助程序类用于生成包含大图像附件的大幅面通知。

class Notification.BigTextStyle

用于生成包含大量文本的大格式通知的助手类。

class Notification.Builder

Notification对象的生成器类。

class Notification.CarExtender

Helper类将Android Auto扩展添加到通知。

class Notification.DecoratedCustomViewStyle

由系统装饰的自定义视图的通知样式

开发人员可以设置此风格,而不是提供完全自定义的通知,而是通过展开可供件和动作来获取系统装饰,例如通知标题。

class Notification.DecoratedMediaCustomViewStyle

媒体自定义视图的通知样式,由系统修饰

开发人员可以设置此风格,而不是提供完全自定义的媒体通知,而是通过扩展可供件和动作来获取系统装饰,例如通知标题。

interface Notification.Extender

extend(Notification.Action.Extender)一起使用的扩展器接口。

class Notification.InboxStyle

Helper类用于生成包含(最多5个)字符串列表的大型通知。

class Notification.MediaStyle

媒体播放通知的通知样式。

class Notification.MessagingStyle

Helper类用于生成包含多个不同类型的多个来回消息的大格式通知。

class Notification.Style

可以将丰富的通知样式应用于Notification.Builder对象的对象。

class Notification.WearableExtender

助手类为通知添加可穿戴扩展。

Constants

String CATEGORY_ALARM

通知类别:闹钟或定时器。

String CATEGORY_CALL

通知类别:来电(语音或视频)或类似的同步通信请求。

String CATEGORY_EMAIL

通知类别:异步批量消息(电子邮件)。

String CATEGORY_ERROR

通知类别:后台操作或身份验证状态发生错误。

String CATEGORY_EVENT

通知类别:日历事件。

String CATEGORY_MESSAGE

通知类别:传入直接消息(SMS,即时消息等)。

String CATEGORY_PROGRESS

通知类别:长时间运行的后台操作的进度。

String CATEGORY_PROMO

通知类别:促销或广告。

String CATEGORY_RECOMMENDATION

通知类别:针对单一事物的特定及时推荐。

String CATEGORY_REMINDER

通知类别:用户预定提醒。

String CATEGORY_SERVICE

通知类别:运行后台服务的指示。

String CATEGORY_SOCIAL

通知类别:社交网络或分享更新。

String CATEGORY_STATUS

通知类别:关于设备或上下文状态的持续信息。

String CATEGORY_SYSTEM

通知类别:系统或设备状态更新。

String CATEGORY_TRANSPORT

通知类别:用于播放的媒体传输控制。

int COLOR_DEFAULT

特殊值 color告诉系统不要使用任何特殊颜色修饰此通知,而是在呈现此通知时使用默认颜色。

int DEFAULT_ALL

使用所有默认值(如果适用)。

int DEFAULT_LIGHTS

使用默认通知灯。

int DEFAULT_SOUND

使用默认通知声音。

int DEFAULT_VIBRATE

使用默认通知振动。

String EXTRA_BACKGROUND_IMAGE_URI

extras键:A content URI指向选定通知时可以在后台显示的图像。

String EXTRA_BIG_TEXT

extras键:这是 Notification.BigTextStyle通知的大格式中显示的较长文本,提供给 bigText(CharSequence)

String EXTRA_CHRONOMETER_COUNT_DOWN

extras键:在通知上设置的精密计时器是否应该倒计时而不是倒计时。

String EXTRA_COMPACT_ACTIONS

extras键:提供给(例如) setShowActionsInCompactView(int)的紧凑视图中要显示的动作的索引。

String EXTRA_CONVERSATION_TITLE

extras键: CharSequence被显示为由 Notification.MessagingStyle表示的对话的标题

String EXTRA_INFO_TEXT

extras键:这是提供给 setContentInfo(CharSequence)附加文本。

String EXTRA_LARGE_ICON

extras键:显示提供给 setLargeIcon(android.graphics.Bitmap)的通知有效负载时,此位图将用来代替小图标。

String EXTRA_LARGE_ICON_BIG

extras键:这是要代替所述一个的用于从位图 setLargeIcon(android.graphics.Bitmap)当在其膨胀形式示出的通知时,作为供给到 bigLargeIcon(android.graphics.Bitmap)

String EXTRA_MEDIA_SESSION

extras关键:一个 MediaSession.Token与相关 Notification.MediaStyle通知。

String EXTRA_MESSAGES

extras键:由 Notification.MessagingStyle通知提供的 Notification.MessagingStyle.Message捆绑包的数组。

String EXTRA_PEOPLE

extras key:包含此通知相关的人员的字符串数组,每个数组都提供给 addPerson(String)

String EXTRA_PICTURE

extras键:这是一个位图,显示在 Notification.BigPictureStyle展开的通知中,提供给 bigPicture(android.graphics.Bitmap)

String EXTRA_PROGRESS

extras键:这是提供给 setProgress(int, int, boolean)的进度值。

String EXTRA_PROGRESS_INDETERMINATE

extras键:是否进度条不确定,提供给 setProgress(int, int, boolean)

String EXTRA_PROGRESS_MAX

extras键:这是提供给 setProgress(int, int, boolean)的最大值。

String EXTRA_REMOTE_INPUT_HISTORY

extras键:这是远程输入历史记录,提供给 setRemoteInputHistory(CharSequence[])

String EXTRA_SELF_DISPLAY_NAME

extras键:为用户发送的所有邮件显示的用户名,包括直接回复 Notification.MessagingStyle通知。

String EXTRA_SHOW_CHRONOMETER

extras键:是否 when显示为提供给 setUsesChronometer(boolean)Chronometer计时器(具体为 Chronometer )而不是时间戳。

String EXTRA_SHOW_WHEN

extras键:是否显示 when ,提供给 setShowWhen(boolean)

String EXTRA_SMALL_ICON

extras键:这是通知的主要小图标的资源ID,提供给 setSmallIcon(int)

String EXTRA_SUB_TEXT

extras键:这是提供给 setSubText(CharSequence)的第三行文本。

String EXTRA_SUMMARY_TEXT

extras键:这是一行概要信息,旨在与扩展通知一起显示,并提供给(例如) setSummaryText(CharSequence)

String EXTRA_TEMPLATE

extras key:表示用于创建此通知的特定 Notification.Style的名称的字符串。

String EXTRA_TEXT

extras键:这是提供给 setContentText(CharSequence)的主要文本有效载荷。

String EXTRA_TEXT_LINES

extras键:要在 Notification.InboxStyle展开的通知中显示的CharSequence数组,其中每个提供给 addLine(CharSequence)

String EXTRA_TITLE

extras键:这是提供给 setContentTitle(CharSequence)的通知的标题。

String EXTRA_TITLE_BIG

extras键:这是以扩展形式显示时通知的标题,例如

int FLAG_AUTO_CANCEL

如果通知在被用户点击时应该被取消,应将位设置成 flags字段。

int FLAG_FOREGROUND_SERVICE

如果此通知表示当前正在运行的服务,则应该将位设置到应该设置的 flags字段中。

int FLAG_GROUP_SUMMARY

如果此通知是一组通知的组摘要,则该位应该被设置成应该设置的 flags字段。

int FLAG_HIGH_PRIORITY

此常数在API级别16中已弃用。请使用priority且值为正值。

int FLAG_INSISTENT

要将位按位进入 flags字段,如果已设置,则会重复该音频,直到通知被取消或通知窗口打开。

int FLAG_LOCAL_ONLY

如果该通知仅与当前设备相关,并且不建议它桥接到其他设备,则该位应该被设置到应该设置的 flags字段中。

int FLAG_NO_CLEAR

如果在用户单击“全部清除”按钮时不应取消通知,则应该将位设置到应该设置的 flags字段中。

int FLAG_ONGOING_EVENT

如果此通知涉及某些正在进行的操作(如电话呼叫),则应将该 flags位到应该设置的 flags字段中。

int FLAG_ONLY_ALERT_ONCE

如果您只喜欢声音,振动和 flags如果通知尚未显示,则应该设置 flags字段中的位。

int FLAG_SHOW_LIGHTS

如果要将LED指示灯打开以进行此通知,应该将位置位到 flags字段中。

String INTENT_CATEGORY_NOTIFICATION_PREFERENCES

提供用户界面以调整其包含的应用程序的通知首选项的活动。

int PRIORITY_DEFAULT

默认通知 priority

int PRIORITY_HIGH

更高的 priority ,用于更重要的通知或警报。

int PRIORITY_LOW

降低 priority ,对于不太重要的项目。

int PRIORITY_MAX

最高 priority ,为您的应用程序的最重要的项目,需要用户及时的关注或输入。

int PRIORITY_MIN

最低priority ; 除特殊情况外,这些项目可能不会显示给用户,例如详细的通知日志。

int STREAM_DEFAULT

此常数在API级别21中已弃用。请改为使用audioAttributes

int VISIBILITY_PRIVATE

通知可见性:在所有锁屏上显示此通知,但隐藏安全锁屏上的敏感或隐私信息。

int VISIBILITY_PUBLIC

通知可见性:在所有锁屏上全部显示此通知。

int VISIBILITY_SECRET

通知可见性:请勿在安全锁屏上显示此通知的任何部分。

Inherited constants

From interface android.os.Parcelable

Fields

public static final AudioAttributes AUDIO_ATTRIBUTES_DEFAULT

默认值为 audioAttributes

public static final Creator<Notification> CREATOR

Parcelable.Creator实例化Notification对象

public Action[] actions

addAction(int, CharSequence, PendingIntent)附加到此通知的所有 Notification.Action结构的 addAction(int, CharSequence, PendingIntent)

public AudioAttributes audioAttributes

播放声音时使用 audio attributes

public int audioStreamType

此字段在API级别21中已弃用。请改为使用audioAttributes

public RemoteViews bigContentView

contentView的大幅面版本,为通知提供了展示更多细节的机会。

public String category

其中一个最能描述此通知的预定义通知类别(请参阅 CATEGORY_*常量)。

public int color

在呈现此通知时由标准样式模板应用的强调颜色(类似于 Color常量的ARGB整数)。

public PendingIntent contentIntent

点击展开状态条目时执行的意图。

public RemoteViews contentView

将在通知列表中显示此通知的视图(从状态栏中拉下来)。

public int defaults

指定应从默认值中获取哪些值。

public PendingIntent deleteIntent

意图在用户明确解除通知时执行,或者使用“全部清除”按钮或单独将其擦除。

public Bundle extras

使用此通知附带的附加语义数据。

public int flags

public PendingIntent fullScreenIntent

意图启动而不是将通知发布到状态栏。

public RemoteViews headsUpContentView

一个中等格式的版本 contentView ,为通知提供了向contentView添加动作按钮的机会。

public int icon

此字段在API级别23中已弃用。请改为使用setSmallIcon(Icon)

public int iconLevel

如果状态栏中的图标要具有多个级别,则可以对其进行设置。

public Bitmap largeIcon

此字段在API级别23中已弃用。请改为使用setLargeIcon(Icon)

public int ledARGB

LED的颜色。

public int ledOffMS

LED在闪烁时关闭的毫秒数。

public int ledOnMS

闪烁时LED亮起的毫秒数。

public int number

此字段在API级别24中已被弃用。此号码不再显示

public int priority

此通知的相对优先级。

public Notification publicVersion

该通知的替换版本,其内容将显示在不安全的上下文中,例如安全键盘保护程序之上。

public Uri sound

要播放的声音。

public CharSequence tickerText

汇总此无障碍服务通知的文本。

public RemoteViews tickerView

以前,一个视图显示 tickerText

public long[] vibrate

振动的模式。

public int visibility

此通知的可见范围,它影响SystemUI如何以及何时在不受信任的情况下(即安全锁屏上)显示通知的存在和内容。

public long when

与此通知相关的时间戳,以时间为单位,以毫秒为单位。

Public constructors

Notification()

使用默认值构造一个Notification对象。

Notification(int icon, CharSequence tickerText, long when)

此构造函数在API级别11中已弃用。请改为使用Notification.Builder

Notification(Parcel parcel)

从包裹解除通知。

Public methods

Notification clone()

创建并返回此对象的副本。

int describeContents()

描述此Parcelable实例的封送表示中包含的特殊对象的种类。

String getGroup()

获取用于将此通知分组到群集或堆栈中的密钥,以及支持此类呈现的设备上的其他通知。

Icon getLargeIcon()

此通知内容视图中显示的大图标。

Icon getSmallIcon()

在状态栏和内容视图中代表此通知的小图标。

String getSortKey()

获取一个排序关键字,可以从同一个包中的其他通知中排列此通知。

String toString()

返回对象的字符串表示形式。

void writeToParcel(Parcel parcel, int flags)

将此通知拼凑成一个包裹。

Inherited methods

From class java.lang.Object
From interface android.os.Parcelable

Constants

CATEGORY_ALARM

Added in API level 21
String CATEGORY_ALARM

通知类别:闹钟或定时器。

常数值:“报警”

CATEGORY_CALL

Added in API level 21
String CATEGORY_CALL

通知类别:来电(语音或视频)或类似的同步通信请求。

常量值:“call”

CATEGORY_EMAIL

Added in API level 21
String CATEGORY_EMAIL

通知类别:异步批量消息(电子邮件)。

常数值:“电子邮件”

CATEGORY_ERROR

Added in API level 21
String CATEGORY_ERROR

通知类别:后台操作或身份验证状态发生错误。

常数值:“err”

CATEGORY_EVENT

Added in API level 21
String CATEGORY_EVENT

通知类别:日历事件。

常数值:“事件”

CATEGORY_MESSAGE

Added in API level 21
String CATEGORY_MESSAGE

通知类别:传入直接消息(SMS,即时消息等)。

常量值:“msg”

CATEGORY_PROGRESS

Added in API level 21
String CATEGORY_PROGRESS

通知类别:长时间运行的后台操作的进度。

常数值:“进度”

CATEGORY_PROMO

Added in API level 21
String CATEGORY_PROMO

通知类别:促销或广告。

常数值:“促销”

CATEGORY_RECOMMENDATION

Added in API level 21
String CATEGORY_RECOMMENDATION

通知类别:针对单一事物的特定及时推荐。 例如,新闻应用可能希望推荐一个它认为用户将要接下来要阅读的新闻报道。

常数值:“推荐”

CATEGORY_REMINDER

Added in API level 23
String CATEGORY_REMINDER

通知类别:用户预定提醒。

常数值:“提醒”

CATEGORY_SERVICE

Added in API level 21
String CATEGORY_SERVICE

通知类别:运行后台服务的指示。

常数值:“服务”

CATEGORY_SOCIAL

Added in API level 21
String CATEGORY_SOCIAL

通知类别:社交网络或分享更新。

常值:“社交”

CATEGORY_STATUS

Added in API level 21
String CATEGORY_STATUS

通知类别:关于设备或上下文状态的持续信息。

常数值:“状态”

CATEGORY_SYSTEM

Added in API level 21
String CATEGORY_SYSTEM

通知类别:系统或设备状态更新。 保留供系统使用。

常量值:“sys”

CATEGORY_TRANSPORT

Added in API level 21
String CATEGORY_TRANSPORT

通知类别:用于播放的媒体传输控制。

常数值:“运输”

COLOR_DEFAULT

Added in API level 21
int COLOR_DEFAULT

color特殊值告诉系统不要用任何特殊颜色修饰此通知,而是在呈现此通知时使用默认颜色。

常量值:0(0x00000000)

DEFAULT_ALL

Added in API level 1
int DEFAULT_ALL

使用所有默认值(如果适用)。

常量值:-1(0xffffffff)

DEFAULT_LIGHTS

Added in API level 1
int DEFAULT_LIGHTS

使用默认通知灯。 这将忽略FLAG_SHOW_LIGHTS位,并ledARGBledOffMS ,或ledOnMS

也可以看看:

常量值:4(0x00000004)

DEFAULT_SOUND

Added in API level 1
int DEFAULT_SOUND

使用默认通知声音。 这将忽略任何给定的sound

嘈杂的通知更有可能作为单挑通知呈现。

也可以看看:

常数值:1(0x00000001)

DEFAULT_VIBRATE

Added in API level 1
int DEFAULT_VIBRATE

使用默认通知振动。 这将忽略任何给定的vibrate 使用手机振动需要VIBRATE权限。

振动通知更有可能作为单挑通知呈现。

也可以看看:

常量值:2(0x00000002)

EXTRA_BACKGROUND_IMAGE_URI

Added in API level 21
String EXTRA_BACKGROUND_IMAGE_URI

extras键:指向可在选择通知时在后台显示的图像的A content URI URI必须指向适合传入BitmapFactory.decodeStream的图像流; 所有其他内容类型将被忽略。 用于此目的的内容提供者URI不需要读取图像数据的权限。

常量值:“android.backgroundImageUri”

EXTRA_BIG_TEXT

Added in API level 21
String EXTRA_BIG_TEXT

extras键:这是 Notification.BigTextStyle通知的大格式中显示的较长文本,提供给 bigText(CharSequence)

常量值:“android.bigText”

EXTRA_CHRONOMETER_COUNT_DOWN

Added in API level 24
String EXTRA_CHRONOMETER_COUNT_DOWN

extras键:在通知上设置的精密计时器是否应该倒数而不是倒计数。 仅当钥匙EXTRA_SHOW_CHRONOMETER存在时才相关。 这额外是一个布尔值。 默认值是false。

常量值:“android.chronometerCountDown”

EXTRA_COMPACT_ACTIONS

Added in API level 21
String EXTRA_COMPACT_ACTIONS

extras键:提供给(例如) setShowActionsInCompactView(int)的紧凑视图中要显示的动作的索引。

常量值:“android.compactActions”

EXTRA_CONVERSATION_TITLE

Added in API level 24
String EXTRA_CONVERSATION_TITLE

extras键:一个 CharSequence被显示为由 Notification.MessagingStyle表示的对话的标题

常量值:“android.conversationTitle”

EXTRA_INFO_TEXT

Added in API level 19
String EXTRA_INFO_TEXT

extras键:这是提供给 setContentInfo(CharSequence)附加文本。

常量值:“android.infoText”

EXTRA_LARGE_ICON

Added in API level 19
String EXTRA_LARGE_ICON

extras键:显示提供给 setLargeIcon(android.graphics.Bitmap)的通知有效载荷时,此位图将用于代替小图标。

常量值:“android.largeIcon”

EXTRA_LARGE_ICON_BIG

Added in API level 19
String EXTRA_LARGE_ICON_BIG

extras键:这是要代替所述一个的用于从位图 setLargeIcon(android.graphics.Bitmap)当在其膨胀形式示出的通知时,作为供给到 bigLargeIcon(android.graphics.Bitmap)

常量值:“android.largeIcon.big”

EXTRA_MEDIA_SESSION

Added in API level 21
String EXTRA_MEDIA_SESSION

extras键:与 Notification.MediaStyle通知关联的A MediaSession.Token

常量值:“android.mediaSession”

EXTRA_MESSAGES

Added in API level 24
String EXTRA_MESSAGES

extras键:由Notification.MessagingStyle通知提供的Notification.MessagingStyle.Message包的数组。 这个额外的包是一个parcelable数组。

常量值:“android.messages”

EXTRA_PEOPLE

Added in API level 19
String EXTRA_PEOPLE

extras key:一个包含此通知相关人员的字符串数组,每个数组都提供给 addPerson(String)

常量值:“android.people”

EXTRA_PICTURE

Added in API level 19
String EXTRA_PICTURE

extras键:这是一个位图,显示在 Notification.BigPictureStyle扩展通知中,提供给 bigPicture(android.graphics.Bitmap)

常量值:“android.picture”

EXTRA_PROGRESS

Added in API level 19
String EXTRA_PROGRESS

extras键:这是提供给 setProgress(int, int, boolean)的进度值。

常量值:“android.progress”

EXTRA_PROGRESS_INDETERMINATE

Added in API level 19
String EXTRA_PROGRESS_INDETERMINATE

extras键:进度条是否不确定,提供给 setProgress(int, int, boolean)

常量值:“android.progressIndeterminate”

EXTRA_PROGRESS_MAX

Added in API level 19
String EXTRA_PROGRESS_MAX

extras键:这是提供给 setProgress(int, int, boolean)的最大值。

常量值:“android.progressMax”

EXTRA_REMOTE_INPUT_HISTORY

Added in API level 24
String EXTRA_REMOTE_INPUT_HISTORY

extras键:这是远程输入历史记录,提供给setRemoteInputHistory(CharSequence[]) 应用程序可以通过setRemoteInputHistory(CharSequence[])填写最新的输入,通过此通知的RemoteInput发送最近的输入,并且一旦它不再相关(例如,一旦对方已响应,则发送聊天通知),应用程序将清除它。 此密钥的额外属性是CharSequence []类型,并且包含0索引处的最新条目,1索引处的最近第二条目,等等。

也可以看看:

常量值:“android.remoteInputHistory”

EXTRA_SELF_DISPLAY_NAME

Added in API level 24
String EXTRA_SELF_DISPLAY_NAME

extras键:为用户发送的所有邮件显示的用户名,包括直接回复Notification.MessagingStyle通知。 这额外是CharSequence

常量值:“android.selfDisplayName”

EXTRA_SHOW_CHRONOMETER

Added in API level 19
String EXTRA_SHOW_CHRONOMETER

extras键: when是否应显示为 when计时器(特别是 Chronometer )而不是时间戳,如提供给 setUsesChronometer(boolean)

常量值:“android.showChronometer”

EXTRA_SHOW_WHEN

Added in API level 19
String EXTRA_SHOW_WHEN

extras键:是否应显示 when ,供应给 setShowWhen(boolean)

常量值:“android.showWhen”

EXTRA_SMALL_ICON

Added in API level 19
String EXTRA_SMALL_ICON

extras键:这是通知的主要小图标的资源ID,提供给 setSmallIcon(int)

常量值:“android.icon”

EXTRA_SUB_TEXT

Added in API level 19
String EXTRA_SUB_TEXT

extras键:这是提供给 setSubText(CharSequence)的第三行文本。

常量值:“android.subText”

EXTRA_SUMMARY_TEXT

Added in API level 19
String EXTRA_SUMMARY_TEXT

extras键:这是一行概要信息,旨在与提供给(例如) setSummaryText(CharSequence)扩展通知一起显示。

常量值:“android.summaryText”

EXTRA_TEMPLATE

Added in API level 21
String EXTRA_TEMPLATE

extras key:一个字符串,表示用于创建此通知的特定 Notification.Style的名称。

常量值:“android.template”

EXTRA_TEXT

Added in API level 19
String EXTRA_TEXT

extras键:这是主要文本有效负载,提供给 setContentText(CharSequence)

常量值:“android.text”

EXTRA_TEXT_LINES

Added in API level 19
String EXTRA_TEXT_LINES

extras键:要在 Notification.InboxStyle展开的通知中显示的CharSequence数组,其中每个提供给 addLine(CharSequence)

常量值:“android.textLines”

EXTRA_TITLE

Added in API level 19
String EXTRA_TITLE

extras键:这是提供给 setContentTitle(CharSequence)的通知标题。

常量值:“android.title”

EXTRA_TITLE_BIG

Added in API level 19
String EXTRA_TITLE_BIG

extras键:这是以展开形式显示时通知的标题,例如提供给 setBigContentTitle(CharSequence)

常量值:“android.title.big”

FLAG_AUTO_CANCEL

Added in API level 1
int FLAG_AUTO_CANCEL

如果在用户单击通知时取消通知,应将该 flags入应该设置的 flags字段中。

常量值:16(0x00000010)

FLAG_FOREGROUND_SERVICE

Added in API level 5
int FLAG_FOREGROUND_SERVICE

如果此通知表示当前正在运行的服务,则该位应该被设置到flags字段中。 这通常会由您设置startForeground(int, Notification)

常量值:64(0x00000040)

FLAG_GROUP_SUMMARY

Added in API level 20
int FLAG_GROUP_SUMMARY

如果此通知是一组通知的组摘要,则位应该被设置到应该设置的flags字段中。 分组通知可以显示在支持这种呈现的设备上的群集或堆栈中。 还需要使用setGroup(String)来设置组密钥。

常量值:512(0x00000200)

FLAG_HIGH_PRIORITY

Added in API level 11
int FLAG_HIGH_PRIORITY

此常数在API级别16中已弃用。
以正值使用priority

指示高优先级通知的过时标志; 改用优先权字段。

常量值:128(0x00000080)

FLAG_INSISTENT

Added in API level 1
int FLAG_INSISTENT

要将位置位到 flags字段中,如果设置了该字段,则会重复该音频,直到通知被取消或通知窗口打开。

常量值:4(0x00000004)

FLAG_LOCAL_ONLY

Added in API level 20
int FLAG_LOCAL_ONLY

如果此通知仅与当前设备相关,并且不建议它桥接到其他设备,则位应该被设置到应该设置的 flags字段中。

常量值:256(0x00000100)

FLAG_NO_CLEAR

Added in API level 1
int FLAG_NO_CLEAR

如果在用户单击“全部清除”按钮时不应取消通知,应将位设置为应该设置的 flags字段。

常量值:32(0x00000020)

FLAG_ONGOING_EVENT

Added in API level 1
int FLAG_ONGOING_EVENT

如果此通知参考正在进行的某些事件(例如电话呼叫),则应将该flags位到应该设置的flags字段中。 如果此通知是针对某个特定时间点发生的事件(例如未接电话),则不应设置。

常量值:2(0x00000002)

FLAG_ONLY_ALERT_ONCE

Added in API level 1
int FLAG_ONLY_ALERT_ONCE

如果通知尚未显示,您只需要播放声音,振动和滚动条即可播放 flags字段,该位应该设置为 flags字段。

常量值:8(0x00000008)

FLAG_SHOW_LIGHTS

Added in API level 1
int FLAG_SHOW_LIGHTS

如果您希望指示灯开启此通知,则位应该设置到 flags字段中。

  • To turn the LED off, pass 0 in the alpha channel for colorARGB or 0 for both ledOnMS and ledOffMS.
  • To turn the LED on, pass 1 for ledOnMS and 0 for ledOffMS.
  • To flash the LED, pass the number of milliseconds that it should be on and off to ledOnMS and ledOffMS.

由于硬件各不相同,因此不能保证您传递的任何值都完全符合。 如果可能,请使用系统默认值(TODO),因为它们将设置为适用于任何给定硬件的值。

Alpha通道必须设置为向前兼容。

常数值:1(0x00000001)

INTENT_CATEGORY_NOTIFICATION_PREFERENCES

Added in API level 21
String INTENT_CATEGORY_NOTIFICATION_PREFERENCES

提供用户界面以调整其包含的应用程序的通知首选项的活动。 可选,但建议用于发布Notifications应用。

常量值:“android.intent.category.NOTIFICATION_PREFERENCES”

PRIORITY_DEFAULT

Added in API level 16
int PRIORITY_DEFAULT

默认通知priority 如果您的应用程序未优先处理自己的通知,请将此值用于所有通知。

常量值:0(0x00000000)

PRIORITY_HIGH

Added in API level 16
int PRIORITY_HIGH

更高的priority ,用于更重要的通知或警报。 与您的应用的PRIORITY_DEFAULT项目相比,用户界面可能选择显示这些项目更大,或者显示在通知列表中的不同位置。

常数值:1(0x00000001)

PRIORITY_LOW

Added in API level 16
int PRIORITY_LOW

降低priority ,对于不太重要的项目。 与您的应用PRIORITY_DEFAULT项目相比,用户界面可能会选择显示较小的项目,或列表中不同的位置。

常量值:-1(0xffffffff)

PRIORITY_MAX

Added in API level 16
int PRIORITY_MAX

最高 priority ,为您的应用程序的最重要的项目,需要用户及时的关注或输入。

常量值:2(0x00000002)

PRIORITY_MIN

Added in API level 16
int PRIORITY_MIN

最低priority ; 除特殊情况外,这些项目可能不会显示给用户,例如详细的通知日志。

常量值:-2(0xfffffffe)

STREAM_DEFAULT

Added in API level 1
int STREAM_DEFAULT

此常数在API级别21中已弃用。
改为使用audioAttributes

使用此常量作为audioStreamType的值来请求使用通知的默认流类型。 目前默认的流类型是STREAM_NOTIFICATION

常量值:-1(0xffffffff)

VISIBILITY_PRIVATE

Added in API level 21
int VISIBILITY_PRIVATE

通知可见性:在所有锁屏上显示此通知,但隐藏安全锁屏上的敏感或隐私信息。

也可以看看:

常量值:0(0x00000000)

VISIBILITY_PUBLIC

Added in API level 21
int VISIBILITY_PUBLIC

通知可见性:在所有锁屏上全部显示此通知。

也可以看看:

常数值:1(0x00000001)

VISIBILITY_SECRET

Added in API level 21
int VISIBILITY_SECRET

通知可见性:请勿在安全锁屏上显示此通知的任何部分。

也可以看看:

常量值:-1(0xffffffff)

Fields

AUDIO_ATTRIBUTES_DEFAULT

Added in API level 21
AudioAttributes AUDIO_ATTRIBUTES_DEFAULT

默认值为 audioAttributes

CREATOR

Added in API level 1
Creator<Notification> CREATOR

Parcelable.Creator实例化Notification对象

actions

Added in API level 19
Action[] actions

addAction(int, CharSequence, PendingIntent)附加到此通知的所有Notification.Action结构的addAction(int, CharSequence, PendingIntent) 对于提供用于调用动作的替代接口的实例NotificationListenerService非常有用。

audioAttributes

Added in API level 21
AudioAttributes audioAttributes

播放声音时使用 audio attributes

audioStreamType

Added in API level 1
int audioStreamType

此字段在API级别21中已被弃用。
改为使用audioAttributes

播放声音时使用的音频流类型。 应该是来自AudioManager的STREAM_常量AudioManager

bigContentView

Added in API level 16
RemoteViews bigContentView

contentView的大幅面版本,为通知提供了展示更多细节的机会。 系统用户界面可以自行选择显示,而不是正常的内容视图。 从N开始,此字段可能为空。 展开的通知视图由Notification.Builder的输入确定; 一个定制的RemoteViews可以随意提供setCustomBigContentView(RemoteViews)

category

Added in API level 21
String category

最能描述此通知的预定义通知类别之一(请参阅CATEGORY_*常量)。 系统可能会使用它进行排序和过滤。

color

Added in API level 21
int color

在呈现此通知时由标准样式模板应用的强调颜色(类似于Color常量的ARGB整数)。 当前的模板设计通过将icon图像(以白色icon叠加在该颜色的字段icon构造彩色标题图像。 Alpha组件被忽略。

contentIntent

Added in API level 1
PendingIntent contentIntent

点击展开状态条目时执行的意图。 如果这是一项活动,则它必须包含FLAG_ACTIVITY_NEW_TASK标志,该标志要求您负责按照Tasks and Back Stack文档中的描述处理任务管理。 特别是,请务必阅读通知部分Handling Notifications以了解从通知启动应用程序的正确方法。

contentView

Added in API level 1
RemoteViews contentView

将在通知列表中显示此通知的视图(从状态栏中拉下来)。 从N开始,此字段可能为空。 通知视图由Notification.Builder的输入确定; 一个定制的RemoteViews可以随意提供setCustomContentView(RemoteViews)

defaults

Added in API level 1
int defaults

指定应从默认值中获取哪些值。

要设置,还是从所需DEFAULT_SOUNDDEFAULT_VIBRATEDEFAULT_LIGHTS 对于所有默认值,请使用DEFAULT_ALL

deleteIntent

Added in API level 1
PendingIntent deleteIntent

意图在用户明确解除通知时执行,或者使用“全部清除”按钮或单独将其擦除。 这可能不应该启动一项活动,因为其中几项将同时发送。

extras

Added in API level 19
Bundle extras

使用此通知附带的附加语义数据。

这里定义的额外密钥旨在将原始输入捕获到 Notification.Builder API,并且旨在供 NotificationListenerService实现从通知对象中提取详细信息。

flags

Added in API level 1
int flags

fullScreenIntent

Added in API level 9
PendingIntent fullScreenIntent

意图启动而不是将通知发布到状态栏。

在用户使用该设备时,系统UI可以选择显示抬头通知,而不是启动该意图。

也可以看看:

headsUpContentView

Added in API level 21
RemoteViews headsUpContentView

中等格式的contentView版本,为通知提供了向contentView添加动作按钮的机会。 系统用户界面可以自行选择将其显示为抬头通知,该通知会弹出,以便用户在不离开当前活动的情况下看到它。 从N开始,此字段可能为空。 抬头通知视图由Notification.Builder的输入Notification.Builder ; 一个定制的RemoteViews可以随意提供setCustomHeadsUpContentView(RemoteViews)

icon

Added in API level 1
int icon

此字段在API级别23中已被弃用。
改为使用setSmallIcon(Icon)

可绘制的资源ID用作状态栏中的图标。

iconLevel

Added in API level 1
int iconLevel

如果状态栏中的图标要具有多个级别,则可以对其进行设置。 否则,将其保留为默认值0。

也可以看看:

largeIcon

Added in API level 11
Bitmap largeIcon

此字段在API级别23中已被弃用。
改为使用setLargeIcon(Icon)

要在通知内容区域中显示的大型位图。

ledARGB

Added in API level 1
int ledARGB

LED的颜色。 硬件将尽其最大的近似。

也可以看看:

ledOffMS

Added in API level 1
int ledOffMS

LED在闪烁时关闭的毫秒数。 硬件将尽其最大的近似。

也可以看看:

ledOnMS

Added in API level 1
int ledOnMS

闪烁时LED亮起的毫秒数。 硬件将尽其最大的近似。

也可以看看:

number

Added in API level 1
int number

此字段在API级别24中已被弃用。
这个号码不再显示

此通知代表的事件数量。 例如,在新的邮件通知中,这可能是未读消息的数量。 系统可能会或可能不会使用此字段来修改通知的外观。 例如,在HONEYCOMB之前,此编号叠加在状态栏中的图标上。 与开始HONEYCOMB ,所用的模板Notification.Builder已经显示在展开的通知视图的数量。 如果数字为0或负数,则永不显示。

priority

Added in API level 16
int priority

此通知的相对优先级。 优先级指示该通知应该消耗多少用户的有价值的关注。 在某些情况下,用户可能会隐藏低优先级通知,而用户可能因高优先级通知而被中断。 系统将在提交通知时确定如何解释此优先级。

至少 PRIORITY_HIGH通知更有可能作为平视通知呈现。

publicVersion

Added in API level 21
Notification publicVersion

该通知的替换版本,其内容将显示在不安全的上下文中,例如安全键盘保护程序之上。 visibilityVISIBILITY_PUBLIC

sound

Added in API level 1
Uri sound

要播放的声音。

嘈杂的通知更有可能作为单挑通知呈现。

要播放默认通知声音,请参阅 defaults

tickerText

Added in API level 1
CharSequence tickerText

汇总此无障碍服务通知的文本。 从L版本开始,此文本不再显示在屏幕上,但对无障碍服务(它充当通知外观的可听通告)仍然有用。

也可以看看:

tickerView

Added in API level 11
RemoteViews tickerView

以前,一个视图显示tickerText 不再显示在API 21的状态栏中。

vibrate

Added in API level 1
long[] vibrate

振动的模式。

要振动默认模式,请参阅 defaults

振动通知更有可能作为单挑通知呈现。

也可以看看:

visibility

Added in API level 21
int visibility

此通知的可见范围,它影响SystemUI如何以及何时在不受信任的情况下(即安全锁屏上)显示通知的存在和内容。 默认级别VISIBILITY_PRIVATE行为与Android上的通知始终完全相同:通知的icontickerText (如果可用)在所有情况下都会显示,但只有在适当用户解锁设备时才会显示内容。 更宽松的政策可以用VISIBILITY_PUBLIC表示; 即使在“不安全”情况下(即在安全锁屏上方)也可以读取这种通知。 要修改此通知的公共版本 - 例如,编辑一些部分 - 请参阅setPublicVersion(Notification) 最后,可以发出通知VISIBILITY_SECRET ,这将禁止其图标和滚动条,直到用户绕过VISIBILITY_SECRET

when

Added in API level 1
long when

与此通知相关的时间戳,以时间为单位,以毫秒为单位。 默认值: Now 选择一个与用户最相关的时间戳。 对于大多数有限事件,这对应于事件发生的时间(或者将发生,在事件尚未发生但用户被告知的情况下)。 无限期活动应该根据活动开始的时间加盖时间戳。 一些例子:

  • Notification of a new chat message should be stamped when the message was received.
  • Notification of an ongoing file download (with a progress bar, for example) should be stamped when the download started.
  • Notification of a completed file download should be stamped when the download finished.
  • Notification of an upcoming meeting should be stamped with the time the meeting will begin (that is, in the future).
  • Notification of an ongoing stopwatch (increasing timer) should be stamped with the watch's start time.
  • Notification of an ongoing countdown timer should be stamped with the timer's end time.
For apps targeting N and above, this time is not shown anymore by default and must be opted into by using setShowWhen(boolean)

Public constructors

Notification

Added in API level 1
Notification ()

使用默认值构造一个Notification对象。 您可能需要考虑使用Notification.Builder

Notification

Added in API level 1
Notification (int icon, 
                CharSequence tickerText, 
                long when)

此构造函数在API级别11中已弃用。
改为使用Notification.Builder

用没有标准展开视图的状态栏图标所需的信息构造一个Notification对象。

Parameters
icon int: The resource id of the icon to put in the status bar.
tickerText CharSequence: The text that flows by in the status bar when the notification first activates.
when long: The time to show in the time field. In the System.currentTimeMillis timebase.

Notification

Added in API level 1
Notification (Parcel parcel)

从包裹解除通知。

Parameters
parcel Parcel

Public methods

clone

Added in API level 1
Notification clone ()

创建并返回此对象的副本。 “复制”的确切含义可能取决于对象的类别。 一般意图是,对于任何对象x ,表达式:

 x.clone() != x
will be true, and that the expression:
 x.clone().getClass() == x.getClass()
will be true, but these are not absolute requirements. While it is typically the case that:
 x.clone().equals(x)
will be true, this is not an absolute requirement.

按照惯例,应该通过调用super.clone获得返回的对象。 如果一个类和它的所有超类( Object除外)都遵守这个约定,那么情况就是x.clone().getClass() == x.getClass()

按照惯例,这个方法返回的对象应该独立于这个对象(被克隆)。 为了实现这种独立性,可能需要在返回super.clone之前修改对象的一个或多个字段。 通常,这意味着复制包含被克隆对象的内部“深层结构”的任何可变对象,并将这些对象的引用替换为对这些副本的引用。 如果一个类仅包含原始字段或对不可变对象的引用,那么通常情况下不需要修改由super.clone返回的对象中的任何字段。

Object的方法clone执行特定的克隆操作。 首先,如果该对象的类没有实现接口Cloneable ,则引发CloneNotSupportedException 请注意,所有数组都被视为实现接口Cloneable并且数组类型T[]clone方法的返回类型为T[] ,其中T是任何引用或基本类型。 否则,此方法创建该对象的类的新实例,并使用该对象的相应字段的内容来初始化其所有字段,就像通过赋值一样; 这些字段的内容本身并不克隆。 因此,此方法执行此对象的“浅拷贝”,而不是“深拷贝”操作。

Object本身并不实现接口 Cloneable ,所以在类为 Object的对象上调用 clone方法将导致在运行时抛出异常。

Returns
Notification a clone of this instance.

describeContents

Added in API level 1
int describeContents ()

描述此Parcelable实例的封送表示中包含的特殊对象的种类。 例如,如果对象将在writeToParcel(Parcel, int)的输出中包含writeToParcel(Parcel, int) ,则此方法的返回值必须包含CONTENTS_FILE_DESCRIPTOR位。

Returns
int a bitmask indicating the set of special object types marshaled by this Parcelable object instance.

getGroup

Added in API level 20
String getGroup ()

获取用于将此通知分组到群集或堆栈中的密钥,以及支持此类呈现的设备上的其他通知。

Returns
String

getLargeIcon

Added in API level 23
Icon getLargeIcon ()

此通知内容视图中显示的大图标。

Returns
Icon

也可以看看:

getSmallIcon

Added in API level 23
Icon getSmallIcon ()

在状态栏和内容视图中代表此通知的小图标。

Returns
Icon the small icon representing this notification.

也可以看看:

getSortKey

Added in API level 20
String getSortKey ()

获取一个排序关键字,可以从同一个包中的其他通知中排列此通知。 如果已经应用了外部排序并且应用程序想要保留这一点,这可能很有用。 通知将按照字典顺序使用此值进行排序,但除了提供排序键之外,提供不同的优先级可能会导致忽略此值。

此排序关键字也可用于订购通知组的成员。 setGroup(String)

Returns
String

也可以看看:

toString

Added in API level 1
String toString ()

返回对象的字符串表示形式。 一般来说, toString方法返回一个“文本表示”该对象的字符串。 结果应该是一个简洁但内容丰富的表述,对于一个人来说很容易阅读。 建议所有子类重写此方法。

ObjecttoString方法返回一个字符串,其中包含对象为实例的类的名称,符号字符“ @ ”以及对象的哈希代码的无符号十六进制表示形式。 换句话说,这个方法返回一个字符串,其值等于:

 getClass().getName() + '@' + Integer.toHexString(hashCode())
 

Returns
String a string representation of the object.

writeToParcel

Added in API level 1
void writeToParcel (Parcel parcel, 
                int flags)

将此通知拼凑成一个包裹。

Parameters
parcel Parcel: The Parcel in which the object should be written.
flags int: Additional flags about how the object should be written. May be 0 or PARCELABLE_WRITE_RETURN_VALUE.

Hooray!