ใน Android 11 (SDK ระดับ 30) ขึ้นไป แอปสามารถใช้ Intent android.provider.Settings.ACTION_WIFI_ADD_NETWORKS
เพื่อแนะนำผู้ใช้ในการเพิ่มเครือข่ายที่บันทึกไว้ใหม่อย่างน้อย 1 เครือข่ายหรือการกำหนดค่า Passpoint นอกจากนี้ API ยังทำงานได้ตามเดิมเพื่อแก้ไขการกำหนดค่าที่บันทึกไว้
อยู่แล้ว
หากต้องการบันทึกการกำหนดค่าเครือข่ายหรือ Passpoint ให้ทำดังนี้
สร้าง
ACTION_WIFI_ADD_NETWORKSความตั้งใจสร้างการกำหนดค่าอย่างน้อย 1 รายการโดยใช้
WifiNetworkSuggestion.Builderโปรดทราบว่าแม้คุณจะใช้WifiNetworkSuggestionแต่ Intent API นี้ก็ ไม่เกี่ยวข้องกับ Suggestion APIสร้างรายการอาร์เรย์ที่ส่งผ่านได้ของการกำหนดค่าและแนบไปกับ Intent ด้วย
EXTRA_WIFI_NETWORK_LISTExtraเรียกใช้
Activity.startActivityForResult()โดยส่งความตั้งใจฟังผลลัพธ์โดยใช้การเรียกกลับ
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: มีการกำหนดค่าที่ขออยู่แล้ว จึงไม่จำเป็นต้องดำเนินการใดๆ
หากคำขอสำเร็จ แพลตฟอร์มจะทริกเกอร์การเชื่อมต่อกับเครือข่ายที่เพิ่งบันทึกใหม่
ตัวอย่างโค้ด
ตัวอย่างโค้ดต่อไปนี้แสดงวิธีบันทึกการกำหนดค่าเครือข่ายหรือ 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
        }
    }
}