ConnectivityManager
には、デバイスの機能やデータ転送オプションなどのさまざまな条件に基づいて、デバイスがネットワークに接続するようにリクエストできる API が用意されています。
コールバックの実装により、デバイスの接続ステータスと現在接続されているネットワークの機能に関する情報をアプリに提供します。この API を使用すると、アプリがアプリの要件を満たすネットワークに現在接続されているかどうかを確認できます。
ネットワーク リクエストを構成する
ネットワークのトランスポートの種類(Wi-Fi 接続やモバイル接続など)と、現在接続されているネットワークの機能(インターネット接続など)を指定するには、ネットワーク リクエストを構成する必要があります。
アプリのネットワーク接続のニーズを表す NetworkRequest
を宣言します。次のコードは、インターネットに接続され、トランスポート タイプとして Wi-Fi またはモバイル接続を使用するネットワークに対するリクエストを作成します。
Kotlin
val networkRequest = NetworkRequest.Builder() .addCapability(NetworkCapabilities.NET_CAPABILITY_INTERNET) .addTransportType(NetworkCapabilities.TRANSPORT_WIFI) .addTransportType(NetworkCapabilities.TRANSPORT_CELLULAR) .build()
Java
NetworkRequest networkRequest = new NetworkRequest.Builder() .addCapability(NetworkCapabilities.NET_CAPABILITY_INTERNET) .addTransportType(NetworkCapabilities.TRANSPORT_WIFI) .addTransportType(NetworkCapabilities.TRANSPORT_CELLULAR) .build();
一部の接続は他の接続よりも大幅に高コストになる場合があります(たとえば、モバイル接続は通常高コストです)。NetworkCapabilities#NET_CAPABILITY_NOT_METERED
を使用して、接続が高コストかどうかを判断します。従量制接続の場合は、アプリのデータ使用量を削減するか、デバイスが従量制ではない接続になるまで遅延させるようにします。
ネットワーク コールバックを構成する
NetworkRequest
を ConnectivityManager
に登録する場合は、NetworkCallback
を実装して、接続ステータスとネットワーク機能の変化に関する通知を受信する必要があります。
NetworkCallback
で一般的に実装される関数は次のとおりです。
onAvailable()
は、NetworkRequest
で指定された機能とトランスポート タイプの要件を満たす新しいネットワークにデバイスが接続されたことを示します。onLost()
はデバイスがネットワークへの接続を失ったことを示します。onCapabilitiesChanged()
は、ネットワークの機能が変更されたことを示します。NetworkCapabilities
オブジェクトは、ネットワークの現在の機能に関する情報を提供します。
Kotlin
private val networkCallback = object : ConnectivityManager.NetworkCallback() { // network is available for use override fun onAvailable(network: Network) { super.onAvailable(network) } // Network capabilities have changed for the network override fun onCapabilitiesChanged( network: Network, networkCapabilities: NetworkCapabilities ) { super.onCapabilitiesChanged(network, networkCapabilities) val unmetered = networkCapabilities.hasCapability(NetworkCapabilities.NET_CAPABILITY_NOT_METERED) } // lost network connection override fun onLost(network: Network) { super.onLost(network) } }
Java
private ConnectivityManager.NetworkCallback networkCallback = new ConnectivityManager.NetworkCallback() { @Override public void onAvailable(@NonNull Network network) { super.onAvailable(network); } @Override public void onLost(@NonNull Network network) { super.onLost(network); } @Override public void onCapabilitiesChanged(@NonNull Network network, @NonNull NetworkCapabilities networkCapabilities) { super.onCapabilitiesChanged(network, networkCapabilities); final boolean unmetered = networkCapabilities.hasCapability(NetworkCapabilities.NET_CAPABILITY_NOT_METERED); } };
ネットワークの更新を登録する
NetworkRequest
と NetworkCallback
を宣言したら、requestNetwork()
関数または registerNetworkCallback()
関数を使用して、NetworkRequest
を満たすデバイスから接続するネットワークを検索します。その後、ステータスは NetworkCallback
に報告されます。
Kotlin
val connectivityManager = getSystemService(ConnectivityManager::class.java) as ConnectivityManager connectivityManager.requestNetwork(networkRequest, networkCallback)
Java
ConnectivityManager connectivityManager = (ConnectivityManager) getSystemService(ConnectivityManager.class); connectivityManager.requestNetwork(networkRequest, networkCallback);