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

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

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

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

إن الطرق التي تسمح لك باكتشاف الزملاء وطلبهم والتواصل معهم، وهي المحدد في صف واحد (WifiP2pManager).
أدوات معالجة الموسيقى التي تسمح لك بإعلامك بنجاح أو فشل طلب بيانات طريقة WifiP2pManager عند استدعاء طرق WifiP2pManager، يمكن لكل methodتلقّي مستمع محدّد يتم تمريره كمَعلمة.
أهداف تُعلمك بأحداث معيّنة ترصدها شبكة 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 P2P.
`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 :

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

يُرجى طلب إذن لاستخدام أجهزة Wi-Fi على الجهاز وتقديم بيان عنه أن يتضمَّن تطبيقك الحد الأدنى الصحيح لإصدار SDK في نظام التشغيل Android manifest:

<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). إرسال إشعار بنشاط P2P إلى شبكة Wi-Fi ويستجيب وفقًا لذلك:

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 intent، يمكنك طلب قائمة بما تم اكتشافه. وأقرانهم بـ 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);
       }
   }
}

على العميل، يتصل بمقبس الخادم باستخدام مقبس عميل وينقل 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
           }
       }
   }
}