اتصال Wi-Fi مباشر (المعروفة أيضًا باسم شبكة الند للند أو P2P) تتيح لتطبيقك العثور بسرعة على الأجهزة المجاورة والتفاعل معها، وذلك على نطاق يتجاوز إمكانات البلوتوث.
تسمح واجهات برمجة التطبيقات لاتصال Wi-Fi مباشر (P2P) للتطبيقات بالاتصال بالأجهزة المجاورة بدون الحاجة إلى الاتصال بشبكة أو نقطة اتصال. إذا كان تطبيقك مصمّمًا ليكون جزءًا من شبكة آمنة قريبة المدى، فإنّ Wi-Fi Direct هو خيار أكثر ملاءمة من شبكة Wi-Fi المخصّصة التقليدية للأسباب التالية:
- يدعم اتصال Wi-Fi مباشر تشفير WPA2. (لا تتوافق بعض الشبكات المخصّصة إلا مع تشفير WEP).
- يمكن للأجهزة بث الخدمات التي تقدّمها، ما يساعد الأجهزة الأخرى في العثور على أجهزة نظيرة مناسبة بسهولة أكبر.
- عند تحديد الجهاز الذي يجب أن يكون مالك المجموعة للشبكة، تفحص ميزة اتصال Wi-Fi مباشر إمكانات إدارة الطاقة وواجهة المستخدم والخدمة لكل جهاز، وتستخدم هذه المعلومات لاختيار الجهاز الذي يمكنه التعامل مع مسؤوليات الخادم بأكثر الطرق فعالية.
- لا يتيح Android وضع شبكة Wi-Fi المخصّصة.
يوضّح لك هذا الدرس كيفية العثور على الأجهزة المجاورة والاتصال بها باستخدام شبكة Wi-Fi P2P.
إعداد أذونات التطبيق
لاستخدام اتصال Wi-Fi مباشر، أضِف الأذونات ACCESS_FINE_LOCATION وCHANGE_WIFI_STATE وACCESS_WIFI_STATE وINTERNET إلى البيان.
إذا كان تطبيقك يستهدف الإصدار 13 من نظام التشغيل Android (المستوى 33 لواجهة برمجة التطبيقات) أو الإصدارات الأحدث، أضِف أيضًا الإذن NEARBY_WIFI_DEVICES إلى البيان. لا تتطلّب ميزة Wi-Fi Direct اتصالاً بالإنترنت، ولكنّها تستخدم مآخذ Java عادية، ما يتطلّب الإذن INTERNET. لذا، تحتاج إلى الأذونات التالية لاستخدام اتصال Wi-Fi مباشر:
<manifest xmlns:android="http://schemas.android.com/apk/res/android" package="com.example.android.nsdchat" ... <!-- If your app targets Android 13 (API level 33) or higher, you must declare the NEARBY_WIFI_DEVICES permission. --> <uses-permission android:name="android.permission.NEARBY_WIFI_DEVICES" <!-- If your app derives location information from Wi-Fi APIs, don't include the "usesPermissionFlags" attribute. --> android:usesPermissionFlags="neverForLocation" /> <uses-permission android:required="true" android:name="android.permission.ACCESS_FINE_LOCATION" <!-- If any feature in your app relies on precise location information, don't include the "maxSdkVersion" attribute. --> android:maxSdkVersion="32" /> <uses-permission android:required="true" android:name="android.permission.ACCESS_WIFI_STATE"/> <uses-permission android:required="true" android:name="android.permission.CHANGE_WIFI_STATE"/> <uses-permission android:required="true" android:name="android.permission.INTERNET"/> ...
بالإضافة إلى الأذونات السابقة، تتطلّب واجهات برمجة التطبيقات التالية أيضًا تفعيل "وضع الموقع الجغرافي":
إعداد جهاز استقبال البث ومدير شبكة الند للند
لاستخدام اتصال Wi-Fi مباشر، عليك الاستماع إلى أغراض البث التي تُعلم تطبيقك عند وقوع أحداث معيّنة. في تطبيقك، أنشئ مثيلاً لـ IntentFilter واضبطه على الاستماع إلى ما يلي:
WIFI_P2P_STATE_CHANGED_ACTION- يشير إلى ما إذا كان اتصال Wi-Fi مباشر مفعّلاً
WIFI_P2P_PEERS_CHANGED_ACTION- يشير إلى أنّ قائمة الأجهزة النظيرة المتاحة قد تغيّرت.
WIFI_P2P_CONNECTION_CHANGED_ACTION-
يشير إلى أنّ حالة اتصال Wi-Fi مباشر قد تغيّرت. بدءًا من
Android 10، لا يكون هذا الإجراء ثابتًا. إذا كان تطبيقك يعتمد على تلقّي عمليات البث هذه
عند التسجيل لأنّها كانت ثابتة، استخدِم الطريقة المناسبة
getعند الإعداد للحصول على المعلومات بدلاً من ذلك. WIFI_P2P_THIS_DEVICE_CHANGED_ACTION-
يشير إلى أنّ تفاصيل إعدادات هذا الجهاز قد تغيّرت. بدءًا من
Android 10، لا يكون هذا الإجراء ثابتًا. إذا كان تطبيقك يعتمد على تلقّي عمليات البث هذه
عند التسجيل لأنّها كانت ثابتة، استخدِم الطريقة المناسبة
getعند الإعداد للحصول على المعلومات بدلاً من ذلك.
Kotlin
private val intentFilter = IntentFilter() ... override fun onCreate(savedInstanceState: Bundle?) { super.onCreate(savedInstanceState) setContentView(R.layout.main) // Indicates a change in the Wi-Fi Direct status. intentFilter.addAction(WifiP2pManager.WIFI_P2P_STATE_CHANGED_ACTION) // Indicates a change in the list of available peers. intentFilter.addAction(WifiP2pManager.WIFI_P2P_PEERS_CHANGED_ACTION) // Indicates the state of Wi-Fi Direct connectivity has changed. intentFilter.addAction(WifiP2pManager.WIFI_P2P_CONNECTION_CHANGED_ACTION) // Indicates this device's details have changed. intentFilter.addAction(WifiP2pManager.WIFI_P2P_THIS_DEVICE_CHANGED_ACTION) ... }
Java
private final IntentFilter intentFilter = new IntentFilter(); ... @Override public void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.main); // Indicates a change in the Wi-Fi Direct status. intentFilter.addAction(WifiP2pManager.WIFI_P2P_STATE_CHANGED_ACTION); // Indicates a change in the list of available peers. intentFilter.addAction(WifiP2pManager.WIFI_P2P_PEERS_CHANGED_ACTION); // Indicates the state of Wi-Fi Direct connectivity has changed. intentFilter.addAction(WifiP2pManager.WIFI_P2P_CONNECTION_CHANGED_ACTION); // Indicates this device's details have changed. intentFilter.addAction(WifiP2pManager.WIFI_P2P_THIS_DEVICE_CHANGED_ACTION); ... }
في نهاية طريقة onCreate()، احصل على مثيل من WifiP2pManager واستدعِ طريقة initialize(). تعرض هذه الطريقة كائن WifiP2pManager.Channel، الذي ستستخدمه لاحقًا لربط تطبيقك بإطار عمل اتصال Wi-Fi مباشر.
Kotlin
private lateinit var channel: WifiP2pManager.Channel private lateinit var manager: WifiP2pManager override fun onCreate(savedInstanceState: Bundle?) { ... manager = getSystemService(Context.WIFI_P2P_SERVICE) as WifiP2pManager channel = manager.initialize(this, mainLooper, null) }
Java
Channel channel; WifiP2pManager manager; @Override public void onCreate(Bundle savedInstanceState) { ... manager = (WifiP2pManager) getSystemService(Context.WIFI_P2P_SERVICE); channel = manager.initialize(this, getMainLooper(), null); }
الآن، أنشئ فئة BroadcastReceiver جديدة ستستخدمها للاستماع إلى التغييرات في حالة Wi-Fi للنظام. في طريقة onReceive()، أضِف شرطًا للتعامل مع كل تغيير في الحالة مدرَج أعلاه.
Kotlin
override fun onReceive(context: Context, intent: Intent) { when(intent.action) { WifiP2pManager.WIFI_P2P_STATE_CHANGED_ACTION -> { // Determine if Wi-Fi Direct mode is enabled or not, alert // the Activity. val state = intent.getIntExtra(WifiP2pManager.EXTRA_WIFI_STATE, -1) activity.isWifiP2pEnabled = state == WifiP2pManager.WIFI_P2P_STATE_ENABLED } WifiP2pManager.WIFI_P2P_PEERS_CHANGED_ACTION -> { // The peer list has changed! We should probably do something about // that. } WifiP2pManager.WIFI_P2P_CONNECTION_CHANGED_ACTION -> { // Connection state changed! We should probably do something about // that. } WifiP2pManager.WIFI_P2P_THIS_DEVICE_CHANGED_ACTION -> { (activity.supportFragmentManager.findFragmentById(R.id.frag_list) as DeviceListFragment) .apply { updateThisDevice( intent.getParcelableExtra( WifiP2pManager.EXTRA_WIFI_P2P_DEVICE) as WifiP2pDevice ) } } } }
Java
@Override public void onReceive(Context context, Intent intent) { String action = intent.getAction(); if (WifiP2pManager.WIFI_P2P_STATE_CHANGED_ACTION.equals(action)) { // Determine if Wi-Fi Direct mode is enabled or not, alert // the Activity. int state = intent.getIntExtra(WifiP2pManager.EXTRA_WIFI_STATE, -1); if (state == WifiP2pManager.WIFI_P2P_STATE_ENABLED) { activity.setIsWifiP2pEnabled(true); } else { activity.setIsWifiP2pEnabled(false); } } else if (WifiP2pManager.WIFI_P2P_PEERS_CHANGED_ACTION.equals(action)) { // The peer list has changed! We should probably do something about // that. } else if (WifiP2pManager.WIFI_P2P_CONNECTION_CHANGED_ACTION.equals(action)) { // Connection state changed! We should probably do something about // that. } else if (WifiP2pManager.WIFI_P2P_THIS_DEVICE_CHANGED_ACTION.equals(action)) { DeviceListFragment fragment = (DeviceListFragment) activity.getFragmentManager() .findFragmentById(R.id.frag_list); fragment.updateThisDevice((WifiP2pDevice) intent.getParcelableExtra( WifiP2pManager.EXTRA_WIFI_P2P_DEVICE)); } }
أخيرًا، أضِف رمزًا لتسجيل intent filter ومستقبِل البث عندما يكون نشاطك الرئيسي مفعّلاً، وألغِ تسجيلهما عندما يتم إيقاف النشاط مؤقتًا.
أفضل مكان لإجراء ذلك هو الطريقتان onResume() وonPause().
Kotlin
/** register the BroadcastReceiver with the intent values to be matched */ public override fun onResume() { super.onResume() receiver = WiFiDirectBroadcastReceiver(manager, channel, this) registerReceiver(receiver, intentFilter) } public override fun onPause() { super.onPause() unregisterReceiver(receiver) }
Java
/** register the BroadcastReceiver with the intent values to be matched */ @Override public void onResume() { super.onResume(); receiver = new WiFiDirectBroadcastReceiver(manager, channel, this); registerReceiver(receiver, intentFilter); } @Override public void onPause() { super.onPause(); unregisterReceiver(receiver); }
بدء عملية استكشاف الأجهزة النظيرة
لبدء البحث عن الأجهزة المجاورة باستخدام شبكة Wi-Fi P2P، استدعِ discoverPeers(). تأخذ هذه الطريقة الوسيطتَين التاليتَين:
WifiP2pManager.Channelالذي تلقّيته عند إعداد mManager للند للند- تنفيذ
WifiP2pManager.ActionListenerمع الطرق التي يستدعيها النظام عند نجاح عملية الاستكشاف أو عدم نجاحها
Kotlin
manager.discoverPeers(channel, object : WifiP2pManager.ActionListener { override fun onSuccess() { // Code for when the discovery initiation is successful goes here. // No services have actually been discovered yet, so this method // can often be left blank. Code for peer discovery goes in the // onReceive method, detailed below. } override fun onFailure(reasonCode: Int) { // Code for when the discovery initiation fails goes here. // Alert the user that something went wrong. } })
Java
manager.discoverPeers(channel, new WifiP2pManager.ActionListener() { @Override public void onSuccess() { // Code for when the discovery initiation is successful goes here. // No services have actually been discovered yet, so this method // can often be left blank. Code for peer discovery goes in the // onReceive method, detailed below. } @Override public void onFailure(int reasonCode) { // Code for when the discovery initiation fails goes here. // Alert the user that something went wrong. } });
ضَع في اعتبارك أنّ هذا الإجراء يبدأ فقط عملية استكشاف الأجهزة النظيرة. تبدأ طريقة discoverPeers() عملية الاستكشاف ثم تعرض على الفور. يُعلمك النظام إذا تم بدء عملية استكشاف الأجهزة النظيرة بنجاح من خلال استدعاء الطرق في مستمع الإجراء المقدَّم.
تظل عملية الاستكشاف مفعّلة أيضًا إلى أن يتم بدء اتصال أو يتم تشكيل مجموعة P2P.
جلب قائمة الأجهزة النظيرة
الآن، اكتب الرمز الذي يجلب قائمة الأجهزة النظيرة ويعالجها. أولاً، نفِّذ واجهة WifiP2pManager.PeerListListener، التي تقدّم معلومات عن الأجهزة النظيرة التي رصدتها ميزة اتصال Wi-Fi مباشر. تسمح هذه المعلومات أيضًا لتطبيقك بتحديد متى تنضم الأجهزة النظيرة إلى الشبكة أو تغادرها. يوضّح مقتطف الرمز التالي هذه العمليات المتعلقة بالأجهزة النظيرة:
Kotlin
private val peers = mutableListOf<WifiP2pDevice>() ... private val peerListListener = WifiP2pManager.PeerListListener { peerList -> val refreshedPeers = peerList.deviceList if (refreshedPeers != peers) { peers.clear() peers.addAll(refreshedPeers) // If an AdapterView is backed by this data, notify it // of the change. For instance, if you have a ListView of // available peers, trigger an update. (listAdapter as WiFiPeerListAdapter).notifyDataSetChanged() // Perform any other updates needed based on the new list of // peers connected to the Wi-Fi P2P network. } if (peers.isEmpty()) { Log.d(TAG, "No devices found") return@PeerListListener } }
Java
private List<WifiP2pDevice> peers = new ArrayList<WifiP2pDevice>(); ... private PeerListListener peerListListener = new PeerListListener() { @Override public void onPeersAvailable(WifiP2pDeviceList peerList) { List<WifiP2pDevice> refreshedPeers = peerList.getDeviceList(); if (!refreshedPeers.equals(peers)) { peers.clear(); peers.addAll(refreshedPeers); // If an AdapterView is backed by this data, notify it // of the change. For instance, if you have a ListView of // available peers, trigger an update. ((WiFiPeerListAdapter) getListAdapter()).notifyDataSetChanged(); // Perform any other updates needed based on the new list of // peers connected to the Wi-Fi P2P network. } if (peers.size() == 0) { Log.d(WiFiDirectActivity.TAG, "No devices found"); return; } } }
الآن، عدِّل طريقة onReceive() لجهاز استقبال البث لاستدعاء requestPeers() عند تلقّي غرض يتضمّن الإجراء WIFI_P2P_PEERS_CHANGED_ACTION. عليك تمرير هذا المتتبِّع إلى جهاز الاستقبال بطريقة ما. إحدى الطرق هي إرساله كوسيطة إلى منشئ مستقبِل البث.
Kotlin
fun onReceive(context: Context, intent: Intent) { when (intent.action) { ... WifiP2pManager.WIFI_P2P_PEERS_CHANGED_ACTION -> { // Request available peers from the wifi p2p manager. This is an // asynchronous call and the calling activity is notified with a // callback on PeerListListener.onPeersAvailable() mManager?.requestPeers(channel, peerListListener) Log.d(TAG, "P2P peers changed") } ... } }
Java
public void onReceive(Context context, Intent intent) { ... else if (WifiP2pManager.WIFI_P2P_PEERS_CHANGED_ACTION.equals(action)) { // Request available peers from the wifi p2p manager. This is an // asynchronous call and the calling activity is notified with a // callback on PeerListListener.onPeersAvailable() if (mManager != null) { mManager.requestPeers(channel, peerListListener); } Log.d(WiFiDirectActivity.TAG, "P2P peers changed"); }... }
الآن، يؤدي غرض يتضمّن الإجراء WIFI_P2P_PEERS_CHANGED_ACTION إلى طلب قائمة محدَّثة بالأجهزة النظيرة.
الاتصال بجهاز نظير
للاتصال بجهاز نظير، أنشئ كائن WifiP2pConfig جديدًا وانسخ البيانات إليه من WifiP2pDevice الذي يمثّل الجهاز الذي تريد الاتصال به. بعد ذلك، استدعِ طريقة connect().
Kotlin
override fun connect() { // Picking the first device found on the network. val device = peers[0] val config = WifiP2pConfig().apply { deviceAddress = device.deviceAddress wps.setup = WpsInfo.PBC } manager.connect(channel, config, object : WifiP2pManager.ActionListener { override fun onSuccess() { // WiFiDirectBroadcastReceiver notifies us. Ignore for now. } override fun onFailure(reason: Int) { Toast.makeText( this@WiFiDirectActivity, "Connect failed. Retry.", Toast.LENGTH_SHORT ).show() } }) }
Java
@Override public void connect() { // Picking the first device found on the network. WifiP2pDevice device = peers.get(0); WifiP2pConfig config = new WifiP2pConfig(); config.deviceAddress = device.deviceAddress; config.wps.setup = WpsInfo.PBC; manager.connect(channel, config, new ActionListener() { @Override public void onSuccess() { // WiFiDirectBroadcastReceiver notifies us. Ignore for now. } @Override public void onFailure(int reason) { Toast.makeText(WiFiDirectActivity.this, "Connect failed. Retry.", Toast.LENGTH_SHORT).show(); } }); }
إذا كان كل جهاز في مجموعتك يتيح ميزة Wi-Fi Direct، ليس عليك أن تطلب بشكلٍ صريح كلمة مرور المجموعة عند الاتصال. للسماح لجهاز لا يتيح ميزة اتصال Wi-Fi مباشر بالانضمام إلى مجموعة، عليك استرداد كلمة المرور هذه من خلال استدعاء requestGroupInfo()، كما هو موضّح في مقتطف الرمز التالي:
Kotlin
manager.requestGroupInfo(channel) { group -> val groupPassword = group.passphrase }
Java
manager.requestGroupInfo(channel, new GroupInfoListener() { @Override public void onGroupInfoAvailable(WifiP2pGroup group) { String groupPassword = group.getPassphrase(); } });
ضَع في اعتبارك أنّ WifiP2pManager.ActionListener الذي تم تنفيذه في طريقة connect() لا يُعلمك إلا عندما تنجح عملية البدء أو تفشل. للاستماع إلى التغييرات في حالة الاتصال، نفِّذ واجهة WifiP2pManager.ConnectionInfoListener.
يُعلمك رد الاتصال onConnectionInfoAvailable() عندما تتغيّر حالة الاتصال. في الحالات التي سيتم فيها ربط أجهزة متعددة بجهاز واحد (مثل لعبة تضم ثلاثة لاعبين أو أكثر أو تطبيق دردشة)، يتم تحديد جهاز واحد ليكون "مالك المجموعة". يمكنك تحديد جهاز معيّن ليكون
مالك المجموعة للشبكة من خلال اتّباع الخطوات الواردة في قسم
إنشاء مجموعة.
Kotlin
private val connectionListener = WifiP2pManager.ConnectionInfoListener { info -> // String from WifiP2pInfo struct val groupOwnerAddress: String = info.groupOwnerAddress.hostAddress // After the group negotiation, we can determine the group owner // (server). if (info.groupFormed && info.isGroupOwner) { // Do whatever tasks are specific to the group owner. // One common case is creating a group owner thread and accepting // incoming connections. } else if (info.groupFormed) { // The other device acts as the peer (client). In this case, // you'll want to create a peer thread that connects // to the group owner. } }
Java
@Override public void onConnectionInfoAvailable(final WifiP2pInfo info) { // String from WifiP2pInfo struct String groupOwnerAddress = info.groupOwnerAddress.getHostAddress(); // After the group negotiation, we can determine the group owner // (server). if (info.groupFormed && info.isGroupOwner) { // Do whatever tasks are specific to the group owner. // One common case is creating a group owner thread and accepting // incoming connections. } else if (info.groupFormed) { // The other device acts as the peer (client). In this case, // you'll want to create a peer thread that connects // to the group owner. } }
الآن، ارجع إلى طريقة onReceive() لجهاز استقبال البث، وعدِّل القسم الذي يستمع إلى غرض WIFI_P2P_CONNECTION_CHANGED_ACTION.
عند تلقّي هذا الغرض، استدعِ requestConnectionInfo(). هذا استدعاء غير متزامن، لذا يتم تلقّي النتائج من خلال مستمع معلومات الاتصال الذي تقدّمه كمعلَمة.
Kotlin
when (intent.action) { ... WifiP2pManager.WIFI_P2P_CONNECTION_CHANGED_ACTION -> { // Connection state changed! We should probably do something about // that. mManager?.let { manager -> val networkInfo: NetworkInfo? = intent .getParcelableExtra(WifiP2pManager.EXTRA_NETWORK_INFO) as NetworkInfo if (networkInfo?.isConnected == true) { // We are connected with the other device, request connection // info to find group owner IP manager.requestConnectionInfo(channel, connectionListener) } } } ... }
Java
... } else if (WifiP2pManager.WIFI_P2P_CONNECTION_CHANGED_ACTION.equals(action)) { if (manager == null) { return; } NetworkInfo networkInfo = (NetworkInfo) intent .getParcelableExtra(WifiP2pManager.EXTRA_NETWORK_INFO); if (networkInfo.isConnected()) { // We are connected with the other device, request connection // info to find group owner IP manager.requestConnectionInfo(channel, connectionListener); } ...
إنشاء مجموعة
إذا كنت تريد أن يكون الجهاز الذي يشغّل تطبيقك هو مالك المجموعة لشبكة تتضمّن أجهزة قديمة، أي الأجهزة التي لا تتيح ميزة اتصال Wi-Fi مباشر، عليك اتّباع التسلسل نفسه من الخطوات كما في قسم الاتصال بجهاز نظير، باستثناء أنّك تنشئ WifiP2pManager.ActionListener
باستخدام createGroup() بدلاً من connect(). يكون رد الاتصال الذي يتم التعامل معه ضمن WifiP2pManager.ActionListener هو نفسه، كما هو موضّح في مقتطف الرمز التالي:
Kotlin
manager.createGroup(channel, object : WifiP2pManager.ActionListener { override fun onSuccess() { // Device is ready to accept incoming connections from peers. } override fun onFailure(reason: Int) { Toast.makeText( this@WiFiDirectActivity, "P2P group creation failed. Retry.", Toast.LENGTH_SHORT ).show() } })
Java
manager.createGroup(channel, new WifiP2pManager.ActionListener() { @Override public void onSuccess() { // Device is ready to accept incoming connections from peers. } @Override public void onFailure(int reason) { Toast.makeText(WiFiDirectActivity.this, "P2P group creation failed. Retry.", Toast.LENGTH_SHORT).show(); } });
ملاحظة: إذا كانت جميع الأجهزة في الشبكة تتيح ميزة Wi-Fi
Direct، يمكنك استخدام طريقة connect() على كل جهاز لأنّ الطريقة تنشئ المجموعة ثم تختار مالك المجموعة تلقائيًا.
بعد إنشاء مجموعة، يمكنك استدعاء requestGroupInfo() لاسترداد تفاصيل عن الأجهزة النظيرة على الشبكة، بما في ذلك أسماء الأجهزة وحالات الاتصال.