ฮอตสปอต Wi-Fi (Soft AP)

Android รองรับฮอตสปอต Wi-Fi (Soft AP) รวมถึงการเชื่อมต่ออินเทอร์เน็ตผ่านมือถือ ผ่านฮอตสปอต Wi-Fi และฮอตสปอต Wi-Fi ในพื้นที่เท่านั้น

ฟีเจอร์ Soft AP ช่วยให้กำหนดค่าสิ่งต่อไปนี้ได้

  • SSID และ BSSID
  • ประเภทการรักษาความปลอดภัย (รวมถึง WPA3)
  • SSID ที่ซ่อนไว้
  • ย่านความถี่และช่องสัญญาณ (รวมถึง ACS)
  • จำนวนไคลเอ็นต์สูงสุดที่อนุญาต
  • ค่าระยะหมดเวลาก่อนปิดอัตโนมัติ
  • รายการที่อนุญาตและรายการที่ถูกบล็อกเพื่อให้ผู้ใช้ควบคุมอุปกรณ์ที่เชื่อมโยงได้
  • ระดับการสุ่ม MAC สำหรับ BSSID ของ AP
  • 802.11ax และ 802.11be

ความสามารถของอุปกรณ์จะเป็นตัวกำหนดความพร้อมใช้งานของการควบคุมเหล่านี้ Android 11 เปิดตัว API เพื่อรับความสามารถเหล่านี้ นอกจากนี้ ผู้ผลิตอุปกรณ์ยังระบุความสามารถพื้นฐานของอุปกรณ์ได้ด้วย โดยใช้การวางซ้อน

พัฒนาแอปด้วยฮอตสปอต API

การใช้งานฮอตสปอต Wi-Fi ที่เชื่อมต่อเริ่มต้นมีให้ใช้งานในแอปการตั้งค่าของ โครงการโอเพนซอร์ส Android (AOSP) แต่ไม่ได้ใช้ API ทั้งหมดสำหรับการกำหนดค่า Soft AP

หากต้องการรองรับการเชื่อมต่ออินเทอร์เน็ตผ่านมือถือผ่านฮอตสปอตหรือฮอตสปอตในพื้นที่เท่านั้น แอปต้องมีฟังก์ชันต่อไปนี้

  1. ลงทะเบียนการเรียกกลับเพื่อรับความสามารถของอุปกรณ์โดยใช้ WifiManager#registerSoftApCallback สำหรับฮอตสปอตที่เชื่อมต่ออินเทอร์เน็ตผ่านมือถือ หรือ WifiManager#registerLocalOnlyHotspotSoftApCallback สำหรับฮอตสปอตที่ใช้ได้เฉพาะในเครื่อง

    Callback SoftApCallback มีเมธอดต่อไปนี้

    • SoftApCallback#onCapabilityChanged: ให้ข้อมูลเกี่ยวกับความสามารถของอุปกรณ์ รวมถึงจำนวนไคลเอ็นต์สูงสุดที่รองรับ และรองรับ SAE หรือ ACS หรือไม่
    • SoftApCallback#onInfoChanged: ให้ข้อมูลเกี่ยวกับ Soft AP ที่กำลังทำงาน (ใช้ได้ครั้งเดียวเมื่อ เริ่มต้น) รวมถึงข้อมูลย่านความถี่และความถี่
    • SoftApCallback#onConnectedClientsChanged: แสดงรายการไคลเอ็นต์ที่เชื่อมต่อ คุณสามารถรับที่อยู่ MAC ของไคลเอ็นต์แต่ละรายได้ หากต้องการรับข้อมูล IP ให้ใช้TetheringEventCallback#onClientsChangedการเรียกกลับ
    • SoftApCallback#onStateChanged: ให้ข้อมูลอัปเดตเกี่ยวกับสถานะของ Soft AP เมื่อมีการเปิดใช้และ ปิดใช้
    • SoftApCallback#onBlockedClientConnecting: ระบุข้อมูลไคลเอ็นต์ที่ถูกบล็อกพร้อมเหตุผลในการบล็อกอย่างใดอย่างหนึ่งต่อไปนี้ อุปกรณ์มีจำนวนไคลเอ็นต์สูงสุดที่รองรับได้ หรือไคลเอ็นต์ไม่ได้รับอนุญาตอย่างชัดเจนให้เชื่อมต่อ
    • SoftApCallback#onClientsDisconnected: แสดงรายการไคลเอ็นต์ที่ยกเลิกการเชื่อมต่อ คุณสามารถ ดูเหตุผลที่ระบบตัดการเชื่อมต่อสำหรับไคลเอ็นต์แต่ละรายได้

