Сохранение сетей и настроек Passpoint

В Android 11 (SDK уровня 30) и выше приложения могут использовать интент android.provider.Settings.ACTION_WIFI_ADD_NETWORKS , чтобы помочь пользователю добавить одну или несколько новых сохраненных сетей или конфигураций Passpoint. API также работает в неизмененном виде для изменения существующих сохраненных конфигураций.

Чтобы сохранить конфигурацию сети или точки доступа, выполните следующие действия:

  1. Создайте интент ACTION_WIFI_ADD_NETWORKS .

  2. Создайте одну или несколько конфигураций, используя WifiNetworkSuggestion.Builder . Обратите внимание, что, даже если вы используете WifiNetworkSuggestion , этот API Intent не связан с API Suggestion .

  3. Создайте список конфигураций в виде массива, допускающего разделение по папкам, и прикрепите его к намерению с помощью дополнительного параметра EXTRA_WIFI_NETWORK_LIST .

  4. Выполните Activity.startActivityForResult() , передав в него Intent.

  5. Отслеживайте результат с помощью функции обратного вызова Activity.onActivityResult() .

    resultCode может принимать одно из следующих значений:

    • Activity.RESULT_OK : указывает, что пользователь принял предложенные сети и сохранил их.
    • Activity.RESULT_CANCELED : указывает на то, что пользователь отклонил предложенные сети.

    Если resultCode равен RESULT_OK , то Intent содержит дополнительный параметр EXTRA_WIFI_NETWORK_RESULT_LIST , который содержит массив кодов результатов, указывающих, были ли отдельные конфигурации успешно сохранены. Возможные коды результатов:

    • ADD_WIFI_RESULT_SUCCESS : конфигурация добавлена ​​или успешно обновлена.
    • ADD_WIFI_RESULT_ADD_OR_UPDATE_FAILED : ошибка при попытке добавить конфигурацию, например, из-за некорректно сформированной конфигурации.
    • ADD_WIFI_RESULT_ALREADY_EXISTS : запрошенная конфигурация уже существовала, поэтому никаких действий не требовалось.

  6. В случае успешного выполнения запроса платформа устанавливает соединение с одной из вновь сохраненных сетей.

Пример кода

Приведённый ниже пример кода демонстрирует, как сохранить конфигурацию сети или точки доступа.

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
        }
    }
}