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