অ্যান্ড্রয়েড ১১ (এসডিকে লেভেল ৩০) এবং এর পরবর্তী সংস্করণগুলোতে, অ্যাপগুলো ব্যবহারকারীকে এক বা একাধিক নতুন সংরক্ষিত নেটওয়ার্ক বা পাসপয়েন্ট কনফিগারেশন যোগ করার জন্য নির্দেশনা দিতে android.provider.Settings.ACTION_WIFI_ADD_NETWORKS ইন্টেন্টটি ব্যবহার করতে পারে। বিদ্যমান সংরক্ষিত কনফিগারেশনগুলো পরিবর্তন করার জন্যও এই এপিআইটি সরাসরি কাজ করে।
নেটওয়ার্ক বা পাসপয়েন্ট কনফিগারেশন সংরক্ষণ করতে, নিম্নলিখিতগুলি করুন:
একটি
ACTION_WIFI_ADD_NETWORKSইন্টেন্ট তৈরি করুন।WifiNetworkSuggestion.Builderব্যবহার করে এক বা একাধিক কনফিগারেশন তৈরি করুন। মনে রাখবেন যে, যদিও আপনি একটিWifiNetworkSuggestionব্যবহার করছেন, এই Intent API-টি Suggestion API-এর সাথে সম্পর্কিত নয়।কনফিগারেশনগুলোর একটি পার্সেলযোগ্য অ্যারে লিস্ট তৈরি করুন এবং
EXTRA_WIFI_NETWORK_LISTএক্সট্রা ব্যবহার করে এটিকে ইন্টেন্টের সাথে সংযুক্ত করুন।ইন্টেন্টটি পাস করে
Activity.startActivityForResult()এক্সিকিউট করুন।Activity.onActivityResult()কলব্যাক ব্যবহার করে ফলাফলের জন্য অপেক্ষা করুন।resultCodeনিম্নলিখিতগুলির মধ্যে একটি হতে পারে:-
Activity.RESULT_OK: যা নির্দেশ করে যে ব্যবহারকারী প্রস্তাবিত নেটওয়ার্কগুলো গ্রহণ করেছেন এবং সংরক্ষণ করেছেন। -
Activity.RESULT_CANCELED: যা নির্দেশ করে যে ব্যবহারকারী প্রস্তাবিত নেটওয়ার্কগুলো প্রত্যাখ্যান করেছেন।
যদি
resultCodeRESULT_OKহয়, তাহলে dataIntentEXTRA_WIFI_NETWORK_RESULT_LISTনামক একটি এক্সট্রা থাকে, যার মধ্যে রেজাল্ট কোডগুলোর একটি অ্যারে থাকে যা নির্দেশ করে যে স্বতন্ত্র কনফিগারেশনগুলো সফলভাবে সংরক্ষিত হয়েছে কিনা। সম্ভাব্য রেজাল্ট কোডগুলো হলো:-
ADD_WIFI_RESULT_SUCCESS: কনফিগারেশন যোগ করা হয়েছে বা সফলভাবে আপডেট করা হয়েছে। -
ADD_WIFI_RESULT_ADD_OR_UPDATE_FAILED: কনফিগারেশন যোগ করার চেষ্টাকালে ব্যর্থতা, যেমন ত্রুটিপূর্ণ কনফিগারেশনের কারণে। -
ADD_WIFI_RESULT_ALREADY_EXISTS: অনুরোধ করা কনফিগারেশনটি আগে থেকেই বিদ্যমান ছিল, তাই কোনো পদক্ষেপ নেওয়ার প্রয়োজন ছিল না।
-
অনুরোধটি সফল হলে, প্ল্যাটফর্মটি নতুন সংরক্ষিত নেটওয়ার্কগুলোর একটির সাথে সংযোগ স্থাপন করে।
কোডের নমুনা
নিম্নলিখিত কোড নমুনাটি দেখায় কিভাবে একটি নেটওয়ার্ক বা পাসপয়েন্ট কনফিগারেশন সংরক্ষণ করতে হয়।
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
}
}
}