上一节:
下一节:

  Android (安卓) 广播接收器（Broadcast Receivers）

  • Android 广播接收器（Broadcast Receivers）

    广播接收器（Broadcast Receivers）仅响应来自其他应用程序或系统本身的广播消息。这些消息有时称为事件或indent。例如，应用程序还可以启动广播，以使其他应用程序知道某些数据已下载到设备并可供他们使用，因此，这是广播接收器，它将拦截此通信并启动适当的操作。
    要使Broadcast Receiver用于系统的广播意图，需要执行以下两个重要步骤-
    • 创建广播接收器
    • 注册广播接收器
    如果要实现您的自定义意图(indents)，还有另外一个步骤，那么您将必须创建并广播这些意图(indents)。

  • 创建广播接收器

    广播接收器实现为BroadcastReceiver类的子类，并且重写onReceive()方法，在该方法中，每个消息均作为Intent对象参数接收。 
    
public class MyReceiver extends BroadcastReceiver {
   @Override
   public void onReceive(Context context, Intent intent) {
      Toast.makeText(context, "Intent Detected.", Toast.LENGTH_LONG).show();
   }
}

  • 注册广播接收器

    应用程序通过在AndroidManifest.xml文件中注册广播接收器来侦听特定的广播意图(indent)。考虑一下，我们将为系统生成的事件ACTION_BOOT_COMPLETED注册MyReceiver，一旦Android系统完成启动过程，系统就会触发该事件。
    service
    
<application
   android:icon="@drawable/ic_launcher"
   android:label="@string/app_name"
   android:theme="@style/AppTheme" >
   <receiver android:name="MyReceiver">
   
      <intent-filter>
         <action android:name="android.intent.action.BOOT_COMPLETED">
         </action>
      </intent-filter>
   
   </receiver>
</application>
    现在，每当您的Android设备启动时，它都会被BroadcastReceiver MyReceiver拦截，并且将执行onReceive()中的已实现逻辑。在Intent类中，有几个系统生成的事件定义为最终静态字段。下表列出了一些重要的系统事件。
    事件 描述
    android.intent.action.BATTERY_CHANGED 粘滞广播，包含充电状态、电平和电池的其他信息。
    android.intent.action.BATTERY_LOW 表示设备电量不足。
    android.intent.action.BATTERY_OKAY 表示电池电量不足后现在是正常的。
    android.intent.action.BOOT_COMPLETED 这将在系统完成引导后广播一次。
    android.intent.action.BUG_REPORT 显示报告错误的活动。
    android.intent.action.CALL 执行对数据指定的某人的调用。
    android.intent.action.CALL_BUTTON 用户按下“呼叫”按钮到拨号器或其他适当的用户界面来进行呼叫。
    android.intent.action.DATE_CHANGED 日期改了。
    android.intent.action.REBOOT 让设备重新启动。

  • 广播自定义意图(Indent)

    如果您希望应用程序本身应生成并发送自定义意图，则必须使用Activity类中的sendBroadcast()方法来创建并发送这些意图(Indent)。如果您使用sendStickyBroadcast(Intent)方法，则该Intent是粘性的，这意味着您要发送的Intent在广播完成后仍然存在。 
    
public void broadcastIntent(View view) {
   Intent intent = new Intent();
   intent.setAction("com.jc2182.demo.CUSTOM_INTENT");
   sendBroadcast(intent);
}
    这个意图com.jc2182.demo.CUSTOM_INTENT也可以通过类似于我们重新注册系统生成的意图的方式进行注册。 
    
<application
   android:icon="@drawable/ic_launcher"
   android:label="@string/app_name"
   android:theme="@style/AppTheme" >
   <receiver android:name="MyReceiver">
   
      <intent-filter>
         <action android:name="com.jc2182.demo.CUSTOM_INTENT">
         </action>
      </intent-filter>
   
   </receiver>
</application>

  • 示例

    本示例将向您说明如何创建BroadcastReceiver来拦截自定义意图。熟悉自定义意图后，即可对应用程序进行编程以拦截系统生成的意图。因此，让我们按照以下步骤修改我们在Hello World示例一章中创建的Android应用程序-
    1. 您将使用Android Studio创建一个Android应用程序，并将其命名为HelloWorld，位于com.jc2182.demo.helloworld包下。
    2. 修改主活动文件MainActivity.java以添加broadcastIntent()方法。
    3. 在com.jc2182.demo.helloworld包下创建一个名为MyReceiver.java的新Java文件， 以定义BroadcastReceiver。
    4. 应用程序可以处理一个或多个自定义和系统意图，而没有任何限制。您要拦截的每个意图都必须使用<receiver ... />标记注册到您的AndroidManifest.xml文件中
    5. 修改res/layout/activity_main.xml文件的默认内容，以包括一个用于广播意图的按钮。
    6. 运行该应用程序以启动Android模拟器并验证在该应用程序中所做更改的结果。
    以下是修改后的主要活动文件MainActivity.java的内容。该文件可以包括每个基本生命周期方法。我们添加了broadcastIntent()方法以广播自定义意图。 
    
