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

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

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

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

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

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

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

الجدول 1. طرق اتصال Wi-Fi بين المنافذ (P2P)

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

الجدول 2. أدوات استشعار P2P لشبكة Wi-Fi

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

الجدول 3. أهداف واي فاي P2P

إنشاء مستقبِل بث لأهداف شبكة Wi-Fi P2P

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

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

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

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

/**
* 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
           }
       }
   }
}

/**
* 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، عليك التأكّد من قدرة تطبيقك على الوصول إلى الجهاز وأن الجهاز يتوافق مع بروتوكول P2P لشبكة Wi-Fi. في حال حذف تتوفّر اتصال 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" />
   

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

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

2. تحقَّق لمعرفة ما إذا كانت شبكة 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
      }
   }
   ...
   }
   

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

   Kotlin

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

   Java

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

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

   Kotlin

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

   Java

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

5. تسجيل جهاز استقبال البث في onResume() من النشاط وإلغاء التسجيل في onPause() النشاط:

   Kotlin

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

   Java

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

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

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

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

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

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

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

   override fun onSuccess() {
       ...
   }

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

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(). يوضح الرمز التالي كيفية إعداد هذا الإجراء.

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

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 إشعارك بنجاح عملية الربط أو إخفاقًا. يوضّح لك الرمز التالي كيفية إنشاء اتصال بجهاز.

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

//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 من برنامج إلى خادم لديه خدمة. للحصول على عمل كامل مثلاً، تجميع وتشغيل العرض التوضيحي.

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

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 على نظام الملفات في جهاز العميل.

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()
   }
}

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
           }
       }
   }
}