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

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

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

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

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

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

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

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

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

טבלה 2. מאזיני Wi-Fi P2P

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

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

יצירת מקלט שידורים עבור Intents של Wi-Fi P2P

מקלט שידורים מאפשר לך לקבל כוונות שמשודרות על ידי Android כך שהאפליקציה שלך תוכל להגיב לאירועים שמעניינים אותך אינץ' השלבים הבסיסיים ליצירת מקלט שידורים כדי לטפל ב-Wi-Fi P2P Intents הם:

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

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

בקוד הבא מוסבר איך ליצור מקלט שידורים אופייני. מקלט השידור לוקח אובייקט WifiP2pManager ופעילות כארגומנטים ומשתמשת בשני הסוגים האלו כדי לבצע כראוי את הפעולות הנדרשות, מקלט השידור מקבל Intent:

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

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

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

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

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

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

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

2. צריך לבדוק אם חיבור ה-Wi-Fi P2P פועל ונתמך. מקום טוב לבדוק אם הוא במקלט השידורים כשהוא מקבל את Intent מסוג 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. יצירת מסנן Intent והוספת אותן הגדרות Intent ששימשו את מקלט השידור מחפש:

   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 והגדרת שידור המקבל, האפליקציה יכולה לבצע שיחות בשיטת P2P ולקבל Wi-Fi כוונות P2P.

7. מטמיעים את האפליקציה באמצעות תכונות ה-P2P של ה-Wi-Fi על ידי קריאה ב-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) {
       ...
   }
});

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

חיבור לאפליקציות להשוואה

אחרי שקיבלת רשימה של אפליקציות להשוואה ובחרת מכשיר להתחברות עליהם להפעיל את ה-method connect() כדי להתחבר למכשיר. הפעלת ה-method נדרש 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. שליחת נתונים מהלקוח לשרת. לאחר ש-Client socket עובד מתחבר לשקע שרת, ניתן לשלוח נתונים מהלקוח שרת עם זרמים של בייטים.
4. שקע השרת ממתין לחיבור לקוח (עם accept()). השיחה חוסמים עד שהלקוח מתחבר, לכן קוראים את הפעולה הזו בשרשור אחר. כאשר מתרחש, מכשיר השרת יכול לקבל את הנתונים מהלקוח.

הדוגמה הבאה, שונתה מ-Wi-Fi P2P הדגמה (דמו), מראה איך ליצור ולהעביר שקע (socket) של הלקוח לשרת תמונות בפורמט 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
           }
       }
   }
}