Unter Android 11 (SDK-Level 30) und höher können Apps den Nutzer mit dem Intent android.provider.Settings.ACTION_WIFI_ADD_NETWORKS
durch das Hinzufügen eines oder mehrerer neuer gespeicherter Netzwerke oder Passpoint-Konfigurationen führen. Die API funktioniert auch unverändert, um vorhandene gespeicherte Konfigurationen zu ändern.
So speichern Sie eine Netzwerk- oder Passpoint-Konfiguration:
Erstellen Sie einen
ACTION_WIFI_ADD_NETWORKS
-Intent.Erstellen Sie mit
WifiNetworkSuggestion.Builder
eine oder mehrere Konfigurationen. Obwohl Sie eineWifiNetworkSuggestion
verwenden, hat diese Intent API nichts mit der Suggestion API zu tun.Erstellen Sie eine Liste mit geparsten Arrays der Konfigurationen und hängen Sie sie mit dem Extra
EXTRA_WIFI_NETWORK_LIST
an den Intent an.Führen Sie
Activity.startActivityForResult()
aus und übergeben Sie den Intent.Beobachten Sie das Ergebnis mithilfe des Callbacks
Activity.onActivityResult()
.resultCode
kann einer der folgenden Werte sein:Activity.RESULT_OK
: Gibt an, dass der Nutzer die vorgeschlagenen Netzwerke akzeptiert und gespeichert hat.Activity.RESULT_CANCELED
: gibt an, dass der Nutzer die vorgeschlagenen Netzwerke abgelehnt hat.
Wenn
resultCode
den WertRESULT_OK
hat, enthält der Daten-Intent
das Extra-TagEXTRA_WIFI_NETWORK_RESULT_LIST
mit einem Array von Ergebniscodes, die angeben, ob einzelne Konfigurationen erfolgreich gespeichert wurden. Mögliche Ergebniscodes sind:ADD_WIFI_RESULT_SUCCESS
: Konfiguration hinzugefügt oder erfolgreich aktualisiertADD_WIFI_RESULT_ADD_OR_UPDATE_FAILED
: Fehler beim Hinzufügen einer Konfiguration, beispielsweise aufgrund einer falsch formatierten KonfigurationADD_WIFI_RESULT_ALREADY_EXISTS
: Die angeforderte Konfiguration war bereits vorhanden, sodass keine Aktion erforderlich ist.
Wenn die Anfrage erfolgreich ist, löst die Plattform eine Verbindung zu einem der neu gespeicherten Netzwerke aus.
Codebeispiel
Das folgende Codebeispiel zeigt, wie eine Netzwerk- oder Passpoint-Konfiguration gespeichert wird.
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
}
}
}