نظرة عامة على اتصال Wi-Fi المباشر (من نظير إلى نظير أو P2P)

اتصال Wi-Fi مباشر (P2P) يتيح للأجهزة التي تتضمّن الأجهزة المناسبة الاتصال مباشرةً ببعضها بواسطة Wi-Fi بدون نقطة وصول وسيطة. باستخدام واجهات برمجة التطبيقات هذه، يمكنك العثور على الأجهزة الأخرى والاتصال بها عندما يكون كل جهاز متوافقًا مع تقنية Wi-Fi P2P، ثم التواصل عبر اتصال سريع على مسافات أطول بكثير من اتصالات البلوتوث. يكون ذلك مفيدًا للتطبيقات التي تشارك البيانات بين المستخدِمين، مثل لعبة متعدّدة اللاعبين أو تطبيق لمشاركة الصور.

تتألف واجهات برمجة التطبيقات لبروتوكول Wi-Fi P2P من الأجزاء الرئيسية التالية:

• الطرق التي تتيح لك اكتشاف الأجهزة المشابهة وطلب ربطها والاتصال بها، والتي يتم تحديدها في فئة WifiP2pManager
• أدوات الاستماع التي تتيح لك تلقّي إشعارات بشأن نجاح أو تعذُّر طلبات WifiP2pManager عند استدعاء طرق WifiP2pManager، يمكن لكل أسلوب تلقّي مستمع محدّد يتم تمريره كمَعلمة.
• النوايا التي تُعلمك بأحداث معيّنة يرصدها إطار عمل Wi-Fi P2P ، مثل انقطاع الاتصال أو اكتشاف جهاز كمبيوتر شخصي متصل حديثًا

وغالبًا ما يتم استخدام هذه المكونات الثلاثة الرئيسية لواجهات برمجة التطبيقات معًا. على سبيل المثال، يمكنك منح WifiP2pManager.ActionListener إذنًا للاتصال بـ discoverPeers() كي تتمكّن من تلقّي إشعارات من خلال الطريقتَين ActionListener.onSuccess() وActionListener.onFailure(). يتم أيضًا بث نية WIFI_P2P_PEERS_CHANGED_ACTION إذا اكتشفت طريقة discoverPeers() أنّه تم تغيير قائمة النوى.

نظرة عامة على واجهة برمجة التطبيقات

توفّر فئة WifiP2pManager طُرقًا تتيح لك التفاعل مع مكونات Wi-Fi في جهازك لتنفيذ إجراءات مثل اكتشاف الأجهزة المشابهة والاتصال بها. تتوفّر الإجراءات التالية:

الجدول 1: طرق الاتصال المباشر عبر Wi-Fi

الطريقة	الوصف
initialize()	لتسجيل التطبيق في إطار عمل Wi-Fi يمكنك إجراء هذه المكالمة قبل إجراء أي مكالمة أخرى باستخدام تقنية "الاتصال من جهاز إلى جهاز" عبر Wi-Fi.
connect()	يبدأ اتصالاً بين الأجهزة من نظير إلى نظير مع جهاز بالإعدادات المحدّدة.
cancelConnect()	يؤدي ذلك إلى إلغاء أي تفاوض جارٍ بين الأجهزة في مجموعة الند للند.
requestConnectInfo()	يطلب معلومات الاتصال الخاصة بالجهاز.
createGroup()	يؤدي هذا الإجراء إلى إنشاء مجموعة من جهاز إلى جهاز مع تحديد الجهاز الحالي كمالك المجموعة.
removeGroup()	تزيل المجموعة الحالية للاتصال المباشر بين الأجهزة.
requestGroupInfo()	يطلب معلومات عن مجموعة الاتصال المباشر بين الأجهزة.
discoverPeers()	يبدأ عملية اكتشاف الأجهزة المشابهة.
requestPeers()	يطلب القائمة الحالية للأجهزة المتجاوبة التي تم اكتشافها.

تتيح لك طرق WifiP2pManager تمرير مستمع، حتى يتمكّن إطار عمل Wi-Fi P2P من إرسال إشعار إلى نشاطك بحالة المكالمة. في الجدول 2، يتم وصف واجهات المستمعين المتاحة وطلبات WifiP2pManager الطريقة المقابلة التي تستخدِم المستمعين.

