API Wi-Fi Network Request pour la connectivité peer-to-peer

Sur les appareils Android 10 (niveau d'API 29) ou version ultérieure, vous pouvez utiliser une nouvelle API peer-to-peer pour démarrer la configuration des appareils secondaires tels que Chromecast et le matériel Google Home. Cette fonctionnalité permet à votre application d'inviter l'utilisateur à modifier le point d'accès auquel l'appareil est connecté à l'aide de WifiNetworkSpecifier pour décrire les propriétés d'un réseau demandé.

Pour utiliser cette API, procédez comme suit :

1. Créez un spécificateur de réseau Wi-Fi à l'aide de WifiNetworkSpecifier.Builder.

2. Définissez un filtre réseau pour faire correspondre les réseaux auxquels vous souhaitez vous connecter, ainsi que les identifiants requis.

3. Choisissez une combinaison de SSID, SSID pattern, BSSID et BSSID pattern pour définir le filtre réseau dans chaque requête, sous réserve des conditions suivantes:

   • Chaque requête doit fournir au moins l'une des valeurs SSID, SSID pattern, BSSID ou BSSID pattern.
   • Chaque requête ne peut définir qu'un seul SSID ou SSID pattern.
   • Chaque requête ne peut définir qu'un seul BSSID ou BSSID pattern.

4. Ajoutez les spécificateurs à la requête réseau, ainsi qu'une instance NetworkCallback pour suivre l'état de la requête.

   Si l'utilisateur accepte la requête et que la connexion au réseau aboutit, NetworkCallback.onAvailable() est appelé sur l'objet de rappel. Si l'utilisateur refuse la requête ou si la connexion au réseau échoue, NetworkCallback.onUnavailable() est appelé sur l'objet de rappel.

Le lancement de la requête de connexion à un appareil homologue lance une boîte de dialogue sur le même appareil, à partir de laquelle l'utilisateur de cet appareil peut accepter la requête de connexion.

Remarque :Créer une connexion à l'aide de cette API ne fournit pas de connexion Internet à l'application ni à l'appareil. Pour fournir une connexion Internet aux applications d'un appareil, utilisez plutôt l'API Wi-Fi Suggestion.

Contourner l'approbation de l'utilisateur

Une fois que l'utilisateur a approuvé un réseau auquel se connecter en réponse à une requête d'une application spécifique, l'appareil stocke l'approbation pour le point d'accès en question. Si l'application envoie une requête spécifique pour se reconnecter à ce point d'accès, l'appareil ignore la phase d'approbation de l'utilisateur et se connecte automatiquement au réseau. Si l'utilisateur choisit d'oublier le réseau lorsqu'il est connecté à un réseau demandé par l'API, cette approbation stockée pour cette combinaison d'application et de réseau est supprimée, et toute future demande de l'application doit être à nouveau approuvée par l'utilisateur. Si l'application envoie une requête non spécifique, par exemple avec un modèle SSID ou BSSID, l'utilisateur doit approuver la requête.

Exemple de code

L'exemple de code suivant montre comment se connecter à un réseau ouvert avec un préfixe SSID de "test" et un 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);