Android 11 (SDK düzeyi 30) ve sonraki sürümlerde uygulamalar
android.provider.Settings.ACTION_WIFI_ADD_NETWORKS
bir veya daha fazla yeni kayıtlı ağ ekleme veya
Passpoint yapılandırmaları. API, mevcut kayıtlı öğeleri değiştirmek için olduğu gibi
yapılandırmanın üç yolu vardır.
Bir ağı veya Passpoint yapılandırmasını kaydetmek için aşağıdakileri yapın:
ACTION_WIFI_ADD_NETWORKS
niyeti oluşturun.Şunu kullanarak bir veya daha fazla yapılandırma oluşturun:
WifiNetworkSuggestion.Builder
.WifiNetworkSuggestion
kullansanız bile bu Intent API'nin Öneri API'si ile ilgili değildir.Yapılandırmaların ayrıştırılabilir bir dizi listesini oluşturun ve bu listeyi ve
EXTRA_WIFI_NETWORK_LIST
ekstraYürütme
Activity.startActivityForResult()
kısa bir ifadedir.Sonucu şunu kullanarak dinleyin:
Activity.onActivityResult()
geri arama.resultCode
şunlardan biri olabilir:Activity.RESULT_OK
: Kullanıcının önerilen ağları kabul ettiğini ve kaydettiğini gösterir.Activity.RESULT_CANCELED
: Bu, kullanıcının önerilen ağları reddettiğini gösterir.
resultCode
değeriRESULT_OK
iseIntent
verileri şunları içerir:EXTRA_WIFI_NETWORK_RESULT_LIST
ekstra (ekstra), tekil kullanıcıların yapılandırma başarıyla kaydedildi. 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
: yapılandırma eklemeye çalışırken hata oluştu (ör. kötü biçimlendirilmiş bir nedeniyle) yapılandırma.ADD_WIFI_RESULT_ALREADY_EXISTS
: İstenen yapılandırma zaten mevcut olduğundan herhangi bir işlem yapılmasına gerek yoktu.
İstek başarılı olursa platform, yeni kaydedilen ağlar.
Kod örneği
Aşağıdaki kod örneğinde bir ağın veya Passpoint'in nasıl kaydedileceği gösterilmektedir yapılandırma.
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
}
}
}