Sur Android 11 (niveau de SDK 30) ou version ultérieure, les applications peuvent utiliser le
android.provider.Settings.ACTION_WIFI_ADD_NETWORKS
dans le but de guider l'utilisateur en ajoutant un ou plusieurs nouveaux réseaux enregistrés ou
Configurations Passpoint. L'API fonctionne également en l'état pour modifier des fichiers existants
de configuration.
Pour enregistrer une configuration réseau ou Passpoint, procédez comme suit:
Créez un intent
ACTION_WIFI_ADD_NETWORKS
.Créez une ou plusieurs configurations à l'aide de
WifiNetworkSuggestion.Builder
Notez que même si vous utilisez unWifiNetworkSuggestion
, cette API Intent est sans lien avec l'API Suggestion.Créez une liste de configurations parcelables et associez-la au avec l'élément
EXTRA_WIFI_NETWORK_LIST
supplémentaires.Exécuter
Activity.startActivityForResult()
, en transmettant l'intent.Écoutez le résultat à l'aide de la méthode
Activity.onActivityResult()
.Le
resultCode
peut avoir l'une des valeurs suivantes:Activity.RESULT_OK
: indiquant que l'utilisateur a accepté les réseaux proposés et les a enregistrés.Activity.RESULT_CANCELED
: indiquant que l'utilisateur a refusé les réseaux proposés.
Si
resultCode
estRESULT_OK
, alors les donnéesIntent
contiennent leEXTRA_WIFI_NETWORK_RESULT_LIST
supplémentaire, qui contient un tableau de codes de résultat indiquant si des configurations ont bien été enregistrées. Les codes de résultat possibles sont les suivants:ADD_WIFI_RESULT_SUCCESS
: configuration ajoutée ou mise à jour correctement.ADD_WIFI_RESULT_ADD_OR_UPDATE_FAILED
: lors de la tentative d'ajout d'une configuration, par exemple en raison d'un mauvais format configuration.ADD_WIFI_RESULT_ALREADY_EXISTS
: la configuration demandée existait déjà. Aucune action n'était donc nécessaire.
Si la requête aboutit, la plate-forme déclenche une connexion à l'un des réseaux récemment enregistrés.
Exemple de code
L'exemple de code suivant montre comment enregistrer un réseau ou un Passpoint configuration.
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
}
}
}