নেটওয়ার্ক এবং পাসপয়েন্ট কনফিগারেশন সংরক্ষণ করুন

অ্যান্ড্রয়েড ১১ (এসডিকে লেভেল ৩০) এবং এর পরবর্তী সংস্করণগুলোতে, অ্যাপগুলো ব্যবহারকারীকে এক বা একাধিক নতুন সংরক্ষিত নেটওয়ার্ক বা পাসপয়েন্ট কনফিগারেশন যোগ করার জন্য নির্দেশনা দিতে android.provider.Settings.ACTION_WIFI_ADD_NETWORKS ইন্টেন্টটি ব্যবহার করতে পারে। বিদ্যমান সংরক্ষিত কনফিগারেশনগুলো পরিবর্তন করার জন্যও এই এপিআইটি সরাসরি কাজ করে।

নেটওয়ার্ক বা পাসপয়েন্ট কনফিগারেশন সংরক্ষণ করতে, নিম্নলিখিতগুলি করুন:

  1. একটি ACTION_WIFI_ADD_NETWORKS ইন্টেন্ট তৈরি করুন।

  2. WifiNetworkSuggestion.Builder ব্যবহার করে এক বা একাধিক কনফিগারেশন তৈরি করুন। মনে রাখবেন যে, যদিও আপনি একটি WifiNetworkSuggestion ব্যবহার করছেন, এই Intent API-টি Suggestion API-এর সাথে সম্পর্কিত নয়।

  3. কনফিগারেশনগুলোর একটি পার্সেলযোগ্য অ্যারে লিস্ট তৈরি করুন এবং EXTRA_WIFI_NETWORK_LIST এক্সট্রা ব্যবহার করে এটিকে ইন্টেন্টের সাথে সংযুক্ত করুন।

  4. ইন্টেন্টটি পাস করে Activity.startActivityForResult() এক্সিকিউট করুন।

  5. Activity.onActivityResult() কলব্যাক ব্যবহার করে ফলাফলের জন্য অপেক্ষা করুন।

    resultCode নিম্নলিখিতগুলির মধ্যে একটি হতে পারে:

    • Activity.RESULT_OK : যা নির্দেশ করে যে ব্যবহারকারী প্রস্তাবিত নেটওয়ার্কগুলো গ্রহণ করেছেন এবং সংরক্ষণ করেছেন।
    • Activity.RESULT_CANCELED : যা নির্দেশ করে যে ব্যবহারকারী প্রস্তাবিত নেটওয়ার্কগুলো প্রত্যাখ্যান করেছেন।

    যদি resultCode RESULT_OK হয়, তাহলে data Intent EXTRA_WIFI_NETWORK_RESULT_LIST নামক একটি এক্সট্রা থাকে, যার মধ্যে রেজাল্ট কোডগুলোর একটি অ্যারে থাকে যা নির্দেশ করে যে স্বতন্ত্র কনফিগারেশনগুলো সফলভাবে সংরক্ষিত হয়েছে কিনা। সম্ভাব্য রেজাল্ট কোডগুলো হলো:

    • ADD_WIFI_RESULT_SUCCESS : কনফিগারেশন যোগ করা হয়েছে বা সফলভাবে আপডেট করা হয়েছে।
    • ADD_WIFI_RESULT_ADD_OR_UPDATE_FAILED : কনফিগারেশন যোগ করার চেষ্টাকালে ব্যর্থতা, যেমন ত্রুটিপূর্ণ কনফিগারেশনের কারণে।
    • ADD_WIFI_RESULT_ALREADY_EXISTS : অনুরোধ করা কনফিগারেশনটি আগে থেকেই বিদ্যমান ছিল, তাই কোনো পদক্ষেপ নেওয়ার প্রয়োজন ছিল না।
  6. অনুরোধটি সফল হলে, প্ল্যাটফর্মটি নতুন সংরক্ষিত নেটওয়ার্কগুলোর একটির সাথে সংযোগ স্থাপন করে।

কোডের নমুনা

নিম্নলিখিত কোড নমুনাটি দেখায় কিভাবে একটি নেটওয়ার্ক বা পাসপয়েন্ট কনফিগারেশন সংরক্ষণ করতে হয়।

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