Menyimpan jaringan dan konfigurasi Passpoint

Di Android 11 (SDK level 30) dan yang lebih tinggi, aplikasi dapat menggunakan android.provider.Settings.ACTION_WIFI_ADD_NETWORKS maksud memandu pengguna dalam menambah satu atau lebih jaringan tersimpan baru atau Konfigurasi Passpoint. API ini juga berfungsi apa adanya untuk memodifikasi konfigurasi standar.

Catatan: API ini memiliki fungsi yang paling mendekati dengan yang tidak digunakan lagi WifiManager.addNetwork(WifiConfiguration config) API, sehingga hasil ditambahkan ke jaringan tersimpan terkelola yang ditampilkan kepada pengguna, daftar langganan.

Untuk menyimpan konfigurasi jaringan atau Passpoint, lakukan langkah 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 konfigurasi yang dapat dibagi-bagi dan lampirkan ke dengan intent EXTRA_WIFI_NETWORK_LIST tambahan.

4. {i>Execute<i} Activity.startActivityForResult(), meneruskan intent.

5. Dengarkan hasilnya menggunakan Activity.onActivityResult() .

   resultCode dapat berupa salah satu dari hal berikut:

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

   Jika resultCode adalah RESULT_OK, maka data Intent berisi EXTRA_WIFI_NETWORK_RESULT_LIST tambahan, yang berisi susunan kode hasil yang mengindikasikan apakah setiap konfigurasi berhasil disimpan. Kode hasil yang mungkin adalah:

   • ADD_WIFI_RESULT_SUCCESS: konfigurasi ditambahkan atau berhasil diperbarui.
   • ADD_WIFI_RESULT_ADD_OR_UPDATE_FAILED: terjadi kegagalan saat mencoba menambah konfigurasi, misalnya karena format konfigurasi Anda.
   • ADD_WIFI_RESULT_ALREADY_EXISTS: konfigurasi yang diminta sudah ada sehingga tidak perlu melakukan 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 jaringan atau Passpoint konfigurasi Anda.

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
        }
    }
}