อุปกรณ์ที่ใช้ Android 10 (API ระดับ 29) ขึ้นไปอนุญาตให้แอปเพิ่มเครือข่ายได้
ข้อมูลเข้าสู่ระบบของอุปกรณ์เพื่อเชื่อมต่อกับจุดเข้าใช้งาน Wi-Fi โดยอัตโนมัติ คุณสามารถระบุคำแนะนำสำหรับเครือข่ายที่จะเชื่อมต่อได้โดยใช้ WifiNetworkSuggestion
แพลตฟอร์มจะเลือกจุดเข้าใช้งานที่จะยอมรับในท้ายที่สุดโดยอิงตามข้อมูลจากแอปของคุณและแอปอื่นๆ
ใน Android 11 (API ระดับ 30) ขึ้นไป ให้ทำดังนี้
- การจัดสรร
PasspointConfiguration
สนับสนุนโดย API การแนะนำ ก่อน Android 11 กำลังจัดสรรPasspointConfiguration
ต้องใช้addOrUpdatePasspointConfiguration()
API - เฟรมเวิร์กบังคับใช้ข้อกำหนดด้านความปลอดภัยกับองค์กรที่ใช้ TLS
คำแนะนำ (EAP-TLS, EAP-TTLS และ EAP-PEAP) การแนะนำไปยังเครือข่ายดังกล่าว
ต้องตั้งค่า
Root CA certificate
และserver domain name
- เฟรมเวิร์กนี้จะบังคับใช้ข้อกำหนดการเป็นเจ้าของสำหรับองค์กรที่ใช้ EAP-SIM คำแนะนำ (EAP-SIM, EAP-AKA, EAP-AKA-PRIME); คำแนะนำดังกล่าว อนุญาตเฉพาะแอปที่ลงนามโดยผู้ให้บริการ
- เฟรมเวิร์กโดยอัตโนมัติสำหรับคำแนะนำจากแอปที่ลงนามโดยผู้ให้บริการ กำหนดรหัสผู้ให้บริการที่สอดคล้องกับ การรับรองของผู้ให้บริการ ระบบจะปิดใช้คำแนะนำดังกล่าวโดยอัตโนมัติหากนำซิมที่เกี่ยวข้องออกจากอุปกรณ์
ใน Android 12 (API ระดับ 31) ขึ้นไป ให้ทำดังนี้
คุณเปิดใช้ความเป็นส่วนตัวเพิ่มเติมได้ผ่านการสุ่ม MAC แบบไม่ถาวร ซึ่งจะสุ่มที่อยู่ MAC แบบสุ่มใหม่เป็นระยะ ใช้
setMacRandomizationSetting
เพื่อระบุระดับการสุ่มสําหรับเครือข่ายisPasspointTermsAndConditionsSupported()
: ข้อกําหนดและเงื่อนไขคือฟีเจอร์ Passpoint ที่ช่วยให้การติดตั้งใช้งานเครือข่ายแทนที่แคพทีฟพอร์ทัลที่ไม่ปลอดภัยซึ่งใช้เครือข่ายแบบเปิดด้วยเครือข่าย Passpoint ที่ปลอดภัย ระบบจะแสดงการแจ้งเตือนต่อผู้ใช้เมื่อต้องยอมรับข้อกำหนดและเงื่อนไข แอปที่แนะนำเครือข่าย Passpoint ซึ่งจำกัดขอบเขตตามข้อกำหนดและเงื่อนไข ต้องเรียกใช้ API นี้ก่อนเพื่อให้แน่ใจว่าอุปกรณ์รองรับความสามารถดังกล่าว หากอุปกรณ์ไม่รองรับความสามารถนี้ อุปกรณ์จะเชื่อมต่อเครือข่ายนี้ไม่ได้ และต้องแนะนำเครือข่ายอื่นหรือเครือข่ายเดิมisDecoratedIdentitySupported()
: เมื่อมีการตรวจสอบสิทธิ์ไปยังเครือข่ายที่มีการตกแต่งคำนำหน้า การตั้งค่า คำนำหน้าข้อมูลประจำตัวอนุญาตให้ผู้ให้บริการเครือข่ายอัปเดตการเข้าถึงเครือข่าย ตัวระบุ (NAI) เพื่อทำการกำหนดเส้นทางที่ชัดเจนผ่านพร็อกซีหลายรายการภายใน ของเครือข่าย AAA (โปรดดู RFC 7542 สำหรับ เกี่ยวกับเรื่องนี้เพิ่มเติม)Android 12 ใช้ฟีเจอร์นี้เพื่อปฏิบัติตามข้อกำหนด WBA สำหรับ PPS-MO ส่วนขยาย แอปที่แนะนำเครือข่าย Passpoint ที่กำหนดให้ต้องใช้ข้อมูลประจำตัวที่มีการประดับประดาต้องเรียกใช้ API นี้ก่อนเพื่อให้แน่ใจว่าอุปกรณ์รองรับความสามารถดังกล่าว ถ้า อุปกรณ์ไม่รองรับความสามารถ จะไม่มีการตกแต่งข้อมูลประจำตัว และการตรวจสอบสิทธิ์ไปยังเครือข่ายอาจล้มเหลว
ในการสร้างคำแนะนำ Passpoint แอปต้องใช้
PasspointConfiguration
,
Credential
และ
HomeSp
ชั้นเรียน คลาสเหล่านี้อธิบายโปรไฟล์ Passpoint ซึ่งกำหนดไว้ในข้อกำหนดของ Wi-Fi Alliance สำหรับ Passpoint
ตัวอย่างโค้ดต่อไปนี้แสดงวิธีระบุข้อมูลเข้าสู่ระบบสำหรับการเปิด 1 ครั้ง ครั้งเดียว WPA2, เครือข่าย WPA3 1 เครือข่าย และเครือข่าย Passpoint 1 เครือข่าย
val suggestion1 = WifiNetworkSuggestion.Builder() .setSsid("test111111") .setIsAppInteractionRequired(true) // Optional (Needs location permission) .build(); val suggestion2 = WifiNetworkSuggestion.Builder() .setSsid("test222222") .setWpa2Passphrase("test123456") .setIsAppInteractionRequired(true) // Optional (Needs location permission) .build(); val suggestion3 = WifiNetworkSuggestion.Builder() .setSsid("test333333") .setWpa3Passphrase("test6789") .setIsAppInteractionRequired(true) // Optional (Needs location permission) .build(); val passpointConfig = PasspointConfiguration(); // configure passpointConfig to include a valid Passpoint configuration val suggestion4 = WifiNetworkSuggestion.Builder() .setPasspointConfig(passpointConfig) .setIsAppInteractionRequired(true) // Optional (Needs location permission) .build(); val suggestionsList = listOf(suggestion1, suggestion2, suggestion3, suggestion4); val wifiManager = context.getSystemService(Context.WIFI_SERVICE) as WifiManager; val status = wifiManager.addNetworkSuggestions(suggestionsList); if (status != WifiManager.STATUS_NETWORK_SUGGESTIONS_SUCCESS) { // do error handling here } // Optional (Wait for post connection broadcast to one of your suggestions) val intentFilter = IntentFilter(WifiManager.ACTION_WIFI_NETWORK_SUGGESTION_POST_CONNECTION); val broadcastReceiver = object : BroadcastReceiver() { override fun onReceive(context: Context, intent: Intent) { if (!intent.action.equals(WifiManager.ACTION_WIFI_NETWORK_SUGGESTION_POST_CONNECTION)) { return; } // do post connect processing here } }; context.registerReceiver(broadcastReceiver, intentFilter);
final WifiNetworkSuggestion suggestion1 = new WifiNetworkSuggestion.Builder() .setSsid("test111111") .setIsAppInteractionRequired(true) // Optional (Needs location permission) .build(); final WifiNetworkSuggestion suggestion2 = new WifiNetworkSuggestion.Builder() .setSsid("test222222") .setWpa2Passphrase("test123456") .setIsAppInteractionRequired(true) // Optional (Needs location permission) .build(); final WifiNetworkSuggestion suggestion3 = new WifiNetworkSuggestion.Builder() .setSsid("test333333") .setWpa3Passphrase("test6789") .setIsAppInteractionRequired(true) // Optional (Needs location permission) .build(); final PasspointConfiguration passpointConfig = new PasspointConfiguration(); // configure passpointConfig to include a valid Passpoint configuration final WifiNetworkSuggestion suggestion4 = new WifiNetworkSuggestion.Builder() .setPasspointConfig(passpointConfig) .setIsAppInteractionRequired(true) // Optional (Needs location permission) .build(); final List<WifiNetworkSuggestion> suggestionsList = new ArrayList<WifiNetworkSuggestion> {{ add(suggestion1); add(suggestion2); add(suggestion3); add(suggestion4); }}; final WifiManager wifiManager = (WifiManager) context.getSystemService(Context.WIFI_SERVICE); final int status = wifiManager.addNetworkSuggestions(suggestionsList); if (status != WifiManager.STATUS_NETWORK_SUGGESTIONS_SUCCESS) { // do error handling here… } // Optional (Wait for post connection broadcast to one of your suggestions) final IntentFilter intentFilter = new IntentFilter(WifiManager.ACTION_WIFI_NETWORK_SUGGESTION_POST_CONNECTION); final BroadcastReceiver broadcastReceiver = new BroadcastReceiver() { @Override public void onReceive(Context context, Intent intent) { if (!intent.getAction().equals( WifiManager.ACTION_WIFI_NETWORK_SUGGESTION_POST_CONNECTION)) { return; } // do post connect processing here... } }; context.registerReceiver(broadcastReceiver, intentFilter);
ทันทีหลังจากที่แอปแสดงคำแนะนำเป็นครั้งแรก ผู้ใช้จะ การแจ้งเตือน ประเภทการแจ้งเตือนจะขึ้นอยู่กับเวอร์ชัน Android ที่กำลังใช้งาน ในอุปกรณ์
- ใน Android 11 (API ระดับ 30) ขึ้นไป ผู้ใช้จะเห็นกล่องโต้ตอบหากแอปทำงานอยู่เบื้องหน้า และจะเห็นการแจ้งเตือนหากแอปทำงานอยู่เบื้องหลัง
- ใน Android 10 (API ระดับ 29) ผู้ใช้จะเห็นการแจ้งเตือนโดยไม่คำนึงถึง ไม่ว่าแอปจะทำงานอยู่ในเบื้องหน้าหรือเบื้องหลัง
เมื่อแพลตฟอร์มเชื่อมต่อกับเครือข่ายที่แนะนำรายการใดรายการหนึ่ง การตั้งค่าจะแสดงข้อความที่ระบุแหล่งที่มาของการเชื่อมต่อเครือข่ายไปยังแอปแนะนำที่เกี่ยวข้อง
การจัดการการเชื่อมต่อของผู้ใช้ที่ขาดไป
หากผู้ใช้ใช้เครื่องมือเลือก Wi-Fi เพื่อยกเลิกการเชื่อมต่ออย่างชัดแจ้งจากเครือข่ายที่แนะนำเมื่อเชื่อมต่ออยู่ ระบบจะไม่สนใจเครือข่ายนั้นเมื่อยังอยู่ในระยะสัญญาณ ในช่วงเวลาดังกล่าว เราจะพิจารณาเครือข่ายนั้น เพื่อการเชื่อมต่ออัตโนมัติ แม้ว่าแอปจะนำคำแนะนำเครือข่ายออกและเพิ่มอีกครั้งก็ตาม ที่สอดคล้องกับเครือข่าย หากผู้ใช้ใช้เครื่องมือเลือก Wi-Fi เพื่อ เชื่อมต่อกับเครือข่ายที่ไม่ได้เชื่อมต่อก่อนหน้านี้ เครือข่ายนั้นจะ พิจารณาสำหรับการเชื่อมต่ออัตโนมัติทันที
การเปลี่ยนสถานะการอนุมัติสำหรับแอป
ผู้ใช้ปฏิเสธการแจ้งเตือนเกี่ยวกับคำแนะนำเครือข่ายจะนำ
สิทธิ์CHANGE_WIFI_STATE
จากแอป ผู้ใช้สามารถให้การอนุมัตินี้ได้
ในภายหลังโดยไปที่เมนูควบคุม Wi-Fi (การตั้งค่า >
แอปและ การแจ้งเตือน > แอปพิเศษ
การเข้าถึง > การควบคุม Wi-Fi > App name)