สำหรับฮอตสปอตที่เชื่อมต่ออินเทอร์เน็ตผ่านมือถือ

  1. กำหนดค่า AP แบบซอฟต์สำหรับการเชื่อมต่ออินเทอร์เน็ตผ่านมือถือโดยการเรียกใช้เมธอด WifiManager#setSoftApConfiguration และระบุอินสแตนซ์ SoftApConfiguration สร้าง SoftApConfigurationโดยใช้คลาส SoftApConfiguration.Builder
  2. เริ่มการแชร์อินเทอร์เน็ตโดยเรียกใช้เมธอด tethering ที่ TetheringManager#startTethering

สำหรับฮอตสปอตที่ใช้ได้เฉพาะในพื้นที่:

  1. เริ่มฮอตสปอตที่ใช้ได้เฉพาะในพื้นที่ด้วยการกำหนดค่า AP แบบซอฟต์แวร์ที่เฉพาะเจาะจงโดย เรียกใช้เมธอด WifiManager#startLocalOnlyHotspot

ใช้รายการที่อนุญาตและรายการที่บล็อก

โดยทั่วไปข้อกำหนดของผู้ให้บริการคือการให้สิทธิ์ควบคุมแก่ผู้ใช้สำหรับ อุปกรณ์ที่ได้รับอนุญาตให้เชื่อมโยงกับ Soft AP ซึ่งทำได้หลายวิธีดังนี้

  • จำกัดจำนวนอุปกรณ์สูงสุดที่เชื่อมโยงกับ Soft AP ได้โดยใช้ SoftApConfiguration.Builder#setMaxNumberOfClients โปรดระบุจำนวนที่ต่ำกว่าจำนวนไคลเอ็นต์สูงสุดที่อุปกรณ์รองรับ คุณดูหมายเลขสูงสุดได้จาก SoftApCapability#getMaxSupportedClients

  • ให้การควบคุมแบบไดนามิกโดยใช้รายการที่อนุญาตและรายการที่บล็อก

    • การกำหนดค่าเริ่มต้นของ Soft AP จะอนุญาตให้อุปกรณ์ทั้งหมดเชื่อมโยงกับ Soft AP ยกเว้นอุปกรณ์ที่มีการเพิ่มที่อยู่ MAC ลงใน SoftApConfiguration.Builder#setBlockedClientList
    • หากกำหนดค่า Soft AP ด้วย SoftApConfiguration.Builder#setClientControlByUserEnabled(true) ระบบจะใช้รายการที่อนุญาต
      • ระบบจะบล็อกอุปกรณ์ทั้งหมดที่มีที่อยู่ MAC อยู่ใน SoftApConfiguration.Builder#setBlockedClientList ไม่ให้เชื่อมโยง
      • อุปกรณ์ทั้งหมดที่มีที่อยู่ MAC อยู่ใน SoftApConfiguration.Builder#setAllowedClientList จะได้รับอนุญาต ให้เชื่อมโยง
      • อุปกรณ์อื่นๆ ทั้งหมด (กล่าวคือ อุปกรณ์ที่มีที่อยู่ MAC ไม่อยู่ในรายการที่อนุญาตหรือรายการที่บล็อก) จะถูกบล็อกไม่ให้เชื่อมโยง แต่จะมีการเรียกใช้ SoftApCallback#onBlockedClientConnecting ซึ่งจะอนุญาตให้แอปควบคุม (กล่าวคือ แอปการตั้งค่า) ดำเนินการได้ เช่น ขอให้ผู้ใช้ยืนยัน แล้วเพิ่มอุปกรณ์ลงในรายการที่อนุญาตหรือรายการที่บล็อก ขึ้นอยู่กับพฤติกรรมของผู้ใช้

    โปรดทราบว่าอุปกรณ์จะใช้ฟังก์ชันรายการที่อนุญาตได้ก็ต่อเมื่ออุปกรณ์ รองรับเท่านั้น คุณตรวจสอบว่าอุปกรณ์รองรับหรือไม่ได้โดยใช้ SoftApCapability#areFeaturesSupported(SOFTAP_FEATURE_CLIENT_FORCE_DISCONNECT)

