네트워크 및 Passpoint 구성 저장

Android 11 (SDK 수준 30) 이상에서는 앱이 android.provider.Settings.ACTION_WIFI_ADD_NETWORKS 인텐트를 사용하여 사용자에게 저장된 네트워크 또는 Passpoint 구성을 하나 이상 추가하는 방법을 안내할 수 있습니다. 이 API는 기존에 저장된 구성을 수정하는 데도 그대로 사용할 수 있습니다.

네트워크 또는 Passpoint 구성을 저장하려면 다음 단계를 따르세요.

  1. ACTION_WIFI_ADD_NETWORKS 인텐트를 만듭니다.

  2. WifiNetworkSuggestion.Builder를 사용하여 구성을 하나 이상 만듭니다. WifiNetworkSuggestion를 사용하더라도 이 Intent API는 Suggestion API와 관련이 없습니다.

  3. 구성의 parcelable 배열 목록을 만들고 EXTRA_WIFI_NETWORK_LIST 엑스트라를 사용하여 이를 인텐트에 연결합니다.

  4. 인텐트를 전달하여 Activity.startActivityForResult()를 실행합니다.

  5. Activity.onActivityResult() 콜백을 사용하여 결과를 리슨합니다.

    resultCode는 다음 중 하나일 수 있습니다.

    • Activity.RESULT_OK: 사용자가 제안된 네트워크를 수락하고 저장했음을 나타냅니다.
    • Activity.RESULT_CANCELED: 사용자가 제안된 방송 네트워크를 거부했음을 나타냅니다.

    resultCode가 RESULT_OK이면 데이터 Intent에는 EXTRA_WIFI_NETWORK_RESULT_LIST 추가 항목이 포함되며, 여기에는 개별 구성이 성공적으로 저장되었는지 나타내는 결과 코드의 배열이 포함됩니다. 가능한 결과 코드는 다음과 같습니다.

  6. 요청이 성공하면 플랫폼은 새로 저장된 네트워크 중 하나에 대한 연결을 트리거합니다.

코드 샘플

다음 코드 샘플은 네트워크 또는 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
        }
    }
}