Netzwerke und Passpoint-Konfigurationen speichern

Unter Android 11 (SDK-Level 30) und höher können Apps die android.provider.Settings.ACTION_WIFI_ADD_NETWORKS die Nutzer durch das Hinzufügen eines oder mehrerer neu gespeicherter Netzwerke oder Passpoint-Konfigurationen. Die API funktioniert auch unverändert, um vorhandene gespeicherte Konfigurationen.

Hinweis: Die Funktionalität dieser API entspricht am ehesten der eingestellten WifiManager.addNetwork(WifiConfiguration config)-API, da die resultierende wird die Konfiguration dem für Nutzer sichtbaren und verwalteten gespeicherten Netzwerk hinzugefügt Aboliste.

So speichern Sie eine Netzwerk- oder Passpoint-Konfiguration:

1. Erstellen Sie einen ACTION_WIFI_ADD_NETWORKS-Intent.

2. Erstellen Sie eine oder mehrere Konfigurationen mit WifiNetworkSuggestion.Builder Hinweis: Obwohl Sie eine WifiNetworkSuggestion verwenden, ist diese Intent API hat nichts mit der Suggestion API zu tun.

3. Erstellen Sie eine Liste mit parcelable-Arrays der Konfigurationen und hängen Sie sie an die Intent mit der EXTRA_WIFI_NETWORK_LIST extra.

4. Ausführen Activity.startActivityForResult(), der Intent übergeben wird.

5. Warte auf das Ergebnis mit der Activity.onActivityResult() Callback des Nutzers an.

   resultCode kann einer der folgenden Werte sein:

   • Activity.RESULT_OK: : Der Nutzer hat die vorgeschlagenen Netzwerke akzeptiert und gespeichert.
   • Activity.RESULT_CANCELED: , dass der Nutzer die vorgeschlagenen Netzwerke abgelehnt hat.

   Wenn resultCode auf RESULT_OK gesetzt ist, enthalten die Daten Intent die EXTRA_WIFI_NETWORK_RESULT_LIST Extra, das ein Array von Ergebniscodes enthält, die angeben, ob einzelne Konfigurationen wurden gespeichert. Mögliche Ergebniscodes sind:

   • ADD_WIFI_RESULT_SUCCESS: Konfiguration hinzugefügt oder erfolgreich aktualisiert.
   • ADD_WIFI_RESULT_ADD_OR_UPDATE_FAILED: Fehler beim Hinzufügen der Konfiguration, z. B. aufgrund einer falsch formatierten Konfiguration.
   • ADD_WIFI_RESULT_ALREADY_EXISTS: Die angeforderte Konfiguration war bereits vorhanden, sodass keine Aktion erforderlich war.

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

Codebeispiel

Das folgende Codebeispiel zeigt, wie ein Netzwerk oder ein Passpoint gespeichert wird Konfiguration.

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