اعتبارًا من عام 2026، ولضمان اتّساق نموذج التطوير الثابت الأساسي واستقرار المنصة في النظام المتكامل، سننشر رمز المصدر في مشروع Android مفتوح المصدر (AOSP) في الربعَين الثاني والرابع. لبناء مشروع Android مفتوح المصدر والمساهمة فيه، استخدِم android-latest-release. سيشير فرع بيان android-latest-release دائمًا إلى أحدث إصدار تم نشره في مشروع Android مفتوح المصدر. لمزيد من المعلومات، يُرجى الاطّلاع على التغييرات في مشروع Android مفتوح المصدر.

تستخدم Google تكنولوجيا الذكاء الاصطناعي لترجمة المحتوى إلى لغتك المفضّلة، وقد تتضمّن بعض الأخطاء.

IWifiHelper

public interface IWifiHelper

com.android.tradefed.device.IWifiHelper

الفئات الفرعية غير المباشرة المعروفة

WifiHelper

WifiHelper فئة مساعدة للتعامل مع خدمات Wi-Fi على الجهاز

واجهة مساعِدة للتعامل مع خدمات Wi-Fi على الجهاز

ملخّص

الإجراءات العامة
`abstract boolean`	`addOpenNetwork(String ssid)` تضيف هذه السمة شبكة الأمان المفتوحة التي تم تحديدها بواسطة ssid.
`abstract boolean`	`addOpenNetwork(String ssid, boolean scanSsid)` تضيف هذه السمة شبكة الأمان المفتوحة التي تم تحديدها بواسطة ssid.
`abstract boolean`	`addWpaPskNetwork(String ssid, String psk)` تضيف هذه السمة شبكة أمان WPA-PSK التي تم تحديدها بواسطة ssid.
`abstract boolean`	`addWpaPskNetwork(String ssid, String psk, boolean scanSsid)` تضيف هذه السمة شبكة أمان WPA-PSK التي تم تحديدها بواسطة ssid.
`abstract boolean`	`checkConnectivity(String urlToCheck)` يتحقّق من إمكانية الاتصال من خلال إرسال طلب HTTP إلى عنوان URL المحدّد.
`abstract void`	`cleanUp()` تنظيف الموارد وعملية تثبيت حزمة أداة المساعدة في شبكة Wi-Fi
`abstract boolean`	`connectToNetwork(String ssid, String psk, String urlToCheck)` الاتصال بشبكة Wi-Fi والتحقّق من الاتصال
`abstract IWifiHelper.WifiConnectionResult`	`connectToNetwork(String ssid, String psk, String urlToCheck, boolean scanSsid, String defaultType)` الاتصال بشبكة Wi-Fi والتحقّق من الاتصال
`abstract IWifiHelper.WifiConnectionResult`	`connectToNetwork(String ssid, String psk, String urlToCheck, boolean scanSsid)` الاتصال بشبكة Wi-Fi والتحقّق من الاتصال
`abstract boolean`	`disableWifi()` يؤدي ذلك إلى إيقاف حالة شبكة Wi-Fi على الجهاز.
`abstract boolean`	`disconnectFromNetwork()` قطع الاتصال بشبكة Wi-Fi الحالية وإيقاف Wi-Fi
`abstract boolean`	`enableWifi()` يتم تفعيل حالة شبكة Wi-Fi على الجهاز.
`abstract String`	`getBSSID()` تعرض هذه السمة معرّف مجموعة الخدمات الأساسية (BSSID) لنقطة الوصول الحالية.
`abstract String`	`getIpAddress()` تعرض هذه السمة عنوان IP المرتبط بواجهة Wi-Fi.
`abstract String`	`getSSID()` تعرض هذه السمة معرّف مجموعة الخدمات للشبكة المتصلة حاليًا.
`abstract Map<String, String>`	`getWifiInfo()` يحصل على معلومات اتصال شبكة Wi-Fi الحالية.
`abstract boolean`	`hasValidIp()`
`abstract boolean`	`isWifiEnabled()` تحقَّق مما إذا كانت شبكة Wi-Fi مفعّلة حاليًا.
`abstract boolean`	`removeAllNetworks()` يزيل هذا الإجراء جميع الشبكات المعروفة.
`abstract boolean`	`startMonitor(long interval, String urlToCheck)` يبدأ في مراقبة إمكانية الاتصال بالشبكة.
`abstract List<Long>`	`stopMonitor()` يوقف مراقبة الاتصال بالشبكة.
`abstract boolean`	`waitForIp(long timeout)` انتظِر إلى أن يتم تعيين عنوان IP لمحوّل Wi-Fi.
`abstract boolean`	`waitForWifiDisabled(long timeout)` انتظِر إلى أن تصبح قيمة `isWifiEnabled()` خطأ.
`abstract boolean`	`waitForWifiDisabled()` انتظِر إلى أن تصبح قيمة `isWifiEnabled()` "خطأ" مع مهلة تلقائية.
`abstract boolean`	`waitForWifiEnabled(long timeout)` انتظِر إلى أن تصبح قيمة `isWifiEnabled()` صحيحة.
`abstract boolean`	`waitForWifiEnabled()` انتظِر إلى أن تصبح قيمة `isWifiEnabled()` صحيحة مع مهلة تلقائية.
`abstract boolean`	`waitForWifiState(WifiState... expectedStates)` تنتظر هذه السمة إلى أن تحدث إحدى حالات شبكة Wi-Fi المتوقّعة.

