Android
 Computer >> コンピューター >  >> プログラミング >> Android

KotlinでAndroidアプリのインターネット接続状態とネットワークタイプを確認する方法

このチュートリアルでは、Kotlinを使ってAndroid端末のインターネット接続の可用性とネットワークタイプ(Wi-Fi・モバイル回線など)を確認する方法を、サンプルコードとともにわかりやすく解説します。

手順1:新規プロジェクトを作成する

Android Studioを開き、「File」→「New Project」を選択して、必要な項目を入力し新しいプロジェクトを作成します。

手順2:レイアウトファイル(activity_main.xml)を編集する

res/layout/activity_main.xml に以下のコードを追加します。

<?xml version="1.0" encoding="utf-8"?>
<RelativeLayout xmlns:android="https://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent">
    <TextView
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_centerHorizontal="true"
        android:layout_marginTop="70dp"
        android:background="#008080"
        android:padding="5dp"
        android:text="TutorialsPoint"
        android:textColor="#fff"
        android:textSize="24sp"
        android:textStyle="bold" />
    <TextView
        android:id="@+id/textView"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_centerInParent="true"
        android:textColor="@android:color/holo_purple"
        android:textSize="24sp"
        android:textStyle="bold" />
</RelativeLayout>

手順3:MainActivity.ktを実装する

src/MainActivity.kt に以下のコードを記述します。ConnectivityManagerを利用してネットワークの状態を取得し、その結果をToastとTextViewに表示しています。

import android.content.Context
import android.net.ConnectivityManager
import android.os.Bundle
import android.widget.TextView
import android.widget.Toast
import androidx.appcompat.app.AppCompatActivity

class MainActivity : AppCompatActivity() {
    lateinit var textView: TextView
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)
        title = "KotlinApp"
        textView = findViewById(R.id.textView)
        if (checkNetwork()) {
            Toast.makeText(this, "Network connection is available", Toast.LENGTH_SHORT).show()
        } else {
            Toast.makeText(this, "Network connection is not available", Toast.LENGTH_SHORT).show()
        }
    }
    private fun checkNetwork(): Boolean {
        val connManager = getSystemService(Context.CONNECTIVITY_SERVICE) as ConnectivityManager
        val networkInfo = connManager.getNetworkInfo(ConnectivityManager.TYPE_WIFI)
        textView.text = "Network type is " + networkInfo!!.typeName
        return networkInfo!!.isConnected
    }
}

手順4:AndroidManifest.xmlにパーミッションを追加する

ネットワーク状態へアクセスするためには、AndroidManifest.xml に ACCESS_NETWORK_STATE 権限の宣言が必要です。manifestタグ直下(applicationタグの外)に以下のように追記してください。

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="https://schemas.android.com/apk/res/android" package="com.example.q11">
    <uses-permission android:name="android.permission.ACCESS_NETWORK_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端末をパソコンにUSB接続していることを前提とします。Android Studioでプロジェクト内のアクティビティファイルを開き、ツールバーの「Run」アイコン KotlinでAndroidアプリのインターネット接続状態とネットワークタイプを確認する方法 をクリックします。デバイス選択のダイアログで接続したモバイル端末を選択すると、端末上にアプリの画面が表示されます。

KotlinでAndroidアプリのインターネット接続状態とネットワークタイプを確認する方法

Wi-Fiに接続された状態でアプリを起動すると「Network connection is available」というトーストが表示され、画面中央には現在のネットワークタイプが示されます。オフラインの場合は「Network connection is not available」と表示されます。

補足:新しいAPI(NetworkCapabilities)を使った判定方法

なお、getNetworkInfo() はAPI 29(Android 10)以降で非推奨となっています。新しい環境向けには、次のように NetworkCapabilities を使う実装が推奨されます。

import android.net.NetworkCapabilities

private fun checkNetworkStatus(): String {
    val connManager = getSystemService(Context.CONNECTIVITY_SERVICE) as ConnectivityManager
    val network = connManager.activeNetwork ?: return "オフライン"
    val capabilities = connManager.getNetworkCapabilities(network) ?: return "オフライン"
    return if (capabilities.hasCapability(NetworkCapabilities.NET_CAPABILITY_INTERNET)) {
        when {
            capabilities.hasTransport(NetworkCapabilities.TRANSPORT_WIFI) -> "Wi-Fi接続中"
            capabilities.hasTransport(NetworkCapabilities.TRANSPORT_CELLULAR) -> "モバイル回線接続中"
            else -> "その他のネットワーク接続中"
        }
    } else {
        "オフライン"
    }
}

このようにConnectivityManagerを活用すれば、アプリ起動時や通信処理の前にネットワークの状態を簡単に判定できます。通信エラーを未然に防ぎ、ユーザー体験の向上につなげるために、ぜひ活用してください。

  1. Androidで現在のインターネット接続タイプを取得する方法を解説

    概要この記事では、Androidアプリで現在のインターネット接続タイプ(Wi-Fi、モバイル回線など)を取得し、画面に表示する方法を解説します。接続情報の取得には、Androidが標準で提供しているConnectivityManagerクラスを使用します。ステップ1:新規プロジェクトを作成するAndroid Studioで新しいプロジェクトを作成します。メニューから「File」⇒「New Project」を選択し、必要な項目をすべて入力してプロジェクトを作成してください。ステップ2:レイアウトファイルを編集する以下のコードを res/layout/activity_main.xml に追加しま

  2. Androidでネットワーク接続の有無を確認する方法をステップ形式で解説

    本記事では、Androidアプリ上でインターネット接続(Wi-Fiまたはモバイルデータ通信)が利用可能かどうかをプログラムから判定する方法を、実際のサンプルコードとともに段階的に解説します。オフライン時のエラー処理やユーザーへの通知を実装したい場合に役立つ基本的なテクニックです。手順1:新規プロジェクトを作成するまず、Android Studioを起動し、メニューから「File」→「New Project」を選択して、必要な項目をすべて入力し、新しいプロジェクトを作成します。手順2:レイアウトファイル(activity_main.xml)を編集する次に、res/layout/activity_