סקירה כללית על Wi-Fi ישיר (מקצה לקצה (P2P) או P2P)

Wi-Fi ישיר (P2P) מאפשר למכשירים עם החומרה המתאימה להתחבר ישירות זה לזה באמצעות Wi-Fi, ללא נקודת גישה ביניים. באמצעות ממשקי ה-API האלה אפשר לגלות מכשירים אחרים ולהתחבר אליהם כאשר כל מכשיר תומך ב-Wi-Fi P2P, ואז לתקשר באמצעות חיבור מהיר במרחקים ארוכים בהרבה מאשר חיבור Bluetooth. האפשרות הזו שימושית לאפליקציות שמשתפות נתונים בין משתמשים, כמו משחק מרובה משתתפים או אפליקציה לשיתוף תמונות.

ממשקי ה-API של P2P של Wi-Fi מורכבים מהחלקים העיקריים הבאים:

• שיטות שמאפשרות לגלות, לבקש ולהתחבר למשתתפים אחרים, שמוגדרות בכיתה WifiP2pManager.
• מאזינים שמאפשרים לקבל התראות על הצלחה או כישלון של קריאות ל-method‏ WifiP2pManager. כשקוראים לשיטות WifiP2pManager, כל שיטה יכולה לקבל מאזין ספציפי שמוענק כפרמטר.
• כוונות שמעדכנות אתכם על אירועים ספציפיים שזוהו על ידי מסגרת ה-Wi-Fi P2P, כמו חיבור שנפל או עמית חדש שזוהה.

בדרך כלל תשתמשו בשלושת הרכיבים העיקריים האלה יחד בממשקי ה-API. לדוגמה, אפשר לספק את הערך WifiP2pManager.ActionListener לקריאה ל-discoverPeers() כדי שהשיטות ActionListener.onSuccess() ו-ActionListener.onFailure() יוכלו להודיע לכם. כוונה מסוג WIFI_P2P_PEERS_CHANGED_ACTION תישלח גם אם השיטה discoverPeers() תזהה שרשימה של השכנים השתנתה.

סקירה כללית על ממשקי API

הקורס WifiP2pManager מספק שיטות שמאפשרות ליצור אינטראקציה עם חומרת ה-Wi-Fi במכשיר כדי לבצע פעולות כמו חיפוש של אפליקציות להשוואה והתחברות אליהן. אלה הפעולות הזמינות:

טבלה 1. שיטות Wi-Fi P2P

באמצעות methods של WifiP2pManager אפשר להעביר מאזין, כדי שמסגרת ה-Wi-Fi P2P תוכל להודיע לפעילות שלכם על סטטוס השיחה. ממשקי המאזינים הזמינים והקריאות המתאימות ל-method‏ WifiP2pManager שמשתמשות במאזינים מתוארים בטבלה 2.

טבלה 2. מאזינים מסוג Wi-Fi P2P

ממשקי ה-API של P2P ב-Wi-Fi מגדירים כוונות שמשודרות כשמתרחשים אירועי Wi-Fi מסוימים ב-P2P. למשל, כשמתגלים עמיתים חדשים או כשמצב ה-Wi-Fi של המכשיר משתנה. כדי לקבל את הכוונות האלה באפליקציה, צריך ליצור מקלט שידור שמטפל בהן:

טבלה 3 כוונות Wi-Fi P2P

יצירת מקלט שידור לכוונות Wi-Fi P2P

באמצעות מקלט שידור אפשר לקבל כוונות (intents) שמשודרות על ידי מערכת Android, כדי שהאפליקציה תוכל להגיב לאירועים שמעניינים אתכם. השלבים הבסיסיים ליצירת מקלט שידורים שיטפל בכוונות P2P של Wi-Fi:

1. יוצרים כיתה שמרחיבה את הכיתה BroadcastReceiver. ב-constructor של המחלקה, צריך להשתמש בפרמטרים של WifiP2pManager ו-WifiP2pManager.Channel, וגם של הפעילות שבה יירשם מקלט השידור הזה. כך מקלט השידור יכול לשלוח עדכונים לפעילות, וגם לקבל גישה לחומרה של ה-Wi-Fi ולערוץ תקשורת במקרה הצורך.

2. במקלט השידורים, בודקים באמצעות method onReceive() את ה-Intents שמעניינים אתכם. מבצעים את הפעולות הנדרשות בהתאם לכוונה שהתקבלה. לדוגמה, אם מקלט השידור מקבל WIFI_P2P_PEERS_CHANGED_ACTION intent, אפשר לקרוא ל-method‏ requestPeers() כדי לקבל רשימה של השכנים שהתגלו כרגע.

הקוד הבא מראה איך יוצרים מקלט שידור אופייני. ה-broadcast receiver מקבל אובייקט 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 כוללת יצירה ורישום של מקלט שידור לאפליקציה, גילוי עמיתים, חיבור לעמית והעברת נתונים לעמית. בקטעים הבאים מוסבר איך לעשות זאת.

הגדרה ראשונית

לפני שמשתמשים בממשקי ה-API של Wi-Fi P2P, צריך לוודא שהאפליקציה יכולה לגשת לחומרה ושהמכשיר תומך בפרוטוקול Wi-Fi P2P. אם יש תמיכה ב-Wi-Fi P2P, תוכלו לקבל מכונה של WifiP2pManager, ליצור ולרשום את מקלט השידור ולהתחיל להשתמש ב-API של Wi-Fi P2P.

1. מבקשים הרשאה להשתמש בחומרת ה-Wi-Fi במכשיר ומצהירים שבמניפסט של Android יש את גרסת ה-SDK המינימלית הנכונה:

   <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" />
   

   חוץ מההרשאות הקודמות, צריך להפעיל את מצב המיקום גם בממשקי ה-API הבאים:

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

2. בודקים אם התכונה Wi-Fi P2P מופעלת ונתמכת. מקום טוב לבדוק אם זה נמצא במקלט השידורים כשהוא מקבל את Intent 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. ב-method onCreate() של הפעילות, מקבלים מופע של WifiP2pManager ורושמים את האפליקציה באמצעות framework של 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. ה-method onPeersAvailable() מספקת את הפקודה WifiP2pDeviceList, שאפשר לחזור עליה כדי למצוא את האפליקציה להשוואה.

התחברות לעמיתים

אחרי שמקבלים רשימה של אפליקציות להשוואה ובוחרים מכשיר להתחבר אליו, צריך לבצע קריאה ל-method 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
           }
       }
   }
}