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

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

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

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