API Wi-Fi Network Request per la connettività peer-to-peer

Sui dispositivi Android 10 (livello API 29) e versioni successive, puoi utilizzare una nuova API peer-to-peer per avviare la configurazione per dispositivi secondari come Chromecast e hardware Google Home. Questa funzionalità consente all'app di chiedere all'utente di cambiare il punto di accesso a cui è connesso il dispositivo utilizzando WifiNetworkSpecifier per descrivere le proprietà di una rete richiesta.

Per utilizzare questa API:

  1. Crea un identificatore di rete Wi-Fi utilizzando WifiNetworkSpecifier.Builder.

  2. Imposta un filtro di rete per trovare le reti a cui connetterti, insieme alle credenziali richieste.

  3. Decidi una combinazione di SSID, SSID pattern, BSSID, e BSSID pattern per impostare il filtro di rete in ogni richiesta, in base ai seguenti requisiti:

    • Ogni richiesta deve fornire almeno uno dei seguenti valori: SSID, SSID pattern, BSSID o BSSID pattern
    • Ogni richiesta può impostare solo uno dei valori SSID o SSID pattern
    • Ogni richiesta può impostare solo uno dei valori BSSID o BSSID pattern

  4. Aggiungi gli identificatori alla richiesta di rete insieme a un'istanza NetworkCallback per monitorare lo stato della richiesta.

    Se l'utente accetta la richiesta e la connessione alla rete va a buon fine, viene richiamato NetworkCallback.onAvailable() sull'oggetto callback. Se l'utente rifiuta la richiesta o se la connessione alla rete non va a buon fine, NetworkCallback.onUnavailable() viene richiamato sull'oggetto callback.

L'avvio della richiesta di connessione a un dispositivo peer apre una finestra di dialogo sullo stesso dispositivo, da cui l'utente del dispositivo può accettare la richiesta di connessione.

Ignorare l'approvazione dell'utente

Una volta che l'utente approva la connessione a una rete in risposta a una richiesta di un'app specifica, il dispositivo memorizza l'approvazione per il punto di accesso specifico. Se l'app fa una richiesta specifica per connettersi di nuovo a quel punto di accesso, il dispositivo salta la fase di approvazione dell'utente e si connette automaticamente alla rete. Se l'utente sceglie di dimenticare la rete mentre è connesso a una rete richiesta dall'API, l'approvazione memorizzata per quella combinazione di app e rete viene rimossa e qualsiasi richiesta futura dall'app deve essere approvata nuovamente dall'utente. Se l'app effettua una richiesta non specifica, ad esempio con un pattern SSID o BSSID, l'utente deve approvare la richiesta.

Esempio di codice

Il seguente esempio di codice mostra come connettersi a una rete aperta con un prefisso SSID di "test" e un OUI BSSID di "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);