Idioma

VpnService.SetUnderlyingNetworks(Network[]) Método

Definição

Define as redes subjacentes usadas pela VPN para suas conexões upstream.

[Android.Runtime.Register("setUnderlyingNetworks", "([Landroid/net/Network;)Z", "GetSetUnderlyingNetworks_arrayLandroid_net_Network_Handler", ApiSince=22)]
public virtual bool SetUnderlyingNetworks(Android.Net.Network[]? networks);
[<Android.Runtime.Register("setUnderlyingNetworks", "([Landroid/net/Network;)Z", "GetSetUnderlyingNetworks_arrayLandroid_net_Network_Handler", ApiSince=22)>]
abstract member SetUnderlyingNetworks : Android.Net.Network[] -> bool
override this.SetUnderlyingNetworks : Android.Net.Network[] -> bool

Parâmetros

networks
Network[]

Uma matriz de redes que a VPN usa para túnel de/para seus servidores.

Retornos

true sobre o sucesso.

Atributos

Comentários

Define as redes subjacentes usadas pela VPN para suas conexões upstream.

Usado pelo sistema para conhecer as redes reais que transportam tráfego para aplicativos afetados por essa VPN para apresentar essas informações ao usuário (por exemplo, por meio de ícones da barra de status).

Esse método só precisa ser chamado se a VPN tiver explicitamente associado seus canais de comunicação subjacentes — como os soquetes passados para #protect(int) — para um Network uso de APIs como Network#bindSocket(Socket) ou Network#bindSocket(DatagramSocket). A VPN deve chamar esse método sempre que o conjunto de Networks estiver usando alterações.

networks é um dos seguintes: <ul><li><forte>uma matriz< não vazia/forte>: uma matriz de um ou mais Networks, na ordem de preferência decrescente. Por exemplo, se essa VPN usa redes wi-fi e móveis (celulares) para transportar o tráfego do aplicativo, mas prefere ou usa wi-fi mais do que móvel, o wi-fi deve aparecer primeiro na matriz.</li li><><forte>uma matriz< vazia/forte>: uma matriz de elemento zero, o que significa que a VPN não tem nenhuma conexão de rede subjacente e, portanto, o tráfego do aplicativo não será enviado ou recebido.</li><li><strong>null</strong>: (padrão) significa que a VPN usa qualquer que seja a rede padrão do sistema. Ou seja, ele não usa as bindSocketbindDatagramSocket APIs mencionadas acima para enviar tráfego por canais específicos.</li></ul>

Essa chamada só terá êxito se a VPN estiver estabelecida no momento. Para definir esse valor quando a VPN ainda não tiver sido estabelecida, consulte Builder#setUnderlyingNetworks.

Java documentação para android.net.VpnService.setUnderlyingNetworks(android.net.Network[]).

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.

Aplica-se a