【Android】利用可能なWi-Fiネットワークを取得してリストに表示する方法

はじめに

この記事では、Androidアプリで周囲にある利用可能なWi-Fiネットワークをスキャンして取得し、ListViewに一覧表示する方法を解説します。Wi-Fiのスキャン結果はBroadcastReceiver経由で受け取り、画面上のリストへ反映させる仕組みです。

手順1：プロジェクトの作成

Android Studioを起動し、「File」→「New Project」を選択して新しいプロジェクトを作成します。必要な項目をすべて入力して、プロジェクトの雛形を生成してください。

手順2：レイアウトファイル（res/layout/activity_main.xml）の編集

以下のコードをactivity_main.xmlに追加します。Wi-Fiネットワークの一覧を表示する「ListView」と、スキャンを実行するための「Button」を配置しています。

<?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"
   android:layout_margin = "16dp"
   android:orientation = "vertical"
   tools:context = ".MainActivity">
   <ListView
      android:id = "@+id/wifiList"
      android:layout_width = "match_parent"
      android:layout_height = "match_parent"
      android:layout_above = "@+id/scanBtn" />
   <Button
      android:id = "@+id/scanBtn"
      android:layout_width = "match_parent"
      android:layout_height = "50dp"
      android:layout_alignParentBottom = "true"
      android:layout_gravity = "bottom"
      android:layout_margin = "15dp"
      android:text = "Scan WiFi" />
</RelativeLayout>

手順3：MainActivity.java の実装

src/MainActivity.java に以下のコードを追加します。Wi-Fiが無効になっている場合は自動的にONに切り替え、ボタンが押されたタイミングで位置情報権限を確認したうえでスキャンを開始します。

package com.example.myapplication;

import android.Manifest;
import android.content.Context;
import android.content.IntentFilter;
import android.content.pm.PackageManager;
import android.net.wifi.WifiManager;
import android.os.Build;
import android.support.annotation.NonNull;
import android.support.v4.app.ActivityCompat;
import android.support.v4.content.ContextCompat;
import android.support.v7.app.AppCompatActivity;
import android.os.Bundle;
import android.view.View;
import android.widget.Button;
import android.widget.ListView;
import android.widget.Toast;

public class MainActivity extends AppCompatActivity {
   private ListView wifiList;
   private WifiManager wifiManager;
   private final int MY_PERMISSIONS_ACCESS_COARSE_LOCATION = 1;
   WifiReceiver receiverWifi;
   @Override
   protected void onCreate(Bundle savedInstanceState) {
      super.onCreate(savedInstanceState);
      setContentView(R.layout.activity_main);
      wifiList = findViewById(R.id.wifiList);
      Button buttonScan = findViewById(R.id.scanBtn);
      wifiManager = (WifiManager) getApplicationContext().getSystemService(Context.WIFI_SERVICE);
      if (!wifiManager.isWifiEnabled()) {
         Toast.makeText(getApplicationContext(), "Turning WiFi ON...", Toast.LENGTH_LONG).show();
         wifiManager.setWifiEnabled(true);
      }
      buttonScan.setOnClickListener(new View.OnClickListener() {
         @Override
         public void onClick(View v) {
            if (ActivityCompat.checkSelfPermission(MainActivity.this, Manifest.permission.ACCESS_COARSE_LOCATION)
               != PackageManager.PERMISSION_GRANTED) {
               ActivityCompat.requestPermissions(
               MainActivity.this, new String[]{Manifest.permission.ACCESS_COARSE_LOCATION}, MY_PERMISSIONS_ACCESS_COARSE_LOCATION);
            } else {
               wifiManager.startScan();
            }
         }
      });
   }
   @Override
   protected void onPostResume() {
      super.onPostResume();
      receiverWifi = new WifiReceiver(wifiManager, wifiList);
      IntentFilter intentFilter = new IntentFilter();
      intentFilter.addAction(WifiManager.SCAN_RESULTS_AVAILABLE_ACTION);
      registerReceiver(receiverWifi, intentFilter);
      getWifi();
   }
   private void getWifi() {
      if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.M) {
         Toast.makeText(MainActivity.this, "version>= marshmallow", Toast.LENGTH_SHORT).show();
         if (ContextCompat.checkSelfPermission(MainActivity.this, Manifest.permission.ACCESS_COARSE_LOCATION)
            != PackageManager.PERMISSION_GRANTED) {
            Toast.makeText(MainActivity.this, "location turned off", Toast.LENGTH_SHORT).show();
            ActivityCompat.requestPermissions(MainActivity.this, new String[]{Manifest.permission.ACCESS_COARSE_LOCATION},
               MY_PERMISSIONS_ACCESS_COARSE_LOCATION);
         } else {
            Toast.makeText(MainActivity.this, "location turned on", Toast.LENGTH_SHORT).show();
            wifiManager.startScan();
         }
      } else {
         Toast.makeText(MainActivity.this, "scanning", Toast.LENGTH_SHORT).show();
         wifiManager.startScan();
      }
   }
   @Override
   protected void onPause() {
      super.onPause();
      unregisterReceiver(receiverWifi);
   }
   @Override
   public void onRequestPermissionsResult(int requestCode, @NonNull String[] permissions, @NonNull int[] grantResults) {
      super.onRequestPermissionsResult(requestCode, permissions, grantResults);
      switch (requestCode) {
         case MY_PERMISSIONS_ACCESS_COARSE_LOCATION:
         if (grantResults.length > 0 && grantResults[0] == PackageManager.PERMISSION_GRANTED) {
            Toast.makeText(MainActivity.this, "permission granted", Toast.LENGTH_SHORT).show();
            wifiManager.startScan();
         } else {
            Toast.makeText(MainActivity.this, "permission not granted", Toast.LENGTH_SHORT).show();
            return;
         }
         break;
      }
   }
}

