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

Android 11 (SDK düzeyi 30) ve sonraki sürümlerde uygulamalar android.provider.Settings.ACTION_WIFI_ADD_NETWORKS bir veya daha fazla yeni kayıtlı ağ ekleme veya Passpoint yapılandırmaları. API, mevcut kayıtlı öğeleri değiştirmek için olduğu gibi yapılandırmanın üç yolu vardır.

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

  1. ACTION_WIFI_ADD_NETWORKS niyeti oluşturun.

  2. Şunu kullanarak bir veya daha fazla yapılandırma oluşturun: WifiNetworkSuggestion.Builder. WifiNetworkSuggestion kullansanız bile bu Intent API'nin Öneri API'si ile ilgili değildir.

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

  4. Yürütme Activity.startActivityForResult() kısa bir ifadedir.

  5. Sonucu şunu kullanarak dinleyin: Activity.onActivityResult() geri arama.

    resultCode şunlardan biri olabilir:

    resultCode değeri RESULT_OK ise Intent verileri şunları içerir: EXTRA_WIFI_NETWORK_RESULT_LIST ekstra (ekstra), tekil kullanıcıların yapılandırma başarıyla kaydedildi. Olası sonuç kodları şunlardır:

  6. İstek başarılı olursa platform, yeni kaydedilen ağlar.

Kod örneği

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

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