💎一站式轻松地调用各大LLM模型接口,支持GPT4、智谱、星火、月之暗面及文生图 广告
通知信息是状态栏中最常用的功能之一。根据用户是否拉下下拉卷帘,通知信息表现为一个位于状态栏的图标,或在下拉卷帘中的一个条目。另外,通知信息还可以在其添加入状态栏之时发出声音,以提醒用户注意查看。通知信息即可以表示一条事件,如新的短消息到来、出现了一条未接来电等,也可以用来表示一个正在后台持续进行着的工作,如正在下载某一文件、正在播放音乐等。 #### 1.通知信息的发送 任何使用者都可以通过NotificationManager所提供的接口向状态栏添加一则通知信息。通知信息的详细内容可以通过一个Notification类的实例来描述。 Notification类中包含如下几个用于描述通知信息的关键字段。 - icon,一个用于描述一个图标的资源id,用于显示在状态栏之上。每条通知信息必须提供一个有效的图标资源,否则此信息将会被忽略。 - iconLevel,如果icon所描述的图标资源存在level,那么iconLevel则用于告知状态栏将显示图标资源的那一个level。 - number,一个int型变量用于表示通知数目。例如,当有3条新的短信时,没有必要使用三个通知,而是将一个通知的number成员设置为3,状态栏会将这一数字显示在通知图标上。 - contentIntent,一个PendingIntent的实例,用于告知状态栏当在下拉卷帘中点击本条通知时应当执行的动作。contentIntent往往用于启动一个Activity以便让用户能够查看关于此条通知的详细信息。例如,当用户点击一条提示新短信的通知时,短信应用将会被启动并显示短信的详细内容。 - deleteIntent,一个PendingIntent的实例,用于告知状态栏当用户从下拉卷帘中删除本条通知时应当执行的动作。deleteIntent往往用在表示某个工作正在后台进行的通知中,以便当用户从下拉卷帘中删除通知时,发送者可以终止此后台工作。 - tickerText,一条文本。当通知信息被添加时,状态栏将会在其上逐行显示这条信息。其目的在于使用户无需进行卷帘下拉操作即可从快速获取通知的内容。 - fullScreenIntent,一个PendingIntent的实例,用于告知状态栏当此条信息被添加时应当执行的动作,一般这一动作是启动一个Activity用于显示与通知相关的详细信息。fullScreenIntent其实是一个替代tickerText的设置。当Notification中指定了fullScreenIntent时,StatusBar将会忽略tickerText的设置。因为这两个设置的目的都是为了让用户可以在第一时间了解通知的内容。不过相对于tickerText,fullScreenIntent强制性要明显得多,因为它将打断用户当前正在进行的工作。因此fullScreenIntent应该仅用于通知非常重要或紧急的事件,比如说来电或闹钟。 - contentView/bigContentView,RemoteView的实例,可以用来定制通知信息在下拉卷帘中的显示形式。一般来讲,相对于contentView,bigContentView可以占用更多空间以显示更加详细的内容。状态栏将根据自己的判断选择将通知信息显示为contentView或是bigContentView。 - sound与audioStreamType,指定一个用于播放通知声音的Uri及其所使用的音频流类型。在默认情况下,播放通知声音所用的音频流类型为STREAM\_NOTIFICATION。 - vibrate,一个float数组,用于描述震动方式。 - ledARGB/ledOnMS/ledOffMS,指定当此通知被添加到状态栏时设备上的LED指示灯的行为,这几个设置需要硬件设备的支持。 - defaults,用于指示声音、震动以及LED指示灯是否使用系统的默认行为。 - flags,用于存储一系列用于定制通知信息行为的标记。通知信息的发送者可以根据需求在其中加入这样的标记:FLAG\_SHOW\_LIGHTS要求使用LED指示灯,FLAG\_ONGOING\_EVENT指示通知信息用于描述一个正在进行的后台工作,FLAG\_INSISTENT指示通知声音将持续播放直到通知信息被移除或被用户查看,FLAG\_ONLY\_ARLERT\_ONCE指示任何时候通知信息被加入到状态栏时都会播放一次通知声音,FLAG\_AUTO\_CANCEL指示当用户在下拉卷帘中点击通知信息时自动将其移出,FLAG\_FOREGROUND\_SERVICE指示此通知用来表示一个正在以foreground形式运行的服务。 - priority,描述了通知的重要性级别。通知信息的级别从低到高共分为MIN(-2)、LOW(-1)、DEFAULT(0)以及HIGH(1)四级。低优先级的通知信息有可能不会被显示给用户,或显示在通知列表中靠下的位置。 在随后的讨论中将会详细介绍这些信息如何影响通知信息的显示与行为。 当通知信息的发送者根据需求完成了Notification实例的创建之后,便可以通过NotificationManager.notify()方法将通知显示在状态栏上。 notify()方法要求通知信息的发送者除了提供一个Notification实例之外,还需要提供一个字符串类型的参数tag,以及int类型的参数id,这两个参数一并确定了信息的意图。当一条通知信息已经被提交给NotificationManager.notify()并且仍然显示在状态栏中时,它将会被新提交的拥有相同意图(即相同的tag以及相同的id)通知信息所替换。 参考NotificationManager.notify()方法的实现: **NotificationManager.java-->NotificationManager.notify()** ``` public void notify(String tag, int id,Notification notification) { int[]idOut = new int[1]; // **① 获取NotificationManagerService的Bp端代理** INotificationManager service = getService(); // **② 获取信息发送者的包名** Stringpkg = mContext.getPackageName(); ...... try { // **③ 将包名、tag、id以及Notification实例一并提交给NotificationManagerService** service.enqueueNotificationWithTag(pkg, tag, id, notification, idOut, UserHandle.myUserId()); } catch(RemoteException e) {......} } ``` NotificationManager会将通知信息发送给NotificationManagerService,并由NotificationManagerService对信息进行进一步处理。注意Notification将通知发送者的包名作为参数传递给了NotificationManagerService。对于一个应用程序来说,tag与id而这一起确定了通知的意图。由于NotificationManagerService作为一个系统服务需要接受来自各个应用程序通知信息,因此对NotificationManagerService来说,确定通知的意图需要在tag与id之外再增加一项:通知发送者的包名。因此由于包名的不一样,来自两个应用程序的具有相同tag与id的通知信息之间不会发生任何冲突。另外将包名作为通知意图的元素之一的原因出于对信息安全考虑。 而将一则通知信息从状态栏中移除则简单得多了,NotificationManager.cancel()方法可以提供这一操作,它接受tag、id作为参数用于指明希望移除的通知所具有的意图。