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 lors de l'ajout d'un ou de plusieurs réseaux enregistrés ou de configurations Passpoint. L'API fonctionne également telle quelle pour modifier les configurations enregistrées existantes.

Pour enregistrer une configuration de réseau ou de 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 Intent n'est pas liée à l'API Suggestion.

3. Créez une liste de tableaux parcellables des configurations 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().

   L'élément resultCode peut avoir l'une des valeurs suivantes:

   • 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 chaînes proposées.

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

   • ADD_WIFI_RESULT_SUCCESS : configuration ajoutée ou mise à jour avec succès.
   • ADD_WIFI_RESULT_ADD_OR_UPDATE_FAILED : échec lors de l'ajout d'une configuration, par exemple en raison d'une configuration mal formée.
   • 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 de réseau ou de point d'accès 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
        }
    }
}