NotificationListenerService的那些事儿
最近在公司时接到一个需求：需要实时监听设备的通知栏消息，并可以捕获到通知的内容，然后进行对应的操作。刚看到这个需求的时候，脑子里第一反应就是使用 AccessibilityService 。 AccessibilityService 支持的事件监听类型中有 TYPE_NOTIFICATION_STATE_CHANGED ，该事件类型就是用来监听通知栏消息状态改变的，众多的抢红包插件利用的就是这个原理。
之后在 Github 上看到了 qianghongbao 这个抢红包的项目，发现代码里面有一个 QHBNotificationService 继承了 NotificationListenerService ，这个 NotificationListenerService 极大地引起了我的兴趣。查了一下资料，发现 NotificationListenerService 是在 Android 4.3 （API 18）时被加入的，作用就是用来监听通知栏消息。并且官方建议在 Android 4.3 及以上使用 NotificationListenerService 来监听通知栏消息，以此取代 AccessibilityService 。
image
NotificationListenerService 的使用范围也挺广的，比如我们熟知的抢红包，智能手表同步通知，通知栏去广告工具等，都是利用它来完成的。所以，我也想赶时髦地好好利用这把“利器”。最后方案也就出来了：在 Android 4.3 以下（API < 18）使用 AccessibilityService 来读取新通知，在 Android 4.3 及以上（API >= 18）使用 NotificationListenerService 来满足需求。
这也正是本篇博客诞生的“起源”。
NotificationListenerService
在这里，我们就做一个小需求：实时检测微信的新通知，如果该通知是微信红包的话，就进入微信聊天页面。
准备好了吗，我们开始吧！
首先创建一个 WeChatNotificationListenerService 继承 NotificationListenerService 。然后在 AndroidManifest.xml 中进行声明相关权限和
然后一般会重写下面这三个方法：
onNotificationPosted(StatusBarNotification sbn)：当有新通知到来时会回调；onNotificationRemoved(StatusBarNotification sbn)：当有通知移除时会回调；onListenerConnected()：当NotificationListenerService是可用的并且和通知管理器连接成功时回调。
onNotificationPosted(StatusBarNotification sbn)
下面我们来看看 NotificationListenerService 中的重点： onNotificationPosted(StatusBarNotification sbn) 方法。
@Override
public void onNotificationPosted(StatusBarNotification sbn) {
// 如果该通知的包名不是微信，那么 pass 掉
if (!"com.tencent.mm".equals(sbn.getPackageName())) {
return;
}
Notification notification = sbn.getNotification();
if (notification == null) {
return;
}
PendingIntent pendingIntent = null;
// 当 API > 18 时，使用 extras 获取通知的详细信息
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.KITKAT) {
Bundle extras = notification.extras;
if (extras != null) {
// 获取通知标题
String title = extras.getString(Notification.EXTRA_TITLE, "");
// 获取通知内容
String content = extras.getString(Notification.EXTRA_TEXT, "");
if (!TextUtils.isEmpty(content) && content.contains("[微信红包]")) {
pendingIntent = notification.contentIntent;
}
}
} else {
// 当 API = 18 时，利用反射获取内容字段
List textList = getText(notification);
if (textList != null && textList.size() > 0) {
for (String text : textList) {
if (!TextUtils.isEmpty(text) && text.contains("[微信红包]")) {
pendingIntent = notification.contentIntent;
break;
}
}
}
}
// 发送 pendingIntent 以此打开微信
try {
if (pendingIntent != null) {
pendingIntent.send();
}
} catch (PendingIntent.CanceledException e) {
e.printStackTrace();
}
}
从上面的代码可知，对于分析 Notification 的内容分为了两种：
- 当 API > 18 时，利用
Notification.extras来获取通知内容。extras是在 API 19 时被加入的； - 当 API = 18 时，利用反射获取
Notification中的内容。具体的代码在下方。
public List getText(Notification notification) {
if (null == notification) {
return null;
}
RemoteViews views = notification.bigContentView;
if (views == null) {
views = notification.contentView;
}
if (views == null) {
return null;
}
// Use reflection to examine the m_actions member of the given RemoteViews object.
// It's not pretty, but it works.
List text = new ArrayList<>();
try {
Field field = views.getClass().getDeclaredField("mActions");
field.setAccessible(true);
@SuppressWarnings("unchecked")
ArrayList actions = (ArrayList) field.get(views);
// Find the setText() and setTime() reflection actions
for (Parcelable p : actions) {
Parcel parcel = Parcel.obtain();
p.writeToParcel(parcel, 0);
parcel.setDataPosition(0);
// The tag tells which type of action it is (2 is ReflectionAction, from the source)
int tag = parcel.readInt();
if (tag != 2) continue;
// View ID
parcel.readInt();
String methodName = parcel.readString();
if (null == methodName) {
continue;
} else if (methodName.equals("setText")) {
// Parameter type (10 = Character Sequence)
parcel.readInt();
// Store the actual string
String t = TextUtils.CHAR_SEQUENCE_CREATOR.createFromParcel(parcel).toString().trim();
text.add(t);
}
parcel.recycle();
}
} catch (Exception e) {
e.printStackTrace();
}
return text;
}
凭着 onNotificationPosted(StatusBarNotification sbn) 方法就已经可以完成监听微信通知并打开的动作了。下面我们来看一下其他关于 NotificationListenerService 的二三事。
取消通知
有了监听，NotificationListenerService 自然提供了可以取消通知的方法。取消通知的方法有：
cancelNotification(String key)：是 API >= 21 才可以使用的。利用StatusBarNotification的getKey()方法来获取key并取消通知。cancelNotification(String pkg, String tag, int id)：在 API < 21 时可以使用，在 API >= 21 时使用此方法来取消通知将无效，被废弃。
最后，取消通知的方法：
public void cancelNotification(StatusBarNotification sbn) {
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.LOLLIPOP) {
cancelNotification(sbn.getKey());
} else {
cancelNotification(sbn.getPackageName(), sbn.getTag(), sbn.getId());
}
}
检测通知监听服务是否被授权
public boolean isNotificationListenerEnabled(Context context) {
Set packageNames = NotificationManagerCompat.getEnabledListenerPackages(this);
if (packageNames.contains(context.getPackageName())) {
return true;
}
return false;
}
打开通知监听设置页面
public void openNotificationListenSettings() {
try {
Intent intent;
if (android.os.Build.VERSION.SDK_INT >= android.os.Build.VERSION_CODES.LOLLIPOP_MR1) {
intent = new Intent(Settings.ACTION_NOTIFICATION_LISTENER_SETTINGS);
} else {
intent = new Intent("android.settings.ACTION_NOTIFICATION_LISTENER_SETTINGS");
}
startActivity(intent);
} catch (Exception e) {
e.printStackTrace();
}
}
被杀后再次启动时，监听不生效的问题
这个问题来源于知乎问题： NotificationListenerService不能监听到通知，研究了一天不知道是什么原因？
从问题的回答中可以了解到，是因为 NotificationListenerService 被杀后再次启动时，并没有去 bindService ，所以导致监听效果无效。
最后，在回答中还给出了解决方案：利用 NotificationListenerService 先 disable 再 enable ，重新触发系统的 rebind 操作。代码如下：
private void toggleNotificationListenerService() {
PackageManager pm = getPackageManager();
pm.setComponentEnabledSetting(new ComponentName(this, com.fanwei.alipaynotification.ui.AlipayNotificationListenerService.class),
PackageManager.COMPONENT_ENABLED_STATE_DISABLED, PackageManager.DONT_KILL_APP);
pm.setComponentEnabledSetting(new ComponentName(this, com.fanwei.alipaynotification.ui.AlipayNotificationListenerService.class),
PackageManager.COMPONENT_ENABLED_STATE_ENABLED, PackageManager.DONT_KILL_APP);
}
该方法使用前提是 NotificationListenerService 已经被用户授予了权限，否则无效。另外，在自己的小米手机上实测，重新完成 rebind 操作需要等待 10 多秒（我的手机测试过大概在 13 秒左右）。幸运的是，官方也已经发现了这个问题，在 API 24 中提供了 requestRebind(ComponentName componentName) 方法来支持重新绑定。
AccessibilityService
讲完了 NotificationListenerService 之后，按照前面说的那样，在 API < 18 的时候使用 AccessibilityService 。
同样，创建一个 WeChatAccessibilityService ，并且在 AndroidManifest.xml 中进行声明：
声明之后，还要对 WeChatAccessibilityService 进行配置。需要在 res 目录下新建一个 xml 文件夹，在里面新建一个 accessible_service_config.xml 文件：
最后就是代码了：
public class WeChatAccessibilityService extends AccessibilityService {
@Override
public void onAccessibilityEvent(AccessibilityEvent event) {
if (Build.VERSION.SDK_INT < 18) {
Notification notification = (Notification) event.getParcelableData();
List textList = getText(notification);
if (textList != null && textList.size() > 0) {
for (String text : textList) {
if (!TextUtils.isEmpty(text) &&
text.contains("[微信红包]")) {
final PendingIntent pendingIntent = notification.contentIntent;
try {
if (pendingIntent != null) {
pendingIntent.send();
}
} catch (PendingIntent.CanceledException e) {
e.printStackTrace();
}
}
break;
}
}
}
}
@Override
public void onInterrupt() {
}
}
看了一圈 WeChatAccessibilityService 的代码，发现和 WeChatNotificationListenerService 在 API < 18 时处理的逻辑是一样的，getText(notification) 方法就是上面那个，在这里就不复制粘贴了，基本没什么好讲的了。
有了 WeChatAccessibilityService 之后，在 API < 18 的情况下也能监听通知啦。(ο)/
我们终于实现了当初许下的那个需求了。 cry ...
总结
除了监听通知之外，AccessibilityService 还可以进行模拟点击、检测界面变化等功能。具体的可以在 GitHub 上搜索抢红包有关的 Repo 进行深入学习。
而 NotificationListenerService 的监听通知功能更加强大，也更加专业。在一些设备上，如果 NotificationListenerService 被授予了权限，那么可以做到该监听进程不死的效果，也算是另类的进程保活。
今天就到这儿了，拜拜！！
源码下载：ListenWeChatNotification.rar
References
- Android 4.3 APIs
- NotificationListenerService
- NotificationListenerService不能监听到通知，研究了一天不知道是什么原因？
- 本文作者： 俞其荣
- 本文链接： http://yuqirong.me/2017/02/09/NotificationListenerService的那些事儿/
- 版权声明： 本博客所有文章除特别声明外，均采用 CC BY-NC-SA 4.0 许可协议。转载请注明出处！