ConnectivityManager.NetworkCallback.OnAvailable(Network) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Chamado quando a estrutura se conecta e declara uma nova rede pronta para uso.
[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
Parâmetros
- network
- Network
A Network da rede satisfatória.
- Atributos
Comentários
Para retornos de chamada registrados com #registerNetworkCallback, várias redes podem estar disponíveis ao mesmo tempo e, em Disponibilidade, serão chamados para cada uma delas conforme aparecerem.
Para retornos de chamada registrados com #requestNetwork e #registerDefaultNetworkCallback, isso significa que a rede passada como um argumento é a nova melhor rede para essa solicitação e agora é controlada por esse retorno de chamada; esse retorno de chamada não receberá mais chamadas de método sobre outras redes que podem ter sido passadas para esse método anteriormente. A rede anteriormente melhor pode ter se desconectado ou ainda pode estar por perto e a rede recém-melhor pode ser simplesmente melhor.
Começando com android.os.Build.VERSION_CODES#O, isso sempre será seguido imediatamente por uma chamada para #onCapabilitiesChanged(Network, NetworkCapabilities) , em seguida, por uma chamada para #onLinkPropertiesChanged(Network, LinkProperties), e uma chamada para #onBlockedStatusChanged(Network, boolean).
NÃO chame #getNetworkCapabilities(Network) ou #getLinkProperties(Network) ou outros métodos ConnectivityManager síncronos neste retorno de chamada, pois isso é propenso a condições de corrida (não há garantia de que os objetos retornados por esses métodos serão atuais). Em vez disso, aguarde uma chamada e #onCapabilitiesChanged(Network, NetworkCapabilities)#onLinkPropertiesChanged(Network, LinkProperties) cujos argumentos têm a garantia de serem bem ordenados em relação a outros retornos de chamada.
Partes desta página são modificações baseadas no trabalho criado e compartilhado pelo Project Open Source do Open Source e usadas de acordo com os termos descritos na Creative Commons 2.5.