BroadcastReceiver

public abstract class BroadcastReceiver
extends Object

Known Direct Subclasses AppWidgetProvider, DeviceAdminReceiver, MediaButtonReceiver, RestrictionsReceiver, WakefulBroadcastReceiver AppWidgetProvider 帮助实现AppWidget提供者的便利课程。 DeviceAdminReceiver 实现设备管理组件的基类。 MediaButtonReceiver 媒体按钮接收器接收并帮助将硬件媒体播放按钮（例如有线和无线耳机中的按钮）转换为应用程序中的相应回调。 RestrictionsReceiver 限制提供商BroadcastReceiver的抽象实现。 WakefulBroadcastReceiver 帮助器实现 BroadcastReceiver的常见模式，该模式接收设备唤醒事件，然后将工作传递给 Service ，同时确保设备在过渡期间不会回到睡眠状态。

将接收sendBroadcast（）发送的意图的代码的基类。

如果您不需要跨应用程序发送广播，请考虑将此类与LocalBroadcastManager一起使用，而不是下面介绍的更一般的设施。 这将为您提供更高效的实现（不需要跨进程通信），并且可以避免考虑与其他应用程序能够接收或发送广播相关的任何安全问题。

您可以动态地注册这个类的一个实例 Context.registerReceiver()或静态发布通过实现 <receiver>标签在你 AndroidManifest.xml 。

注意：如果在您的Activity.onResume()实施中注册接收器，则应该在Activity.onPause()取消注册。 （暂停时不会收到意图，这将减少不必要的系统开销）。 请勿注销Activity.onSaveInstanceState() ，因为如果用户移回历史堆栈中，则不会调用该注册。

有两种主要类型的广播可以收到：

• Normal broadcasts (sent with Context.sendBroadcast) are completely asynchronous. All receivers of the broadcast are run in an undefined order, often at the same time. This is more efficient, but means that receivers cannot use the result or abort APIs included here.
• Ordered broadcasts (sent with Context.sendOrderedBroadcast) are delivered to one receiver at a time. As each receiver executes in turn, it can propagate a result to the next receiver, or it can completely abort the broadcast so that it won't be passed to other receivers. The order receivers run in can be controlled with the android:priority attribute of the matching intent-filter; receivers with the same priority will be run in an arbitrary order.

即使在正常广播的情况下，系统在某些情况下也可能恢复为每次传送一个广播接收机。 特别是，对于可能需要创建进程的接收者，一次只能运行一个，以避免使用新进程对系统进行过载。 然而，在这种情况下，无序的语义保持不变：这些接收器仍然不能返回结果或中止它们的广播。

请注意，尽管Intent类用于发送和接收这些广播，但这里的Intent广播机制与用于启动Context.startActivity()活动”的Intents完全分离。 BroadcastReceiver无法查看或捕获与startActivity（）一起使用的Intents; 同样，当您广播一个意图时，您将永远不会找到或启动一个活动。 这两个操作在语义上非常不同：用Intent启动一个Activity是一个前台操作，它修改了用户当前正在与之交互的内容; 广播Intent是用户通常不知道的后台操作。

该广播接收器类（当通过一个清单的一个组成部分推出 <receiver>标签）是一个重要组成部分 application's overall lifecycle 。

涵盖的主题包括：

1. Security
2. Receiver Lifecycle
3. Process Lifecycle

Security

与Context API一起使用的接收器本身就是一个交叉应用程序，因此您必须考虑其他应用程序如何滥用您的应用程序。 有些事情要考虑的是：

• Intent命名空间是全局的。 确保Intent操作名称和其他字符串被写入您拥有的名称空间中，否则可能会与其他应用程序无意中冲突。

• 当您使用registerReceiver(BroadcastReceiver, IntentFilter) ， 任何应用程序都可能向该注册的接收方发送广播。 您可以通过以下权限控制谁可以向其发送广播。

• 当您在应用程序的清单中发布接收器并为其指定意图过滤器时，无论您指定哪个过滤器，任何其他应用程序都可以向其发送广播。 为了防止他人发送给它，请使用android:exported="false"使其不可用。

• 当您使用sendBroadcast(Intent)或相关方法时，通常任何其他应用程序都可以接收这些广播。 您可以通过下述权限控制哪些人可以收到此类广播。 或者，从ICE_CREAM_SANDWICH开始，您还可以安全地将广播限制为单个应用程序，并且Intent.setPackage

