נקודת 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 של נקודות גישה אישיות

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

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

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

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

    • ‫SoftApCallback#onCapabilityChanged: מספק מידע על יכולות המכשיר, כולל המספר המקסימלי של לקוחות נתמכים, והאם נתמכים SAE או ACS.
    • ‫SoftApCallback#onInfoChanged: מספק מידע על נקודת הגישה הרכה שפועלת (תקף רק אחרי ההפעלה), כולל מידע על הפס והתדר.
    • ‫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)

כדי לאמת את התכונה של נקודת Wi-Fi לשיתוף אינטרנט, אפשר להשתמש בבדיקות CTS. מערכת CTS מזהה מתי התכונה מופעלת וכוללת אוטומטית את הבדיקות שקשורות אליה.

כדי להפעיל את בדיקות ה-CTS, מריצים את הפקודה:

atest android.net.wifi.cts.WifiManagerTest

חבילה לבדיקת ספקים (VTS)

אם הממשק של HIDL מיושם, מריצים את הפקודה:

atest VtsHalWifiHostapdV1_2Target

אם ממשק ה-AIDL מיושם, מריצים את הפקודה:

atest VtsHalHostapdTargetTest