Ağları ve Passpoint yapılandırmalarını kaydedin

Android 11 (SDK düzeyi 30) ve sonraki sürümlerde uygulamalar, kullanıcıya bir veya daha fazla yeni kayıtlı ağ ya da Passpoint yapılandırması ekleme konusunda yol göstermek için android.provider.Settings.ACTION_WIFI_ADD_NETWORKS niyetini kullanabilir. API, mevcut kayıtlı yapılandırmaları değiştirmek için de olduğu gibi çalışır.

Not: Bu API, işlevsel olarak desteği sonlandırılan WifiManager.addNetwork(WifiConfiguration config) API'ye en yakın API'dir. Sonuç olarak elde edilen yapılandırma, kullanıcıya yönelik ve yönetilen kayıtlı ağ ve abonelik listesine eklenir.

Bir ağ veya Passpoint yapılandırmasını kaydetmek için aşağıdakileri yapın:

1. ACTION_WIFI_ADD_NETWORKS amacı oluşturun.

2. WifiNetworkSuggestion.Builder kullanarak bir veya daha fazla yapılandırma oluşturun. WifiNetworkSuggestion kullansanız bile bu Intent API'nin Suggestion API ile alakalı olmadığını unutmayın.

3. Yapılandırmaların ayrıştırılabilir bir dizi listesini oluşturun ve EXTRA_WIFI_NETWORK_LIST ekstrasıyla bu listeyi amaca ekleyin.

4. Niyeti ileterek Activity.startActivityForResult()'i yürütün.

5. Activity.onActivityResult() geri çağırma işlevini kullanarak sonucu dinleyin.

   resultCode şunlardan biri olabilir:

   • Activity.RESULT_OK: Kullanıcının önerilen ağları kabul edip kaydettiğini gösterir.
   • Activity.RESULT_CANCELED: Kullanıcı tarafından önerilen ağların reddedildiğini gösterir.

   resultCode RESULT_OK ise Intent verileri, ayrı yapılandırmaların başarıyla kaydedilip kaydedilmediğini belirten bir sonuç kodu dizisi içeren EXTRA_WIFI_NETWORK_RESULT_LIST ekstrasını içerir. Olası sonuç kodları şunlardır:

   • ADD_WIFI_RESULT_SUCCESS: Yapılandırması eklendi veya başarıyla güncellendi.
   • ADD_WIFI_RESULT_ADD_OR_UPDATE_FAILED: Yapılandırma eklemeye çalışırken (ör. hatalı oluşturulmuş bir yapılandırma nedeniyle) hata oluştu.
   • ADD_WIFI_RESULT_ALREADY_EXISTS: istenen yapılandırma zaten mevcut olduğundan herhangi bir işlem yapılması gerekmedi.

6. İstek başarılı olursa platform, yeni kaydedilen ağlardan birine bağlantı oluşturur.

Kod örneği

Aşağıdaki kod örneğinde, bir ağın veya Passpoint yapılandırmasının nasıl kaydedileceği gösterilmektedir.

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