Aby uzyskać listę punktów dostępu Wi-Fi, które są widoczne na urządzeniu, możesz użyć funkcji skanowania Wi-Fi dostępnej w Wi-Manager API.
Proces skanowania Wi-Fi
Proces skanowania składa się z 3 etapów:
Zarejestruj detektor transmisji w usłudze
SCAN_RESULTS_AVAILABLE_ACTION
, która jest wywoływana po zrealizowaniu żądań skanowania i z informacją o ich stanie powodzenia lub niepowodzenia. W przypadku urządzeń z Androidem 10 (poziom interfejsu API 29) lub nowszym ta transmisja będzie wysyłana w przypadku każdego pełnego skanowania Wi-Fi wykonanego na urządzeniu przez platformę lub inne aplikacje. Aplikacje mogą pasywnie nasłuchiwać wszystkich ukończonych skanowania na urządzeniu, wykorzystując transmisję bez skanowania własnych urządzeń.Wyślij prośbę o skanowanie za pomocą
WifiManager.startScan()
. Sprawdź stan zwrotu metody, ponieważ wywołanie może się nie powieść z tych powodów:- Żądania skanowania mogą być ograniczane z powodu zbyt wielu skanowań w krótkim czasie.
- Urządzenie jest nieaktywne, a skanowanie jest wyłączone.
- Sprzęt Wi-Fi zgłasza błąd skanowania.
Pobierz wyniki skanowania za pomocą
WifiManager.getScanResults()
. Zwrócone wyniki skanowania to najnowsze zaktualizowane wyniki. Mogą one pochodzić z poprzedniego skanowania, jeśli bieżące skanowanie nie zostało ukończone lub zakończyło się powodzeniem. Oznacza to, że możesz uzyskać starsze wyniki skanowania, jeśli wywołasz tę metodę przed odebraniem pomyślnej transmisjiSCAN_RESULTS_AVAILABLE_ACTION
.
Poniżej znajduje się przykład implementacji tych czynności:
Kotlin
val wifiManager = context.getSystemService(Context.WIFI_SERVICE) as WifiManager val wifiScanReceiver = object : BroadcastReceiver() { override fun onReceive(context: Context, intent: Intent) { val success = intent.getBooleanExtra(WifiManager.EXTRA_RESULTS_UPDATED, false) if (success) { scanSuccess() } else { scanFailure() } } } val intentFilter = IntentFilter() intentFilter.addAction(WifiManager.SCAN_RESULTS_AVAILABLE_ACTION) context.registerReceiver(wifiScanReceiver, intentFilter) val success = wifiManager.startScan() if (!success) { // scan failure handling scanFailure() } .... private fun scanSuccess() { val results = wifiManager.scanResults ... use new scan results ... } private fun scanFailure() { // handle failure: new scan did NOT succeed // consider using old scan results: these are the OLD results! val results = wifiManager.scanResults ... potentially use older scan results ... }
Java
WifiManager wifiManager = (WifiManager) context.getSystemService(Context.WIFI_SERVICE); BroadcastReceiver wifiScanReceiver = new BroadcastReceiver() { @Override public void onReceive(Context c, Intent intent) { boolean success = intent.getBooleanExtra( WifiManager.EXTRA_RESULTS_UPDATED, false); if (success) { scanSuccess(); } else { // scan failure handling scanFailure(); } } }; IntentFilter intentFilter = new IntentFilter(); intentFilter.addAction(WifiManager.SCAN_RESULTS_AVAILABLE_ACTION); context.registerReceiver(wifiScanReceiver, intentFilter); boolean success = wifiManager.startScan(); if (!success) { // scan failure handling scanFailure(); } .... private void scanSuccess() { List<ScanResult> results = wifiManager.getScanResults(); ... use new scan results ... } private void scanFailure() { // handle failure: new scan did NOT succeed // consider using old scan results: these are the OLD results! List<ScanResult> results = wifiManager.getScanResults(); ... potentially use older scan results ... }
Ograniczenia
W Androidzie 8.0 (poziom interfejsu API 26) wprowadzono ograniczenia dotyczące uprawnień i dopuszczalnej częstotliwości skanowania Wi-Fi.
Aby poprawić wydajność sieci, bezpieczeństwo i żywotność baterii, Android 9 (poziom interfejsu API 28) zaostrzał wymagania dotyczące uprawnień i jeszcze bardziej ograniczył częstotliwość skanowania Wi-Fi.
Uprawnienia
Android 8.0 i Android 8.1:
Udane wywołanie do WifiManager.getScanResults()
wymaga dowolnego z tych uprawnień:
Jeśli aplikacja do połączeń nie ma żadnego z tych uprawnień, wywołanie zakończy się niepowodzeniem z komunikatem SecurityException
.
Na urządzeniach z Androidem 8.0 (poziom interfejsu API 26) lub nowszym możesz też użyć interfejsu CompanionDeviceManager
, aby przeskanować urządzenia towarzyszące w pobliżu w imieniu aplikacji bez wymagania dostępu do lokalizacji. Więcej informacji o tej opcji znajdziesz w artykule Parowanie urządzeń towarzyszących.
Android 9:
Udane wywołanie do WifiManager.startScan()
wymaga spełnienia wszystkich tych warunków:
- Twoja aplikacja ma uprawnienie
ACCESS_FINE_LOCATION
lubACCESS_COARSE_LOCATION
. - Twoja aplikacja ma uprawnienie
CHANGE_WIFI_STATE
. - Usługi lokalizacyjne są włączone na urządzeniu (w sekcji Ustawienia > Lokalizacja).
Android 10 (poziom interfejsu API 29) i nowszy:
Udane wywołanie do WifiManager.startScan()
wymaga spełnienia wszystkich tych warunków:
- Jeśli Twoja aplikacja jest kierowana na pakiet SDK na Androida 10 (poziom interfejsu API 29) lub nowszego, ma ona uprawnienia
ACCESS_FINE_LOCATION
. - Jeśli aplikacja jest kierowana na pakiet SDK niższy niż Android 10 (poziom interfejsu API 29), ma ona uprawnienia
ACCESS_COARSE_LOCATION
lubACCESS_FINE_LOCATION
. - Twoja aplikacja ma uprawnienie
CHANGE_WIFI_STATE
. - Usługi lokalizacyjne są włączone na urządzeniu (w sekcji Ustawienia > Lokalizacja).
Aby wywołać metodę WifiManager.getScanResults()
, upewnij się, że są spełnione wszystkie te warunki:
- Jeśli Twoja aplikacja jest kierowana na pakiet SDK na Androida 10 (poziom interfejsu API 29) lub nowszego, ma uprawnienie
ACCESS_FINE_LOCATION
. - Jeśli aplikacja jest kierowana na pakiet SDK starszego typu niż Android 10 (poziom interfejsu API 29), ma ona uprawnienie
ACCESS_COARSE_LOCATION
lubACCESS_FINE_LOCATION
. - Twoja aplikacja ma uprawnienie
ACCESS_WIFI_STATE
. - Usługi lokalizacyjne są włączone na urządzeniu (w sekcji Ustawienia > Lokalizacja).
Jeśli aplikacja do wykonywania połączeń nie spełnia wszystkich tych wymagań, połączenie zakończy się niepowodzeniem i pojawi się SecurityException
.
Ograniczanie
Podane niżej ograniczenia mają zastosowanie do częstotliwości skanowania z użyciem WifiManager.startScan()
.
Android 8.0 i Android 8.1:
Każda aplikacja w tle może przeskanować urządzenie 1 raz na 30 minut.
Android 9:
Każda aplikacja na pierwszym planie może przeprowadzać skanowanie 4 razy w ciągu 2 minut. Pozwala to na wykonanie serii skanowań w krótkim czasie.
Wszystkie aplikacje działające w tle łącznie mogą skanować je raz w ciągu 30 minut.
Android 10 lub nowszy:
Obowiązują te same limity ograniczeń co w Androidzie 9. Dostępna jest nowa opcja dla programistów, która umożliwia wyłączenie ograniczenia na potrzeby testów lokalnych (w sekcji Opcje programisty > Sieć > Ograniczanie skanowania Wi-Fi).