Android 开发者
开发
核心领域
连接
指南
保存网络和 Passpoint 配置
使用集合保持井井有条 根据您的偏好保存和分类内容。
在 Android 11（SDK 级别 30）及更高版本上，应用可以使用 android.provider.Settings.ACTION_WIFI_ADD_NETWORKS intent 引导用户添加一个或多个新的已保存网络或 Passpoint 配置。该 API 也可直接用于修改现有的已保存配置。
注意： 此 API 在功能上与已弃用的 WifiManager.addNetwork(WifiConfiguration config) API 最为相似，因为生成的配置会添加到面向用户且受管理的已保存网络和订阅列表。
要保存网络或 Passpoint 配置，请执行以下操作
创建一个 ACTION_WIFI_ADD_NETWORKS intent。
使用 WifiNetworkSuggestion.Builder 创建一个或多个配置。请注意，即使您使用了 WifiNetworkSuggestion，此 Intent API 也与建议 API 无关。
创建一个可序列化的配置数组列表，并使用 EXTRA_WIFI_NETWORK_LIST extra 将其附加到 intent 中。
执行 Activity.startActivityForResult()，并传入 intent。
使用 Activity.onActivityResult() 回调监听结果。
resultCode 可以是以下值之一
Activity.RESULT_OK：表示用户接受了建议的网络并将其保存。
Activity.RESULT_CANCELED：表示用户拒绝了建议的网络。
如果 resultCode 是 RESULT_OK，则数据 Intent 包含 EXTRA_WIFI_NETWORK_RESULT_LIST extra，其中包含一个结果代码数组，指示各个配置是否已成功保存。可能的结果代码如下：
ADD_WIFI_RESULT_SUCCESS：配置已添加或成功更新。
ADD_WIFI_RESULT_ADD_OR_UPDATE_FAILED：添加配置时失败，例如配置格式错误。
ADD_WIFI_RESULT_ALREADY_EXISTS：请求的配置已存在，因此无需执行任何操作。
如果请求成功，平台会触发与其中一个新保存网络的连接。
代码示例
以下代码示例展示了如何保存网络或 Passpoint 配置。
class MainActivity : AppCompatActivity() {
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
...
}
fun startOperation() {
val suggestions = ArrayList
// 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
}
}
}
此页面上的内容和代码示例受 内容许可 中所述的许可条款约束。Java 和 OpenJDK 是 Oracle 和/或其关联公司的商标或注册商标。
上次更新时间：2025-06-10 UTC。
[[["易于理解","easyToUnderstand","thumb-up"],["解决了我的问题","solvedMyProblem","thumb-up"],["其他","otherUp","thumb-up"]],[["缺少我需要的信息","missingTheInformationINeed","thumb-down"],["太复杂/步骤过多","tooComplicatedTooManySteps","thumb-down"],["过时","outOfDate","thumb-down"],["示例/代码问题","samplesCodeIssue","thumb-down"],["其他","otherDown","thumb-down"]],["上次更新时间：2025-06-10 UTC。"],[],[]]