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