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);