手順4：WifiReceiver クラスの作成

src/WifiReceiver.java を新規作成し、以下のコードを追加します。スキャン完了のブロードキャストを受け取ると、検出された各ネットワークのSSIDと暗号化方式（capabilities）をListViewに表示します。

package com.example.myapplication;

import android.content.BroadcastReceiver;
import android.content.Context;
import android.content.Intent;
import android.net.wifi.ScanResult;
import android.net.wifi.WifiManager;
import android.widget.ArrayAdapter;
import android.widget.ListView;
import android.widget.Toast;
import java.util.ArrayList;
import java.util.List;

class WifiReceiver extends BroadcastReceiver {
   WifiManager wifiManager;
   StringBuilder sb;
   ListView wifiDeviceList;
   public WifiReceiver(WifiManager wifiManager, ListView wifiDeviceList) {
      this.wifiManager = wifiManager;
      this.wifiDeviceList = wifiDeviceList;
   }
   public void onReceive(Context context, Intent intent) {
      String action = intent.getAction();
      if (WifiManager.SCAN_RESULTS_AVAILABLE_ACTION.equals(action)) {
         sb = new StringBuilder();
         List<ScanResult> wifiList = wifiManager.getScanResults();
         ArrayList<String> deviceList = new ArrayList<>();
         for (ScanResult scanResult : wifiList) {
            sb.append("\n").append(scanResult.SSID).append(" - ").append(scanResult.capabilities);
            deviceList.add(scanResult.SSID + " - " + scanResult.capabilities);
         }
         Toast.makeText(context, sb, Toast.LENGTH_SHORT).show();
         ArrayAdapter arrayAdapter = new ArrayAdapter(context, android.R.layout.simple_list_item_1, deviceList.toArray());
         wifiDeviceList.setAdapter(arrayAdapter);
      }
   }
}

手順5：AndroidManifest.xml への権限追加

androidManifest.xml に以下のパーミッションを追加します。位置情報権限（ACCESS_COARSE_LOCATION）と、Wi-Fi状態の参照・変更に関する権限が必要です。

<?xml version = "1.0" encoding = "utf-8"?>
<manifest xmlns:android = "https://schemas.android.com/apk/res/android"
   package = "com.example.myapplication">
   <uses-permission android:name = "android.permission.ACCESS_COARSE_LOCATION" />
   <uses-permission android:name = "android.permission.ACCESS_WIFI_STATE" />
   <uses-permission android:name = "android.permission.CHANGE_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 = "com.example.myapplication.MainActivity">
         <intent-filter>
            <action android:name = "android.intent.action.MAIN" />
            <category android:name = "android.intent.category.LAUNCHER" />
         </intent-filter>
      </activity>
   </application>
</manifest>

補足：権限に関する注意点

Android 6.0（Marshmallow）以降では、Wi-Fiスキャン結果を取得するために位置情報権限（ACCESS_COARSE_LOCATION）が必須です。さらに、端末本体の位置情報サービスがOFFになっているとスキャン結果が正しく取得できない点にも注意してください。より新しいOSバージョンでは、ACCESS_FINE_LOCATIONの使用が推奨される場合があります。

アプリの実行

それでは、作成したアプリを実行してみましょう。ここでは、実機のAndroidスマートフォンをPCに接続しているものとして説明を進めます。Android Studioでプロジェクト内のいずれかのアクティビティファイルを開き、ツールバーの「Run」アイコンをクリックしてください。接続中のモバイルデバイスを選択すると、実機でアプリが起動し、以下のような画面が表示されます。