تسمح اتصال Wi-Fi Direct (المعروف أيضًا باسم شبكة الند للند أو P2P) لتطبيقك بالعثور على الأجهزة القريبة والتفاعل معها بسرعة الأجهزة، في نطاق يتجاوز إمكانات البلوتوث.
تسمح واجهات برمجة تطبيقات Wi-Fi Direct (P2P) للتطبيقات بالاتصال بالأجهزة القريبة بدون الحاجة إلى الاتصال بشبكة أو نقطة اتصال. إذا تم تصميم تطبيقك ليكون جزءًا من شبكة آمنة قريبة المدى أو Wi-Fi إنّ الاتصال المباشر هو خيار أكثر ملاءمةً من شبكة Wi-Fi المخصّصة التقليدية. التواصل الاجتماعي للأسباب التالية:
- يدعم اتصال Wi-Fi المباشر تشفير WPA2. (تتوافق بعض الشبكات المخصصة فقط تشفير WEP).
- يمكن للأجهزة بث الخدمات التي تقدمها، مما يساعد الأجهزة على اكتشاف أقران مناسبين بسهولة أكبر.
- عند تحديد الجهاز الذي يجب أن يكون مالك المجموعة للشبكة، تفحص شبكة Wi-Fi Direct إدارة الطاقة وواجهة المستخدم والخدمة لكل جهاز الإمكانات واستخدام هذه المعلومات لاختيار الجهاز الذي يمكنه التعامل مع ومسئوليات الخادم بشكل أكثر فاعلية.
- لا يدعم Android الوضع المخصّص لشبكة Wi-Fi.
يوضح لك هذا الدرس كيفية العثور على الأجهزة المجاورة والاتصال بها باستخدام شبكة Wi-Fi P2P.
إعداد أذونات التطبيقات
لاستخدام Wi-Fi Direct، أضف
ACCESS_FINE_LOCATION
,
CHANGE_WIFI_STATE
,
ACCESS_WIFI_STATE
،
INTERNET
من الأذونات إلى ملف البيان.
إذا كان تطبيقك يستهدف الإصدار 13 من نظام التشغيل Android (المستوى 33) أو إصدارًا أحدث، أضِف أيضًا السمة
NEARBY_WIFI_DEVICES
إذنًا بالوصول إلى البيان. اتصال Wi-Fi
لا يتطلب البث المباشر اتصالاً بالإنترنت، ولكنه يستخدم لغة Java قياسية
socks (المأخذ) التي تتطلّب توفُّر 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 Direct، تحتاج إلى الاستماع إلى أهداف البث التي تخبرك
التطبيق عند وقوع أحداث معينة. في تطبيقك، أنشأ مثيل
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)); } }
وأخيرًا، أضف رمزًا لتسجيل فلتر الأهداف ومتلقي البث عند
يكون نشاطك الرئيسي نشطًا، وإلغاء تسجيلهم عندما يكون النشاط متوقفًا مؤقتًا.
أفضل مكان للقيام بذلك هو 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 Direct
الجديدة. وتسمح هذه المعلومات أيضًا لتطبيقك بتحديد موعد انضمام التطبيقات المشابهة أو
أو مغادرة الشبكة. يوضح مقتطف الرمز التالي هذه العمليات
المتعلقة بالتطبيقات المشابهة:
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 المباشر، فلن تحتاج إلى
لطلب كلمة مرور المجموعة صراحةً عند الاتصال. للسماح بجهاز
لا يتوافق مع ميزة Wi-Fi Direct للانضمام إلى مجموعة، ومع ذلك، يجب أن
لاسترداد كلمة المرور هذه عن طريق استدعاء
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
بشكل مباشر، يمكنك استخدام طريقة connect()
على كل جهاز بسبب
تنشئ المجموعة وتختار مالك المجموعة تلقائيًا.
بعد إنشاء مجموعة، يمكنك الاتصال
requestGroupInfo()
لعرض تفاصيل عن التطبيقات المشابهة على
الشبكة، بما في ذلك أسماء الأجهزة وحالات الاتصال.