במכשירים עם Android 10 (רמת API 29) ומעלה, אפשר להשתמש ב-API חדש מסוג Peer-to-Peer כדי להגדיר מכשירים משניים כמו Chromecast וחומרה של Google Home. התכונה הזו מאפשרת לאפליקציה לבקש מהמשתמש לשנות את נקודת הגישה שהמכשיר מחובר אליה באמצעות WifiNetworkSpecifier כדי לתאר את המאפיינים של הרשת המבוקשת.
כדי להשתמש ב-API הזה:
יוצרים מפרט של רשת Wi-Fi באמצעות
WifiNetworkSpecifier.Builder.מגדירים מסנן רשת כדי להתאים רשתות להתחברות, יחד עם פרטי הכניסה הנדרשים.
כדי להגדיר את מסנן הרשת בכל בקשה, צריך לבחור שילוב של
SSID,SSID pattern,BSSIDו-BSSID pattern, בכפוף לדרישות הבאות:- כל בקשה צריכה לכלול לפחות אחד מהשדות הבאים:
SSID,SSID pattern,BSSIDאוBSSID pattern - בכל בקשה אפשר להגדיר רק את
SSIDאו אתSSID pattern - בכל בקשה אפשר להגדיר רק את
BSSIDאו אתBSSID pattern
- כל בקשה צריכה לכלול לפחות אחד מהשדות הבאים:
מוסיפים את המאפיינים לבקשה לאחזור מהרשת יחד עם מופע של
NetworkCallbackכדי לעקוב אחרי סטטוס הבקשה.אם המשתמש מאשר את הבקשה והחיבור לרשת מצליח, מתבצעת קריאה ל-
NetworkCallback.onAvailable()באובייקט ה-callback. אם המשתמש דוחה את הבקשה או אם החיבור לרשת נכשל, מתבצעת קריאה ל-NetworkCallback.onUnavailable()באובייקט ה-callback.
כשמפעילים את הבקשה להתחבר למכשיר מקביל, נפתחת תיבת דו-שיח באותו מכשיר, שדרכה המשתמש במכשיר יכול לאשר את בקשת החיבור.
עקיפת אישור המשתמש
אחרי שהמשתמש מאשר חיבור לרשת בתגובה לבקשה מאפליקציה ספציפית, המכשיר שומר את האישור לנקודת הגישה הספציפית. אם האפליקציה שולחת בקשה ספציפית להתחבר שוב לנקודת הגישה הזו, המכשיר מדלג על שלב אישור המשתמש ומתחבר אוטומטית לרשת. אם המשתמש בוחר לשכוח את הרשת בזמן שהוא מחובר לרשת שהתבקשה על ידי ה-API, האישור השמור לשילוב הזה של האפליקציה והרשת יוסר, וכל בקשה עתידית מהאפליקציה תצטרך לקבל שוב את אישור המשתמש. אם האפליקציה שולחת בקשה לא ספציפית, למשל עם תבנית SSID או BSSID, המשתמש צריך לאשר את הבקשה.
דוגמת קוד
דוגמת הקוד הבאה מראה איך להתחבר לרשת פתוחה עם קידומת SSID של "test" ו-BSSID OUI של "10:03:23":
Kotlin
val specifier = WifiNetworkSpecifier.Builder()
.setSsidPattern(PatternMatcher("test", PatternMatcher.PATTERN_PREFIX))
.setBssidPattern(MacAddress.fromString("10:03:23:00:00:00"), MacAddress.fromString("ff:ff:ff:00:00:00"))
.build()
val request = NetworkRequest.Builder()
.addTransportType(NetworkCapabilities.TRANSPORT_WIFI)
.removeCapability(NetworkCapabilities.NET_CAPABILITY_INTERNET)
.setNetworkSpecifier(specifier)
.build()
val connectivityManager = context.getSystemService(Context.CONNECTIVITY_SERVICE) as ConnectivityManager
val networkCallback = object : ConnectivityManager.NetworkCallback() {
...
override fun onAvailable(network: Network?) {
// do success processing here..
}
override fun onUnavailable() {
// do failure processing here..
}
...
}
connectivityManager.requestNetwork(request, networkCallback)
...
// Release the request when done.
connectivityManager.unregisterNetworkCallback(networkCallback)
Java
final NetworkSpecifier specifier =
new WifiNetworkSpecifier.Builder()
.setSsidPattern(new PatternMatcher("test", PatternMatcher.PATTERN_PREFIX))
.setBssidPattern(MacAddress.fromString("10:03:23:00:00:00"), MacAddress.fromString("ff:ff:ff:00:00:00"))
.build();
final NetworkRequest request =
new NetworkRequest.Builder()
.addTransportType(NetworkCapabilities.TRANSPORT_WIFI)
.removeCapability(NetworkCapabilities.NET_CAPABILITY_INTERNET)
.setNetworkSpecifier(specifier)
.build();
final ConnectivityManager connectivityManager = (ConnectivityManager)
context.getSystemService(Context.CONNECTIVITY_SERVICE);
final NetworkCallback networkCallback = new NetworkCallback() {
...
@Override
void onAvailable(...) {
// do success processing here..
}
@Override
void onUnavailable(...) {
// do failure processing here..
}
...
};
connectivityManager.requestNetwork(request, networkCallback);
...
// Release the request when done.
connectivityManager.unregisterNetworkCallback(networkCallback);