Menyimpan jaringan dan konfigurasi Passpoint

Di Android 11 (SDK level 30) dan yang lebih baru, aplikasi dapat menggunakan intent android.provider.Settings.ACTION_WIFI_ADD_NETWORKS untuk memandu pengguna menambahkan satu atau beberapa jaringan tersimpan baru atau konfigurasi Passpoint. API ini juga berfungsi sebagaimana mestinya untuk mengubah konfigurasi yang disimpan.

Catatan: API ini memiliki fungsi yang paling mirip dengan WifiManager.addNetwork(WifiConfiguration config) API yang tidak digunakan lagi, karena konfigurasi yang dihasilkan ditambahkan ke daftar jaringan dan langganan tersimpan yang ditampilkan dan dikelola pengguna.

Untuk menyimpan konfigurasi jaringan atau Passpoint, lakukan hal berikut:

1. Buat intent ACTION_WIFI_ADD_NETWORKS.

2. Buat satu atau beberapa konfigurasi menggunakan WifiNetworkSuggestion.Builder. Perhatikan bahwa meskipun Anda menggunakan WifiNetworkSuggestion, Intent API ini tidak terkait dengan Suggestion API.

3. Buat daftar array parcelable dari konfigurasi dan lampirkan ke intent dengan tambahan EXTRA_WIFI_NETWORK_LIST.

4. Jalankan Activity.startActivityForResult(), dengan meneruskan intent.

5. Proses hasil menggunakan callback Activity.onActivityResult().

   resultCode dapat berupa salah satu dari hal berikut:

   • Activity.RESULT_OK: menunjukkan bahwa pengguna menyetujui jaringan yang diusulkan dan menyimpannya.
   • Activity.RESULT_CANCELED: menunjukkan bahwa pengguna menolak jaringan yang diusulkan.

   Jika resultCode adalah RESULT_OK, data Intent akan berisi tambahan EXTRA_WIFI_NETWORK_RESULT_LIST, yang berisi array kode hasil yang menunjukkan apakah setiap konfigurasi berhasil disimpan. Kemungkinan kode hasilnya adalah:

   • ADD_WIFI_RESULT_SUCCESS: konfigurasi ditambahkan atau berhasil diperbarui.
   • ADD_WIFI_RESULT_ADD_OR_UPDATE_FAILED: kegagalan saat mencoba menambahkan konfigurasi, seperti karena konfigurasi yang terbentuk buruk.
   • ADD_WIFI_RESULT_ALREADY_EXISTS: konfigurasi yang diminta sudah ada sehingga tidak perlu tindakan apa pun.

6. Jika permintaan berhasil, platform akan memicu koneksi ke salah satu jaringan yang baru disimpan.

Contoh kode

Contoh kode berikut menunjukkan cara menyimpan konfigurasi jaringan atau Passpoint.

class MainActivity : AppCompatActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        ...
    }

    fun startOperation() {
        val suggestions = ArrayList<WifiNetworkSuggestion>()

        // WPA2 configuration
        suggestions.add(
                WifiNetworkSuggestion.Builder()
                        .setSsid("test111111")
                        .setWpa2Passphrase("test123456")
                        .build()
        )

        // Open configuration
        suggestions.add(
                WifiNetworkSuggestion.Builder()
                        .setSsid("test222222")
                        .build()
        )

        // Passpoint configuration
        val config = PasspointConfiguration()
        config.credential = Credential().apply {
            realm = "realm.example.com"
            simCredential = Credential.SimCredential().apply {
                eapType = 18
                imsi = "123456*"
            }
        }
        config.homeSp = HomeSp().apply {
            fqdn = "test1.example.com"
            friendlyName = "Some Friendly Name"
        }
        suggestions.add(
                WifiNetworkSuggestion.Builder()
                        .setPasspointConfig(config)
                        .build())

        // Create intent
        val bundle = Bundle()
        bundle.putParcelableArrayList(EXTRA_WIFI_NETWORK_LIST, suggestions)
        val intent = Intent(ACTION_WIFI_ADD_NETWORKS)
        intent.putExtras(bundle)

        // Launch intent
        startActivityForResult(intent, 0)
    }

    override fun onActivityResult(requestCode: Int, resultCode: Int, data: Intent?) {
        super.onActivityResult(requestCode, resultCode, data)
        if(resultCode == RESULT_OK) {
            // user agreed to save configurations: still need to check individual results
            if (data != null && data.hasExtra(EXTRA_WIFI_NETWORK_RESULT_LIST)) {
                for (code in data.getIntegerArrayListExtra(EXTRA_WIFI_NETWORK_RESULT_LIST)) {
                    when (code) {
                        ADD_WIFI_RESULT_SUCCESS ->
                            ... // Configuration saved or modified
                        ADD_WIFI_RESULT_ADD_OR_UPDATE_FAILED ->
                            ... // Something went wrong - invalid configuration
                        ADD_WIFI_RESULT_ALREADY_EXISTS ->
                            ... // Configuration existed (as-is) on device, nothing changed
                        else ->
                            ... // Other errors
                    }
                }
            }
        } else {
            // User refused to save configurations
        }
    }
}