الإجراءات العامة

addOpenNetwork

public abstract boolean addOpenNetwork (String ssid)

تضيف هذه السمة شبكة الأمان المفتوحة التي تم تحديدها بواسطة ssid.

للاتصال بأي شبكة Wi-Fi، يجب أولاً إنشاء ملف تعريف للشبكة في إعدادات wpa_supplicant. سيؤدي ذلك إلى استدعاء wpa_cli لإضافة شبكة أمان مفتوحة تم تحديدها بواسطة ssid.

المعلَمات
`ssid`	`String`: معرّف SSID للشبكة المطلوب إضافتها

المرتجعات
`boolean`	‫`true` إذا تمت إضافة الشبكة بنجاح، و`false` في الحالات الأخرى

عمليات الطرح
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

addOpenNetwork

public abstract boolean addOpenNetwork (String ssid, 
                boolean scanSsid)

تضيف هذه السمة شبكة الأمان المفتوحة التي تم تحديدها بواسطة ssid.

المعلَمات
`ssid`	`String`: معرّف SSID للشبكة المطلوب إضافتها
`scanSsid`	‫`boolean`: ما إذا كان سيتم البحث عن معرّف SSID مخفي لهذه الشبكة.

المرتجعات
`boolean`	‫`true` إذا تمت إضافة الشبكة بنجاح، و`false` في الحالات الأخرى

عمليات الطرح
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

addWpaPskNetwork

public abstract boolean addWpaPskNetwork (String ssid, 
                String psk)

تضيف هذه السمة شبكة أمان WPA-PSK التي تم تحديدها بواسطة ssid.

المعلَمات
`ssid`	`String`: معرّف SSID للشبكة المطلوب إضافتها
`psk`	`String`: عبارة مرور WPA-PSK المطلوب استخدامها

المرتجعات
`boolean`	‫`true` إذا تمت إضافة الشبكة بنجاح، و`false` في الحالات الأخرى

عمليات الطرح
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

addWpaPskNetwork

public abstract boolean addWpaPskNetwork (String ssid, 
                String psk, 
                boolean scanSsid)

تضيف هذه السمة شبكة أمان WPA-PSK التي تم تحديدها بواسطة ssid.

المعلَمات
`ssid`	`String`: معرّف SSID للشبكة المطلوب إضافتها
`psk`	`String`: عبارة مرور WPA-PSK المطلوب استخدامها
`scanSsid`	‫`boolean`: ما إذا كان سيتم البحث عن معرّف SSID مخفي لهذه الشبكة.

المرتجعات
`boolean`	‫`true` إذا تمت إضافة الشبكة بنجاح، و`false` في الحالات الأخرى

عمليات الطرح
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

checkConnectivity

public abstract boolean checkConnectivity (String urlToCheck)

يتحقّق من إمكانية الاتصال من خلال إرسال طلب HTTP إلى عنوان URL المحدّد.

المعلَمات
`urlToCheck`	`String`: عنوان URL مقصود لإجراء فحص طلب HTTP

المرتجعات
`boolean`	`true` إذا اجتاز الجهاز اختبار الاتصال.

عمليات الطرح
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

cleanUp

public abstract void cleanUp ()

تنظيف الموارد وعملية تثبيت حزمة أداة المساعدة في شبكة Wi-Fi يجب عدم استدعاء هذه الدالة إلا عندما لا تكون شبكة Wi-Fi مطلوبة بعد الآن لتنفيذ الطلب، لأنّ الجهاز سيفقد الاتصال بشبكة Wi-Fi عند إلغاء تثبيت التطبيق المساعد.

عمليات الطرح
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

connectToNetwork

public abstract boolean connectToNetwork (String ssid, 
                String psk, 
                String urlToCheck)

