Notification.Builder

Notification.Builder

Notification.Builder

public static class Notification.Builder extends Object

java.lang.Object

android.app.Notification.Builder

Notification对象的生成器类。 提供一种方便的方式来设置Notification的各个字段并使用平台的通知布局模板生成内容视图。 如果您的应用支持与API级别4一样旧的Android版本,则可以改为使用NotificationCompat.Builder中的NotificationCompat.Builder 。

例:

Notification noti = new Notification.Builder(mContext)

.setContentTitle("New mail from " + sender.toString())

.setContentText(subject)

.setSmallIcon(R.drawable.new_mail)

.setLargeIcon(aBitmap)

.build();

Summary

Public constructors

Notification.Builder(Context context) 用默认值构造一个新的Builder:

priority

PRIORITY_DEFAULT

when

now (currentTimeMillis())

audio stream

STREAM_DEFAULT

Public methods

Notification.Builder

addAction(int icon, CharSequence title, PendingIntent intent) 此方法在API级别23中已弃用。请改为使用addAction(Action) 。

Notification.Builder

addAction(Notification.Action action) 向此通知添加一个操作。

Notification.Builder

addExtras(Bundle extras) 将其他元数据合并到此通知中。

Notification.Builder

addPerson(String uri) 添加与此通知相关的人员。

Notification

build() 组合所有已设置的选项并返回一个新的 Notification对象。

RemoteViews

createBigContentView() 构建最终大通知布局的RemoteViews。

RemoteViews

createContentView() 构建最终1U通知布局的RemoteViews。

RemoteViews

createHeadsUpContentView() 构建最终抬头通知布局的RemoteViews。

Notification.Builder

extend(Notification.Extender extender) 将扩展器应用于此通知构建器。

Bundle

getExtras() 获取此通知构建器使用的当前元数据包。

Notification

getNotification() 此方法在API级别16中已弃用。请改为使用build() 。

static Notification.Builder

recoverBuilder(Context context, Notification n) 从现有的通知中创建一个Builder,以便进行进一步的更改。

Notification.Builder

setActions(Action... actions) 修改附加到此通知的完整操作列表。

Notification.Builder

setAutoCancel(boolean autoCancel) 当用户触摸该通知时,自动解除该通知。

Notification.Builder

setCategory(String category) 设置通知类别。

Notification.Builder

setChronometerCountDown(boolean countDown) 将计时器设置为倒数而不是倒数。

Notification.Builder

setColor(int argb) 套 color 。

Notification.Builder

setContent(RemoteViews views) 提供一个自定义的RemoteViews来代替平台模板。

Notification.Builder

setContentInfo(CharSequence info) 此方法在API级别24中已弃用。请使用setSubText(CharSequence)代替在标题中设置文本。 对于定位到N以下版本的旧版应用,此字段仍会显示,但子文本将优先。

Notification.Builder

setContentIntent(PendingIntent intent) 提供单击通知时要发送的 PendingIntent 。

Notification.Builder

setContentText(CharSequence text) 在平台通知模板中设置第二行文字。

Notification.Builder

setContentTitle(CharSequence title) 在平台通知模板中设置第一行文字。

Notification.Builder

setCustomBigContentView(RemoteViews contentView) 提供自定义RemoteViews,以代替展开形式的平台模板。

Notification.Builder

setCustomContentView(RemoteViews contentView) 提供使用自定义RemoteViews来代替平台模板。

Notification.Builder

setCustomHeadsUpContentView(RemoteViews contentView) 提供自定义RemoteViews,以便在抬头对话框中使用而不是平台模板。

Notification.Builder

setDefaults(int defaults) 设置哪些通知属性将从系统默认值继承。

Notification.Builder

setDeleteIntent(PendingIntent intent) 当通知被用户明确清除时,提供一个 PendingIntent发送。

Notification.Builder

setExtras(Bundle extras) 为此通知设置元数据。

Notification.Builder

setFullScreenIntent(PendingIntent intent, boolean highPriority) 意图启动而不是将通知发布到状态栏。

Notification.Builder

setGroup(String groupKey) 将此通知设置为共享相同密钥的一组通知的一部分。

Notification.Builder

