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

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

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

• שיטות שמאפשרות לגלות, לבקש ולהתחבר למשתמשי peer, שמוגדרות בכיתה 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

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

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

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

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

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

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

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

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

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

לפני שמשתמשים בממשקי ה-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 מופעלת ונתמכת. מקום טוב לבדוק את זה הוא ב-broadcast receiver כשמתקבלת בו ה-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 ומריצים את initialize() כדי לרשום את האפליקציה במסגרת Wi-Fi P2P. השיטה הזו מחזירה 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. רושמים את מקלט השידור ב-method‏ onResume() של הפעילות, ומבטלים את הרישום שלו ב-method‏ 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 ותגדירו מקלט שידור, האפליקציה שלכם תוכל לבצע קריאות ל-method של 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
           }
       }
   }
}