package com.jc2182.helloworld;

import androidx.appcompat.app.AppCompatActivity;

import android.content.ComponentName;
import android.content.Intent;
import android.os.Bundle;
import android.view.View;

public class MainActivity extends AppCompatActivity {
    

    /** 在第一次创建activity时调用。 */
    @Override

    public void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
    }


    // 广播自定义意图。

    public void broadcastIntent(View view){
        Intent intent = new Intent();
        intent.setAction("com.test.CUSTOM_INTENT");
        // 这里ComponentName 第一个参数是 包名 ，第二个参数是广播接收器的类路径
        intent.setComponent(new ComponentName("com.jc2182.helloworld","com.jc2182.helloworld.MyReceiver"));
        sendBroadcast(intent);
    }
}
    以下是MyReceiver.java的内容： 
    
package com.jc2182.helloworld;

import android.content.BroadcastReceiver;
import android.content.Context;
import android.content.Intent;
import android.widget.Toast;

public class MyReceiver extends BroadcastReceiver {

    @Override
    public void onReceive(Context context, Intent intent) {
        Toast.makeText(context, "检测到意图。", Toast.LENGTH_LONG).show();
    }
}
    以下将修改AndroidManifest.xml文件的内容 。在这里，我们添加了<receiver ... />标签以包括我们的广播接收器： 
    
<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="com.jc2182.helloworld">

    <application
        android:allowBackup="true"
        android:icon="@mipmap/ic_launcher"
        android:label="@string/app_name"
        android:roundIcon="@mipmap/ic_launcher_round"
        android:supportsRtl="true"
        android:theme="@style/AppTheme">
        <activity android:name=".MainActivity">
            <intent-filter>
                <action android:name="android.intent.action.MAIN" />

                <category android:name="android.intent.category.LAUNCHER" />
            </intent-filter>
        </activity>

        <receiver android:name=".MyReceiver" >
            <intent-filter>
                <action android:name="com.test.CUSTOM_INTENT">
                </action>
            </intent-filter>
        </receiver>

    </application>

</manifest>
    以下是res/layout/activity_main.xml文件的内容，其中包括广播我们的自定义意图的按钮- 
    
<?xml version="1.0" encoding="utf-8"?>
<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:paddingLeft="@dimen/activity_horizontal_margin"
    android:paddingRight="@dimen/activity_horizontal_margin"
    android:paddingTop="@dimen/activity_vertical_margin"
    android:paddingBottom="@dimen/activity_vertical_margin"
    tools:context=".MainActivity">


    <TextView
        android:id="@+id/textView1"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="Broadcast 例子"
        android:layout_alignParentTop="true"
        android:layout_centerHorizontal="true"
        android:textSize="30dp" />

    <TextView
        android:id="@+id/textView2"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="蝴蝶教程 "
        android:textColor="#ff87ff09"
        android:textSize="30dp"
        android:layout_above="@+id/imageButton"
        android:layout_centerHorizontal="true"
        android:layout_marginBottom="40dp" />

    <ImageButton
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:id="@+id/imageButton"
        android:src="@drawable/logo"
        android:layout_centerVertical="true"
        android:layout_centerHorizontal="true" />

    <Button
        android:id="@+id/button2"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_below="@+id/imageButton"
        android:layout_centerHorizontal="true"
        android:layout_marginTop="55dp"
        android:onClick="broadcastIntent"
        android:text="广播意图" />

</RelativeLayout>
    让我们尝试运行修改后的Hello World！我们刚刚修改的应用程序。我假设您在进行环境设置时已创建了AVD。要从Android Studio运行该应用，请打开您项目的活动文件之一，然后点击Android StudioRun图标工具栏中的“运行” 图标。Android Studio将应用程序安装在您的AVD上并启动它，如果设置和应用程序一切正常，它将显示在“模拟器”窗口下面-
    service
    现在启动广播接收器，让我们单击“广播意图”按钮，这将启动广播接收器，一条广播消息将出现在模拟器的底部，如下所示：
    service
上一节:
下一节: