נקודת Wi-Fi לשיתוף אינטרנט (Soft AP)

‫Android מספק תמיכה בנקודת Wi-Fi לשיתוף אינטרנט (Soft AP), כולל שיתוף אינטרנט בין מכשירים דרך נקודת Wi-Fi לשיתוף אינטרנט ונקודות Wi-Fi לשיתוף אינטרנט באופן מקומי בלבד.

התכונה 'נקודת גישה רכה' מאפשרת להגדיר את הדברים הבאים:

  • SSID ו-BSSID
  • סוג אבטחה (כולל WPA3)
  • SSID מוסתר
  • פס הפעלה וערוץ (כולל ACS)
  • מספר הלקוחות המקסימלי המותר
  • הערך של הזמן הקצוב לתפוגה של כיבוי אוטומטי
  • רשימת היתרים ורשימת חסימה כדי לאפשר למשתמשים לשלוט במכשירים המשויכים
  • רמת הרנדומיזציה של כתובת ה-MAC עבור ה-BSSID של נקודת הגישה
  • ‫802.11ax ו-802.11be

הזמינות של אמצעי הבקרה האלה תלויה ביכולות המכשיר. ב-Android 11 נוספו ממשקי API כדי לקבל את היכולות האלה. יצרני מכשירים יכולים גם לציין יכולות בסיסיות של המכשיר באמצעות שכבות-על.

פיתוח אפליקציות באמצעות ממשקי API של נקודות גישה אישיות

הטמעה של נקודה לשיתוף אינטרנט ב-Wi-Fi מסופקת כברירת מחדל על ידי אפליקציית ההגדרות של פרויקט הקוד הפתוח של Android ‏ (AOSP), אבל היא לא מפעילה את כל ממשקי ה-API להגדרת Soft AP.

כדי לתמוך בשיתוף אינטרנט באמצעות נקודה לשיתוף אינטרנט או נקודה מקומית בלבד לשיתוף אינטרנט, האפליקציה צריכה לבצע את הפונקציות הבאות:

  1. רושמים קריאה חוזרת (callback) כדי לקבל את יכולות המכשיר באמצעות WifiManager#registerSoftApCallback לנקודה ניידת לשיתוף אינטרנט או WifiManager#registerLocalOnlyHotspotSoftApCallback לנקודה ניידת לשיתוף אינטרנט מקומית בלבד.

    פונקציית הקריאה החוזרת SoftApCallback מספקת את המתודות הבאות:

    • ‫SoftApCallback#onCapabilityChanged: מספק מידע על יכולות המכשיר, כולל המספר המקסימלי של לקוחות נתמכים, ועל התמיכה ב-SAE או ב-ACS.
    • ‫SoftApCallback#onInfoChanged: מספק מידע על נקודת הגישה הווירטואלית (Soft AP) שפועלת (תקף רק אחרי ההפעלה), כולל מידע על התדר והפס.
    • ‫SoftApCallback#onConnectedClientsChanged: הצגת רשימה של לקוחות מחוברים. לכל לקוח, אפשר לקבל את כתובת ה-MAC. כדי לקבל את פרטי ה-IP, משתמשים בקריאה החוזרת (callback) TetheringEventCallback#onClientsChanged.
    • ‫SoftApCallback#onStateChanged: מספק עדכונים על מצב ה-Soft AP כשהוא מופעל ומושבת.
    • ‫SoftApCallback#onBlockedClientConnecting: הפרטים של הלקוח שנחסם, עם אחת מהסיבות הבאות לחסימה: המכשיר הגיע למספר המקסימלי של לקוחות שהוא יכול לתמוך בהם, או שהלקוח לא קיבל הרשאה מפורשת להתחבר.
    • ‫SoftApCallback#onClientsDisconnected: הצגת רשימה של הלקוחות המנותקים. לכל לקוח אפשר לקבל את הסיבה לניתוק.

לנקודה לשיתוף אינטרנט שמחוברת באמצעות כבל:

  1. כדי להגדיר את ההגדרה של נקודת גישה וירטואלית לשיתוף אינטרנט, קוראים ל-method‏ WifiManager#setSoftApConfiguration ומספקים מופע SoftApConfiguration. בונים את SoftApConfiguration באמצעות המחלקה SoftApConfiguration.Builder.
  2. מתחילים את השיתוף על ידי קריאה לשיטת השיתוף בכתובת TetheringManager#startTethering.

