此页面由 Cloud Translation API 翻译。

广播概览

Android 应用可以通过 Android 系统发送或接收广播消息，其他 Android 应用发布-订阅设计模式这些广播会在所关注的事件发生时发送。例如，Android 系统会在发生各种系统事件时发送广播例如当系统启动或设备开始充电时。应用还可以发送自定义广播自己可能感兴趣的信息（例如，一些新数据已下载）。

系统优化广播的传递，以便保持最佳系统运行状况。因此，广播的传送时间。需要低延迟的进程间通信的应用应可以考虑使用绑定服务

应用可以注册接收特定的广播。广播发送后系统会自动向已订阅接收该特定类型的广播

一般来说，广播可以用作跨应用的消息传递系统以及常规用户流以外的用户但是，您必须小心避免让您有机会响应广播并在后台运行作业，可能会导致系统性能降低

关于系统广播

当各种系统事件发生时，系统会自动发送广播，例如，当系统进入和退出飞行模式时。系统系统就会将广播发送到所有订阅接收事件。

广播消息本身封装在 Intent 中，对象，其操作字符串用于标识发生的事件（例如， android.intent.action.AIRPLANE_MODE）。意图可能还包括绑定至额外字段的额外信息。例如，飞机模式 intent 包含一个布尔型 extra，用于指示模式已开启。

如需详细了解如何读取 intent 以及如何从请参阅 intent 和 intent 过滤器。

有关系统广播操作的完整列表，请参阅 BROADCAST_ACTIONS.TXT 文件。每个广播操作都有一个常量字段例如， “ACTION_AIRPLANE_MODE_CHANGED”现为 android.intent.action.AIRPLANE_MODE。每项广播操作的文档。

系统广播所发生的更改

随着 Android 平台的发展，它会定期改变系统广播的方式行为。为了支持所有 Android 版本，请谨记以下变更。

Android 14

当应用位于缓存中时状态，广播传送是针对系统运行状况进行了优化例如，不太重要的系统广播 ACTION_SCREEN_ON 会在应用处于缓存状态时被延迟。当应用从缓存内容中进入活动进程生命周期，系统任何延迟的广播

声明的重要广播清单从缓存中暂时移除应用状态。

Android 9

从 Android 9（API 级别 28）开始， NETWORK_STATE_CHANGED_ACTION 广播不会接收关于用户所在位置或个人身份的信息可识别身份的数据

此外，如果您的应用安装在搭载 Android 9 或更高版本的设备上，来自 Wi-Fi 的系统广播不包含 SSID、BSSID、连接信息或扫描结果。要获取此信息，请调用 getConnectionInfo() 。

Android 8.0

从 Android 8.0（API 级别 26）开始，系统会强制执行额外针对清单声明的接收器的限制

如果您的应用以 Android 8.0 或更高版本为目标平台，则不能使用清单对于大多数隐式广播（并非）。您仍然可以使用上下文注册的接收器。

Android 7.0

Android 7.0（API 级别 24）及更高版本不发送以下系统广播：

ACTION_NEW_PICTURE
ACTION_NEW_VIDEO

此外，以 Android 7.0 及更高版本为目标平台的应用必须注册 CONNECTIVITY_ACTION 广播使用 registerReceiver(BroadcastReceiver, IntentFilter)。无法在清单中声明接收器。

接收广播

应用可以通过两种方式接收广播：通过清单声明的接收器和上下文注册的接收器

清单声明的接收器

如果您在清单中声明广播接收器，系统会启动您的应用（如果应用尚未运行）。

要在清单中声明广播接收器，请执行以下步骤：

指定 <receiver> 元素。

<!-- If this receiver listens for broadcasts sent from the system or from
     other apps, even other apps that you own, set android:exported to "true". -->
<receiver android:name=".MyBroadcastReceiver" android:exported="false">
    <intent-filter>
        <action android:name="APP_SPECIFIC_BROADCAST" />
    </intent-filter>
</receiver>

Intent 过滤器指定您的接收器所订阅的广播操作。

创建 BroadcastReceiver 子类并实现 onReceive(Context, Intent)。通过以下示例中的广播接收器会记录日志并显示内容以下内容：

Kotlin

private const val TAG = "MyBroadcastReceiver"

class MyBroadcastReceiver : BroadcastReceiver() {

    override fun onReceive(context: Context, intent: Intent) {
        StringBuilder().apply {
            append("Action: ${intent.action}\n")
            append("URI: ${intent.toUri(Intent.URI_INTENT_SCHEME)}\n")
            toString().also { log ->
                Log.d(TAG, log)

                val binding = ActivityNameBinding.inflate(layoutInflater)
                val view = binding.root
                setContentView(view)

                Snackbar.make(view, log, Snackbar.LENGTH_LONG).show()
            }
        }
    }
}

