هم‌زمان بودن Wi-Fi STA/STA

‫Android 12 هم‌زمان بودن Wi-Fi STA/STA را معرفی می‌کند که به دستگاه‌ها امکان می‌دهد به‌طور هم‌زمان به دو شبکه Wi-Fi متصل شوند. این ویژگی اختیاری عملکردهای زیر را فعال می‌کند:

  • اتصال قبل‌از قطع: دستگاه قبل‌از قطع اتصال موجود، به شبکه Wi-Fi جدید متصل می‌شود. این کار باعث می‌شود هنگام جابه‌جایی بین شبکه‌های Wi-Fi، انتقال‌ها روان‌تر انجام شود.
  • اتصال هم‌زمان فقط محلی و اینترنت: دستگاه بدون مختل کردن اتصال اصلی ارائه‌دهنده اینترنت دستگاه، به شبکه فقط محلی متصل می‌شود.
  • اتصال اینترنت و شبکه محدودشده هم‌زمان: دستگاه بدون اینکه اتصال اصلی ارائه‌دهنده اینترنت دستگاه را مختل کند، به شبکه محدودشده (فقط برای برنامه‌های ممتاز خاص دردسترس است) متصل می‌شود.
  • (Android 13 یا بالاتر) چندین شبکه هم‌زمان با اتصال اینترنت: دستگاه به دو شبکه متصل می‌شود که هر دو نامحدود و برای همه برنامه‌ها دردسترس هستند و اتصال اینترنت را فراهم می‌کنند.

این صفحه عملکرد دستگاه را هنگام فعال بودن این ویژگی و جزئیات پیاده‌سازی برای تولیدکنندگان و فروشندگان دستگاه شرح می‌دهد.

پیاده‌سازی

دستگاه‌ها باید از موارد زیر پشتیبانی کنند تا بتوانند هم‌زمانی Wi-Fi STA/STA را پیاده‌سازی کنند:

  • تراشه یا سفت‌افزار Wi-Fi باید از دو اتصال STA هم‌زمان پشتیبانی کند. سفت‌افزار باید از همه ترکیب‌های کانال و باند برای هر دو اتصال پشتیبانی کند. برای جلوگیری از مشکلات عملکرد، توصیه می‌کنیم از تراشه Wi-Fi با قابلیت DBS 2x2+2x2 استفاده کنید.

  • دستگاه باید از APIهای زیر در پیاده‌سازی AIDL یا HIDL IWifiChip پشتیبانی کند.

    • IWifiChip.setMultiStaPrimaryConnection(String ifName)
    • IWifiChip.setMultiStaUseCase(MultiStaUseCase useCase)
  • ترکیب میانای Wi-Fi در لایه انتزاع سخت‌افزار باید دو میانای STA هم‌زمان داشته باشد که بااستفاده از قالب مشخصاتی مثل [{STA} <= 2, ...] نمایان شده‌اند. برای اطلاعات بیشتر، هم‌زمان بودن چند واسط Wi-Fi را ببینید.

اگر این پیش‌نیازها برآورده شده است، هم‌زمانی Wi-Fi STA/STA را با انجام کارهای زیر پیاده‌سازی کنید:

  1. بااستفاده از رونوشت‌های منبع زمان اجرا (به‌طور پیش‌فرض غیرفعال است)، یک یا چند تابع را به‌صورت جداگانه فعال کنید.

    • اتصال قبل‌از قطع: config_wifiMultiStaNetworkSwitchingMakeBeforeBreakEnabled
    • اتصال اینترنت و محلی هم‌زمان: config_wifiMultiStaLocalOnlyConcurrencyEnabled
    • محدودیت هم‌زمان و اتصال اینترنت: config_wifiMultiStaRestrictedConcurrencyEnabled
    • چند شبکه هم‌زمان با اتصال اینترنت: config_wifiMultiStaMultiInternetConcurrencyEnabled
  2. هر پیاده‌سازی را همان‌طور که در بخش‌های مربوطه توضیح داده شده است، اعتبارسنجی کنید.

