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