การใช้งาน

หากต้องการรองรับการเชื่อมต่ออินเทอร์เน็ตผ่านมือถือผ่านฮอตสปอตหรือรองรับฮอตสปอตที่ใช้ได้เฉพาะในเครื่อง ผู้ผลิตอุปกรณ์ต้องให้การสนับสนุนแอปการตั้งค่า เฟรมเวิร์ก และ HAL/เฟิร์มแวร์

  • แอปการตั้งค่า: แอปการตั้งค่าของโครงการโอเพนซอร์ส Android (AOSP) มีพื้นฐานสำหรับการกำหนดค่าฮอตสปอตการเชื่อมต่ออินเทอร์เน็ตผ่านมือถือด้วย SSID และข้อมูลเข้าสู่ระบบเพื่อรักษาความปลอดภัย คุณสามารถใช้โค้ดนี้ได้เลยหรือจะแก้ไขเพื่อเพิ่มความสามารถ ตามที่อธิบายไว้ใน การพัฒนาแอปด้วย Hotspot API ก็ได้

  • เฟรมเวิร์ก: โค้ดเฟรมเวิร์ก AOSP รองรับฟังก์ชันการทำงานทั้งหมด ที่อธิบายไว้ในการพัฒนาแอปด้วย Hotspot API

  • HAL/เฟิร์มแวร์สำหรับฮอตสปอต: HIDL IHostapd.hal เวอร์ชัน 1.2 ขึ้นไป หรือ AIDL IHostapd.aidl

การปรับแต่ง