برای پشتیبانی بهتر از همزمانی Wi-Fi STA/STA، توصیه می‌کنیم چارچوب‌ها و برنامه‌های سفارشی‌سازی‌شده OEM به‌جای WifiManager#getConnectionInfo() از روش NetworkCallback#onCapabilitiesChanged() استفاده کنند که فقط WifiInfo را برای یک شبکه برمی‌گرداند و در Android 12 منسوخ شده است. برای اطلاعات بیشتر، Wi-Fi Network Request API برای اتصال‌پذیری رایانه به رایانه را ببینید.

اتصال قبل‌از قطع

عملکرد اتصال قبل‌از قطع به دستگاه‌ها امکان می‌دهد درحالی‌که اتصال شبکه Wi-Fi موجود را حفظ می‌کنند به شبکه Wi-Fi جدید متصل شوند و فقط زمانی از شبکه قدیمی قطع می‌شوند که با موفقیت به شبکه Wi-Fi جدید متصل شوند و به اینترنت دسترسی داشته باشند.

حالت استفاده «اتصال قبل‌از قطع» مشکلات زیر را در Android 11 یا نسخه‌های پایین‌تر برطرف می‌کند، جایی که دستگاه باید قبل‌از اتصال به شبکه جدید، از شبکه Wi-Fi موجود قطع شود (قطع قبل‌از اتصال).

  • هنگام اتصال به شبکه جدید، ممکن است دستگاه متوجه شود که گذرواژه Wi-Fi نادرستی ذخیره کرده است یا شبکه جدید دسترسی به اینترنت ندارد. این کار دستگاه را مجبور می‌کند به شبکه قدیمی برگردد و درنتیجه، دستگاه برای مدت قابل‌توجهی اتصال Wi-Fi نخواهد داشت.

  • شبکه قدیمی به‌طور ناگهانی قطع می‌شود، به این معنی که همه سوکت‌ها بسته می‌شوند. برنامه‌ها اغلب به ازدست رفتن ناگهانی اتصال‌پذیری واکنش خوبی نشان نمی‌دهند و این ممکن است باعث شود کاربر تا زمانی که اتصال جدید به‌طور کامل برقرار شود، چند ثانیه بدون اتصال اینترنت را تجربه کند.

  • شبکه پیش‌فرض دو بار تغییر می‌کند، از شبکه Wi-Fi قدیمی به شبکه تلفن همراه، سپس از شبکه تلفن همراه به شبکه Wi-Fi جدید. این کار باعث می‌شود برنامه‌ها دو بار به تغییرات شبکه واکنش نشان دهند. دستگاه باید مدت کوتاهی نیز از داده تلفن همراه استفاده کند.

جریان «اتصال قبل‌از قطع» فقط برای تعویض خودکار شبکه Wi-Fi که توسط سیستم‌عامل آغاز می‌شود استفاده می‌شود. در تعویض شبکه که کاربر آغاز می‌کند، از جریان قدیمی قطع-قبل‌از-اتصال استفاده می‌شود، که در آن شبکه قبلی به‌طور کامل قطع می‌شود و سپس شبکه جدید متصل می‌شود. در برخی موارد، جریان «قطع قبل‌از وصل» حتی در سوئیچ‌های خودکار که توسط سیستم‌عامل آغاز شده‌اند نیز استفاده می‌شود، برای مثال، هنگام سوئیچ کردن بین دو شبکه که هر دو برای استفاده از مک آدرس کارخانه پیکربندی شده‌اند.

برنامه‌ها می‌توانند بااستفاده از WifiManager#isMakeBeforeBreakWifiSwitchingSupported() API بررسی کنند که آیا این مورد استفاده در دستگاه پشتیبانی می‌شود یا نه.

اعتبارسنجی اتصال قبل‌از قطع