לנקודה לשיתוף אינטרנט (hotspot) מקומית בלבד:

  1. כדי להפעיל נקודה לשיתוף אינטרנט לשימוש מקומי בלבד עם הגדרה ספציפית של AP וירטואלי, צריך לקרוא לשיטה WifiManager#startLocalOnlyHotspot.

הטמעה של רשימות היתרים ורשימות חסימה

דרישה אופיינית של ספקי סלולר היא לספק למשתמש אמצעי בקרה על המכשירים שמורשים להתחבר לנקודת הגישה הווירטואלית. יש כמה מנגנונים שמאפשרים לעשות את זה:

  • הגבלת המספר המקסימלי של מכשירים שיכולים להתחבר לנקודת הגישה הווירטואלית באמצעות SoftApConfiguration.Builder#setMaxNumberOfClients. חשוב לציין מספר שהוא נמוך מהמספר המקסימלי של לקוחות שהמכשיר תומך בהם. אפשר לקבל את המספר המקסימלי מ-SoftApCapability#getMaxSupportedClients.

  • מספקות שליטה דינמית באמצעות רשימות של אישור וחסימה:

    • ההגדרה שמוגדרת כברירת מחדל בנקודת גישה וירטואלית מאפשרת לכל המכשירים להתחבר אליה, למעט מכשירים שכתובות ה-MAC שלהם נוספו ל-SoftApConfiguration.Builder#setBlockedClientList.
    • אם נקודת הגישה הרכה מוגדרת עם SoftApConfiguration.Builder#setClientControlByUserEnabled(true), נעשה שימוש ברשימת ההיתרים.
      • כל המכשירים שכתובות ה-MAC שלהם מופיעות ב-SoftApConfiguration.Builder#setBlockedClientList נחסמים מקישור.
      • לכל המכשירים שכתובות ה-MAC שלהם מופיעות ב-SoftApConfiguration.Builder#setAllowedClientList יש הרשאה לשיוך.
      • כל המכשירים האחרים (כלומר, מכשירים שכתובות ה-MAC שלהם לא מופיעות ברשימת ההיתרים או ברשימת החסימה) נחסמים מהשיוך, אבל מתבצעת קריאה ל-SoftApCallback#onBlockedClientConnecting, שמאפשרת לאפליקציה השולטת (כלומר, לאפליקציית ההגדרות) לבצע פעולה, למשל לבקש מהמשתמש אישור ואז להוסיף את המכשיר לרשימת ההיתרים או לרשימת החסימה, בהתאם להתנהגות המשתמש.

    חשוב לדעת: מכשירים יכולים להשתמש בפונקציונליות של רשימת ההיתרים רק אם היא נתמכת במכשיר. אפשר לבדוק אם המכשיר נתמך באמצעות SoftApCapability#areFeaturesSupported(SOFTAP_FEATURE_CLIENT_FORCE_DISCONNECT).

הטמעה

כדי לתמוך בשיתוף אינטרנט באמצעות נקודה לשיתוף אינטרנט או לתמוך בנקודה לשיתוף אינטרנט מקומית בלבד, יצרני המכשירים צריכים לספק אפליקציית הגדרות, מסגרת ותמיכה ב-HAL/קושחה:

התאמה אישית

כדי להתאים אישית את ההטמעה, מומלץ ליצרני מכשירים להגדיר את שכבות העל ואת הגדרות הספק הבאות, שמפורטות במאמר 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).
  • ‫(Available from 13) config_wifiSoftapPassphraseAsciiEncodableCheck: האם ביטוי הסיסמה של ה-AP הרך צריך להיות ניתן לקידוד ב-ASCII.
  • ‫config_wifiSoftapAutoUpgradeToBridgedConfigWhenSupported: האם לשדרג אוטומטית את הגדרת הפס לפסים כפולים במהלך שחזור הגדרות הענן כשמתווסף תמיכה במכשיר חדש.
  • (זמין מגרסה 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
    • (זמין מגיל 13) config_wifiSoftapOweTransitionSupported
    • (זמין מגיל 13) config_wifiSoftapOweSupported
    • config_wifi_softap_ieee80211ac_supported
    • config_wifiSoftapIeee80211axSupported
    • (זמין מגיל 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) כדי לאמת את התכונה של נקודה לשיתוף אינטרנט. אפשר גם לבדוק את התכונה 'נקודה חמה' באמצעות Vendor Test Suite‏ (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