Na urządzeniach z Androidem 10 (poziom interfejsu API 29) lub nowszym możesz używać nowego interfejsu API peer-to-peer do uruchamiania konfiguracji urządzeń dodatkowych, takich jak Chromecast i sprzęt Google Home. Ta funkcja umożliwia aplikacji wyświetlanie użytkownikowi prośby o zmianę punktu dostępu, z którym urządzenie jest połączone, za pomocą WifiNetworkSpecifier do opisywania właściwości żądanej sieci.
Aby użyć tego interfejsu API, wykonaj te czynności:
Utwórz specyfikator sieci Wi-Fi za pomocą
WifiNetworkSpecifier.Builder.Ustaw filtr sieci, aby dopasować sieci, z którymi chcesz się połączyć, oraz wymagane dane logowania.
Wybierz kombinację parametrów
SSID,SSID pattern,BSSIDiBSSID pattern, aby ustawić filtr sieci w każdym żądaniu, z uwzględnieniem tych wymagań:- Każda prośba powinna zawierać co najmniej jeden z tych parametrów:
SSID,SSID pattern,BSSIDlubBSSID pattern - W każdym żądaniu można ustawić tylko
SSIDlubSSID pattern - W każdym żądaniu można ustawić tylko
BSSIDlubBSSID pattern
- Każda prośba powinna zawierać co najmniej jeden z tych parametrów:
Dodaj specyfikatory do żądania sieciowego wraz z instancją
NetworkCallback, aby śledzić stan żądania.Jeśli użytkownik zaakceptuje prośbę i połączenie z siecią zostanie nawiązane, w obiekcie wywołania zwrotnego zostanie wywołana metoda
NetworkCallback.onAvailable(). Jeśli użytkownik odrzuci prośbę lub połączenie z siecią się nie powiedzie, w obiekcie wywołania zwrotnego zostanie wywołana metodaNetworkCallback.onUnavailable().
Rozpoczęcie prośby o połączenie z urządzeniem równorzędnym powoduje wyświetlenie na tym urządzeniu okna, w którym użytkownik może zaakceptować prośbę o połączenie.
Pominięcie zatwierdzenia przez użytkownika
Gdy użytkownik zatwierdzi sieć, z którą chce się połączyć, w odpowiedzi na prośbę z określonej aplikacji, urządzenie zapisze zgodę na dany punkt dostępu. Jeśli aplikacja wyśle konkretną prośbę o ponowne połączenie z tym punktem dostępu, urządzenie pominie etap zatwierdzania przez użytkownika i automatycznie połączy się z siecią. Jeśli użytkownik zdecyduje się zapomnieć sieć, gdy jest połączony z siecią, o którą prosi interfejs API, zapisana zgoda na tę kombinację aplikacji i sieci zostanie usunięta, a każda przyszła prośba z aplikacji będzie musiała zostać ponownie zatwierdzona przez użytkownika. Jeśli aplikacja wysyła niesprecyzowane żądanie, np. ze wzorcem SSID lub BSSID, użytkownik musi je zatwierdzić.
Przykładowy kod
Poniższy przykładowy kod pokazuje, jak połączyć się z siecią otwartą z prefiksem SSID "test" i identyfikatorem 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);