الجدول 2: أدوات معالجة أحداث الاتصال من شخص إلى آخر عبر Wi-Fi

واجهة المستمع	الإجراءات المرتبطة
WifiP2pManager.ActionListener	connect() وcancelConnect() createGroup() وremoveGroup() discoverPeers()
WifiP2pManager.ChannelListener	initialize()
WifiP2pManager.ConnectionInfoListener	requestConnectInfo()
WifiP2pManager.GroupInfoListener	requestGroupInfo()
WifiP2pManager.PeerListListener	requestPeers()

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

الجدول 3: نوايا الاتصال المباشر عبر Wi-Fi

الهدف	الوصف
WIFI_P2P_CONNECTION_CHANGED_ACTION	البث عند تغيير حالة اتصال الجهاز بشبكة Wi-Fi
WIFI_P2P_PEERS_CHANGED_ACTION	فعِّل ميزة "البث" عند الاتصال بـ discoverPeers(). عادةً ما يتم الاتصال بـ requestPeers() للحصول على قائمة محدّثة بالتطبيقات المشابهة إذا كان تطبيقك يعالج هذا الإجراء.
WIFI_P2P_STATE_CHANGED_ACTION	البث عندما يكون الاتصال من نظير إلى نظير عبر Wi-Fi مفعَّلاً أو غير مفعَّل على الجهاز
WIFI_P2P_THIS_DEVICE_CHANGED_ACTION	البث عند تغيير تفاصيل الجهاز، مثل اسم الجهاز

إنشاء مستلِم بث لطلبات Wi-Fi P2P

يتيح لك جهاز استقبال البثّ تلقّي النوايا التي يبثّها نظام Android ، حتى يتمكّن تطبيقك من الاستجابة للأحداث التي تهمّك. في ما يلي الخطوات الأساسية لإنشاء جهاز استقبال للبث من أجل معالجة طلبات Wi-Fi P2P:

1. أنشئ فئة تمثّل توسيعًا لفئة BroadcastReceiver. في أسلوب إنشاء الفئة، ستستخدم مَعلمات WifiP2pManager WifiP2pManager.Channel والنشاط الذي سيتم تسجيل مستقبل البث فيه. يتيح ذلك لمستقبل البث إرسال آخر المعلومات إلى النشاط، بالإضافة إلى الوصول إلى جهاز Wi-Fi وقناة الاتصال إذا لزم الأمر.

2. في ملف استلام البث، ابحث عن النوايا التي تهمّك في الأسلوب onReceive(). اتّخِذ أي إجراءات ضرورية استنادًا إلى الطلب الذي يتم تلقّيه. على سبيل المثال، إذا تلقّى جهاز استقبال البث WIFI_P2P_PEERS_CHANGED_ACTIONintent، يمكنك استدعاء requestPeers() method للحصول على قائمة بالأجهزة المتجاوبة التي تم اكتشافها حاليًا.

توضِّح لك التعليمة البرمجية التالية كيفية إنشاء جهاز استقبال بث نموذجي. يأخذ WifiP2pManager broadcast receiver كائنًا ونشاطًا كوسيطات ويستخدم هاتين الفئتَين لتنفيذ الإجراءات المطلوبة بشكلٍ مناسب عندما يتلقّى WifiP2pManager broadcast receiver نية:

Kotlin

/**
* A BroadcastReceiver that notifies of important Wi-Fi p2p events.
*/
class WiFiDirectBroadcastReceiver(
       private val manager: WifiP2pManager,
       private val channel: WifiP2pManager.Channel,
       private val activity: MyWifiActivity
) : BroadcastReceiver() {

   override fun onReceive(context: Context, intent: Intent) {
       val action: String = intent.action
       when (action) {
           WifiP2pManager.WIFI_P2P_STATE_CHANGED_ACTION -> {
               // Check to see if Wi-Fi is enabled and notify appropriate activity
           }
           WifiP2pManager.WIFI_P2P_PEERS_CHANGED_ACTION -> {
               // Call WifiP2pManager.requestPeers() to get a list of current peers
           }
           WifiP2pManager.WIFI_P2P_CONNECTION_CHANGED_ACTION -> {
               // Respond to new connection or disconnections
           }
           WifiP2pManager.WIFI_P2P_THIS_DEVICE_CHANGED_ACTION -> {
               // Respond to this device's wifi state changing
           }
       }
   }
}