Java

public class MyBroadcastReceiver extends BroadcastReceiver {
        private static final String TAG = "MyBroadcastReceiver";
        @Override
        public void onReceive(Context context, Intent intent) {
            StringBuilder sb = new StringBuilder();
            sb.append("Action: " + intent.getAction() + "\n");
            sb.append("URI: " + intent.toUri(Intent.URI_INTENT_SCHEME).toString() + "\n");
            String log = sb.toString();
            Log.d(TAG, log);

            ActivityNameBinding binding =
                    ActivityNameBinding.inflate(layoutInflater);
            val view = binding.root;
            setContentView(view);

            Snackbar.make(view, log, Snackbar.LENGTH_LONG).show();
        }
    }

如需启用视图绑定，请执行以下操作：在模块级中 configure viewBinding build.gradle 文件中。

系统软件包管理器会在应用安装时注册接收器。然后，接收器将成为应用的单独入口点，这意味着确保系统可以启动应用并传递广播（如果应用未。

系统会创建一个新的 BroadcastReceiver 组件对象来处理它接收的每个广播。仅此对象有效在调用 onReceive(Context, Intent) 期间有效。将代码添加到返回时，系统会将该组件活动状态。

上下文注册的接收器

上下文注册的接收器可以接收广播，前提是它们的注册上下文有效。例如，如果您在一个 Activity 上下文，只要 activity 不被销毁，您就会收到广播。如果您注册到应用上下文，那么，只要应用正在运行。

要使用上下文注册接收器，请执行以下步骤：

在应用的模块级 build 文件中，添加 1.9.0 或更高版本的 AndroidX Core 库：

Groovy

dependencies {
    def core_version = "1.13.1"

    // Java language implementation
    implementation "androidx.core:core:$core_version"
    // Kotlin
    implementation "androidx.core:core-ktx:$core_version"

    // To use RoleManagerCompat
    implementation "androidx.core:core-role:1.0.0"

    // To use the Animator APIs
    implementation "androidx.core:core-animation:1.0.0"
    // To test the Animator APIs
    androidTestImplementation "androidx.core:core-animation-testing:1.0.0"

    // Optional - To enable APIs that query the performance characteristics of GMS devices.
    implementation "androidx.core:core-performance:1.0.0"

    // Optional - to use ShortcutManagerCompat to donate shortcuts to be used by Google
    implementation "androidx.core:core-google-shortcuts:1.1.0"

    // Optional - to support backwards compatibility of RemoteViews
    implementation "androidx.core:core-remoteviews:1.1.0"

    // Optional - APIs for SplashScreen, including compatibility helpers on devices prior Android 12
    implementation "androidx.core:core-splashscreen:1.2.0-alpha01"
}

Kotlin

dependencies {
    val core_version = "1.13.1"

    // Java language implementation
    implementation("androidx.core:core:$core_version")
    // Kotlin
    implementation("androidx.core:core-ktx:$core_version")

    // To use RoleManagerCompat
    implementation("androidx.core:core-role:1.0.0")

    // To use the Animator APIs
    implementation("androidx.core:core-animation:1.0.0")
    // To test the Animator APIs
    androidTestImplementation("androidx.core:core-animation-testing:1.0.0")

    // Optional - To enable APIs that query the performance characteristics of GMS devices.
    implementation("androidx.core:core-performance:1.0.0")

    // Optional - to use ShortcutManagerCompat to donate shortcuts to be used by Google
    implementation("androidx.core:core-google-shortcuts:1.1.0")

    // Optional - to support backwards compatibility of RemoteViews
    implementation("androidx.core:core-remoteviews:1.1.0")

    // Optional - APIs for SplashScreen, including compatibility helpers on devices prior Android 12
    implementation("androidx.core:core-splashscreen:1.2.0-alpha01")
}

创建 BroadcastReceiver:

Kotlin

val br: BroadcastReceiver = MyBroadcastReceiver()

Java

BroadcastReceiver br = new MyBroadcastReceiver();

创建 IntentFilter:

Kotlin

val filter = IntentFilter(APP_SPECIFIC_BROADCAST)

Java

IntentFilter filter = new IntentFilter(APP_SPECIFIC_BROADCAST);

