Cómo guardar redes y configuraciones de Passpoint

En Android 11 (nivel de SDK 30) y versiones posteriores, las apps pueden usar el intent android.provider.Settings.ACTION_WIFI_ADD_NETWORKS para guiar al usuario a través del proceso de agregar una o más redes guardadas nuevas o configuraciones de Passpoint. La API también funciona tal como está para modificar las configuraciones guardadas existentes.

Nota: Esta API es la más cercana en funcionalidad a la API de WifiManager.addNetwork(WifiConfiguration config) obsoleta, ya que la configuración resultante se agrega a la lista de redes y suscripciones guardadas administradas y visibles para el usuario.

Para guardar una red o una configuración de Passpoint, haz lo siguiente:

1. Crea un intent ACTION_WIFI_ADD_NETWORKS.

2. Crea una o más configuraciones con WifiNetworkSuggestion.Builder. Ten en cuenta que, aunque uses un WifiNetworkSuggestion, esta API de Intent no está relacionada con la API de Suggestion.

3. Crea una lista de array parcelable de las configuraciones y adjúntala al intent con el extra EXTRA_WIFI_NETWORK_LIST.

4. Ejecuta Activity.startActivityForResult() y pasa el intent.

5. Espera el resultado con la devolución de llamada Activity.onActivityResult().

   El resultCode puede ser uno de los siguientes:

   • Activity.RESULT_OK: Indica que el usuario aceptó las redes propuestas y las guardó.
   • Activity.RESULT_CANCELED: Indica que el usuario rechazó las redes propuestas.

   Si resultCode es RESULT_OK, los datos Intent contienen el elemento adicional EXTRA_WIFI_NETWORK_RESULT_LIST, que incluye un array de códigos de resultado que indican si se guardaron correctamente las configuraciones individuales. Los posibles códigos de resultado son los siguientes:

   • ADD_WIFI_RESULT_SUCCESS: Se agregó o actualizó correctamente la configuración.
   • ADD_WIFI_RESULT_ADD_OR_UPDATE_FAILED: Falla al intentar agregar la configuración, por ejemplo, debido a una configuración mal formada.
   • ADD_WIFI_RESULT_ALREADY_EXISTS: La configuración solicitada ya existía, por lo que no fue necesaria ninguna acción.

6. Si la solicitud se realiza correctamente, la plataforma activa una conexión a una de las redes recién guardadas.

Muestra de código

En el siguiente ejemplo de código, se muestra cómo guardar una configuración de red o de 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
        }
    }
}