تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

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

يتيح اتصال Wi-Fi مباشر (من جهاز إلى جهاز) للأجهزة التي تتضمّن الأجهزة المناسبة الاتصال مباشرةً ببعضها البعض عبر شبكة 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 من إعلام نشاطك بحالة المكالمة. يوضّح الجدول 2 واجهات المستمعين المتاحة واستدعاءات طريقة WifiP2pManager المقابلة التي تستخدم المستمعين.

الجدول 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 Intents

النية	الوصف
`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:

أنشئ فئة توسّع الفئة BroadcastReceiver. بالنسبة إلى الدالة الإنشائية للفئة، ستستخدِم مَعلمات WifiP2pManager وWifiP2pManager.Channel والنشاط الذي سيتم تسجيل أداة استقبال البث فيه. يسمح ذلك لمستقبِل البث بإرسال التحديثات إلى النشاط، كما يتيح له الوصول إلى أجهزة Wi-Fi وقناة اتصال عند الحاجة.
في أداة استقبال البث، ابحث عن النوايا التي تهمّك في الطريقة 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 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 P2P إنشاء مسجّل بث وتسجيله لتطبيقك، واكتشاف الأجهزة المتصلة بالشبكة، والاتصال بجهاز آخر، ونقل البيانات إلى جهاز آخر. توضّح الأقسام التالية كيفية إجراء ذلك.

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

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

يجب طلب الإذن باستخدام أجهزة 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" />

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

تحقَّق مما إذا كانت ميزة 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 -> {
               // 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
   }
}
...
}

في طريقة 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);
   ...
}

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

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);
   ...
}

سجِّل أداة استقبال البث في طريقة 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);
}

بعد الحصول على WifiP2pManager.Channel وإعداد أداة استقبال البث، يمكن لتطبيقك إجراء طلبات إلى طرق Wi-Fi P2P وتلقّي أغراض Wi-Fi P2P.
نفِّذ تطبيقك باستخدام ميزات 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 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
   }
});

نقل البيانات

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

أنشئ ServerSocket. تنتظر هذه المقبس اتصالاً من عميل على منفذ محدّد ويتم حظرها إلى أن يحدث ذلك، لذا عليك تنفيذ ذلك في سلسلة محادثات في الخلفية.
أنشئ عميلاً Socket. يستخدم العميل عنوان IP ومنفذ مقبس الخادم للاتصال بجهاز الخادم.
إرسال البيانات من العميل إلى الخادم عندما يتم ربط مقبس العميل بمقبس الخادم بنجاح، يمكنك إرسال البيانات من العميل إلى الخادم باستخدام تدفقات البايت.
تنتظر مقبس الخادم اتصال العميل (باستخدام طريقة 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
           }
       }
   }
}