با مجموعهها، منظم بمانید
ذخیره و طبقهبندی محتوا براساس اولویتهای شما.
در Android 10 و بالاتر، زیرساخت Wi-Fi شامل API پیشنهادی Wi-Fi برای اتصال به اینترنت و API درخواست شبکه Wi-Fi برای اتصال همتا به همتا است. در Android 11 و بالاتر، Settings Intent API به شما امکان میدهد از کاربر بخواهید افزودن یک شبکه ذخیرهشده یا پیکربندی Passpoint را تأیید کند.
API ها
این سه API موارد استفاده متفاوتی را هدف قرار میدهند و قابلیتها و محدودیتهای متفاوتی دارند:
Suggestion API : برنامههایی را هدف قرار میدهد که پیکربندیهای دارای قابلیت اینترنت را ارائه و ارائه میکنند. این تنظیمات به صورت جداگانه متعلق به کاربر نیست. کاربران می توانند تنظیمات خاصی را غیرفعال کنند یا برنامه پیشنهادی را غیرفعال کنند، اما نمی توانند آنها را حذف کنند.
تأیید کاربر برای هر برنامه لازم است، نه برای شبکه پیشنهادی برنامه.
برای برنامههای پیکربندی بارگیری Wi-Fi اپراتور و سایر برنامههایی که ممکن است به طور فعال شبکههای تخلیه را مدیریت کنند، در نظر گرفته شده است.
API درخواست شبکه : برنامههایی را هدف قرار میدهد که باید به یک دستگاه همتا متصل شوند، مانند هنگام پیکربندی دستگاه اینترنت اشیا یا انتقال فایلها به دوربین. در چنین مواردی، دستگاه همتا یک SoftAP را راه اندازی می کند و API به برنامه اجازه می دهد تا کاربر را برای اتصال به دستگاه راهنمایی کند. شبکه حاصل برای ارائه دسترسی به اینترنت در نظر گرفته نشده است، سیستم نمی تواند از آن استفاده کند و هیچ برنامه ای به جز برنامه پیکربندی نمی تواند از آن استفاده کند.
اولین باری که اتصال به همتای جدید برقرار می شود، انتخاب و تأیید کاربر مورد نیاز است.
برای برنامه های پیکربندی اینترنت اشیا و برنامه های انتقال فایل اینترنت اشیا در نظر گرفته شده است.
ACTION_WIFI_ADD_NETWORKS API : به برنامه ها (با تایید کاربر) اجازه می دهد تا شبکه ها یا تنظیمات Passpoint را به شبکه ذخیره شده یا لیست اشتراک اضافه کنند. سپس با این تنظیمات طوری رفتار می شود که گویی کاربر مستقیماً آنها را اضافه کرده است. به عنوان مثال، کاربر می تواند بعداً آنها را حذف کند.
تأیید کاربر برای هر درخواست برای افزودن شبکه های ذخیره شده لازم است.
برای برنامههایی در نظر گرفته شده است که یک نقطه دسترسی خانگی را پیکربندی میکنند و باید پیکربندی را به لیست شبکه ذخیرهشده کاربر اضافه کنند. برنامههایی که پیکربندی Passpoint حساب کاربری ارائه میکنند، مانند Enterprise، شبکههای فدرال، و مؤسسات آموزشی.
پیکربندی امن Wi-Fi Enterprise
در Android 11 QPR1 و بالاتر، سیستم تنظیمات امنیتی سختگیرانه ای را برای اتصالات Wi-Fi Enterprise مبتنی بر TLS الزامی می کند. برای اطلاعات بیشتر، به پیکربندی امن Wi-Fi Enterprise مراجعه کنید.
محتوا و نمونه کدها در این صفحه مشمول پروانههای توصیفشده در پروانه محتوا هستند. جاوا و OpenJDK علامتهای تجاری یا علامتهای تجاری ثبتشده Oracle و/یا وابستههای آن هستند.
تاریخ آخرین بهروزرسانی 2025-08-27 بهوقت ساعت هماهنگ جهانی.
[[["درک آسان","easyToUnderstand","thumb-up"],["مشکلم را برطرف کرد","solvedMyProblem","thumb-up"],["غیره","otherUp","thumb-up"]],[["اطلاعاتی که نیاز دارم وجود ندارد","missingTheInformationINeed","thumb-down"],["بیشازحد پیچیده/ مراحل بسیار زیاد","tooComplicatedTooManySteps","thumb-down"],["قدیمی","outOfDate","thumb-down"],["مشکل ترجمه","translationIssue","thumb-down"],["مشکل کد / نمونهها","samplesCodeIssue","thumb-down"],["غیره","otherDown","thumb-down"]],["تاریخ آخرین بهروزرسانی 2025-08-27 بهوقت ساعت هماهنگ جهانی."],[],[],null,["On Android 10 and higher, the Wi-Fi infrastructure includes the Wi-Fi suggestion\nAPI for internet connectivity and the Wi-Fi network request API for peer-to-peer\nconnectivity. On Android 11 and higher, the Settings Intent API lets you\nask the user to approve adding a saved network or Passpoint configuration.\n\nAPIs\n\nThe three APIs target different use cases and have different capabilities and\nconstraints:\n\n- [Suggestion API](/develop/connectivity/wifi/wifi-suggest): targets apps that\n provision and provide internet-capable configurations. These configurations\n are not individually owned by the user. Users can disable specific\n configurations or disable the suggesting app, but can't delete\n them.\n\n - User approval is required per app, not per network suggested by the app.\n - Intended for carrier Wi-Fi offload configuration apps and other apps that may actively manage offload networks.\n- [Network request API](/develop/connectivity/wifi/wifi-bootstrap): targets\n apps that need to connect to a peer device, such as when configuring an IoT\n device or transferring files to a camera. In such cases, the peer device\n starts up a SoftAP and the API allows the app to guide the user to connect to\n the device. The resulting network is not intended to provide internet access,\n can't be used by the system, and can't be used by any app except the\n configuring app.\n\n - User selection and approval is required the first time a connection is made to a new peer.\n - Intended for IoT configuration apps and IoT file transfer apps.\n- [`ACTION_WIFI_ADD_NETWORKS`\n API](/develop/connectivity/wifi/wifi-save-network-passpoint-config): allows\n apps (with user approval) to add networks or Passpoint configurations to the\n saved network or subscription list. These configurations are then treated as\n if the user added them directly. For example, the user can later delete them.\n\n - User approval is required for every request to add saved networks.\n - Intended for apps that configure a home Access Point and need to add the configuration to the user's saved network list. Apps that provision a user-account Passpoint configuration, such as Enterprise, federated networks, and educational institutions.\n\n| **Note:** These APIs are a replacement for the deprecated `WifiManager.addNetwork(WifiConfiguration config)` and related APIs. The other deprecated APIs allowed apps to directly add and manage a Wi-Fi configuration in the saved network list. The replacement APIs provide use-case-targeted alternatives.\n\nSecure Wi-Fi Enterprise configuration\n\nOn Android 11 QPR1 and higher, the system mandates strict security\nconfigurations for TLS-based Wi-Fi Enterprise connections. For more\ninformation, see\n[Secure Wi-Fi Enterprise configuration](/develop/connectivity/wifi-enterprise)."]]