الاتصال بشبكة Wi-Fi والتحقّق من الاتصال

المعلَمات
`ssid`	‫`String`: معرّف SSID للشبكة المطلوب الاتصال بها
`psk`	`String`: عبارة مرور WPA-PSK التي سيتم استخدامها يمكن أن تكون هذه القيمة فارغة.
`urlToCheck`	`String`: عنوان URL مقصود لإجراء فحص طلب HTTP

المرتجعات
`boolean`	`true` إذا اجتاز الجهاز اختبار الاتصال.

عمليات الطرح
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

connectToNetwork

public abstract IWifiHelper.WifiConnectionResult connectToNetwork (String ssid, 
                String psk, 
                String urlToCheck, 
                boolean scanSsid, 
                String defaultType)

الاتصال بشبكة Wi-Fi والتحقّق من الاتصال

المعلَمات
`ssid`	‫`String`: معرّف SSID للشبكة المطلوب الاتصال بها
`psk`	`String`: عبارة مرور WPA-PSK التي سيتم استخدامها يمكن أن تكون هذه القيمة فارغة.
`urlToCheck`	`String`: عنوان URL مقصود لإجراء فحص طلب HTTP
`scanSsid`	‫`boolean`: ما إذا كان سيتم البحث عن معرّف SSID مخفي لهذه الشبكة
`defaultType`	`String`: نوع الشبكة التلقائي الذي سيتم الرجوع إليه في حال عدم تحديد نوع شبكة SSID

المرتجعات
`IWifiHelper.WifiConnectionResult`	‫WifiConnectionResult الذي يمثّل نتيجة اتصال Wi-Fi

عمليات الطرح
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

connectToNetwork

public abstract IWifiHelper.WifiConnectionResult connectToNetwork (String ssid, 
                String psk, 
                String urlToCheck, 
                boolean scanSsid)

الاتصال بشبكة Wi-Fi والتحقّق من الاتصال

المعلَمات
`ssid`	‫`String`: معرّف SSID للشبكة المطلوب الاتصال بها
`psk`	`String`: عبارة مرور WPA-PSK التي سيتم استخدامها يمكن أن تكون هذه القيمة فارغة.
`urlToCheck`	`String`: عنوان URL مقصود لإجراء فحص طلب HTTP
`scanSsid`	‫`boolean`: ما إذا كان سيتم البحث عن معرّف SSID مخفي لهذه الشبكة

المرتجعات
`IWifiHelper.WifiConnectionResult`	‫WifiConnectionResult الذي يمثّل نتيجة اتصال Wi-Fi

عمليات الطرح
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

disableWifi

public abstract boolean disableWifi ()

يؤدي ذلك إلى إيقاف حالة شبكة Wi-Fi على الجهاز.

المرتجعات
`boolean`	‫`true` إذا تم إيقاف شبكة Wi-Fi بنجاح

عمليات الطرح
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

disconnectFromNetwork

public abstract boolean disconnectFromNetwork ()

قطع الاتصال بشبكة Wi-Fi الحالية وإيقاف Wi-Fi

المرتجعات
`boolean`	‫`true` إذا نجحت العملية

عمليات الطرح
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

enableWifi

public abstract boolean enableWifi ()

يتم تفعيل حالة شبكة Wi-Fi على الجهاز.

المرتجعات
`boolean`	‫`true` إذا تم تفعيل شبكة Wi-Fi بنجاح

عمليات الطرح
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

getBSSID

public abstract String getBSSID ()

تعرض هذه السمة معرّف مجموعة الخدمات الأساسية (BSSID) لنقطة الوصول الحالية.

المرتجعات
`String`

عمليات الطرح
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

يُرجى الاطّلاع أيضًا على:

http://developer.android.com/reference/android/net/wifi/WifiInfo.html#getSSID()‎

getIpAddress

public abstract String getIpAddress ()

تعرض هذه السمة عنوان IP المرتبط بواجهة Wi-Fi. تعرِض null إذا حدث خطأ أثناء استرداد عنوان IP.

المرتجعات
`String`

عمليات الطرح
`DeviceNotAvailableException`

getSSID

public abstract String getSSID ()

تعرض هذه السمة معرّف مجموعة الخدمات للشبكة المتصلة حاليًا.

المرتجعات
`String`

عمليات الطرح
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

يُرجى الاطّلاع أيضًا على:

http://developer.android.com/reference/android/net/wifi/WifiInfo.html#getSSID()‎

getWifiInfo

public abstract Map<String, String> getWifiInfo ()

