ב-Android מגרסה 11 (רמת SDK 30) ואילך, אפליקציות יכולות להשתמש ב-intent android.provider.Settings.ACTION_WIFI_ADD_NETWORKS כדי להנחות את המשתמש בתהליך של הוספת רשתות שמורות חדשות או הגדרות Passpoint. בנוסף, אפשר להשתמש ב-API כמו שהוא כדי לשנות הגדרות קיימות שנשמרו.
כדי לשמור הגדרה של רשת או של Passpoint:
יוצרים כוונה
ACTION_WIFI_ADD_NETWORKS.יוצרים הגדרה אחת או יותר באמצעות
WifiNetworkSuggestion.Builder. שימו לב: למרות שאתם משתמשים ב-WifiNetworkSuggestion, ממשק Intent API הזה לא קשור ל-Suggestion API.יוצרים רשימת מערכים שניתנת להעברה של ההגדרות ומצרפים אותה ל-intent באמצעות התוסף
EXTRA_WIFI_NETWORK_LIST.מריצים את הפקודה
Activity.startActivityForResult()ומעבירים את הכוונה.מאזינים לתוצאה באמצעות הקריאה החוזרת (callback)
Activity.onActivityResult().הערך
resultCodeיכול להיות אחד מהבאים:-
Activity.RESULT_OK: מציין שהמשתמש אישר את הרשתות המוצעות ושמר אותן. -
Activity.RESULT_CANCELED: מציין שהמשתמש דחה את הרשתות המוצעות.
אם הערך של
resultCodeהואRESULT_OK, הנתוניםIntentמכילים אתEXTRA_WIFI_NETWORK_RESULT_LISTextra, שמכיל מערך של קודי תוצאות שמציינים אם ההגדרות האישיות נשמרו בהצלחה. אלה קודי התוצאה האפשריים:-
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
}
}
}