Java

/**
* A BroadcastReceiver that notifies of important Wi-Fi p2p events.
*/
public class WiFiDirectBroadcastReceiver extends BroadcastReceiver {

   private WifiP2pManager manager;
   private Channel channel;
   private MyWiFiActivity activity;

   public WiFiDirectBroadcastReceiver(WifiP2pManager manager, Channel channel,
           MyWifiActivity activity) {
       super();
       this.manager = manager;
       this.channel = channel;
       this.activity = activity;
   }

   @Override
   public void onReceive(Context context, Intent intent) {
       String action = intent.getAction();

       if (WifiP2pManager.WIFI_P2P_STATE_CHANGED_ACTION.equals(action)) {
           // Check to see if Wi-Fi is enabled and notify appropriate activity
       } else if (WifiP2pManager.WIFI_P2P_PEERS_CHANGED_ACTION.equals(action)) {
           // Call WifiP2pManager.requestPeers() to get a list of current peers
       } else if (WifiP2pManager.WIFI_P2P_CONNECTION_CHANGED_ACTION.equals(action)) {
           // Respond to new connection or disconnections
       } else if (WifiP2pManager.WIFI_P2P_THIS_DEVICE_CHANGED_ACTION.equals(action)) {
           // Respond to this device's wifi state changing
       }
   }
}

على الأجهزة التي تعمل بالإصدار Android 10 والإصدارات الأحدث، تكون نوايا البث التالية غير ثابتة:

WIFI_P2P_CONNECTION_CHANGED_ACTION

يمكن للتطبيقات استخدام requestConnectionInfo() أو requestNetworkInfo() أو requestGroupInfo() لاسترداد معلومات الاتصال الحالية.

WIFI_P2P_THIS_DEVICE_CHANGED_ACTION

يمكن للتطبيقات استخدام requestDeviceInfo() لاسترداد معلومات الاتصال الحالية.

إنشاء تطبيق للاتصال المباشر عبر Wi-Fi

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

الإعداد الأولي

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

1. اطلب إذنًا لاستخدام جهاز Wi-Fi على الجهاز وأعلن أنّ تطبيقك يتضمّن الحد الأدنى الصحيح لإصدار حزمة SDK في بيان Android:

   <uses-sdk android:minSdkVersion="14" />
   <uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
   <uses-permission android:name="android.permission.CHANGE_WIFI_STATE" />
   <uses-permission android:name="android.permission.CHANGE_NETWORK_STATE" />
   <uses-permission android:name="android.permission.INTERNET" />
   <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
   <!-- 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: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" />
   

   ملاحظة: في التطبيقات التي تستهدف الإصدار 13 من نظام التشغيل Android (المستوى 33 لواجهة برمجة التطبيقات) والإصدارات الأحدث، يتطلب كل من discoverPeers() وconnect() الحصول على الإذن android.permission.NEARBY_WIFI_DEVICES. في التطبيقات التي تستهدف إصدارات Android الأقدم، تتطلّب هذه الخطوات الحصول على إذن ACCESS_FINE_LOCATION بدلاً من ذلك. بما أنّ هذه الأذونات هي أذونات خطيرة، عليك طلبها في وقت التشغيل قبل أن تتمكّن من الاتصال بـ discoverPeers() أو connect().

   بالإضافة إلى الأذونات السابقة، تتطلّب واجهات برمجة التطبيقات التالية أيضًا تفعيل "وضع الموقع الجغرافي":

   • discoverPeers()
   • discoverServices()
   • requestPeers()

