语言

ConnectivityManager.NetworkCallback.OnAvailable(Network) 方法

定义

当框架连接并声明新的网络可供使用时调用。

[Android.Runtime.Register("onAvailable", "(Landroid/net/Network;)V", "GetOnAvailable_Landroid_net_Network_Handler")]
public virtual void OnAvailable(Android.Net.Network network);
[<Android.Runtime.Register("onAvailable", "(Landroid/net/Network;)V", "GetOnAvailable_Landroid_net_Network_Handler")>]
abstract member OnAvailable : Android.Net.Network -> unit
override this.OnAvailable : Android.Net.Network -> unit

参数

network
Network

Network满足的网络。

特性

注解

对于注册到 #registerNetworkCallback的回调,多个网络可能同时可用,并且将在其中每个网络出现时为其调用 onAvailable。

对于注册的 #requestNetwork 回调, #registerDefaultNetworkCallback这意味着作为参数传递的网络是此请求的新最佳网络,现在由此回调跟踪;此回调将不再接收以前可能传递给此方法的其他网络的方法调用。 以前最好的网络可能已断开连接,或者它可能仍在周围,而新最好的网络可能更好。

从 android.os.Build.VERSION_CODES#O头开始,此操作将始终紧跟 #onCapabilitiesChanged(Network, NetworkCapabilities) 呼叫,然后通过呼叫来调用 #onLinkPropertiesChanged(Network, LinkProperties)和呼叫 #onBlockedStatusChanged(Network, boolean)。

请勿在此回调中调用或其他#getNetworkCapabilities(Network)同步 ConnectivityManager 方法,因为这很容易出现#getLinkProperties(Network)争用条件(不能保证这些方法返回的对象将是最新的)。 相反,请等待调用 #onCapabilitiesChanged(Network, NetworkCapabilities) 并 #onLinkPropertiesChanged(Network, LinkProperties) 保证其参数与其他回调一致有序。

Java文档android.net.ConnectivityManager.NetworkCallback.onAvailable(android.net.Network)。

本页的某些部分是根据 创建和共享的工作进行的修改,并根据 许可证中所述的条款使用。

适用于