অ্যান্ড্রয়েড ১১ (SDK লেভেল ৩০) এবং তার উচ্চতর সংস্করণে, অ্যাপগুলি android.provider.Settings.ACTION_WIFI_ADD_NETWORKS ব্যবহার করে ব্যবহারকারীকে এক বা একাধিক নতুন সংরক্ষিত নেটওয়ার্ক বা পাসপয়েন্ট কনফিগারেশন যোগ করার মাধ্যমে গাইড করতে পারে। API বিদ্যমান সংরক্ষিত কনফিগারেশনগুলি পরিবর্তন করার জন্যও যেমন আছে তেমন কাজ করে।
একটি নেটওয়ার্ক বা পাসপয়েন্ট কনফিগারেশন সংরক্ষণ করতে, নিম্নলিখিতগুলি করুন:
একটি
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: ব্যবহারকারী প্রস্তাবিত নেটওয়ার্কগুলি প্রত্যাখ্যান করেছেন তা নির্দেশ করে।
যদি
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: অনুরোধ করা কনফিগারেশনটি ইতিমধ্যেই বিদ্যমান ছিল তাই কোনও পদক্ষেপ নেওয়ার প্রয়োজন ছিল না।
-
যদি অনুরোধটি সফল হয়, তাহলে প্ল্যাটফর্মটি নতুন সংরক্ষিত নেটওয়ার্কগুলির একটিতে সংযোগ চালু করবে।
কোড নমুনা
নিম্নলিখিত কোড নমুনাটি দেখায় কিভাবে একটি নেটওয়ার্ক বা পাসপয়েন্ট কনফিগারেশন সংরক্ষণ করতে হয়।
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
}
}
}