في نظام التشغيل Android 11 (المستوى 30 لواجهة برمجة التطبيقات) والإصدارات الأحدث، يمكن للتطبيقات استخدام الغرض
android.provider.Settings.ACTION_WIFI_ADD_NETWORKS
لتوجيه المستخدم خلال عملية إضافة شبكة واحدة أو أكثر من الشبكات المحفوظة الجديدة أو
إعدادات Passpoint. تعمل واجهة برمجة التطبيقات أيضًا كما هي لتعديل الإعدادات المحفوظة الحالية.
لحفظ شبكة أو إعدادات Passpoint، اتّبِع الخطوات التالية:
أنشئ
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: كانت الإعدادات المطلوبة متوفّرة من قبل، لذا لم يكن من الضروري اتّخاذ أي إجراء.
-
في حال نجاح الطلب، ستفعّل المنصة عملية ربط بإحدى الشبكات التي تم حفظها حديثًا.
عيّنة تعليمات برمجية
يوضّح نموذج الرمز البرمجي التالي كيفية حفظ إعدادات شبكة أو 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
}
}
}