หากต้องการปรับแต่งการติดตั้งใช้งาน เราขอแนะนำให้ผู้ผลิตอุปกรณ์กำหนดค่า การซ้อนทับและการกำหนดค่าของผู้ให้บริการต่อไปนี้ ซึ่งระบุไว้ใน packages/modules/Wifi/service/ServiceWifiResources/res/values/config.xml

  • config_wifiFrameworkSoftApShutDownTimeoutMilliseconds: ช่วงหมดเวลา การปิดระบบเริ่มต้น ใช้ได้เมื่อเปิดใช้ SoftApConfiguration#setAutoShutdownEnabled เท่านั้น สามารถลบล้างได้ โดยใช้ SoftApConfiguration#setShutdownTimeoutMillis
  • config_wifiHardwareSoftapMaxClientCount: ข้อจำกัดด้านฮาร์ดแวร์สำหรับ จำนวนไคลเอ็นต์สูงสุดที่รองรับ จำนวนไคลเอ็นต์สูงสุด ที่อุปกรณ์รองรับคือข้อจำกัดขั้นต่ำของฮาร์ดแวร์และผู้ให้บริการ (ระบุโดย CarrierConfigManager.Wifi#KEY_HOTSPOT_MAX_CLIENT_COUNT) ผลลัพธ์สุดท้าย จะแสดงต่อแอปด้วย SoftApCapabilities#getMaxSupportedClients
  • config_wifiSofapClientForceDisconnectSupported: อุปกรณ์มีความสามารถในการบังคับยกเลิกการเชื่อมต่อไคลเอ็นต์หรือไม่ ต้องระบุเพื่อเปิดใช้รายการที่อนุญาต และรายการที่บล็อก สื่อสารกับแอปควบคุม (แอปการตั้งค่า) ผ่าน SoftApCapabilities#areFeaturesSupported(SOFTAP_FEATURE_CLIENT_FORCE_DISCONNECT)
  • (พร้อมใช้งานตั้งแต่ Android 13) config_wifiSoftapPassphraseAsciiEncodableCheck: ไม่ว่าจะต้องเข้ารหัสพาสเฟรสของ AP แบบซอฟต์เป็น ASCII หรือไม่
  • config_wifiSoftapAutoUpgradeToBridgedConfigWhenSupported: จะอัปเกรดการกำหนดค่าการตั้งค่าแบนด์เป็นแบบ 2 แบนด์โดยอัตโนมัติในระหว่างการกู้คืนการกำหนดค่าในระบบคลาวด์เมื่อรองรับอุปกรณ์ใหม่หรือไม่
  • (พร้อมใช้งานตั้งแต่ Android 13) config_wifiSoftapAutoAppendLowerBandsToBandConfigurationEnabled: ไม่ว่าเฟรมเวิร์กจะต่อท้ายแถบความถี่ที่ต่ำกว่าโดยอัตโนมัติไปยังการกำหนดค่าแถบความถี่ เพื่อหลีกเลี่ยงการจัดการการทำงานร่วมกันหรือไม่
  • config_wifiSoftApDynamicCountryCodeUpdateSupported: อุปกรณ์รองรับการอัปเดตรหัสประเทศแบบไดนามิกในโหมด AP หรือไม่
  • ช่องที่รองรับ: config_wifiSoftap2gChannelList, config_wifiSoftap5gChannelList, config_wifiSoftap6gChannelList และ config_wifiSoftap60gChannelList
  • รองรับการกู้คืนโดยระบุว่าจะรีเซ็ตรายการที่เกี่ยวข้องเป็นค่าเริ่มต้นหรือไม่ เมื่อกู้คืนการกำหนดค่าฮอตสปอตไปยังอุปกรณ์ใหม่ config_wifiSoftapResetChannelConfig, config_wifiSoftapResetHiddenConfig, config_wifiSoftapResetUserControlConfig, config_wifiSoftapResetAutoShutdownTimerConfig, config_wifiSoftapResetMaxClientSettingConfig โปรดทราบว่าค่าเหล่านี้จะตั้งค่าเป็น true โดยค่าเริ่มต้น ซึ่งหมายความว่าระบบจะรีเซ็ตค่า ซึ่งเป็นสิ่งสำคัญหาก อุปกรณ์ใหม่ไม่รองรับการกำหนดค่า
  • ความสามารถของฮาร์ดแวร์
    • config_wifi_softap_acs_supported
    • config_wifi_softap_sae_supported
    • (พร้อมใช้งานตั้งแต่ Android 13) config_wifiSoftapOweTransitionSupported
    • (พร้อมใช้งานตั้งแต่ Android 13) config_wifiSoftapOweSupported
    • config_wifi_softap_ieee80211ac_supported
    • config_wifiSoftapIeee80211axSupported
    • (พร้อมใช้งานตั้งแต่ Android 13) config_wifiSoftapIeee80211beSupported
    • config_wifiSoftapMacAddressCustomizationSupported
    • config_wifiSoftapHeSuBeamformerSupported
    • config_wifiSoftapHeSuBeamformeeSupported
    • config_wifiSoftapHeMuBeamformerSupported
    • config_wifiSoftapHeTwtSupported
    • config_wifiSoftap24ghzSupported
    • config_wifiSoftap5ghzSupported
    • config_wifiSoftap6ghzSupported
    • config_wifiSoftap60ghzSupported
    • config_wifiSoftapAcsIncludeDfs

การตรวจสอบ

Android มีชุดการทดสอบหน่วยและการทดสอบชุดเครื่องมือทดสอบความเข้ากันได้ (CTS) เพื่อตรวจสอบฟีเจอร์ฮอตสปอต นอกจากนี้ คุณยังทดสอบฟีเจอร์ฮอตสปอตได้โดยใช้ ชุดทดสอบของผู้ให้บริการ (VTS)

การทดสอบหน่วย

ยืนยันแพ็กเกจฮอตสปอตโดยใช้การทดสอบต่อไปนี้

  • การทดสอบบริการ

    atest packages/modules/Wifi/service/tests/wifitests/

  • การทดสอบของบัญชีดูแลจัดการ

    atest packages/modules/Wifi/framework/tests/

การทดสอบชุดเครื่องมือทดสอบความเข้ากันได้ (CTS)

ใช้การทดสอบ CTS เพื่อตรวจสอบฟีเจอร์ฮอตสปอต CTS จะตรวจจับเมื่อมีการเปิดใช้ฟีเจอร์และรวมการทดสอบที่เกี่ยวข้องโดยอัตโนมัติ

หากต้องการเรียกใช้การทดสอบ CTS ให้เรียกใช้คำสั่งต่อไปนี้

atest android.net.wifi.cts.WifiManagerTest

ชุดทดสอบของผู้ให้บริการ (VTS)

หากมีการใช้งานอินเทอร์เฟซ HIDL ให้เรียกใช้คำสั่งต่อไปนี้

atest VtsHalWifiHostapdV1_2Target

หากใช้งานอินเทอร์เฟซ AIDL ให้เรียกใช้คำสั่งต่อไปนี้

atest VtsHalHostapdTargetTest