2. تحقَّق ممّا إذا كانت تقنية Wi-Fi P2P مفعَّلة ومتوفّرة. يمكنك التحقّق من ذلك في مستقبل البث عند تلقّيه WIFI_P2P_STATE_CHANGED_ACTIONintent. يمكنك إعلام نشاطك بحالة ميزة Wi-Fi P2P واتخاذ الإجراء المناسب وفقًا لذلك:

   Kotlin

   override fun onReceive(context: Context, intent: Intent) {
   ...
   val action: String = intent.action
   when (action) {
      WifiP2pManager.WIFI_P2P_STATE_CHANGED_ACTION -> {
          val state = intent.getIntExtra(WifiP2pManager.EXTRA_WIFI_STATE, -1)
          when (state) {
              WifiP2pManager.WIFI_P2P_STATE_ENABLED -> {
                  // Wifi P2P is enabled
              }
              else -> {
                  // Wi-Fi P2P is not enabled
              }
          }
      }
   }
   ...
   }
   

   Java

   @Override
   public void onReceive(Context context, Intent intent) {
   ...
   String action = intent.getAction();
   if (WifiP2pManager.WIFI_P2P_STATE_CHANGED_ACTION.equals(action)) {
      int state = intent.getIntExtra(WifiP2pManager.EXTRA_WIFI_STATE, -1);
      if (state == WifiP2pManager.WIFI_P2P_STATE_ENABLED) {
          // Wifi P2P is enabled
      } else {
          // Wi-Fi P2P is not enabled
      }
   }
   ...
   }
   

3. في onCreate() طريقة نشاطك، احصل على مثيل من WifiP2pManager وسجِّل تطبيقك بإطار عمل Wi-Fi P2P من خلال الاتصال بـ initialize(). تُرجِع هذه الطريقة WifiP2pManager.Channel، والذي يُستخدَم لربط تطبيقك بإطار عمل Wi-Fi P2P. يجب أيضًا إنشاء مثيل لمستقبل البث باستخدام العنصرَين WifiP2pManager وWifiP2pManager.Channel مع إشارة إلى نشاطك. يتيح ذلك لجهاز استقبال البث إعلام نشاطك بالأحداث المثيرة للاهتمام وتعديله وفقًا لذلك. وتتيح لك هذه الميزة أيضًا التلاعب بحالة Wi-Fi على الجهاز إذا لزم الأمر:

   Kotlin

   val manager: WifiP2pManager? by lazy(LazyThreadSafetyMode.NONE) {
      getSystemService(Context.WIFI_P2P_SERVICE) as WifiP2pManager?
   }
   
   var channel: WifiP2pManager.Channel? = null
   var receiver: BroadcastReceiver? = null
   
   override fun onCreate(savedInstanceState: Bundle?) {
      ...
   
      channel = manager?.initialize(this, mainLooper, null)
      channel?.also { channel ->
          receiver = WiFiDirectBroadcastReceiver(manager, channel, this)
      }
   }
   

   Java

   WifiP2pManager manager;
   Channel channel;
   BroadcastReceiver receiver;
   ...
   @Override
   protected void onCreate(Bundle savedInstanceState){
      ...
      manager = (WifiP2pManager) getSystemService(Context.WIFI_P2P_SERVICE);
      channel = manager.initialize(this, getMainLooper(), null);
      receiver = new WiFiDirectBroadcastReceiver(manager, channel, this);
      ...
   }
   

4. أنشئ فلتر أهداف وأضِف الأهداف نفسها التي يبحث عنها مستقبل البث:

   Kotlin

   val intentFilter = IntentFilter().apply {
      addAction(WifiP2pManager.WIFI_P2P_STATE_CHANGED_ACTION)
      addAction(WifiP2pManager.WIFI_P2P_PEERS_CHANGED_ACTION)
      addAction(WifiP2pManager.WIFI_P2P_CONNECTION_CHANGED_ACTION)
      addAction(WifiP2pManager.WIFI_P2P_THIS_DEVICE_CHANGED_ACTION)
   }
   

   Java

   IntentFilter intentFilter;
   ...
   @Override
   protected void onCreate(Bundle savedInstanceState){
      ...
      intentFilter = new IntentFilter();
      intentFilter.addAction(WifiP2pManager.WIFI_P2P_STATE_CHANGED_ACTION);
      intentFilter.addAction(WifiP2pManager.WIFI_P2P_PEERS_CHANGED_ACTION);
      intentFilter.addAction(WifiP2pManager.WIFI_P2P_CONNECTION_CHANGED_ACTION);
      intentFilter.addAction(WifiP2pManager.WIFI_P2P_THIS_DEVICE_CHANGED_ACTION);
      ...
   }
   