برای اعتبارسنجی پیاده‌سازی‌تان، سوئیچ شبکه Wi-Fi خودکار را راه‌اندازی کنید (با تأیید اینکه شبکه‌ای با قدرت سیگنال قوی‌تر از شبکه متصل‌شده دردسترس است) و تأیید کنید که دستگاه اتصال موجود را درحین اتصال به شبکه جدید حفظ می‌کند. برای مشاهده وضعیت هر دو میانای Wi-Fi و تأیید اینکه هر دو متصل هستند، از دستور زیر استفاده کنید:

adb shell wpa_cli -i wlan0 status ; echo ; adb shell wpa_cli -i wlan1 status

اگر شبکه جدید اتصال نداشته باشد، دستگاه تلاش می‌کند به شبکه متصل شود، درحالی‌که اتصال با شبکه موجود را حفظ می‌کند، و وقتی تشخیص دهد شبکه جدید اینترنت ندارد، تلاش را لغو می‌کند. سپس دستگاه به استفاده از اتصال موجود به‌عنوان شبکه Wi-Fi اصلی ادامه می‌دهد.

اتصال هم‌زمان فقط محلی و اینترنت

عملکرد اتصال اینترنت و اتصال محلی هم‌زمان به دستگاه‌ها اجازه می‌دهد به‌طور هم‌زمان با شبکه اصلی ارائه‌دهنده اینترنت، به اتصال محلی (مثلاً اتصال به دستگاه IoT) متصل شوند. این عملکرد تجربه کاربر را هنگام اتصال مستقیم به دستگاه‌های «اینترنت اشیا» (IoT)، مانند دوربین‌ها، بهبود می‌بخشد. این اتصال ازطریق WifiNetworkSpecifier API اضافه‌شده در Android 10 امکان‌پذیر است.

در Android نسخه ۱۱ و پایین‌تر، دستگاه‌ها هنگام اتصال به دستگاه IoT از شبکه Wi-Fi اصلی قطع می‌شوند که منجر به ازدست رفتن اتصال اینترنت می‌شود (مگر اینکه دستگاه نوع انتقال دیگری مانند داده تلفن همراه داشته باشد).

برنامه‌ها می‌توانند بااستفاده از WifiManager#isStaConcurrencyForLocalOnlyConnectionsSupported() API بررسی کنند که آیا این عملکرد در دستگاه پشتیبانی می‌شود یا نه.

برای کسب اطلاعات بیشتر درباره تغییرات عملکرد اتصال اینترنت و اتصال محلی هم‌زمان در Android 12، Wi-Fi Network Request API برای اتصال‌پذیری همتا به همتا را ببینید.

اتصال اینترنت و فقط محلی را اعتبارسنجی کنید

برای اعتبارسنجی این تابع، از MultiStaConcurrencyWifiNetworkSpecifierTest آزمون CTS استفاده کنید.

اتصال اینترنت و محدودیت هم‌زمان

عملکرد اتصال اینترنت و محدودشده هم‌زمان به دستگاه اجازه می‌دهد به‌طور هم‌زمان به شبکه Wi-Fi اصلی برای کاربر و شبکه Wi-Fi محدودشده‌ای که فقط برای برنامه‌های منتخب دردسترس است متصل شود.

برنامه‌ها می‌توانند بااستفاده از WifiManager#isStaConcurrencyForRestrictedConnectionsSupported() API بررسی کنند که آیا این عملکرد در دستگاه پشتیبانی می‌شود یا نه.

برای فعال کردن دستگاه جهت اتصال به شبکه‌های Wi-Fi محدودشده ثانویه، این مراحل را دنبال کنید:

  1. با setOemPaid یا setOemPrivate تنظیم‌شده روی درست، پیشنهادهای شبکه Wi-Fi را اضافه کنید.

  2. در ConnectivityManager، NetworkRequest را با قابلیت‌های مربوطه ثبت کنید:

