1、Notification(通知)编码方式
1.1 创建NotificationManager对通知进行管理
无论在哪里创建通知,整体步骤都是相同的,要使用通知,首先需要创建一个通知管理器NotificationManager,通知管理器可以通过getSystemService()方法接收一个字符串参数用于确定获取系统的哪个服务。这里需要传入Context. NOTIFICATION_SERVICE,因此可以通过代码:
NotificationManager manager = (NotificationManager)getSystemService(Context.NOTIFICATION_SERVICE);
1.2 Builder构造器
接下来需要使用一个Builder构造器来创建Notification对象,但问题在于,几乎Android系统的每一个版本都会对通知这部分功能进行或多或少的修改,API不稳定性在通知这个方面显得十分突出,解决办法就是使用support库中提供的兼容API。通过使用NotificationCompat类的Builder构造器就可以使得我们的程序在所有的Android版本上面都能够正常工作:
NotificationCompat.Builder builder = new NotificationCompat.Builder(Context,id);
//Notification notification = new NotificationCompat.Builder(Context,id)...
这里的Context就是指环境上下文,id就是指唯一的通知通道的id,用于标识,例如: String notificationChannelId = "notification_channel_id_01";
这里的id和manager.notify()中的id不一样,这里的id是用于指定通知通道,至于通知通道,下面会记录。
1.3 利用Builder构造器来设置Notification的UI样式
创建好Builder构造器,就可以通过它来设置通知的样式了,首先需要先了解一下通知的结构:
1)小图标:此为必要图标,通过setSmallIcon()设置。
2)应用名称:此由系统提供。
3)时间戳:此由系统提供,不过可以通过 setWhen() 进行替换,或使用 setShowWhen(false) 将其隐藏。setWhen()中传入System.currentTimeMillis()来显示系统当前时间。
4)大图标:此为可选图标(通常仅用于联系人照片;请勿将其用于应用图标),通过setLargeIcon() 设置。
5)标题:此为可选内容,通过 setContentTitle()设置。
6)文本:此为可选内容,通过 setContentText()设置。
1.4 通知的点击效果
要想实现通知的点击效果,我们需要在代码中进行相应的设置,这就涉及到了PendingIntent。PengdingIntent提供了几个静态方法用于获取PengdingIntent的实例,可以根据需求选择是使用getActivity()、getBroadcast()、还是getService()方法。这几个方法的参数是相同的,都有四个参数:
参数一:Context
参数二:返回代码,一般使用0或1
参数三:一个Intent对象,可以通过这个对象构建中PendingIntent的意图
参数四:用于确定PendingIntent的行为,有四个参数可选:FLAG_ONE_SHOT、FLAG_NO_CREATE、FLAG_CANCEL_CURRENT、FLAG_UPDATE_CURRENT。
创建好PendingIntent之后,可以通过setContentIntent()方法,接收的参数是一个PendingIntent对象,这时一个延迟执行的“意图”就构建成功了,当用户点击这条通知的时候就会执行相应的意图。
1.5 给通知添加按钮点击事件
我们会希望通知上有一些按钮,点击该按钮可以实现一些点击事件,一个通知最对可以提供三个操作按钮,让用户可以快速响应,例如暂停提醒,甚或回复短信。要添加操作按钮,请将 PendingIntent 传递给 addAction() 方法。这就像是设置通知的默认点按操作,不同的是可以不单单是启动 Activity,还可以完成各种其他任务,例如启动在后台执行作业的 BroadcastReceiver,这样该操作就不会干扰已经打开的应用。
1.6 创建通知并显示
上面的一切设计都是针对Builder对象的操作,当通知已经设计完成了以后,我们需要创建我们设计好的通知,这个过程十分简单,我们通过 Builder.build()就可以实现。创建好通知后需要实现它,这时候就需要用到上面创建的通知管理器NotificationManager了,通过NotificationManager.notify()可以实现,这个方法里面有两个参数,第一个参数是我们设置的用于标识通知的id,可以任意设置,但是需要唯一。第二个参数是我们创建的通知,代码示例如下:
notificationManager.notify(123, notification);
2、Notification(通知)兼容性设置
2.1创建通知渠道
上面1.2说到,在创建通知构建器的时候:
NotificationCompat.Builder builder = new NotificationCompat.Builder(Context,id);
需要传入唯一的通知渠道ID,用于标识通知渠道的唯一性,这里的通知渠道,是在Android8.0以后需要创建的,8.0以前的系统是不需要的,为了提高应用的兼容性,我们需要进行判断,如果系统版本低于8.0.那么直接采用上面的方式设计、创建、并显示通知,如果系统版本高于8.0,那么则先为通知创建渠道。判断的代码如下:
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O){}
从 Android 8.0(API 级别 26)开始,所有的通知都必须分配到相应的渠道。对于每个渠道,您可以设置应用于其中的所有通知的视觉和听觉行为(也就是通知的级别)。然后,用户可以更改这些设置,并确定您应用中的哪些通知渠道应具有干扰性或应该可见。我认为添加这个功能主要是为了让用户能够更透明的管理通知。
创建渠道的步骤如下:
- 建立渠道:
NotificationChannel notificationChannel = new NotificationChannel(notificationChannelId, channelName, importance);
-
配置渠道:
//配置通知渠道的描述
notificationChannel.setDescription("Channel description");
//LED灯
notificationChannel.enableLights(true);
notificationChannel.setLightColor(Color.RED);
//震动
notificationChannel.setVibrationPattern(new long[]{0, 1000, 500, 1000});
notificationChannel.enableVibration(true);
//设置提示音
channel.setSound();
//设置锁屏展示
channel.setLockscreenVisibility();
创建渠道:
上面创建了通知管理器NotificationManager,渠道设置好了之后,就需要通过通知管理器将渠道创建出来,代码如下:
manager.createNotificationChannel(notificationChannel);
2.2 设置通知级别
Android7.0(API级别25)及之前,通过setPriority(NotificationCompat.PRIORITY_LOW)方法可以直接设置。
Android8.0(API级别26)及更高版本,在Android8.0以上版本这一功能需要在通知渠道中设置:
NotificationChannel channel = new NotificationChannel(channelID, channelNAME, NotificationManager.IMPORTANCE_LOW);
其中第三个参数Importance就是对通知级别进行设置,通知的级别如下所示:
除了在创建渠道的时候设置,在渠道创建完成之后也可以设置,通过代码:
channel.setImportance(Notification.IMPORTANCE_HIGH);
可以在渠道创建完成之后进行设置。
3、自定义Notification通知
自定义通知有两种,一种是为内容区域创建自定义布局,另一种是创建完全自定义的通知布局。
3.1 为内容区域创建自定义布局:
如果需要自定义内容区域的布局,可以将 NotificationCompat.DecoratedCustomViewStyle应用到通知。借助此 API,可以为通常由标题和文本内容占据的内容区域提供自定义布局,同时仍对通知图标、时间戳、子文本和操作按钮使用系统装饰。
自定义布局的使用方式如下:
1)构建基本通知(使用 NotificationCompat.Builder)
2)调用 setStyle(),向其传递一个 NotificationCompat.DecoratedMediaCustomViewStyle实例。
3)将自定义布局扩充为 RemoteViews 的实例。
4)调用 setCustomContentView() 以设置收起后通知的布局。您还可以选择调用 setCustomBigContentView() 来为展开后通知设置不同的布局。
代码如下:
RemoteViews notificationLayout = new RemoteViews(getPackageName(), R.layout.custom_notification_item);
RemoteViews notificationLayoutExpanded = new RemoteViews(getPackageName(), R.layout.custom_notification_large);
NotificationCompat.Builder notification = new NotificationCompat.Builder(this, channelId)
.setStyle(new NotificationCompat.DecoratedCustomViewStyle())
.setCustomContentView(notificationLayout)
.setCustomBigContentView(notificationLayoutExpanded)
.setVisibility(NotificationCompat.VISIBILITY_PUBLIC)
.setAutoCancel(true);//设置点击后能否自动取消通知
3.2 创建完全自定义通知布局
如果您不希望使用标准通知图标和标题装饰通知,按照上述步骤使用 setCustomBigContentView(),但不要调用 setStyle()。要支持低于 Android 4.1(API 级别 16)的 Android 版本,还应调用 setContent(),向其传递同一 RemoteViews 对象。
4、自定义Dialog
4.1 自定义Dialog布局
要使用自定义Dialog,首先需要为这个Dialog定义布局,新建一个XML布局文件,对其进行设计,这个就是我们将会应用于Dialog的布局样式,当我们触发Dialog的时候,就会显示这个布局样式。
4.2 自定义Dialog类
因为使用的不是原生Dialog,而是自定义的Dialog,我们就需要为其定义一个类,继承于Dialog类,并在它的构造方法中绑定我们自定义的布局,代码如下:
public class MyDiaLog extends Dialog{
public MyDiaLog(@NonNull Context context) {
super(context);
setContentView(R.layout.dialog_layout);
}
}
4.3 显示自定义DIalog
要显示我们之前自定义的Dialog,步骤十分简单,首先实例化一个Dialog对象,然后调用它的.show()方法,便可以显示我们自定义的Dialog对象了。
4.4 原生的各种DiaLog的使用
除了自定义的Dialog之外,还有很多各式原生Dialog可以使用,比如带有输入框的Dialog,带有进度条的Dialog,列表Dialog等等,具体的原生Dialog使用在附件Demo中。