Wi-Fi Network Request API untuk konektivitas peer-to-peer

Di perangkat Android 10 (API level 29) dan yang lebih tinggi, Anda dapat menggunakan API peer to peer baru untuk melakukan bootstrap konfigurasi untuk perangkat sekunder seperti hardware Chromecast dan Google Home. Fitur ini memungkinkan aplikasi Anda meminta pengguna untuk mengubah titik akses yang terhubung ke perangkat menggunakan WifiNetworkSpecifier untuk mendeskripsikan properti jaringan yang diminta.

Untuk menggunakan API ini, lakukan hal berikut:

1. Buat penentu jaringan Wi-Fi menggunakan WifiNetworkSpecifier.Builder.

2. Tetapkan filter jaringan untuk mencocokkan jaringan yang akan dihubungkan, beserta kredensial yang diperlukan.

3. Tentukan kombinasi SSID, SSID pattern, BSSID, dan BSSID pattern untuk menetapkan filter jaringan di setiap permintaan, dengan tunduk pada persyaratan berikut:

   • Setiap permintaan harus memberikan setidaknya salah satu dari SSID, SSID pattern, BSSID, atau BSSID pattern
   • Setiap permintaan hanya dapat menetapkan salah satu dari SSID atau SSID pattern
   • Setiap permintaan hanya dapat menetapkan salah satu dari BSSID atau BSSID pattern

4. Tambahkan penentu ke permintaan jaringan bersama dengan instance NetworkCallback untuk melacak status permintaan.

   Jika pengguna menyetujui permintaan dan koneksi ke jaringan berhasil, NetworkCallback.onAvailable() akan dipanggil pada objek callback. Jika pengguna menolak permintaan atau jika koneksi ke jaringan tidak berhasil, NetworkCallback.onUnavailable() akan dipanggil pada objek callback.

Memulai permintaan untuk terhubung ke perangkat peer akan meluncurkan kotak dialog di perangkat yang sama, yang dapat digunakan oleh pengguna perangkat tersebut untuk menerima permintaan koneksi.

Melewati persetujuan pengguna

Setelah pengguna menyetujui jaringan untuk terhubung sebagai respons terhadap permintaan dari aplikasi tertentu, perangkat akan menyimpan persetujuan untuk titik akses tertentu. Jika aplikasi membuat permintaan khusus untuk terhubung ke titik akses tersebut lagi, perangkat akan melewati fase persetujuan pengguna dan otomatis terhubung ke jaringan. Jika pengguna memilih untuk melupakan jaringan saat terhubung ke jaringan yang diminta oleh API, persetujuan yang disimpan untuk kombinasi aplikasi dan jaringan tersebut akan dihapus, dan permintaan apa pun di masa mendatang dari aplikasi harus disetujui oleh pengguna lagi. Jika aplikasi membuat permintaan yang tidak spesifik, seperti dengan pola SSID atau BSSID, pengguna harus menyetujui permintaan tersebut.

Contoh kode

Contoh kode berikut menunjukkan cara terhubung ke jaringan terbuka dengan awalan SSID "test" dan OUI BSSID "10:03:23":

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)

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);