Di Android 11 (SDK level 30) dan yang lebih tinggi, 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 juga berfungsi apa adanya untuk mengubah konfigurasi tersimpan
yang sudah ada.
Untuk menyimpan konfigurasi jaringan atau Passpoint, lakukan hal berikut:
Buat intent
ACTION_WIFI_ADD_NETWORKS
.Buat satu atau beberapa konfigurasi menggunakan
WifiNetworkSuggestion.Builder
. Perhatikan bahwa meskipun Anda menggunakanWifiNetworkSuggestion
, Intent API ini tidak terkait dengan Suggestion API.Buat daftar konfigurasi array yang dapat dibagikan dan lampirkan ke intent dengan tambahan
EXTRA_WIFI_NETWORK_LIST
.Jalankan
Activity.startActivityForResult()
, dengan meneruskan intent.Proses hasilnya menggunakan callback
Activity.onActivityResult()
.resultCode
dapat berupa salah satu dari hal berikut:Activity.RESULT_OK
: menunjukkan bahwa pengguna menerima jaringan yang diusulkan dan menyimpannya.Activity.RESULT_CANCELED
: menunjukkan bahwa pengguna menolak jaringan yang diusulkan.
Jika
resultCode
adalahRESULT_OK
, maka dataIntent
berisi tambahanEXTRA_WIFI_NETWORK_RESULT_LIST
, yang berisi array kode hasil yang menunjukkan apakah setiap konfigurasi berhasil disimpan atau tidak. Kode hasil yang mungkin adalah:ADD_WIFI_RESULT_SUCCESS
: konfigurasi ditambahkan atau berhasil diupdate.ADD_WIFI_RESULT_ADD_OR_UPDATE_FAILED
: kegagalan saat mencoba menambahkan konfigurasi, seperti karena konfigurasi yang salah.ADD_WIFI_RESULT_ALREADY_EXISTS
: konfigurasi yang diminta sudah ada sehingga tidak diperlukan tindakan apa pun.
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
}
}
}