Netzwerke und Passpoint-Konfigurationen speichern

Unter Android 11 (SDK-Ebene 30) und höher können Apps den Intent android.provider.Settings.ACTION_WIFI_ADD_NETWORKS verwenden, um Nutzer durch das Hinzufügen eines oder mehrerer neuer gespeicherter Netzwerke oder Passpoint-Konfigurationen zu führen. Die API kann auch verwendet werden, um vorhandene gespeicherte Konfigurationen zu ändern.

Hinweis: Diese API kommt der eingestellten WifiManager.addNetwork(WifiConfiguration config) API am nächsten, da die resultierende Konfiguration der nutzerseitigen und verwalteten Liste der gespeicherten Netzwerke und Abos hinzugefügt wird.

So speichern Sie eine Netzwerk- oder Passpoint-Konfiguration:

1. Erstellen Sie einen ACTION_WIFI_ADD_NETWORKS-Intent.

2. Erstellen Sie mit WifiNetworkSuggestion.Builder eine oder mehrere Konfigurationen. Auch wenn Sie einen WifiNetworkSuggestion verwenden, hat diese Intent API nichts mit der Suggestion API zu tun.

3. Erstellen Sie eine parzellierbare Arrayliste der Konfigurationen und hängen Sie sie mit dem Extra EXTRA_WIFI_NETWORK_LIST an die Intent an.

4. Führen Sie Activity.startActivityForResult() aus und übergeben Sie den Intent.

5. Mit dem Callback Activity.onActivityResult() auf das Ergebnis warten

   resultCode kann einer der folgenden Werte sein:

   • Activity.RESULT_OK: Das bedeutet, dass der Nutzer die vorgeschlagenen Netzwerke akzeptiert und gespeichert hat.
   • Activity.RESULT_CANCELED: Gibt an, dass der Nutzer die vorgeschlagenen Netzwerke abgelehnt hat.

   Wenn resultCode den Wert RESULT_OK hat, enthält das Datenelement Intent das Extra EXTRA_WIFI_NETWORK_RESULT_LIST. Dieses enthält ein Array mit Ergebniscodes, die angeben, ob einzelne Konfigurationen erfolgreich gespeichert wurden. Mögliche Ergebniscodes:

   • ADD_WIFI_RESULT_SUCCESS: Konfiguration hinzugefügt oder erfolgreich aktualisiert.
   • ADD_WIFI_RESULT_ADD_OR_UPDATE_FAILED: Beim Versuch, eine Konfiguration hinzuzufügen, ist ein Fehler aufgetreten, z. B. aufgrund einer fehlerhaften Konfiguration.
   • ADD_WIFI_RESULT_ALREADY_EXISTS: Die angeforderte Konfiguration existierte bereits, sodass keine Maßnahmen erforderlich waren.

6. Wenn die Anfrage erfolgreich ist, löst die Plattform eine Verbindung zu einem der neu gespeicherten Netzwerke aus.

Codebeispiel

Im folgenden Codebeispiel wird gezeigt, wie eine Netzwerk- oder Passpoint-Konfiguration gespeichert wird.

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