Android NDK开发详解连接性之保存网络和 Passpoint 配置

Passpoint

Passpoint 是一种 Wi-Fi 联盟 (WFA) 协议，使移动设备能够发现提供互联网接入的 Wi-Fi 热点并进行身份验证。

如需了解适用于 Passpoint 的 Wi-Fi 建议 API，请参阅适用于互联网连接的 Wi-Fi 建议 API 和 WifiNetworkSuggestion.Builder。

如需详细了解如何在 Android 中实现 Passpoint，请参阅 Passpoint（热点 2.0）。

保存网络和 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 与 Suggestion API 无关。

创建配置的 Parcelable 数组列表，并使用 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<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
        }
    }
}

本页面上的内容和代码示例受内容许可部分所述许可的限制。Java 和 OpenJDK 是 Oracle 和/或其关联公司的注册商标。

最后更新时间 (UTC)：2023-11-02。