setGroupSummary(boolean isGroupSummary) 将此通知设置为一组通知的组摘要。

Notification.Builder

setLargeIcon(Bitmap b) 将大图标添加到通知内容视图。

Notification.Builder

setLargeIcon(Icon icon) 将大图标添加到通知内容视图。

Notification.Builder

setLights(int argb, int onMs, int offMs) 设置设备上指示灯的所需颜色以及闪烁占空比(以毫秒为单位)。

Notification.Builder

setLocalOnly(boolean localOnly) 设置此通知是否不能桥接到其他设备。

Notification.Builder

setNumber(int number) 此方法在API级别24中已弃用。此数字不再显示在任何位置

Notification.Builder

setOngoing(boolean ongoing) 设置这是否是“正在进行中”的通知。

Notification.Builder

setOnlyAlertOnce(boolean onlyAlertOnce) 设置此标志,如果您只希望在通知尚未显示的情况下播放声音,振动和播报。

Notification.Builder

setPriority(int pri) 设置此通知的优先级。

Notification.Builder

setProgress(int max, int progress, boolean indeterminate) 设置此通知代表的进度。

Notification.Builder

setPublicVersion(Notification n) 提供替换通知,其内容应显示在不安全的上下文中(即,

Notification.Builder

setRemoteInputHistory(CharSequence[] text) 设置远程输入历史记录。

Notification.Builder

setShowWhen(boolean show) 控制是否在内容视图中显示使用 setWhen设置的时间戳。

Notification.Builder

setSmallIcon(int icon, int level) setSmallIcon(int)一种变体,当图标是 LevelListDrawable时需要额外的级别参数。

Notification.Builder

setSmallIcon(int icon) 设置小图标资源,用于在状态栏中表示通知。

Notification.Builder

setSmallIcon(Icon icon) 设置小图标,用于在状态栏和内容视图中表示通知(除非由 large icon覆盖)。

Notification.Builder

setSortKey(String sortKey) 设置一个排序键,在同一个包中的其他通知中排列此通知。

Notification.Builder

setSound(Uri sound, AudioAttributes audioAttributes) 设置要播放的声音以及播放期间使用的特定 audio attributes 。

Notification.Builder

setSound(Uri sound) 设置声音播放。

Notification.Builder

setSound(Uri sound, int streamType) 此方法在API级别21中已弃用。 setSound(Uri, AudioAttributes)改为使用setSound(Uri, AudioAttributes) 。

Notification.Builder

setStyle(Notification.Style style) 添加丰富的通知样式,以便在构建时应用。

Notification.Builder

setSubText(CharSequence text) 这提供了通知中显示的一些附加信息。

Notification.Builder

setTicker(CharSequence tickerText, RemoteViews views) 已淘汰的版本 setTicker(CharSequence) 。

Notification.Builder

setTicker(CharSequence tickerText) 设置发送到无障碍服务的“ticker”文本。

Notification.Builder

setUsesChronometer(boolean b) 将 when字段显示为秒表。

Notification.Builder

setVibrate(long[] pattern) 设置要使用的振动模式。

Notification.Builder

setVisibility(int visibility) 指定值 visibility 。

Notification.Builder

setWhen(long when) 添加与通知有关的时间戳(通常是事件发生的时间)。

Inherited methods

From class java.lang.Object

Object

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

boolean

equals(Object obj) 指示其他某个对象是否“等于”这一个。

void

finalize() 当垃圾收集确定没有更多对该对象的引用时,由对象上的垃圾回收器调用。

final Class

getClass() 返回此 Object的运行时类。

int

hashCode() 返回对象的哈希码值。

final void

notify() 唤醒正在等待该对象监视器的单个线程。

final void

notifyAll() 唤醒在该对象监视器上等待的所有线程。

String

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

final void

wait(long millis, int nanos) 导致当前线程等待,直到另一个线程为该对象调用 notify()方法或 notifyAll()方法,或者某个其他线程中断当前线程,或者经过了一定的实时时间。

final void

wait(long millis) 使当前线程等待,直到另一个线程调用此对象的 notify()方法或 notifyAll()方法或经过指定的时间量。

final void

wait() 导致当前线程等待,直到另一个线程调用此对象的 notify()方法或 notifyAll()方法。

Public constructors

Notification.Builder

Added in

API level 11

Notification.Builder (Context context)

用默认值构造一个新的Builder:

priority

PRIORITY_DEFAULT

when

now (currentTimeMillis())

audio stream

STREAM_DEFAULT

Parameters

context

Context: A Context that will be used by the Builder to construct the RemoteViews. The Context will not be held past the lifetime of this Builder object.

Public methods

addAction

Added in

API level 16

Notification.Builder addAction (int icon,

CharSequence title,

PendingIntent intent)

此方法在API级别23中已弃用。 改为使用addAction(Action) 。

向此通知添加一个操作。 操作通常由系统显示为与通知内容相邻的按钮。

每个动作必须有一个图标(32dp正方形并与 Holo Dark action bar视觉样式相匹配),文本标签和 PendingIntent 。

以展开形式显示的通知最多可以显示3个操作,从左到右依次添加。 但是,在通知崩溃时,操作不会显示,因此请确保用户以其他方式访问任何基本功能(例如, contentIntent指向的活动)。

Parameters

icon

int: Resource ID of a drawable that represents the action.

title

CharSequence: Text describing the action.

intent

PendingIntent: PendingIntent to be fired when the action is invoked.

Returns

Notification.Builder

addAction

Added in

API level 20

Notification.Builder addAction (Notification.Action action)

向此通知添加一个操作。 操作通常由系统显示为与通知内容相邻的按钮。

每个动作都必须有一个图标(32dp正方形并与 Holo Dark action bar视觉样式相匹配),文本标签和 PendingIntent 。

以展开形式显示的通知最多可以显示3个操作,从左到右依次添加。 但是,当通知崩溃时,操作将不会显示,因此请确保用户以其他方式访问任何基本功能(例如,在contentIntent指向的活动中)。

Parameters

action

Notification.Action: The action to add.

Returns

Notification.Builder

addExtras

Added in

API level 20

Notification.Builder addExtras (Bundle extras)

将其他元数据合并到此通知中。

Bundle中的值将替换此Builder中现有的额外值。

Parameters

extras

Bundle

Returns

Notification.Builder

也可以看看:

extras

addPerson

Added in

API level 21

Notification.Builder addPerson (String uri)

添加与此通知相关的人员。

根据用户偏好,此注释可能允许通知通过中断过滤器,并在用户界面中更突出显示。

这个人应该由指定 String一个代表性 CONTENT_LOOKUP_URI 。

系统还将尝试解析mailto:和tel:模式URI。 这些URI的路径部分必须存在于联系人数据库中适当的列中,否则引用将被废弃为无效。 电话架构URI将由ContactsContract.PhoneLookup解决。

Parameters

uri

String: A URI for the person.

Returns

Notification.Builder

也可以看看:

EXTRA_PEOPLE

build

Added in

API level 16

Notification build ()

组合所有已设置的选项并返回一个新的 Notification对象。

Returns

Notification

createBigContentView

Added in

API level 24

RemoteViews createBigContentView ()

构建最终大通知布局的RemoteViews。

Returns

RemoteViews

createContentView

Added in

API level 24

RemoteViews createContentView ()

构建最终1U通知布局的RemoteViews。 按顺序:1.从调用者自定义contentView 2.样式的建议内容视图3.标准模板视图

Returns

RemoteViews

createHeadsUpContentView

Added in

API level 24

RemoteViews createHeadsUpContentView ()

构建最终抬头通知布局的RemoteViews。

Returns

RemoteViews

extend

Added in

API level 20

Notification.Builder extend (Notification.Extender extender)

将扩展器应用于此通知构建器。 扩展器可用于在此构建器上添加元数据或更改选项。

Parameters

extender

Notification.Extender

Returns

Notification.Builder

getExtras

Added in

API level 20

Bundle getExtras ()

获取此通知构建器使用的当前元数据包。

返回的Bundle与此Builder共享。

每次调用 build() ,该Bundle的当前内容都会复制到通知中。

Returns

Bundle

也可以看看:

extras

getNotification

Added in

API level 11

Notification getNotification ()

此方法在API级别16中已被弃用。 改为使用build() 。

Returns

Notification

recoverBuilder

Added in

API level 24

Notification.Builder recoverBuilder (Context context,

Notification n)

从现有的通知中创建一个Builder,以便进行进一步的更改。

Parameters

context

Context: The context for your application / activity.

n

Notification: The notification to create a Builder from.

Returns

Notification.Builder

setActions

Added in

API level 24

Notification.Builder setActions (Action... actions)

修改附加到此通知的完整操作列表。

Returns

Notification.Builder

也可以看看:

addAction(Action)

setAutoCancel

Added in

API level 11

Notification.Builder setAutoCancel (boolean autoCancel)

当用户触摸该通知时,自动解除该通知。 PendingIntent设置为setDeleteIntent(PendingIntent)将在发生这种情况时发送。

Parameters

autoCancel

boolean

Returns

Notification.Builder

也可以看看:

FLAG_AUTO_CANCEL

setCategory

Added in

API level 21

Notification.Builder setCategory (String category)

设置通知类别。

Parameters

category

String

Returns

Notification.Builder

也可以看看:

category

setChronometerCountDown

Added in

API level 24

Notification.Builder setChronometerCountDown (boolean countDown)

将计时器设置为倒数而不是倒数。

这仅在setUsesChronometer(boolean)设置为true时才setUsesChronometer(boolean) 。 如果没有设置,精密计时器将计数。

Parameters

countDown

boolean

Returns

Notification.Builder

也可以看看:

setUsesChronometer(boolean)

setColor

Added in

API level 21

Notification.Builder setColor (int argb)

套 color 。

Parameters

argb

int: The accent color to use

Returns

Notification.Builder

The same Builder.

setContent

Added in

API level 11

Notification.Builder setContent (RemoteViews views)

提供一个自定义的RemoteViews来代替平台模板。 改为使用setCustomContentView(RemoteViews) 。

Parameters

views

RemoteViews

Returns

Notification.Builder

setContentInfo

Added in

API level 11

Notification.Builder setContentInfo (CharSequence info)

此方法在API级别24中已弃用。 改为使用setSubText(CharSequence)在标题中设置文本。 对于定位到N以下版本的旧版应用,此字段仍会显示,但子文本将优先。

有关此通知的一小部分额外信息。 平台模板将在最右边的通知的最后一行(如果放置在那里的小型图标的右侧)绘制该图标。

Parameters

info

CharSequence

Returns

Notification.Builder

setContentIntent

Added in

API level 11

Notification.Builder setContentIntent (PendingIntent intent)

提供单击通知时要发送的PendingIntent 。 从HONEYCOMB ,如果未设置此字段并且您已指定setContent(RemoteViews)的自定义RemoteView, setContent(RemoteViews)可以使用RemoteViews.setOnClickPendingIntent(int,PendingIntent)将PendingIntents分配给该自定义布局中的各个视图(即,在通知视图内创建可点击的按钮)。

Parameters

intent

PendingIntent

Returns

Notification.Builder

也可以看看:

Notification.contentIntent

setContentText

Added in

API level 11

Notification.Builder setContentText (CharSequence text)

在平台通知模板中设置第二行文字。

Parameters

text

CharSequence

Returns

Notification.Builder

setContentTitle

Added in

API level 11

Notification.Builder setContentTitle (CharSequence title)

在平台通知模板中设置第一行文字。

Parameters

title

CharSequence

Returns

Notification.Builder

setCustomBigContentView

Added in

API level 24

Notification.Builder setCustomBigContentView (RemoteViews contentView)

提供自定义RemoteViews,以代替展开形式的平台模板。 这将覆盖本构建器对象构建的扩展布局。

Parameters

contentView

RemoteViews

Returns

Notification.Builder

setCustomContentView

Added in

API level 24

Notification.Builder setCustomContentView (RemoteViews contentView)

提供使用自定义RemoteViews来代替平台模板。 这将覆盖本构建器对象构建的布局。

Parameters

contentView

RemoteViews

Returns

Notification.Builder

setCustomHeadsUpContentView

Added in

API level 24

Notification.Builder setCustomHeadsUpContentView (RemoteViews contentView)

提供自定义RemoteViews,以便在抬头对话框中使用而不是平台模板。 这将覆盖否则将由此Builder对象构建的抬头布局。

Parameters

contentView

RemoteViews

Returns

Notification.Builder

setDefaults

Added in

API level 11

Notification.Builder setDefaults (int defaults)

设置哪些通知属性将从系统默认值继承。

该值应为一个或多个以下的字段与按位或组合的: DEFAULT_SOUND , DEFAULT_VIBRATE , DEFAULT_LIGHTS 。

对于所有默认值,请使用 DEFAULT_ALL 。

Parameters

defaults

int

Returns

Notification.Builder

setDeleteIntent

Added in

API level 11

Notification.Builder setDeleteIntent (PendingIntent intent)

当通知被用户明确清除时,提供一个 PendingIntent发送。

Parameters

intent

PendingIntent

Returns

Notification.Builder

也可以看看:

deleteIntent

setExtras

Added in

API level 19

Notification.Builder setExtras (Bundle extras)

为此通知设置元数据。

在Builder的整个生命周期中都会引用Bundle,并且每次调用 build() ,Bundle的当前内容都将被复制到Notification中。

将所有现有的额外值替换为提供的Bundle中的值。 改为使用addExtras(Bundle)来合并元数据。

Parameters

extras

Bundle

Returns

Notification.Builder

也可以看看:

extras

setFullScreenIntent

Added in

API level 11

Notification.Builder setFullScreenIntent (PendingIntent intent,

boolean highPriority)

意图启动而不是将通知发布到状态栏。 仅用于需要用户立即关注的极高优先级通知,例如用户明确设置为特定时间的来电或闹钟。 如果此设施用于其他用途,请给用户一个关闭它并使用正常通知的选项,因为这可能会造成极大的干扰。

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

Parameters

intent

PendingIntent: The pending intent to launch.

highPriority

boolean: Passing true will cause this notification to be sent even if other notifications are suppressed.

Returns

Notification.Builder

也可以看看:

fullScreenIntent

setGroup

Added in

API level 20

Notification.Builder setGroup (String groupKey)

将此通知设置为共享相同密钥的一组通知的一部分。 分组通知可以显示在支持这种呈现的设备上的群集或堆栈中。

要将此通知作为其小组的摘要,也请致电setGroupSummary(boolean) 。 可以通过使用setSortKey(String)为组成员指定排序顺序。

Parameters

groupKey

String: The group key of the group.

Returns

Notification.Builder

this object for method chaining

setGroupSummary

Added in

API level 20

Notification.Builder setGroupSummary (boolean isGroupSummary)

将此通知设置为一组通知的组摘要。 分组通知可以显示在支持这种呈现的设备上的群集或堆栈中。 还需要使用setGroup(String)来设置组密钥。

Parameters

isGroupSummary

boolean: Whether this notification should be a group summary.

Returns

Notification.Builder

this object for method chaining

setLargeIcon

Added in

API level 11

Notification.Builder setLargeIcon (Bitmap b)

将大图标添加到通知内容视图。 在平台模板中,此图片将显示在通知视图的左侧,代替small icon (将放置在大图标顶部的小徽章中)。

Parameters

b

Bitmap

Returns

Notification.Builder

setLargeIcon

Added in

API level 23

Notification.Builder setLargeIcon (Icon icon)

将大图标添加到通知内容视图。 在平台模板中,此图片将显示在通知视图的左侧,代替small icon (将放置在大图标顶部的小徽章中)。

Parameters

icon

Icon

Returns

Notification.Builder

setLights

Added in

API level 11

Notification.Builder setLights (int argb,

int onMs,

int offMs)

设置设备上指示灯的所需颜色以及闪烁占空比(以毫秒为单位)。 并非所有设备都会遵守这些值中的所有(甚至是任何)值。

Parameters

argb

int

onMs

int

offMs

int

Returns

Notification.Builder

也可以看看:

ledARGB

ledOnMS

ledOffMS

setLocalOnly

Added in

API level 20

Notification.Builder setLocalOnly (boolean localOnly)

设置此通知是否不能桥接到其他设备。

有些通知可以桥接到其他设备进行远程显示。 这个提示可以设置为推荐这个通知不被桥接。

Parameters

localOnly

boolean

Returns

Notification.Builder

setNumber

Added in

API level 11

Notification.Builder setNumber (int number)

此方法在API级别24中已弃用。 这个号码不再显示在任何地方

在通知的右侧设置大号。 这相当于setContentInfo,尽管它可能为了可读性而显示不同字体大小的数字。

Parameters

number

int

Returns

Notification.Builder

setOngoing

Added in

API level 11

Notification.Builder setOngoing (boolean ongoing)

设置这是否是“正在进行中”的通知。 正在进行的通知不能被用户解雇,因此您的应用程序或服务必须注意取消它们。 它们通常用于指示用户主动参与的背景任务(例如播放音乐)或以某种方式未决,因此占用设备(例如,文件下载,同步操作,活动网络连接)。

Parameters

ongoing

boolean

Returns

Notification.Builder

也可以看看:

FLAG_ONGOING_EVENT

ERROR(/Service#setForeground(boolean))

setOnlyAlertOnce

Added in

API level 11

Notification.Builder setOnlyAlertOnce (boolean onlyAlertOnce)

设置此标志,如果您只希望在通知尚未显示的情况下播放声音,振动和播报。

Parameters

onlyAlertOnce

boolean

Returns

Notification.Builder

也可以看看:

FLAG_ONLY_ALERT_ONCE

setPriority

Added in

API level 16

Notification.Builder setPriority (int pri)

设置此通知的优先级。

Parameters

pri

int

Returns

Notification.Builder

也可以看看:

priority

setProgress

Added in

API level 14

Notification.Builder setProgress (int max,

int progress,

boolean indeterminate)

设置此通知代表的进度。 平台模板将使用ProgressBar来表示这个。

Parameters

max

int

progress

int

indeterminate

boolean

Returns

Notification.Builder

setPublicVersion

Added in

API level 21

Notification.Builder setPublicVersion (Notification n)

提供替换通知,其内容应显示在不安全的上下文中(即在安全锁屏上)。 见visibility和VISIBILITY_PUBLIC 。

Parameters

n

Notification: A replacement notification, presumably with some or all info redacted.

Returns

Notification.Builder

The same Builder.

setRemoteInputHistory

Added in

API level 24

Notification.Builder setRemoteInputHistory (CharSequence[] text)

设置远程输入历史记录。 这应该设置为通过此通知的RemoteInput发送的最近输入,并在其不再相关时清除(例如,一旦对方已响应,则发送聊天通知)。 最近的输入必须存储在0索引处,第一个索引处的第二个最近的输入等。请注意,系统将限制显示输入的多远以及显示每个输入的多少。

注意:回复文本只会显示在至少有一个动作为 RemoteInput通知中。

Parameters

text

CharSequence

Returns

Notification.Builder

setShowWhen

Added in

API level 17

Notification.Builder setShowWhen (boolean show)

控制是否在内容视图中显示使用setWhen设置的时间戳。 对于定位N及以上的应用,默认为false 。 对于较早的应用程序,默认值为true 。

Parameters

show

boolean

Returns

Notification.Builder

setSmallIcon

Added in

API level 11

Notification.Builder setSmallIcon (int icon,

int level)

setSmallIcon(int)的变体,当图标是 LevelListDrawable时,需要额外的级别参数。

Parameters

icon

int: A resource ID in the application's package of the drawable to use.

level

int: The level to use for the icon.

Returns

Notification.Builder

也可以看看:

icon

iconLevel

setSmallIcon

Added in

API level 11

Notification.Builder setSmallIcon (int icon)

设置小图标资源,用于在状态栏中表示通知。 展开视图的平台模板将在左侧绘制此图标,除非已指定large icon ,此时小图标将移动到右侧。

Parameters

icon

int: A resource ID in the application's package of the drawable to use.

Returns

Notification.Builder

也可以看看:

icon

setSmallIcon

Added in

API level 23

Notification.Builder setSmallIcon (Icon icon)

设置小图标,用于在状态栏和内容视图中表示通知(除非由 large icon覆盖)。

Parameters

icon

Icon: An Icon object to use.

Returns

Notification.Builder

也可以看看:

icon

setSortKey

Added in

API level 20

Notification.Builder setSortKey (String sortKey)

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

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

Parameters

sortKey

String

Returns

Notification.Builder

也可以看看:

compareTo(String)

setSound

Added in

API level 21

Notification.Builder setSound (Uri sound,

AudioAttributes audioAttributes)

设置要播放的声音以及在播放过程中使用的特定 audio attributes 。

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

Parameters

sound

Uri

audioAttributes

AudioAttributes

Returns

Notification.Builder

也可以看看:

sound

setSound

Added in

API level 11

Notification.Builder setSound (Uri sound)

设置声音播放。 它将使用default audio attributes进行通知。

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

Parameters

sound

Uri

Returns

Notification.Builder

也可以看看:

sound

setSound

Added in

API level 11

Notification.Builder setSound (Uri sound,

int streamType)

此方法在API级别21中已弃用。 改为使用setSound(Uri, AudioAttributes) 。

设置要播放的声音以及播放它的特定流。 有关STREAM_常量请参见AudioManager 。

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

Parameters

sound

Uri

streamType

int

Returns

Notification.Builder

也可以看看:

sound

setStyle

Added in

API level 16

Notification.Builder setStyle (Notification.Style style)

添加丰富的通知样式,以便在构建时应用。

Parameters

style

Notification.Style: Object responsible for modifying the notification style.

Returns

Notification.Builder

setSubText

Added in

API level 16

Notification.Builder setSubText (CharSequence text)

这提供了通知中显示的一些附加信息。 在确切显示的地方没有保证。

只有当这些信息为理解通知提供重要利益时才应该提供。 您提供的文字越多,其可读性就越差。 例如,如果添加了多个电子邮件帐户,则电子邮件客户端应只在此处提供帐户名称。

从N此信息显示在通知标题区域中。 在N之前的Android版本中,这将显示在平台通知模板的第三行文本中。 在这些版本中,您不应该同时使用setProgress(int, int, boolean) ; 他们占据了同一个地方。

Parameters

text

CharSequence

Returns

Notification.Builder

setTicker

Added in

API level 11

Notification.Builder setTicker (CharSequence tickerText,

RemoteViews views)

已过时的版本 setTicker(CharSequence) 。

Parameters

tickerText

CharSequence

views

RemoteViews

Returns

Notification.Builder

setTicker

Added in

API level 11

Notification.Builder setTicker (CharSequence tickerText)

设置发送到无障碍服务的“ticker”文本。

Parameters

tickerText

CharSequence

Returns

Notification.Builder

也可以看看:

tickerText

setUsesChronometer

Added in

API level 16

Notification.Builder setUsesChronometer (boolean b)

将when字段显示为秒表。 when不是将时间戳显示为when ,而是显示从when自动更新分钟和秒数的when 。 显示经过时间(如正在进行的电话)时很有用。 计数器也可以设置倒计时到when使用时setChronometerCountDown(boolean) 。

Parameters

b

boolean

Returns

Notification.Builder

也可以看看:

Chronometer

when

setChronometerCountDown(boolean)

setVibrate

Added in

API level 11

Notification.Builder setVibrate (long[] pattern)

设置要使用的振动模式。 有关pattern参数的讨论,请参阅vibrate(long[], int) 。

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

Parameters

pattern

long

Returns

Notification.Builder

也可以看看:

vibrate

setVisibility

Added in

API level 21

Notification.Builder setVisibility (int visibility)

指定 visibility的值。

Parameters

visibility

int: One of VISIBILITY_PRIVATE (the default), VISIBILITY_SECRET, or VISIBILITY_PUBLIC.

Returns

Notification.Builder

The same Builder.

setWhen

Added in

API level 11

Notification.Builder setWhen (long when)

添加与通知有关的时间戳(通常是事件发生的时间)。 对于定位N及以上的应用,默认情况下此时不再显示,必须选择使用setShowWhen(boolean)

Parameters

when

long

Returns

Notification.Builder

也可以看看:

when

相关推荐