وقتی دستگاه نتایج اسکن را با شبکه‌ای که با پیشنهاد خصوصی سازنده اصلی محصول یا پیشنهاد پولی سازنده اصلی محصول مطابقت دارد تشخیص دهد، به‌طور خودکار به‌عنوان شبکه ثانویه به آن متصل می‌شود.

اتصال اینترنت و محدودیت هم‌زمان را اعتبارسنجی کنید

برای اعتبارسنجی این عملکرد، از MultiStaConcurrencyRestrictedWifiNetworkSuggestionTest CTS test استفاده کنید.

چندین شبکه هم‌زمان با اتصال اینترنت

ویژگی چندین شبکه هم‌زمان با اتصال اینترنت که برای Android 13 یا بالاتر دردسترس است به دستگاه اجازه می‌دهد به‌طور هم‌زمان به دو شبکه (نقاط دسترسی) متصل شود که هر دو بدون محدودیت (همه برنامه‌ها دسترسی دارند) هستند و دسترسی به اینترنت را فراهم می‌کنند.

برنامه‌ها می‌توانند بااستفاده از روش WifiManager#isStaConcurrencyForMultiInternetSupported() بررسی کنند که آیا این ویژگی در دستگاه پشتیبانی می‌شود یا نه.

اگر این ویژگی پشتیبانی شود، برنامه‌های دارای امتیاز می‌توانند این ویژگی را بااستفاده از روش WifiManager#setStaConcurrencyForMultiInternetMode(int mode) فعال کنند. ویژگی حالت‌های زیر را دارد:

برای پُرسمان کردن حالت ویژگی فعال، از WifiManager#getStaConcurrencyForMultiInternetMode() روش استفاده کنید.

وقتی این ویژگی فعال باشد، از مراحل زیر برای درخواست شبکه Wi-Fi ارائه‌دهنده اینترنت اضافی استفاده کنید.

  1. مشخص‌کننده شبکه Wi-Fi را بااستفاده از WifiNetworkSpecifier.Builder ایجاد کنید. بااستفاده از روش setBand() ، نواری را برای مشخص‌کننده انتخاب کنید. «شناسه مجموعه خدمات» یا «شناسه مجموعه خدمات پایه» را به‌عنوان شبکه اضافی مشخص نکنید زیرا چارچوب Wi-Fi باند مشخص‌شده را انتخاب می‌کند.

  2. بااستفاده از ConnectivityManager، یک NetworkRequest با قابلیت NET_CAPABILITY_INTERNET ایجاد کنید.

  3. مشخص‌کننده را همراه با NetworkCallback نمونه‌ای برای پیگیری وضعیت درخواست به درخواست شبکه اضافه کنید و درخواست را به ConnectivityManager ارسال کنید. اگر شبکه ذخیره‌شده‌ای با باند درخواست‌شده در نتیجه اسکن دردسترس باشد و اتصال به شبکه موفقیت‌آمیز باشد، NetworkCallback.onAvailable() در شیء برگشت فراخوانی می‌شود.

چند شبکه هم‌زمان با اتصال اینترنت را اعتبارسنجی کنید

برای اعتبارسنجی این تابع، از آزمایش CTS زیر استفاده کنید:

  • CTS: MultiStaConcurrencyMultiInternetWifiNetworkTest

دستورالعمل‌های تراشه Wi-Fi فروشنده

فروشندگان تراشه Wi-Fi برای پشتیبانی از هم‌زمان بودن Wi-Fi STA/STA، از دستورالعمل‌های زیر استفاده کنند.

تراشه Wi-Fi باید از اتصال‌های هم‌زمان دوگانه STA پشتیبانی کند. این یعنی از موارد زیر پشتیبانی می‌کند:

  • هر میانای STA دارای یک MAC یکتا است که چارچوب می‌تواند آن را برنامه‌ریزی کند.
  • میانای STA ثانویه می‌تواند به‌صورت پویا ایجاد و حذف شود.
  • هر STA می‌تواند به SSID متفاوتی متصل شود (چه در همان باند یا باند متفاوت).
  • هر STA می‌تواند به همان SSID متصل شود (چه در همان باند چه در باندی متفاوت). دو STA هرگز نباید به یک BSSID متصل شوند.

