Interfejs Wi-Fi Network Request API do obsługi połączeń peer-to-peer

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:

  1. Utwórz specyfikator sieci Wi-Fi za pomocą WifiNetworkSpecifier.Builder.

  2. Ustaw filtr sieci, aby dopasować sieci, z którymi chcesz się połączyć, oraz wymagane dane logowania.

  3. Wybierz kombinację parametrów SSID, SSID pattern, BSSID i BSSID 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, BSSID lub BSSID pattern
    • W każdym żądaniu można ustawić tylko SSID lub SSID pattern
    • W każdym żądaniu można ustawić tylko BSSID lub BSSID pattern
  4. 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 metoda NetworkCallback.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);