选择是否应导出广播接收器并向以下对象显示和设备上的其他应用此接收器是否正在监听已发送的广播无论是来自系统还是来自其他应用（甚至是您拥有的其他应用），都会使用 RECEIVER_EXPORTED 标志。如果该接收器只监听广播时，请使用 RECEIVER_NOT_EXPORTED 标志。

一些系统广播来自具有较高特权这类应用（例如蓝牙和电话应用），但不在系统的唯一进程 ID (UID) 下运行。接收者接收所有系统广播，包括来自具有较高特权的广播应用，请使用 RECEIVER_EXPORTED 标记您的接收器。

如果您使用 RECEIVER_NOT_EXPORTED 标记接收器，接收器可以接收来自您的服务器应用，但不从具有较高特权的应用进行广播。

如果您的应用要监听多个广播，但只应监听部分广播已将RECEIVER_NOT_EXPORTED和部分标记为 RECEIVER_EXPORTED，将广播划分到不同的广播接收器。
Kotlin
val listenToBroadcastsFromOtherApps = false val receiverFlags = if (listenToBroadcastsFromOtherApps) { ContextCompat.RECEIVER_EXPORTED } else { ContextCompat.RECEIVER_NOT_EXPORTED }
Java
boolean listenToBroadcastsFromOtherApps = false; if (listenToBroadcastsFromOtherApps) { receiverFlags = ContextCompat.RECEIVER_EXPORTED; } else { receiverFlags = ContextCompat.RECEIVER_NOT_EXPORTED; }
注意：如果导出了广播接收器，其他应用可能会发送不受保护的广播。

通过调用以下方法来注册接收器： registerReceiver():

Kotlin

ContextCompat.registerReceiver(context, br, filter, receiverFlags)

Java

ContextCompat.registerReceiver(context, br, filter, receiverFlags);

如需停止接收广播，请调用 unregisterReceiver(android.content.BroadcastReceiver)。当您不再需要该接收器时，请务必将其取消注册，或者上下文不再有效。

请注意你注册和取消注册接收器的位置，例如，如果使用 activity 的上下文在 onCreate(Bundle) 中注册接收器，您将应该在onDestroy()中取消注册，以便防止接收器从 activity 上下文中泄露。如果您注册 onResume() 中的接收器，应该在 onPause() 中取消注册，以防止多次注册该程序（如果您不想接收广播这样做可以减少不必要的系统开销）。错误做法在onSaveInstanceState(Bundle)取消注册，因为如果用户在历史记录堆栈中后退，则不会调用此方法。

对进程状态的影响

无论是您的BroadcastReceiver 是否正在运行或未影响其包含的进程，这些进程可能会改变其系统终止的可能性。前台进程执行接收器的 onReceive() 方法。通过系统除了在极端内存压力下运行进程外，

BroadcastReceiver 会在 onReceive() 后停用。接收方的主机进程的重要性与其应用组件同等重要。如果该进程在清单声明的接收器中（用户从未使用或最近未与之交互），系统可能会在 onReceive() 之后将其终止，以确保其他更关键的进程可用的资源

因此，广播接收器不应启动长时间运行的后台线程。在 onReceive() 之后，系统可以随时停止该进程以进行回收终止已创建的线程。要让进程保持活动状态，请安排 JobService 使用 JobScheduler 从接收器中获取以便系统知道该进程仍在运行后台工作概览提供了更多详细信息。

发送广播

Android 为应用提供三种方式来发送广播：

sendOrderedBroadcast(Intent, String) 方法一次向一个接收器发送广播。当每个接收器执行反过来，就可以将结果传播到下一个接收器，也可以完全中止广播，这样就不会将其传递给接收器。您可以使用匹配 intent-filter 的 android:priority 属性；具有优先级相同的规则会按任意顺序运行
sendBroadcast(Intent) 方法会发送以未定义的顺序向所有接收器发送广播。这称为常规广播。这种做法更高效，但也意味着接收器从其他接收器接收结果，传播从广播接收的数据，或者中止广播。

以下代码段演示了如何通过创建 intent 并调用 sendBroadcast(Intent)。

Kotlin

Intent().also { intent ->
    intent.setAction("com.example.broadcast.MY_NOTIFICATION")
    intent.putExtra("data", "Nothing to see here, move along.")
    sendBroadcast(intent)
}

Java

Intent intent = new Intent();
intent.setAction("com.example.broadcast.MY_NOTIFICATION");
intent.putExtra("data", "Nothing to see here, move along.");
sendBroadcast(intent);

广播消息封装在 Intent 对象中。 intent 的操作字符串必须提供应用的 Java 软件包名称语法和唯一标识广播事件。您可以将其他信息使用 putExtra(String, Bundle) 将 intent 传递给 intent。您还可以通过以下方式将广播限定到同一单位中的一组应用：对 intent 调用 setPackage(String)。

