Uygulamalar, Android 11 (SDK düzeyi 30) ve sonraki sürümlerde kullanıcıya bir veya daha fazla yeni kayıtlı ağ ya da Passpoint yapılandırması ekleme konusunda rehberlik etmek için android.provider.Settings.ACTION_WIFI_ADD_NETWORKS
amacını kullanabilir. API, kayıtlı mevcut yapılandırmaları değiştirmek için de olduğu gibi çalışır.
Bir ağı veya Passpoint yapılandırmasını kaydetmek için aşağıdakileri yapın:
ACTION_WIFI_ADD_NETWORKS
amacı oluşturun.WifiNetworkSuggestion.Builder
kullanarak bir veya daha fazla yapılandırma oluşturun.WifiNetworkSuggestion
kullansanız bile bu Intent API'nin Suggestion API ile ilişkili olmadığını unutmayın.Yapılandırmaların ayrıştırılabilir bir dizi listesini oluşturun ve bunu
EXTRA_WIFI_NETWORK_LIST
ekstra ile niyete ekleyin.Amacı başarılı şekilde
Activity.startActivityForResult()
yürütün.Activity.onActivityResult()
geri çağırma işlevini kullanarak sonucu dinleyin.resultCode
şunlardan biri olabilir:Activity.RESULT_OK
: Kullanıcının önerilen ağları kabul ettiğini ve kaydettiğini belirtme.Activity.RESULT_CANCELED
: Kullanıcının önerilen ağları reddettiğini belirtir.
resultCode
değeriRESULT_OK
iseIntent
verileri, bağımsız yapılandırmaların başarıyla kaydedilip kaydedilmediğini gösteren bir sonuç kodu dizisi içerenEXTRA_WIFI_NETWORK_RESULT_LIST
ekstrasını içerir. Olası sonuç kodları şunlardır:ADD_WIFI_RESULT_SUCCESS
: Yapılandırma eklendi veya başarıyla güncellendi.ADD_WIFI_RESULT_ADD_OR_UPDATE_FAILED
: Kötü biçimlendirilmiş bir yapılandırma nedeniyle, yapılandırma eklenmeye çalışılırken hata meydana gelir.ADD_WIFI_RESULT_ALREADY_EXISTS
: İstenen yapılandırma zaten mevcut olduğundan işlem gerekmiyordu.
İstek başarılı olursa platform, yeni kaydedilen ağlardan birine bağlantı tetikler.
Kod örneği
Aşağıdaki kod örneğinde bir ağın veya Passpoint yapılandırmasının nasıl kaydedileceği gösterilmektedir.
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
}
}
}