【Android】BroadcastReceiverの使い方を実例つきで解説｜WiFi状態の変化を検知するアプリを作ろう

はじめに

この記事では、AndroidアプリにおけるBroadcastReceiver（ブロードキャストレシーバー）の基本的な使い方を、実際に動作するサンプルコードとともに解説します。サンプルとして、システムから配信される「WiFi状態の変化」というブロードキャストを受信し、その結果をスイッチ型UIにリアルタイムで反映するアプリを作成していきます。

BroadcastReceiverは、ネットワーク接続の変化やバッテリー残量の低下など、システム全体にブロードキャストされるイベントを受け取るためのコンポーネントです。これを使いこなせるようになると、端末の状態変化に応じて柔軟に動作するアプリを開発できるようになります。

実装の手順

ステップ1：Android Studioで新規プロジェクトを作成する

まず、Android Studioで新しいプロジェクトを作成します。メニューから「File」→「New Project」を選択し、必要な項目をすべて入力してプロジェクトを作成してください。

ステップ2：レイアウトファイル（activity_main.xml）を編集する

res/layout/activity_main.xml に以下のコードを記述します。画面中央に、WiFiのON/OFFを切り替えるためのSwitchウィジェットを配置しています。

<?xml version="1.0" encoding="utf-8"?>
<RelativeLayout xmlns:android="https://schemas.android.com/apk/res/android"
   xmlns:tools="https://schemas.android.com/tools"
   android:layout_width="match_parent"
   android:layout_height="match_parent"
   tools:context=".MainActivity">
   <Switch
      android:id="@+id/wifiSwitch"
      android:layout_width="wrap_content"
      android:layout_height="wrap_content"
      android:layout_centerInParent="true"/>
</RelativeLayout>

ステップ3：MainActivity.java を編集する

src/MainActivity.java に以下のコードを追加します。ここが本記事の核心部分で、BroadcastReceiverの登録・解除・受信処理をすべて行っています。

import android.content.BroadcastReceiver;
import android.content.Context;
import android.content.Intent;
import android.content.IntentFilter;
import android.net.wifi.WifiManager;
import android.support.v7.app.AppCompatActivity;
import android.os.Bundle;
import android.widget.CompoundButton;
import android.widget.Switch;
import android.widget.Toast;
public class MainActivity extends AppCompatActivity {
   Switch wifiSwitch;
   WifiManager wifiManager;
   @Override
   protected void onCreate(Bundle savedInstanceState) {
      super.onCreate(savedInstanceState);
      setContentView(R.layout.activity_main);
      wifiSwitch = findViewById(R.id.wifiSwitch);
      wifiManager = (WifiManager) getApplicationContext().getSystemService(Context.WIFI_SERVICE);
      wifiSwitch.setOnCheckedChangeListener(new CompoundButton.OnCheckedChangeListener() {
         @Override
         public void onCheckedChanged(CompoundButton buttonView, boolean isChecked) {
            if (isChecked) {
               wifiManager.setWifiEnabled(true);
               wifiSwitch.setText("WiFi is ON");
            } else {
               wifiManager.setWifiEnabled(false);
               wifiSwitch.setText("WiFi is OFF");
            }
         }
      });
   }
   @Override
   protected void onStart() {
      super.onStart();
      IntentFilter intentFilter = new IntentFilter(WifiManager.WIFI_STATE_CHANGED_ACTION);
      registerReceiver(wifiStateReceiver, intentFilter);
   }
   @Override
   protected void onStop() {
      super.onStop();
      unregisterReceiver(wifiStateReceiver);
   }
   private BroadcastReceiver wifiStateReceiver = new BroadcastReceiver() {
      @Override
      public void onReceive(Context context, Intent intent) {
         int wifiStateExtra = intent.getIntExtra(WifiManager.EXTRA_WIFI_STATE, WifiManager.WIFI_STATE_UNKNOWN);
         switch (wifiStateExtra) {
            case WifiManager.WIFI_STATE_ENABLED:
               wifiSwitch.setChecked(true);
               wifiSwitch.setText("WiFi is ON");
               Toast.makeText(MainActivity.this, "Wifi is On", Toast.LENGTH_SHORT).show();
               break;
            case WifiManager.WIFI_STATE_DISABLED:
               wifiSwitch.setChecked(false);
               wifiSwitch.setText("WiFi is OFF");
               Toast.makeText(MainActivity.this, "Wifi is Off", Toast.LENGTH_SHORT).show();
               break;
         }
      }
   };
}

ステップ4：AndroidManifest.xml に権限を追加する

androidManifest.xml に以下のコードを記述します。WiFiの状態を取得・変更するために、2つのパーミッションを宣言しています。

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="https://schemas.android.com/apk/res/android" package="app.com.sample">
   <uses-permission android:name="android.permission.CHANGE_WIFI_STATE" />
   <uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
   <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>
   </application>
</manifest>

アプリを実行してみよう

それでは、実際にアプリを起動してみましょう。あらかじめ実機のAndroidスマートフォンをパソコンに接続しておいてください。Android Studioでプロジェクト内の任意のActivityファイルを開き、ツールバーの「Run」アイコンをクリックします。実行先のデバイスとして自分のスマートフォンを選択すると、端末上に次のような画面が表示されます。

実装のポイント解説

• レシーバーの登録と解除： onStart() 内で registerReceiver() を呼び出してレシーバーを登録し、onStop() 内で unregisterReceiver() によって必ず解除します。これにより、画面に表示されている間だけイベントを受け取る構造になり、メモリリークの防止にもつながります。
• IntentFilterの役割： IntentFilterに WifiManager.WIFI_STATE_CHANGED_ACTION を指定することで、WiFi状態の変化に関するブロードキャストだけを絞り込んで受信できます。
• 状態の取得方法： onReceive() 内では intent.getIntExtra() で EXTRA_WIFI_STATE を取り出し、WIFI_STATE_ENABLED / WIFI_STATE_DISABLED のどちらかを判定してUIに反映しています。
• 注意点： setWifiEnabled() はAndroid 10（API 29）以降で非推奨となり、通常のアプリからは呼び出しても動作しなくなりました。Android 10以降をターゲットとする場合は、Settings.Panel.ACTION_WIFI を利用したWiFi設定パネルの表示へ置き換えることをおすすめします。

以上が、AndroidでBroadcastReceiverを使用する基本の流れです。今回のサンプルはWiFi状態の監視でしたが、同じ仕組みは電池残量、充電状態、ヘッドフォンの接続など、さまざまなシステムイベントの検知にも応用できます。ぜひ自分のアプリでも試してみてください。