नेटवर्क और पासपॉइंट कॉन्फ़िगरेशन सेव करें

Android 11 (एसडीके लेवल 30) और उसके बाद के वर्शन पर, ऐप्लिकेशन android.provider.Settings.ACTION_WIFI_ADD_NETWORKS इंटेंट का इस्तेमाल कर सकते हैं. इससे उपयोगकर्ता को एक या उससे ज़्यादा नए सेव किए गए नेटवर्क या Passpoint कॉन्फ़िगरेशन जोड़ने में मदद मिलती है. यह एपीआई, सेव किए गए मौजूदा कॉन्फ़िगरेशन में बदलाव करने के लिए भी काम करता है.

नेटवर्क या पासपॉइंट कॉन्फ़िगरेशन सेव करने के लिए, यह तरीका अपनाएं:

  1. ACTION_WIFI_ADD_NETWORKS इंटेंट बनाएं.

  2. WifiNetworkSuggestion.Builder का इस्तेमाल करके, एक या उससे ज़्यादा कॉन्फ़िगरेशन बनाएं. ध्यान दें कि WifiNetworkSuggestion का इस्तेमाल करने के बावजूद, यह Intent API, Suggestion API से जुड़ा नहीं है.

  3. कॉन्फ़िगरेशन की पार्सल की जा सकने वाली ऐरे सूची बनाएं और उसे EXTRA_WIFI_NETWORK_LIST एक्स्ट्रा के साथ इंटेंट से अटैच करें.

  4. Execute Activity.startActivityForResult(), passing in the intent.

  5. Activity.onActivityResult() कॉलबैक का इस्तेमाल करके, नतीजे सुनें.

    resultCode इनमें से कोई एक हो सकता है:

    • Activity.RESULT_OK: इससे पता चलता है कि उपयोगकर्ता ने सुझाए गए नेटवर्क स्वीकार कर लिए हैं और उन्हें सेव कर लिया है.
    • Activity.RESULT_CANCELED: इससे पता चलता है कि उपयोगकर्ता ने सुझाए गए नेटवर्क को अस्वीकार कर दिया है.

    अगर resultCode RESULT_OK है, तो डेटा Intent में EXTRA_WIFI_NETWORK_RESULT_LIST एक्स्ट्रा शामिल होता है. इसमें नतीजों के कोड की एक ऐसी सरणी होती है जिससे यह पता चलता है कि अलग-अलग कॉन्फ़िगरेशन सेव हुए हैं या नहीं. नतीजे के ये कोड हो सकते हैं:

    • ADD_WIFI_RESULT_SUCCESS: कॉन्फ़िगरेशन जोड़ा गया या अपडेट किया गया.
    • ADD_WIFI_RESULT_ADD_OR_UPDATE_FAILED: कॉन्फ़िगरेशन जोड़ने की कोशिश करते समय गड़बड़ी हुई. जैसे, कॉन्फ़िगरेशन का फ़ॉर्मैट सही न होने की वजह से गड़बड़ी हुई.
    • ADD_WIFI_RESULT_ALREADY_EXISTS: अनुरोध किया गया कॉन्फ़िगरेशन पहले से मौजूद था. इसलिए, कोई कार्रवाई ज़रूरी नहीं थी.

  6. अनुरोध पूरा होने पर, प्लैटफ़ॉर्म हाल ही में सेव किए गए किसी नेटवर्क से कनेक्शन ट्रिगर करता है.

कोड सैंपल

यहां दिए गए कोड के सैंपल में, नेटवर्क या Passpoint कॉन्फ़िगरेशन को सेव करने का तरीका बताया गया है.

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