ב-Android מגרסה 11 (SDK ברמה 30) ואילך, אפליקציות יכולות להשתמש
android.provider.Settings.ACTION_WIFI_ADD_NETWORKS
כוונה להדריך את המשתמש איך להוסיף רשת שמורה אחת או יותר, או
הגדרות Passpoint. ה-API פועל גם כפי שהוא כדי לשנות פריטים שמורים קיימים
הגדרות אישיות.
כדי לשמור הגדרות רשת או Passpoint, מבצעים את הפעולות הבאות:
צריך ליצור Intent מסוג
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
}
}
}