Android编程权威指南（第二版）学习笔记（二十七）—— 第27章 broadcast intent

本章主要讲的是 Android 系统的广播机制，并介绍了广播的使用，权限以及有序广播的用法。

GitHub 地址：
完成第27章

在使用广播之前，首先回顾一下 PhotoGallery 在本章之前的逻辑：

1. 打开程序后，如果开始推送服务，就每隔一段时间获取一次图片信息
2. 如果图片有更新，就发出通知

那么本章我们想做到的有：

1. 在开机以后自动启用服务（如果打开了开关）
2. 在应用打开时图片有更新也不发出通知

这里，我们将使用广播来完成这些任务。

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. 过滤应用在前台时的通知

为了实现这一点，我们把发出通知的思路改了：之前是在服务中查询到新的结果就发出通知，现在则是：

1. 在查询到新的结果后，发出一条应用内的广播并在其中标记一个代码 A，
2. 在应用中动态登记广播接收器，如果接收到广播（说明应用在前台），就把这个代码改成 B。
3. 最后总有一个优先级最低的接收器接收到这个广播，如果代码是 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
简书：http://www.jianshu.com/u/723da691aa42