Unter Android 11 (SDK-Level 30) und höher können Apps den android.provider.Settings.ACTION_WIFI_ADD_NETWORKS
-Intent verwenden, um den Nutzer zum Hinzufügen eines oder mehrerer neuer gespeicherter Netzwerke oder Passpoint-Konfigurationen zu 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 eine oder mehrere Konfigurationen mit
WifiNetworkSuggestion.Builder
. Hinweis: Auch wenn du eineWifiNetworkSuggestion
verwendest, steht diese Intent API nicht in Verbindung mit der Suggestion API.Erstellen Sie eine Liste mit Parcelable-Arrays mit den 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.Überwachen Sie das Ergebnis mit dem
Activity.onActivityResult()
-Callback.resultCode
kann einer der folgenden sein:Activity.RESULT_OK
: Damit wird angegeben, 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
aufRESULT_OK
gesetzt ist, enthalten die DatenIntent
dasEXTRA_WIFI_NETWORK_RESULT_LIST
-Extra mit einem Array von Ergebniscodes, das angibt, ob einzelne Konfigurationen erfolgreich gespeichert wurden. Folgende Ergebniscodes sind möglich:ADD_WIFI_RESULT_SUCCESS
: Konfiguration wurde hinzugefügt oder aktualisiert.ADD_WIFI_RESULT_ADD_OR_UPDATE_FAILED
: Fehler beim Hinzufügen einer Konfiguration, z. B. aufgrund einer fehlerhaften Konfiguration.ADD_WIFI_RESULT_ALREADY_EXISTS
: Die angeforderte Konfiguration war bereits vorhanden, sodass keine Maßnahme erforderlich war.
Wenn die Anfrage erfolgreich ist, löst die Plattform eine Verbindung zu einem der neu gespeicherten Netzwerke aus.
Codebeispiel
Das folgende Codebeispiel zeigt, wie Sie eine Netzwerk- oder Passpoint-Konfiguration speichern.
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
}
}
}