5. سجِّل مستقبل البث في onResume() في ملف نشاطك، وألغِ تسجيله في onPause() في ملف نشاطك:

   Kotlin

   /* register the broadcast receiver with the intent values to be matched */
   override fun onResume() {
      super.onResume()
      receiver?.also { receiver ->
          registerReceiver(receiver, intentFilter)
      }
   }
   
   /* unregister the broadcast receiver */
   override fun onPause() {
      super.onPause()
      receiver?.also { receiver ->
          unregisterReceiver(receiver)
      }
   }
   

   Java

   /* register the broadcast receiver with the intent values to be matched */
   @Override
   protected void onResume() {
      super.onResume();
      registerReceiver(receiver, intentFilter);
   }
   /* unregister the broadcast receiver */
   @Override
   protected void onPause() {
      super.onPause();
      unregisterReceiver(receiver);
   }
   

6. بعد الحصول على WifiP2pManager.Channel وإعداد جهاز استقبال بث، يمكن لتطبيقك إجراء طلبات باستخدام طريقة Wi-Fi P2P وتلقّي نوايا Wi-Fi P2P.

7. نفِّذ تطبيقك باستخدام ميزات Wi-Fi P2P من خلال استدعاء methods في WifiP2pManager.

توضّح الأقسام التالية كيفية تنفيذ الإجراءات الشائعة، مثل اكتشاف الأجهزة المشابهة والاتصال بها.

التعرّف على التطبيقات المشابهة

اتصل بـ discoverPeers() لرصد الأجهزة المتوافقة المتوفّرة في النطاق والمتوفّرة للاتصال. إنّ استدعاء هذه الدالة غير متزامن ويتم إرسال حالة النجاح أو التعذُّر إلى تطبيقك باستخدام onSuccess() وonFailure() إذا أنشأت WifiP2pManager.ActionListener. لا تُعلمك طريقة onSuccess() إلا بنجاح عملية الاكتشاف، ولا تقدّم أي معلومات عن الأجهزة المتناظرة التي تم اكتشافها، إن وجدت. يوضّح رمز النموذج التالي كيفية إعداد ذلك.

Kotlin

manager?.discoverPeers(channel, object : WifiP2pManager.ActionListener {

   override fun onSuccess() {
       ...
   }

   override fun onFailure(reasonCode: Int) {
       ...
   }
})

Java

manager.discoverPeers(channel, new WifiP2pManager.ActionListener() {
   @Override
   public void onSuccess() {
       ...
   }

   @Override
   public void onFailure(int reasonCode) {
       ...
   }
});

إذا نجحت عملية الاكتشاف ورصدت الأجهزة المشابهة، يُرسِل النظام نية WIFI_P2P_PEERS_CHANGED_ACTION التي يمكنك الاستماع إليها في جهاز استقبال البث للحصول على قائمة بالأجهزة المشابهة. عندما يتلقّى تطبيقك نية WIFI_P2P_PEERS_CHANGED_ACTION، يمكنك طلب قائمة بالمثيل الذين تم اكتشافهم باستخدام requestPeers(). توضّح التعليمة البرمجية التالية كيفية إعداد ذلك.

Kotlin

override fun onReceive(context: Context, intent: Intent) {
   val action: String = intent.action
   when (action) {
       ...
       WifiP2pManager.WIFI_P2P_PEERS_CHANGED_ACTION -> {
           manager?.requestPeers(channel) { peers: WifiP2pDeviceList? ->
               // Handle peers list
           }
       }
       ...
   }
}

Java

PeerListListener myPeerListListener;
...
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 (manager != null) {
       manager.requestPeers(channel, myPeerListListener);
   }
}

إنّ طريقة requestPeers() غير متزامنة أيضًا ويمكنها إرسال إشعارات إلى نشاطك عندما تتوفّر قائمة بالنظيرِين باستخدام onPeersAvailable()، الذي تم تحديده في واجهة WifiP2pManager.PeerListListener. تمنحك الطريقة onPeersAvailable() WifiP2pDeviceList، والتي يمكنك تكرارها للعثور على المثيّر الذي تريد الاتصال به.

التواصل مع التطبيقات المشابهة

