Enregistrer les configurations de réseaux et de Passpoint

Sur Android 11 (niveau de SDK 30) ou version ultérieure, les applications peuvent utiliser l'intent android.provider.Settings.ACTION_WIFI_ADD_NETWORKS pour guider l'utilisateur dans l'ajout d'un ou de plusieurs réseaux enregistrés ou configurations Passpoint. L'API fonctionne également telle quelle pour modifier les configurations enregistrées existantes.

Remarque :Cette API est la fonctionnalité la plus proche de l'API obsolète WifiManager.addNetwork(WifiConfiguration config), car la configuration qui en résulte est ajoutée à la liste des réseaux et abonnements enregistrés gérés et visibles par l'utilisateur.

Pour enregistrer une configuration réseau ou Passpoint, procédez comme suit:

1. Créez un intent ACTION_WIFI_ADD_NETWORKS.

2. Créez une ou plusieurs configurations à l'aide de WifiNetworkSuggestion.Builder. Notez que même si vous utilisez un WifiNetworkSuggestion, cette API d'intent n'est pas liée à l'API Suggestion.

3. Créez une liste des configurations sous forme de tableau parcelable et associez-la à l'intent avec l'extra EXTRA_WIFI_NETWORK_LIST.

4. Exécutez Activity.startActivityForResult() en transmettant l'intent.

5. Écoutez le résultat à l'aide du rappel Activity.onActivityResult().

   Le resultCode peut être l'un des éléments suivants:

   • Activity.RESULT_OK : indique que l'utilisateur a accepté les réseaux proposés et les a enregistrés.
   • Activity.RESULT_CANCELED : indique que l'utilisateur a refusé les réseaux proposés.

   Si resultCode est défini sur RESULT_OK, les données Intent contiennent l'extra EXTRA_WIFI_NETWORK_RESULT_LIST, qui contient un tableau de codes de résultat indiquant si les configurations individuelles ont bien été enregistrées. Les codes de résultat possibles sont les suivants:

   • ADD_WIFI_RESULT_SUCCESS : configuration ajoutée ou mise à jour.
   • ADD_WIFI_RESULT_ADD_OR_UPDATE_FAILED : échec de la tentative d'ajout d'une configuration, en raison d'une configuration mal formée, par exemple.
   • ADD_WIFI_RESULT_ALREADY_EXISTS : la configuration demandée existait déjà. Aucune action n'était donc nécessaire.

6. Si la requête aboutit, la plate-forme déclenche une connexion à l'un des réseaux nouvellement enregistrés.

Exemple de code

L'exemple de code suivant montre comment enregistrer une configuration réseau ou Passpoint.

class MainActivity : AppCompatActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        ...
    }

    fun startOperation() {
        val suggestions = ArrayList<WifiNetworkSuggestion>()

        // WPA2 configuration
        suggestions.add(
                WifiNetworkSuggestion.Builder()
                        .setSsid("test111111")
                        .setWpa2Passphrase("test123456")
                        .build()
        )

        // Open configuration
        suggestions.add(
                WifiNetworkSuggestion.Builder()
                        .setSsid("test222222")
                        .build()
        )

        // Passpoint configuration
        val config = PasspointConfiguration()
        config.credential = Credential().apply {
            realm = "realm.example.com"
            simCredential = Credential.SimCredential().apply {
                eapType = 18
                imsi = "123456*"
            }
        }
        config.homeSp = HomeSp().apply {
            fqdn = "test1.example.com"
            friendlyName = "Some Friendly Name"
        }
        suggestions.add(
                WifiNetworkSuggestion.Builder()
                        .setPasspointConfig(config)
                        .build())

        // Create intent
        val bundle = Bundle()
        bundle.putParcelableArrayList(EXTRA_WIFI_NETWORK_LIST, suggestions)
        val intent = Intent(ACTION_WIFI_ADD_NETWORKS)
        intent.putExtras(bundle)

        // Launch intent
        startActivityForResult(intent, 0)
    }

    override fun onActivityResult(requestCode: Int, resultCode: Int, data: Intent?) {
        super.onActivityResult(requestCode, resultCode, data)
        if(resultCode == RESULT_OK) {
            // user agreed to save configurations: still need to check individual results
            if (data != null && data.hasExtra(EXTRA_WIFI_NETWORK_RESULT_LIST)) {
                for (code in data.getIntegerArrayListExtra(EXTRA_WIFI_NETWORK_RESULT_LIST)) {
                    when (code) {
                        ADD_WIFI_RESULT_SUCCESS ->
                            ... // Configuration saved or modified
                        ADD_WIFI_RESULT_ADD_OR_UPDATE_FAILED ->
                            ... // Something went wrong - invalid configuration
                        ADD_WIFI_RESULT_ALREADY_EXISTS ->
                            ... // Configuration existed (as-is) on device, nothing changed
                        else ->
                            ... // Other errors
                    }
                }
            }
        } else {
            // User refused to save configurations
        }
    }
}