Netzwerke und Passpoint-Konfigurationen speichern

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

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. Auch wenn Sie WifiNetworkSuggestion verwenden, ist diese Intent-API nicht mit der Suggestion API verknüpft.

  3. Erstellen Sie eine Parcelable-Array-Liste der Konfigurationen und fügen Sie sie mit dem Extra EXTRA_WIFI_NETWORK_LIST an den Intent an.

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

  5. Verwenden Sie den Activity.onActivityResult() Callback, um auf das Ergebnis zu warten.

    Der resultCode kann einer der folgenden Werte sein:

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

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

Codebeispiel

Das folgende Codebeispiel zeigt, wie Sie eine Netzwerk- oder Passpoint-Konfiguration speichern.

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