通过权限限制广播

利用权限，您可以将广播限定到特定权限您可以对发件人或广播接收器。

带权限的发送

当你拨打 sendBroadcast(Intent, String) 或 sendOrderedBroadcast(Intent, String, BroadcastReceiver, Handler, int, String, Bundle)，您可以指定权限参数。只有已向以下对象请求该权限的接收方：标记（随后被授予权限）可以接收广播。例如，以下代码会发送广播：

Kotlin

sendBroadcast(Intent(BluetoothDevice.ACTION_FOUND),
              Manifest.permission.BLUETOOTH_CONNECT)

Java

sendBroadcast(new Intent(BluetoothDevice.ACTION_FOUND),
              Manifest.permission.BLUETOOTH_CONNECT)

要接收广播，接收方应用必须通过以下方式请求权限：如下所示：

<uses-permission android:name="android.permission.BLUETOOTH_CONNECT"/>

您可以指定现有的系统权限，例如 BLUETOOTH_CONNECT 也可以使用 <permission> 元素。对于有关权限和安全性的一般信息，请参阅系统权限。

带权限的接收

如果您在注册广播接收器时指定了权限参数（使用 registerReceiver(BroadcastReceiver, IntentFilter, String, Handler) 或 <receiver> 代码中的则只有使用 <uses-permission> 标记（如果该对象为 id 序列，危险）可向接收器发送 intent。

例如，假设接收方应用有一个清单声明的接收器，如下所示如下所示：

<receiver android:name=".MyBroadcastReceiver"
          android:permission="android.permission.BLUETOOTH_CONNECT">
    <intent-filter>
        <action android:name="android.intent.action.ACTION_FOUND"/>
    </intent-filter>
</receiver>

或者您的接收方应用具有如下所示的上下文注册的接收器：

Kotlin

var filter = IntentFilter(Intent.ACTION_FOUND)
registerReceiver(receiver, filter, Manifest.permission.BLUETOOTH_CONNECT, null )

Java

IntentFilter filter = new IntentFilter(Intent.ACTION_FOUND);
registerReceiver(receiver, filter, Manifest.permission.BLUETOOTH_CONNECT, null );

然后，为了能够向这些接收器发送广播，发送应用请求权限，如下所示：

<uses-permission android:name="android.permission.BLUETOOTH_CONNECT"/>

安全注意事项和最佳做法

下面介绍了一些与发送和接收电子邮件相关的安全注意事项接收广播：

如果许多应用在清单，它可能会导致系统启动大量应用，从而导致对设备性能和用户体验产生重大影响。为避免因此，请优先使用上下文注册而不是清单声明。有时，Android 系统本身会强制使用上下文注册的接收器。例如，传送 CONNECTIVITY_ACTION 广播上下文注册的接收器。
请勿使用隐式 intent 广播敏感信息。通过注册接收广播的任何应用都可以读取这些信息。您可以通过以下三种方式控制哪些应用可以接收您的广播：
- 您可以在发送广播时指定权限。
- 在 Android 4.0 及更高版本中，您可以指定 package，其中包含 setPackage(String)时，广播。系统会将广播限制到与软件包匹配。
注册接收器后，任何应用都可能会发送潜在的恶意内容向应用的接收器发送广播您可以通过多种方式广播：
- 您可以在注册广播接收器时指定权限。
- 对于清单声明的接收器，您可以将 android:exported 属性设为“false”。接收方未收到来自应用外部来源的广播。
广播操作的命名空间是全局性的。请确保操作名称和其他字符串都是在您拥有的命名空间中编写的，与其他应用发生意外冲突
由于接收器的 onReceive(Context, Intent) 方法在主线程，它应该快速执行并返回。如果您需要执行长时间运行的工作，请注意生成线程或启动因为系统可能会在运行完之后 onReceive() 返回。有关详情，请参阅对进程的影响状态为了执行长时间运行的工作，建议：
- 正在使用以下号码拨打 goAsync()：接收器的 onReceive() 方法，并将 BroadcastReceiver.PendingResult 传递给后台线程。这样，从 onReceive() 返回后，广播将保持活跃状态。不过，即使采用这种方法，系统仍希望您（在 10 秒内）。它允许工作到另一个线程，以免影响主线程。
- 使用 JobScheduler 调度作业。有关相关信息，请参阅智能作业时间安排。
请勿从广播接收器启动 activity，因为用户体验非常突兀特别是在有多个接收器的情况下。您可以考虑改为来显示通知。