Salvar configurações Passpoint e redes

No Android 11 (nível 30 do SDK) e versões mais recentes, os apps podem usar o android.provider.Settings.ACTION_WIFI_ADD_NETWORKS para orientar o usuário durante a adição de uma ou mais redes salvas novas ou Configurações do Passpoint. A API também funciona no estado em que se encontra para modificar personalizadas.

Observação: essa API é a que tem a funcionalidade mais próxima da WifiManager.addNetwork(WifiConfiguration config), porque o resultado for adicionada à rede salva gerenciada e voltada para o usuário e lista de assinaturas.

Para salvar uma configuração de rede ou Passpoint, faça o seguinte:

1. Crie uma intent ACTION_WIFI_ADD_NETWORKS.

2. Crie uma ou mais configurações usando WifiNetworkSuggestion.Builder Observe que mesmo que você use uma WifiNetworkSuggestion, essa API de intent será não relacionadas à API Suggestion.

3. Crie uma lista de matrizes parcelable e anexe-a ao com o EXTRA_WIFI_NETWORK_LIST extra.

4. Executar Activity.startActivityForResult(), transmitir a intent.

5. Ouça o resultado usando o Activity.onActivityResult() o retorno de chamada.

   O resultCode pode ser um dos seguintes:

   • Activity.RESULT_OK: indicando que o usuário aceitou as redes propostas e as salvou.
   • Activity.RESULT_CANCELED: indicando que o usuário rejeitou as redes propostas.

   Se o resultCode for RESULT_OK, os dados Intent conterão o EXTRA_WIFI_NETWORK_RESULT_LIST extra, que contém uma matriz de códigos de resultado indicando se valores individuais configurações foram salvas. Os possíveis códigos de resultado são:

   • ADD_WIFI_RESULT_SUCCESS: configuração adicionada ou atualizada.
   • ADD_WIFI_RESULT_ADD_OR_UPDATE_FAILED: falha ao tentar adicionar uma configuração, por exemplo, devido a um erro de formatação configuração do Terraform.
   • ADD_WIFI_RESULT_ALREADY_EXISTS: a configuração solicitada já existia, então nenhuma ação foi necessária.

6. Se a solicitação for bem-sucedida, a plataforma acionará uma conexão com um dos redes salvas recentemente.

Exemplo de código

O exemplo de código a seguir mostra como salvar uma rede ou um Passpoint configuração do Terraform.

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
        }
    }
}