بعد الحصول على قائمة بالنُسخ المشابهة المحتملة واختيار جهاز للاتصال به، يمكنك استدعاء طريقة connect() للاتصال بالجهاز. تتطلّب دعوة هذه الطريقة عنصر WifiP2pConfig يحتوي على معلومات عن الجهاز المطلوب الاتصال به. يمكن أن يُعلمك WifiP2pManager.ActionListener بنجاح عملية الربط أو تعذّرها. توضِّح لك التعليمة البرمجية التالية كيفية إنشاء اتصال بجهاز.

Kotlin

val device: WifiP2pDevice = ...
val config = WifiP2pConfig()
config.deviceAddress = device.deviceAddress
channel?.also { channel ->
   manager?.connect(channel, config, object : WifiP2pManager.ActionListener {

       override fun onSuccess() {
           //success logic
       }

       override fun onFailure(reason: Int) {
           //failure logic
       }
   }
)}

Java

//obtain a peer from the WifiP2pDeviceList
WifiP2pDevice device;
WifiP2pConfig config = new WifiP2pConfig();
config.deviceAddress = device.deviceAddress;
manager.connect(channel, config, new ActionListener() {

   @Override
   public void onSuccess() {
       //success logic
   }

   @Override
   public void onFailure(int reason) {
       //failure logic
   }
});

نقل البيانات

بعد إجراء عملية الربط، يمكنك نقل البيانات بين الأجهزة باستخدام المقابس. في ما يلي الخطوات الأساسية لنقل البيانات:

1. أنشئ ServerSocket. ينتظر مقبس الشبكة اتصالاً من عميل على منفذ محدّد ويتوقّف إلى أن يتم ذلك، لذا عليك إجراء ذلك في سلسلة محادثات في الخلفية.
2. أنشئ حساب عميل Socket. يستخدم العميل عنوان IP ومنفذ مقبس الخادم للاتصال بجهاز الخادم.
3. إرسال البيانات من العميل إلى الخادم عندما يتم اتصال مقبس العميل بنجاح بمقبس الخادم، يمكنك إرسال البيانات من العميل إلى الخادم باستخدام تدفّقات البايتات.
4. ينتظر مقبس الخادم اتصال العميل (باستخدام الأسلوب accept()). يؤدي هذا الطلب إلى التوقف إلى أن يتصل عميل، لذا يجب استدعاؤه في سلسلة محادثات أخرى. عند اكتمال عملية الربط، يمكن لجهاز الخادم تلقّي البيانات من جهاز العميل.

يوضّح لك المثال التالي، الذي تم تعديله من العرض التمهيدي لبروتوكول Wi-Fi P2P، كيفية إنشاء هذا الاتصال بين مقبس العميل والخادم ونقل صور JPEG من العميل إلى الخادم باستخدام خدمة. للحصول على مثال كامل وعملي، يمكنك تجميع الإصدار التجريبي وتشغيله.

Kotlin

class FileServerAsyncTask(
       private val context: Context,
       private var statusText: TextView
) : AsyncTask<Void, Void, String?>() {

   override fun doInBackground(vararg params: Void): String? {
       /**
        * Create a server socket.
        */
       val serverSocket = ServerSocket(8888)
       return serverSocket.use {
           /**
            * Wait for client connections. This call blocks until a
            * connection is accepted from a client.
            */
           val client = serverSocket.accept()
           /**
            * If this code is reached, a client has connected and transferred data
            * Save the input stream from the client as a JPEG file
            */
           val f = File(Environment.getExternalStorageDirectory().absolutePath +
                   "/${context.packageName}/wifip2pshared-${System.currentTimeMillis()}.jpg")
           val dirs = File(f.parent)

           dirs.takeIf { it.doesNotExist() }?.apply {
               mkdirs()
           }
           f.createNewFile()
           val inputstream = client.getInputStream()
           copyFile(inputstream, FileOutputStream(f))
           serverSocket.close()
           f.absolutePath
       }
   }

   private fun File.doesNotExist(): Boolean = !exists()

   /**
    * Start activity that can handle the JPEG image
    */
   override fun onPostExecute(result: String?) {
       result?.run {
           statusText.text = "File copied - $result"
           val intent = Intent(android.content.Intent.ACTION_VIEW).apply {
               setDataAndType(Uri.parse("file://$result"), "image/*")
           }
           context.startActivity(intent)
       }
   }
}

