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

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

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

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

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

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

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

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

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

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

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

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