نظرة عامة على اتصال 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 P2P

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

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

الجدول 2: متتبِّعات اتصال Wi-Fi المباشر (P2P)

واجهة المستمع الإجراءات المرتبطة
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 P2P

Intent الوصف
WIFI_P2P_CONNECTION_CHANGED_ACTION يتم إرسال هذا الإشعار عند تغيير حالة اتصال الجهاز بشبكة Wi-Fi.
WIFI_P2P_PEERS_CHANGED_ACTION سيتم الإعلان عن ذلك عند الاتصال بـ "discoverPeers()". ستتصل عادةً بـ requestPeers() للحصول على قائمة محدّثة من النظراء إذا كنت تتعامل مع هذا الغرض في تطبيقك.
WIFI_P2P_STATE_CHANGED_ACTION يتم بث هذه الإشارة عند تفعيل Wi-Fi P2P أو إيقافه على الجهاز.
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_ACTION، يمكنك استدعاء الطريقة requestPeers() للحصول على قائمة بالأجهزة النظيرة التي تم اكتشافها حاليًا.

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

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 Wi-Fi 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 Wi-Fi state changing
       }
   }
}

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

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

إنشاء تطبيق Wi-Fi P2P

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

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

قبل استخدام واجهات برمجة التطبيقات 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" />
    

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

  2. تحقَّق مما إذا كانت ميزة Wi-Fi P2P مفعَّلة ومتوافقة. يمكنك التحقّق من ذلك في مستقبل البث عند تلقّي الطلب WIFI_P2P_STATE_CHANGED_ACTION. إعلام نشاطك بحالة 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 -> {
                   // Wi-Fi 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) {
           // Wi-Fi 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. أنشئ intent filter وأضِف intents نفسها التي يتحقّق منها مستقبِل البث:

    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 من خلال استدعاء الطرق في 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 Wi-Fi 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);
       }
   }
}

على الجهاز، اتصِل بمقبس الخادم باستخدام مقبس الجهاز وانقل البيانات. ينقل هذا المثال ملف 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
           }
       }
   }
}