ویژگی‌های حیاتی باید براساس هر میانای کاربری عمل کنند و باید در میانای کاربری اصلی دردسترس باشند. فهرست این ویژگی‌های حیاتی در زیر آمده است:

  • رومینگ باید حداقل در میانای اصلی (تنظیم‌شده بااستفاده از IWifiChip.setMultiStaPrimaryConnection()) پشتیبانی شود. اگر رومینگ در هر دو میانای اصلی پشتیبانی می‌شود، تصمیمات مربوط به یک اتصال نباید با اتصال هم‌زمان دوم تداخل داشته باشد. برای مثال، یک میانای نباید به BSSID اتصال دیگر رومینگ کند.

  • «پروفایل اتصال جانبی» (و سایر تخلیه‌ها مثل ARP و NS) باید حداقل در رابط اصلی (تنظیم‌شده بااستفاده از IWifiChip.setMultiStaPrimaryConnection()) پشتیبانی شود.

  • آمار لایه پیوند باید براساس هر میانجی عمل کند.

پیاده‌سازی‌های تراشه Wi-Fi زیر برای سناریوهای هم‌زمان مختلف توصیه می‌شود:

  • تراشه Wi-Fi باید به چارچوب اجازه دهد IWifiChip.setMultiStaUseCase() را با یکی از ثابت‌های زیر فراخوانی کند تا عملکرد فعلی را مشخص کند:

    • DUAL_STA_TRANSIENT_PREFER_PRIMARY: عملکرد «اتصال قبل‌از قطع» را مشخص می‌کند. کیفیت اتصال اصلی باید نسبت‌به اتصال فرعی در اولویت قرار گیرد.
    • DUAL_STA_NON_TRANSIENT_UNBIASED: عملکرد اتصال اینترنت و فقط محلی هم‌زمان یا عملکرد اتصال اینترنت و محدودشده هم‌زمان را مشخص می‌کند. کیفیت هر دو اتصال باید به‌طور یکسان اولویت‌بندی شود.
  • ازآنجایی‌که STAهای هم‌زمان دوگانه می‌توانند به حالت‌های عملکرد MCC،‏ SCC، و DBS منجر شوند، پیاده‌سازی فروشنده باید بهترین پیکربندی رادیویی را هنگام فراخوانی IWifiChip.setMultiStaUseCase() توسط چارچوب برای نشان دادن عملکرد انتخاب کند. دستورالعمل‌های کلی به شرح زیر است:

    • درصورت دردسترس بودن، از DBS با پیکربندی ۲×۲+۲×۲ استفاده شود.
    • درصورت امکان، از DBS‏ ۱×۱+۱×۱ استفاده نکنید چون تأثیر زیادی بر کیفیت اتصال دارد. درعوض، MCC را ترجیح دهید.
    • چرخه کاری MCC باید توسط درایور یا سفت‌افزار برای عملکردهای مختلف قابل‌پیکربندی باشد. چارچوب چرخه وظیفه MCC را مستقیماً تنظیم نمی‌کند، اما این اطلاعات را بااستفاده از StaLinkLayerIfaceStats.timeSliceDutyCycleInPercent پُرسمان می‌کند.
    • اگر از MCC استفاده می‌کنید، چرخه‌های کاری زیر را بین اتصال‌های اصلی و فرعی توصیه می‌کنیم:

      • ‫DUAL_STA_TRANSIENT_PREFER_PRIMARY: ۷۰٪ اصلی، ۳۰٪ فرعی.
      • ‫DUAL_STA_NON_TRANSIENT_UNBIASED: ۵۰٪ اصلی، ۵۰٪ ثانویه.