تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
في نظام التشغيل Android 10 والإصدارات الأحدث، تتضمّن البنية الأساسية لشبكة Wi-Fi واجهة برمجة التطبيقات لاقتراحات شبكة Wi-Fi من أجل الاتصال بالإنترنت، وواجهة برمجة التطبيقات لطلبات شبكة Wi-Fi من أجل الاتصال بين الأجهزة. في نظام التشغيل Android 11 والإصدارات الأحدث، تتيح واجهة برمجة التطبيقات Settings Intent API للمطوّرين أن يطلبوا من المستخدم الموافقة على إضافة شبكة محفوظة أو إعدادات Passpoint.
واجهات برمجة التطبيقات
تستهدف واجهات برمجة التطبيقات الثلاث حالات استخدام مختلفة، كما أنّ لها إمكانات وقيودًا مختلفة:
واجهة برمجة التطبيقات الخاصة بالاقتراحات: تستهدف التطبيقات التي توفّر إعدادات تتيح الاتصال بالإنترنت. ولا يملك المستخدم هذه الإعدادات بشكل فردي. يمكن للمستخدمين إيقاف إعدادات معيّنة أو إيقاف التطبيق الذي يقترحها، ولكن لا يمكنهم حذفها.
يجب الحصول على موافقة المستخدم لكل تطبيق، وليس لكل شبكة يقترحها التطبيق.
مخصّص لتطبيقات إعدادات نقل البيانات عبر شبكة Wi-Fi التابعة لمشغّل شبكة الجوّال والتطبيقات الأخرى التي قد تدير شبكات نقل البيانات بشكل نشط.
واجهة برمجة التطبيقات لطلبات الشبكة: تستهدف التطبيقات التي تحتاج إلى الاتصال بجهاز آخر، مثل عند إعداد جهاز إنترنت الأشياء أو نقل الملفات إلى كاميرا. في هذه الحالات، يبدأ الجهاز المجاور تشغيل SoftAP وتسمح واجهة برمجة التطبيقات للتطبيق بتوجيه المستخدم للاتصال بالجهاز. ولا يُفترض أن توفّر الشبكة الناتجة إمكانية الوصول إلى الإنترنت، ولا يمكن أن يستخدمها النظام، ولا يمكن أن يستخدمها أي تطبيق باستثناء التطبيق الذي يضبط الإعدادات.
يجب أن يختار المستخدم جهازًا ويوافق عليه عند إنشاء اتصال
بجهاز جديد لأول مرة.
مخصّص لتطبيقات إعداد أجهزة إنترنت الأشياء وتطبيقات نقل ملفات إنترنت الأشياء
ACTION_WIFI_ADD_NETWORKS
واجهة برمجة التطبيقات: تتيح
للتطبيقات (بموافقة المستخدم) إضافة شبكات أو إعدادات Passpoint إلى
قائمة الشبكات المحفوظة أو قائمة الاشتراكات. بعد ذلك، يتم التعامل مع هذه الإعدادات كما لو أنّ المستخدم أضافها مباشرةً. على سبيل المثال، يمكن للمستخدم حذفها لاحقًا.
يجب الحصول على موافقة المستخدم لكل طلب لإضافة شبكات محفوظة.
مخصّص للتطبيقات التي تضبط نقطة وصول منزلية وتحتاج إلى إضافة الإعداد إلى قائمة الشبكات المحفوظة لدى المستخدم. التطبيقات التي توفّر إعدادات Passpoint لحساب مستخدم، مثل المؤسسات والشبكات الموحّدة والمؤسسات التعليمية
إعدادات Secure Wi-Fi Enterprise
في الإصدار Android 11 QPR1 والإصدارات الأحدث، يفرض النظام إعدادات أمان صارمة لاتصالات Wi-Fi Enterprise المستندة إلى بروتوكول أمان طبقة النقل (TLS). لمزيد من المعلومات، يُرجى الاطّلاع على إعداد شبكة Wi-Fi Enterprise الآمنة.
يخضع كل من المحتوى وعيّنات التعليمات البرمجية في هذه الصفحة للتراخيص الموضحّة في ترخيص استخدام المحتوى. إنّ Java و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)."]]
