Android NotificationListenerService使用方式（详细步骤+源码）
前言
今天是七夕，深圳又在下雨，庆幸的是单身狗不用出门，苦涩。NotificationListenerService 通知监听服务，就是监听手机上的广播通知，这个在纯App开发中用的比较少，但是在智能穿戴领域用的很多，比如我有一个智能手表，然后有一个配套的App应用，有时候在上班路上，手机放在口袋里，要接受到手机上的通知消息，例如QQ、微信、来电、短信等。智能手表上显示有新消息，如果手表上有屏幕的话，还能显示消息的内容。这就很Nice了不是吗？
先看看效果图：
正文
下面进入正式的使用，我先说一下使用的思路，NotificationListenerService 是一个服务，服务更多的是在后台运行，其次由于这个需要进行通知监听，会涉及到一个动态权限请求。第三就是手机上是否安装了微信、QQ等应用。
一、配置项目
新建项目NotifyListenerDemo。
主要是项目依赖库的添加，打开工程的build.gradle的repositories{}闭包下添加依赖库：
maven {url "https://jitpack.io"}然后在app模块的build.gradle中添加依赖：
//简单工具类库
implementation 'com.github.lilongweidev:EasyLibrary:1.0.4'然后Sync，同步项目添加依赖库。
二、通知监听服务
创建一个服务，然后将服务注册在AndroidManifest.xml中。创建一个NotifyService类，里面的代码如下：
public class NotifyService extends NotificationListenerService {
public static final String TAG = "NotifyService";
public static final String QQ = "com.tencent.mobileqq";//qq信息
public static final String WX = "com.tencent.mm";//微信信息
public static final String MMS = "com.android.mms";//短信
public static final String HONOR_MMS= "com.hihonor.mms";//荣耀短信
public static final String MESSAGES = "com.google.android.apps.messaging";//信息
public static final String IN_CALL = "com.android.incallui";//来电 -
/**
* 发布通知
* @param sbn 状态栏通知
*/
@Override
public void onNotificationPosted(StatusBarNotification sbn) {
switch (sbn.getPackageName()){
case MESSAGES:
case MMS:
case HONOR_MMS:
Log.d(TAG,"收到短信");
break;
case QQ:
Log.d(TAG,"收到QQ消息");
break;
case WX:
Log.d(TAG,"收到微信消息");
break;
case IN_CALL:
Log.d(TAG,"收到来电");
break;
default:break;
}
}
/**
* 通知已删除
* @param sbn 状态栏通知
*/
@Override
public void onNotificationRemoved(StatusBarNotification sbn) {
switch (sbn.getPackageName()){
case MESSAGES:
case MMS:
case HONOR_MMS:
Log.d(TAG,"移除短信");
break;
case QQ:
Log.d(TAG,"移除QQ消息");
break;
case WX:
Log.d(TAG,"移除微信消息");
break;
case IN_CALL:
Log.d(TAG,"移除来电");
break;
default:break;
}
}
/**
* 监听断开
*/
@Override
public void onListenerDisconnected() {
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.N) {
// 通知侦听器断开连接 - 请求重新绑定
requestRebind(new ComponentName(this, NotificationListenerService.class));
}
}
}这个类继承了NotificationListenerService，里面里面几个方法，都已经注释过了，这里设置通知栏上应用的包名，由于国产厂商对于Android做了定制化，因此各个厂商的系统App软件的包名就不会是一致的，例如我用的是荣耀，那么我监听到的通知短信是com.hihonor.mms，来电是com.android.incallui。这个地方需要开发者自行去适配。不过QQ和微信这种App的包名是固定的，可以放心使用。
下面将这个服务注册在AndroidManifest.xml中。
<service
android:name=".NotifyService"
android:enabled="true"
android:label="测试通知服务"
android:permission="android.permission.BIND_NOTIFICATION_LISTENER_SERVICE">
<intent-filter>
<action android:name="android.service.notification.NotificationListenerService" />
intent-filter>
service>服务配置完成了，下面进行具体的打开服务操作。
三、打开通知服务监听
使用这个通知服务其实就是打开一个手机上应用的开关，效果上和打开蓝牙差不多，下面先写一个方法检查当前应用是否开启这个服务。方法代码如下：
/**
* 是否启用通知监听服务
* @return
*/
public boolean isNLServiceEnabled() {
Set<String> packageNames = NotificationManagerCompat.getEnabledListenerPackages(this);
if (packageNames.contains(getPackageName())) {
return true;
}
return false;
}这里还对应一个方法就是设置服务是否运行，如下：
/**
* 切换通知监听器服务
*
* @param enable
*/
public void toggleNotificationListenerService() {
PackageManager pm = getPackageManager();
pm.setComponentEnabledSetting(new ComponentName(getApplicationContext(), NotifyService.class),
PackageManager.COMPONENT_ENABLED_STATE_DISABLED, PackageManager.DONT_KILL_APP);
pm.setComponentEnabledSetting(new ComponentName(getApplicationContext(), NotifyService.class),
PackageManager.COMPONENT_ENABLED_STATE_ENABLED, PackageManager.DONT_KILL_APP);
}现在方法有了需要一个地方去触发，通过按钮来进行，在activity_main.xml添加一个按钮。
<androidx.constraintlayout.widget.ConstraintLayout xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:app="http://schemas.android.com/apk/res-auto"
xmlns:tools="http://schemas.android.com/tools"
android:layout_width="match_parent"
android:layout_height="match_parent"
tools:context=".MainActivity">
<TextView
android:id="@+id/textView"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:text="Hello World!"
app:layout_constraintBottom_toBottomOf="parent"
app:layout_constraintLeft_toLeftOf="parent"
app:layout_constraintRight_toRightOf="parent"
app:layout_constraintTop_toTopOf="parent" />
<Button
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:text="请求权限"
android:onClick="requestPermission"
app:layout_constraintBottom_toBottomOf="parent"
app:layout_constraintEnd_toEndOf="parent"
app:layout_constraintStart_toStartOf="parent"
app:layout_constraintTop_toBottomOf="@+id/textView" />
androidx.constraintlayout.widget.ConstraintLayout>在MainActivity中添加一个方法：
private static final int REQUEST_CODE = 9527;
/**
* 请求权限
*
* @param view
*/
public void requestPermission(View view) {
if (!isNLServiceEnabled()) {
startActivityForResult(new Intent("android.settings.ACTION_NOTIFICATION_LISTENER_SETTINGS"), REQUEST_CODE);
} else {
showMsg("通知服务已开启");
toggleNotificationListenerService(true);
}
}这个还有一个showMsg方法：
private void showMsg(String msg) {
Toast.makeText(this, msg, Toast.LENGTH_SHORT).show();
}然后是页面返回：
@Override
protected void onActivityResult(int requestCode, int resultCode, Intent data) {
super.onActivityResult(requestCode, resultCode, data);
if (requestCode == REQUEST_CODE) {
if (isNLServiceEnabled()) {
showMsg("通知服务已开启");
toggleNotificationListenerService(true);
} else {
showMsg("通知服务未开启");
toggleNotificationListenerService(false);
}
}
}下面就可以先运行一下：
现在就可以测试数据，这里建议你找一个朋友给你发消息，保持电脑上没有登录微信和QQ，然后手机上的微信和QQ保持后台运行就可以了，下面让你的朋友给你发QQ消息、微信消息。
这是我这里测试的数据，控制打印出来：
QQ、微信、短信、来电都监听到了。
四、页面显示消息类型
现在只是在NotifyService中可以打印出来，那么Activity并不知道，但是实际的UI操作又是在Activity里面，因此需要将消息传递到Activity，这种方式很多，我这里使用接口回调的方式来进行。下面新建一个接口，代码如下：
public interface NotifyListener {
/**
* 接收到通知栏消息
* @param type
*/
void onReceiveMessage(int type);
/**
* 移除掉通知栏消息
* @param type
*/
void onRemovedMessage(int type);
}然后再写一个NotifyHelper帮助类，用于实现接口的回调处理。
public class NotifyHelper {
private static NotifyHelper instance;
public static final int N_MESSAGE = 0;
public static final int N_CALL = 1;
public static final int N_QQ = 2;
public static final int N_WX = 3;
private NotifyListener notifyListener;
public static NotifyHelper getInstance() {
if (instance == null) {
instance = new NotifyHelper();
}
return instance;
}
/**
* 收到消息
* @param type 消息类型
*/
public void onReceive(int type) {
if (notifyListener != null) {
notifyListener.onReceiveMessage(type);
}
}
/**
* 移除消息
* @param type 消息类型
*/
public void onRemoved(int type) {
if (notifyListener != null) {
notifyListener.onRemovedMessage(type);
}
}
/**
* 设置回调方法
*
* @param notifyListener 通知监听
*/
public void setNotifyListener(NotifyListener notifyListener) {
this.notifyListener = notifyListener;
}
}最后收到服务中收到通知进行调用。
移除通知进行调用
最后只要在MainActivity中实现接口。
这里实现接口，然后将收到的结果显示在TextView上，实现接口中的两个回调方法。
/**
* 收到通知
* @param type 通知类型
*/
@Override
public void onReceiveMessage(int type) {
switch (type) {
case N_MESSAGE:
textView.setText("收到短信消息");
break;
case N_CALL:
textView.setText("收到来电消息");
break;
case N_WX:
textView.setText("收到微信消息");
break;
case N_QQ:
textView.setText("收到QQ消息");
break;
default:
break;
}
}
/**
* 移除通知
* @param type 通知类型
*/
@Override
public void onRemovedMessage(int type) {
switch (type) {
case N_MESSAGE:
textView.setText("移除短信消息");
break;
case N_CALL:
textView.setText("移除来电消息");
break;
case N_WX:
textView.setText("移除微信消息");
break;
case N_QQ:
textView.setText("移除QQ消息");
break;
default:
break;
}
}下面再运行一下：
可以看到，现在通过接口想消息类型的结果显示到页面上来了。
五、页面显示消息内容、时间
现在的很多带屏幕的手环都做到了这一点，可以显示消息内容，这个说起来很高大上，实际上很简单，还是之前的那个地方，那个位置，为了更够更好的显示内容，我还是用代码来说明一下。
首先在NotifyListener增加接口中的方法。
/**
* 接收到通知栏消息
* @param sbn
*/
void onReceiveMessage(StatusBarNotification sbn);
/**
* 移除掉通知栏消息
* @param sbn
*/
void onRemovedMessage(StatusBarNotification sbn);与之前的方法中的参数不同，当然图方便也可以只用这个新增的，把之前的可以去掉，因为现在的这个拿到的信息要比之前多，只不过需要再对消息做进一步的处理。
接口方法写好了，在NotifyHelper中新增两个方法对刚才的接口方法进行调用。
/**
* 收到消息
* @param sbn 状态栏通知
*/
public void onReceive(StatusBarNotification sbn) {
if(notifyListener != null) {
notifyListener.onReceiveMessage(sbn);
}
}
/**
* 移除消息
* @param sbn 状态栏通知
*/
public void onRemoved(StatusBarNotification sbn) {
if (notifyListener != null) {
notifyListener.onRemovedMessage(sbn);
}
}这里和之前的接口方法如出一辙，最后就是在NotifyService中调用NotifyHelper中的两个方法即可。
最后只要在MainActivity中实现接口回调方法就可以了。
代码如下：
/**
* 收到通知
*
* @param sbn 状态栏通知
*/
@Override
public void onReceiveMessage(StatusBarNotification sbn) {
if (sbn.getNotification() == null) return;
//消息内容
String msgContent = "";
if (sbn.getNotification().tickerText != null) {
msgContent = sbn.getNotification().tickerText.toString();
}
//消息时间
String time = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss", Locale.CHINESE).format(new Date(sbn.getPostTime()));
textView.setText(String.format(Locale.getDefault(),
"应用包名：%s\\n消息内容：%s\\n消息时间：%s\\n",
sbn.getPackageName(), msgContent, time));
}
/**
* 移除通知
*
* @param sbn 状态栏通知
*/
@Override
public void onRemovedMessage(StatusBarNotification sbn) {
textView.setText("通知移除");
}运行一下：
这个图就说明了消息的内容，在通知栏上并不是所有通知都有内容的，例如手机屏幕录制是没有通知内容的，然后后面我收到一条QQ消息就会显示出消息内容，那么本篇文章就到这里了，山高水长，后会有期~
六、源码
GitHub：NotifyListenerDemo
