本章主要讲的是 Android 系统的广播机制,并介绍了广播的使用,权限以及有序广播的用法。
GitHub 地址:
完成第27章
在使用广播之前,首先回顾一下 PhotoGallery 在本章之前的逻辑:
- 打开程序后,如果开始推送服务,就每隔一段时间获取一次图片信息
- 如果图片有更新,就发出通知
那么本章我们想做到的有:
- 在开机以后自动启用服务(如果打开了开关)
- 在应用打开时图片有更新也不发出通知
这里,我们将使用广播来完成这些任务。
1. 接收系统广播:重启后唤醒
1.1 broadcast intent
Android 设备中,各种事件一直在频繁地发生。Wi-Fi 信号时有时无,各种软件包获得安装,电话不时呼入,短信频繁接收等等。许多系统组件需要知道某些事件的发生。为满足这样的需求,Android 提供了 broadcast intent 组件。broadcast intent 的工作原理类似于之前学过的 intent 唯,一不同的是 broadcast intent 可同时被多个叫作 broadcast receiver 的组件接收。
1.2 standalone receiver
standalone receiver 是一个在 manifest 配置文件中声明的 broadcast receiver。即便应用进程已消亡,standalone receiver 也可以被激活。(另一种就是可以同 fragment 或 activity 的生命周期绑定的 dynamic receiver。)
首先建立这样一个 BroadcastReceiver,并重写 onReceive 方法,注意:该方法是在主线程中执行的
public class StartupReceiver extends BroadcastReceiver {
private static final String TAG = "StartupReceiver";
@Override
public void onReceive(Context context, Intent intent) {
Log.i(TAG, "Received broadcast intent: " + intent.getAction());
boolean isOn = QueryPreferences.isAlarmOn(context);
PollService.setServiceAlarm(context, isOn);
}
}
记得在 manifest 文件中声明
<uses-permission android:name="android.permission.RECEIVE_BOOT_COMPLETED"/>
<application>
……
<receiver android:name=".StartupReceiver">
<intent-filter>
<action android:name="android.intent.action.BOOT_COMPLETED"/>
</intent-filter>
</receiver>
……
</application>
登记好 broadcast receiver 以后,一旦设备启动,这个 receiver 就能接收到启动完成的广播,并随之启动服务了。
2. 过滤应用在前台时的通知
为了实现这一点,我们把发出通知的思路改了:之前是在服务中查询到新的结果就发出通知,现在则是:
- 在查询到新的结果后,发出一条应用内的广播并在其中标记一个代码 A,
- 在应用中动态登记广播接收器,如果接收到广播(说明应用在前台),就把这个代码改成 B。
- 最后总有一个优先级最低的接收器接收到这个广播,如果代码是 A,就发出通知,否则就不发出通知。
2.1 发送 broadcast intent
在 Context 类中直接调用 sendBroadcast(Intent) 即可发出广播。但是为了只让本应用接收到该广播,我们在 manifest 文件中声明一个权限并使用:
<permission android:name="com.kniost.photogallery.PRIVATE"
android:protectionLevel="signature" />
<uses-permission android:name="com.kniost.photogallery.PRIVATE" />
然后使用 sendBroadcast(Intent intent, String permission) 发送通知即可
sendBroadcast(new Intent(ACTION_SHOW_NOTIFICATION), PERM_PRIVATE);
2.2 动态 broadcast receiver
我们要只在应用开启的时候接受发过来的广播过滤,就不能在 manifest 中声明一个过滤器,而是要动态地建立一个广播接收器。我们在这里建立一个用于隐藏前台通知的通用 fragment 子类:
public abstract class VisibleFragment extends Fragment {
private static final String TAG = "VisibleFragment";
@Override
public void onStart() {
super.onStart();
IntentFilter filter = new IntentFilter(PollService.ACTION_SHOW_NOTIFICATION);
getActivity().registerReceiver(mOnShowNotification, filter,
PollService.PERM_PRIVATE, null);
}
@Override
public void onStop() {
super.onStop();
getActivity().unregisterReceiver(mOnShowNotification);
}
private BroadcastReceiver mOnShowNotification = new BroadcastReceiver() {
@Override
public void onReceive(Context context, Intent intent) {
// 如果接收到广播,说明应用正在前台,所以把 ResultCode 更改掉
Log.i(TAG, "canceling notification");
setResultCode(Activity.RESULT_CANCELED);
}
};
}
为什么在 start 和 stop 中登记和撤销 receiver 呢?因为在 retain fragment 中 onCreate(...)和 onDestroy()方法中的 getActivity()方法在设备旋转时会返回不同的值。因此如果想在 Fragment.onCreate(Bundle)和 Fragment.onDestroy()方法中实现登记或撤销登记,应使用 getActivity().getApplicationContext()方法。
2.3 使用有序 broadcast
如果想让程序在打开时不发送出通知,就不能再让服务来发出通知了,因为它无法知道前台的运行状态。所以我们让 PollService 发送一个有序广播。
Notification notification = ……;
Intent i = new Intent(ACTION_SHOW_NOTIFICATION);
i.putExtra(REQUEST_CODE, 0);
i.putExtra(NOTIFICATION, notification);
sendOrderedBroadcast(i, PERM_PRIVATE, null, null,
Activity.RESULT_OK, null, null);
有序广播是按照优先级发送的,先发送给优先级高的接收器,再发给优先级低的接收器。因为在应用结束后也要发出通知,显然我们发出通知的广播接收器是需要声明在 manifest 文件中的。
内部实现如下:
public class NotificationReceiver extends BroadcastReceiver {
private static final String TAG = "NotificaitonReceiver";
@Override
public void onReceive(Context context, Intent intent) {
Log.i(TAG, "received result: " + getResultCode());
if (getResultCode() != Activity.RESULT_OK) {
// PollService 发出的 intent 带的结果码是 RESULT_OK
// 如果接到的不是,说明应用在前台,将结果码修改了
return;
}
// 如果没有 return,说明应用不在前台,就可以发出通知了。
int requestCode = intent.getIntExtra(PollService.REQUEST_CODE, 0);
Notification notification = (Notification)
intent.getParcelableExtra(PollService.NOTIFICATION);
NotificationManagerCompat notificationManager =
NotificationManagerCompat.from(context);
notificationManager.notify(requestCode, notification);
}
}
<receiver android:name=".NotificationReceiver"
android:exported="false">
<!-- 在这里将优先级设为最低,即 -999 -->
<intent-filter
android:priority="-999">
<action android:name="com.kniost.photogallery.SHOW_NOTIFICATION" />
</intent-filter>
</receiver>
GitHub Page: kniost.github.io
简书://www.greatytc.com/u/723da691aa42