Java

public static class FileServerAsyncTask extends AsyncTask {

   private Context context;
   private TextView statusText;

   public FileServerAsyncTask(Context context, View statusText) {
       this.context = context;
       this.statusText = (TextView) statusText;
   }

   @Override
   protected String doInBackground(Void... params) {
       try {

           /**
            * Create a server socket and wait for client connections. This
            * call blocks until a connection is accepted from a client
            */
           ServerSocket serverSocket = new ServerSocket(8888);
           Socket client = serverSocket.accept();

           /**
            * If this code is reached, a client has connected and transferred data
            * Save the input stream from the client as a JPEG file
            */
           final File f = new File(Environment.getExternalStorageDirectory() + "/"
                   + context.getPackageName() + "/wifip2pshared-" + System.currentTimeMillis()
                   + ".jpg");

           File dirs = new File(f.getParent());
           if (!dirs.exists())
               dirs.mkdirs();
           f.createNewFile();
           InputStream inputstream = client.getInputStream();
           copyFile(inputstream, new FileOutputStream(f));
           serverSocket.close();
           return f.getAbsolutePath();
       } catch (IOException e) {
           Log.e(WiFiDirectActivity.TAG, e.getMessage());
           return null;
       }
   }

   /**
    * Start activity that can handle the JPEG image
    */
   @Override
   protected void onPostExecute(String result) {
       if (result != null) {
           statusText.setText("File copied - " + result);
           Intent intent = new Intent();
           intent.setAction(android.content.Intent.ACTION_VIEW);
           intent.setDataAndType(Uri.parse("file://" + result), "image/*");
           context.startActivity(intent);
       }
   }
}

على العميل، يتصل بمقبس الخادم باستخدام مقبس عميل وينقل data. ينقل هذا المثال ملف JPEG على نظام ملفات جهاز العميل.

Kotlin

val context = applicationContext
val host: String
val port: Int
val len: Int
val socket = Socket()
val buf = ByteArray(1024)
...
try {
   /**
    * Create a client socket with the host,
    * port, and timeout information.
    */
   socket.bind(null)
   socket.connect((InetSocketAddress(host, port)), 500)

   /**
    * Create a byte stream from a JPEG file and pipe it to the output stream
    * of the socket. This data is retrieved by the server device.
    */
   val outputStream = socket.getOutputStream()
   val cr = context.contentResolver
   val inputStream: InputStream = cr.openInputStream(Uri.parse("path/to/picture.jpg"))
   while (inputStream.read(buf).also { len = it } != -1) {
       outputStream.write(buf, 0, len)
   }
   outputStream.close()
   inputStream.close()
} catch (e: FileNotFoundException) {
   //catch logic
} catch (e: IOException) {
   //catch logic
} finally {
   /**
    * Clean up any open sockets when done
    * transferring or if an exception occurred.
    */
   socket.takeIf { it.isConnected }?.apply {
       close()
   }
}

Java

Context context = this.getApplicationContext();
String host;
int port;
int len;
Socket socket = new Socket();
byte buf[]  = new byte[1024];
...
try {
   /**
    * Create a client socket with the host,
    * port, and timeout information.
    */
   socket.bind(null);
   socket.connect((new InetSocketAddress(host, port)), 500);

   /**
    * Create a byte stream from a JPEG file and pipe it to the output stream
    * of the socket. This data is retrieved by the server device.
    */
   OutputStream outputStream = socket.getOutputStream();
   ContentResolver cr = context.getContentResolver();
   InputStream inputStream = null;
   inputStream = cr.openInputStream(Uri.parse("path/to/picture.jpg"));
   while ((len = inputStream.read(buf)) != -1) {
       outputStream.write(buf, 0, len);
   }
   outputStream.close();
   inputStream.close();
} catch (FileNotFoundException e) {
   //catch logic
} catch (IOException e) {
   //catch logic
}

/**
* Clean up any open sockets when done
* transferring or if an exception occurred.
*/
finally {
   if (socket != null) {
       if (socket.isConnected()) {
           try {
               socket.close();
           } catch (IOException e) {
               //catch logic
           }
       }
   }
}