使用 LocalBroadcastManager时，这些问题都不存在，因为意图广播它不会超出当前过程。

访问权限可以由广播的发送者或接收者强制执行。

要在发送时强制执行权限，请向sendBroadcast(Intent, String)或sendOrderedBroadcast(Intent, String, BroadcastReceiver, android.os.Handler, int, String, Bundle)提供非空权限参数。 谁已被授予这个权限（通过与请求只接收<uses-permission>在他们的标签AndroidManifest.xml ）将能够接收广播。

为了实施当接收到许可，您在注册时，接收器提供一个非空的许可 -拨打电话时无论是registerReceiver(BroadcastReceiver, IntentFilter, String, android.os.Handler)或静态<receiver>在标签AndroidManifest.xml 。 谁已被授予这个权限（通过与请求仅广播<uses-permission>在他们的标签AndroidManifest.xml ）将能够一个Intent发送到接收器。

有关权限和安全性的更多信息，请参阅Security and Permissions文档。

Receiver Lifecycle

BroadcastReceiver对象仅在调用onReceive(Context, Intent)期间有效。 一旦你的代码从这个函数返回，系统就认为该对象已经完成并且不再处于活动状态。

这对于在 onReceive(Context, Intent)实现中可以执行的操作具有重要影响：任何需要异步操作的任何操作都不可用，因为您需要从该函数返回以处理异步操作，但此时BroadcastReceiver不再处于活动状态，因此在异步操作完成之前，系统可以自由地终止其进程。

特别是，您可能不会显示对话框或绑定到BroadcastReceiver中的服务。 对于前者，您应该使用NotificationManager API。 对于后者，您可以使用Context.startService()向服务发送命令。

Process Lifecycle

目前正在执行BroadcastReceiver的过程（也就是说，目前正在其 onReceive(Context, Intent)方法中运行该代码）被视为前台进程，并将由系统继续运行，除非内存压力过大。

一旦从onReceive（）返回，BroadcastReceiver不再处于活动状态，其宿主进程与运行在其中的任何其他应用程序组件一样重要。 这一点尤其重要，因为如果该进程仅托管BroadcastReceiver（用户从未或最近未与之交互过的应用程序的常见情况），那么在从onReceive（）返回时，系统将认为其进程是空的并积极地杀死它使资源可用于其他更重要的流程。

这意味着对于长时间运行的操作，您通常 Service与BroadcastReceiver结合使用，以保持包含过程在整个操作过程中处于活动状态。

Summary

Inherited methods

From class java.lang.Object Object clone() 创建并返回此对象的副本。 boolean equals(Object obj) 指示其他某个对象是否“等于”这一个。 void finalize() 当垃圾收集确定没有更多对该对象的引用时，由对象上的垃圾回收器调用。 final Class<?> getClass() 返回此 Object的运行时类。 int hashCode() 返回对象的哈希码值。 final void notify() 唤醒正在等待该对象监视器的单个线程。 final void notifyAll() 唤醒在该对象监视器上等待的所有线程。 String toString() 返回对象的字符串表示形式。 final void wait(long millis, int nanos) 使当前线程等待，直到另一个线程调用此对象的 notify()方法或 notifyAll()方法，或者某个其他线程中断当前线程或经过一定的实时时间。 final void wait(long millis) 导致当前线程等待，直到另一个线程调用此对象的 notify()方法或 notifyAll()方法，或经过了指定的时间量。 final void wait() 导致当前线程等待，直到另一个线程调用此对象的 notify()方法或 notifyAll()方法。

Public constructors

BroadcastReceiver ()

Public methods

void abortBroadcast ()

void clearAbortBroadcast ()

boolean getAbortBroadcast ()

boolean getDebugUnregister ()

int getResultCode ()

String getResultData ()

Bundle getResultExtras (boolean makeMap)

BroadcastReceiver.PendingResult goAsync ()

boolean isInitialStickyBroadcast ()

boolean isOrderedBroadcast ()

void onReceive (Context context, 
                Intent intent)

IBinder peekService (Context myContext, 
                Intent service)

void setDebugUnregister (boolean debug)

void setOrderedHint (boolean isOrdered)

void setResult (int code, 
                String data, 
                Bundle extras)

void setResultCode (int code)

void setResultData (String data)

void setResultExtras (Bundle extras)