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
判斷連線是否費用高昂。如果使用計量付費連線,請嘗試減少應用程式數據用量,或延遲應用程式使用非計量付費連線。
設定網路回呼
使用 ConnectivityManager
註冊 NetworkRequest
時,您必須實作 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);