Em dispositivos com o Android 10 (nível 29 da API) e versões mais recentes, é possível usar uma nova API ponto a ponto para
inicializar a configuração de dispositivos secundários, como o Chromecast e o hardware do
Google Home. Esse recurso permite que o app solicite que o usuário mude o ponto de acesso
ao qual o dispositivo está conectado usando WifiNetworkSpecifier para
descrever as propriedades de uma rede solicitada.
Para usar essa API, siga as etapas abaixo:
Crie um especificador de rede Wi-Fi usando
WifiNetworkSpecifier.Builder.Defina um filtro de rede para corresponder às redes que serão conectadas, junto com as credenciais necessárias.
Decida sobre uma combinação de
SSID,SSID pattern,BSSIDeBSSID patternpara definir o filtro de rede em cada solicitação, sujeito aos seguintes requisitos:- Cada solicitação precisa fornecer pelo menos um entre
SSID,SSID pattern,BSSIDouBSSID pattern. - Cada solicitação pode definir apenas
SSIDouSSID pattern. - Cada solicitação pode definir apenas
BSSIDouBSSID pattern.
- Cada solicitação precisa fornecer pelo menos um entre
Adicione os especificadores à solicitação de rede com uma instância
NetworkCallbackpara acompanhar o status da solicitação.Se o usuário aceitar a solicitação e a conexão com a rede for bem-sucedida,
NetworkCallback.onAvailable()será invocado no objeto de callback. Se o usuário negar a solicitação ou se a conexão com a rede falhar,NetworkCallback.onUnavailable()será invocado no objeto de callback.
Iniciar a solicitação de conexão com um dispositivo de peering abre uma caixa de diálogo no mesmo dispositivo, em que o usuário pode aceitar a solicitação de conexão.
Ignorar a aprovação do usuário
Depois que o usuário aprova uma rede para se conectar em resposta a uma solicitação de um app específico, o dispositivo armazena a aprovação para o ponto de acesso em questão. Se o app fizer uma solicitação específica para se conectar a esse ponto de acesso novamente, o dispositivo vai pular a fase de aprovação do usuário e se conectar automaticamente à rede. Se o usuário optar por esquecer a rede enquanto estiver conectado a uma rede solicitada pela API, essa aprovação armazenada para essa combinação de app e rede será removida, e qualquer solicitação futura do app precisará ser aprovada pelo usuário novamente. Se o app fizer uma solicitação não específica, como com um padrão SSID ou BSSID, o usuário precisará aprovar a solicitação.
Exemplo de código
O exemplo de código a seguir mostra como se conectar a uma rede aberta com um prefixo SSID
de "test" e um OUI BSSID de "10:03:23":
Kotlin
val specifier = WifiNetworkSpecifier.Builder()
.setSsidPattern(PatternMatcher("test", PatternMatcher.PATTERN_PREFIX))
.setBssidPattern(MacAddress.fromString("10:03:23:00:00:00"), MacAddress.fromString("ff:ff:ff:00:00:00"))
.build()
val request = NetworkRequest.Builder()
.addTransportType(NetworkCapabilities.TRANSPORT_WIFI)
.removeCapability(NetworkCapabilities.NET_CAPABILITY_INTERNET)
.setNetworkSpecifier(specifier)
.build()
val connectivityManager = context.getSystemService(Context.CONNECTIVITY_SERVICE) as ConnectivityManager
val networkCallback = object : ConnectivityManager.NetworkCallback() {
...
override fun onAvailable(network: Network?) {
// do success processing here..
}
override fun onUnavailable() {
// do failure processing here..
}
...
}
connectivityManager.requestNetwork(request, networkCallback)
...
// Release the request when done.
connectivityManager.unregisterNetworkCallback(networkCallback)
Java
final NetworkSpecifier specifier =
new WifiNetworkSpecifier.Builder()
.setSsidPattern(new PatternMatcher("test", PatternMatcher.PATTERN_PREFIX))
.setBssidPattern(MacAddress.fromString("10:03:23:00:00:00"), MacAddress.fromString("ff:ff:ff:00:00:00"))
.build();
final NetworkRequest request =
new NetworkRequest.Builder()
.addTransportType(NetworkCapabilities.TRANSPORT_WIFI)
.removeCapability(NetworkCapabilities.NET_CAPABILITY_INTERNET)
.setNetworkSpecifier(specifier)
.build();
final ConnectivityManager connectivityManager = (ConnectivityManager)
context.getSystemService(Context.CONNECTIVITY_SERVICE);
final NetworkCallback networkCallback = new NetworkCallback() {
...
@Override
void onAvailable(...) {
// do success processing here..
}
@Override
void onUnavailable(...) {
// do failure processing here..
}
...
};
connectivityManager.requestNetwork(request, networkCallback);
...
// Release the request when done.
connectivityManager.unregisterNetworkCallback(networkCallback);