يحصل على معلومات اتصال شبكة Wi-Fi الحالية.

ويشمل ذلك معرّف مجموعة الخدمات (SSID) ومعرّف مجموعة الخدمات الأساسية (BSSID) وعنوان IP وسرعة الربط وقوة إشارة الاستقبال (RSSI).

المرتجعات
`Map<String, String>`	خريطة تحتوي على معلومات اتصال بشبكة Wi-Fi

عمليات الطرح
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

hasValidIp

public abstract boolean hasValidIp ()

المرتجعات
`boolean`	‫`true` إذا كان الجهاز يتضمّن عنوان IP صالحًا

عمليات الطرح
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

isWifiEnabled

public abstract boolean isWifiEnabled ()

تحقَّق مما إذا كانت شبكة Wi-Fi مفعّلة حاليًا.

المرتجعات
`boolean`

عمليات الطرح
`DeviceNotAvailableException`

removeAllNetworks

public abstract boolean removeAllNetworks ()

يزيل هذا الإجراء جميع الشبكات المعروفة.

المرتجعات
`boolean`

عمليات الطرح
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

startMonitor

public abstract boolean startMonitor (long interval, 
                String urlToCheck)

يبدأ في مراقبة إمكانية الاتصال بالشبكة.

المعلَمات
`interval`	‫`long`: الفاصل الزمني بين عمليات التحقّق من الاتصال
`urlToCheck`	`String`: عنوان URL للتحقّق من الاتصال به.

المرتجعات
`boolean`	‫`true` إذا نجحت العملية

عمليات الطرح
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

stopMonitor

public abstract List<Long> stopMonitor ()

يوقف مراقبة الاتصال بالشبكة.

يعرض هذا الإجراء أيضًا سجلّ وقت الاستجابة منذ آخر مكالمة IWifiHelper.startMonitor(long,String).

المرتجعات
`List<Long>`	سجلّ وقت الاستجابة

عمليات الطرح
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

waitForIp

public abstract boolean waitForIp (long timeout)

انتظِر إلى أن يتم تعيين عنوان IP لمحوّل Wi-Fi.

المعلَمات
`timeout`	`long`: مدة الانتظار

المرتجعات
`boolean`	`true` إذا تم تخصيص عنوان IP قبل انتهاء المهلة، `false` بخلاف ذلك

عمليات الطرح
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

waitForWifiDisabled

public abstract boolean waitForWifiDisabled (long timeout)

انتظِر إلى أن تصبح قيمة isWifiEnabled() خطأ.

المعلَمات
`timeout`	‫`long`: الوقت بالمللي ثانية للانتظار

المرتجعات
`boolean`	‫`true` إذا تم إيقاف شبكة Wi-Fi قبل انتهاء المهلة، `false` في الحالات الأخرى.

عمليات الطرح
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

waitForWifiDisabled

public abstract boolean waitForWifiDisabled ()

انتظِر إلى أن تصبح قيمة isWifiEnabled() "خطأ" مع مهلة تلقائية.

المرتجعات
`boolean`	‫`true` إذا تم إيقاف شبكة Wi-Fi قبل انتهاء المهلة، `false` في الحالات الأخرى.

عمليات الطرح
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

waitForWifiEnabled

public abstract boolean waitForWifiEnabled (long timeout)

انتظِر إلى أن تصبح قيمة isWifiEnabled() صحيحة.

المعلَمات
`timeout`	‫`long`: الوقت بالمللي ثانية للانتظار

المرتجعات
`boolean`	`true` إذا كان Wi-Fi مفعّلاً قبل انتهاء المهلة، `false` في الحالات الأخرى

عمليات الطرح
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

waitForWifiEnabled

public abstract boolean waitForWifiEnabled ()

انتظِر إلى أن تصبح قيمة isWifiEnabled() صحيحة مع مهلة تلقائية.

المرتجعات
`boolean`	`true` إذا كان Wi-Fi مفعّلاً قبل انتهاء المهلة، `false` في الحالات الأخرى

عمليات الطرح
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

waitForWifiState

public abstract boolean waitForWifiState (WifiState... expectedStates)

تنتظر هذه السمة إلى أن تحدث إحدى حالات شبكة Wi-Fi المتوقّعة.

المعلَمات
`expectedStates`	‫`WifiState`: حالة واحدة أو أكثر من حالات شبكة Wi-Fi التي يجب توقّعها

المرتجعات
`boolean`	`true` إذا حدثت إحدى الحالات المتوقّعة. ‫`false` إذا لم تحدث أي من الحالات قبل انتهاء المهلة

عمليات الطرح
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`