Wi-Fi Direct'e (eşler arası veya P2P) genel bakış

Kablosuz Doğrudan Bağlantı (P2P), uygun donanıma sahip cihazların ara erişim noktası olmadan kablosuz ağ üzerinden doğrudan birbirine bağlanmasına olanak tanır. Bu API'leri kullanarak, her cihaz kablosuz P2P'yi desteklediğinde diğer cihazları bulup bunlara bağlanabilir, ardından Bluetooth bağlantısından çok daha uzun mesafelerde hızlı bir bağlantı üzerinden iletişim kurabilirsiniz. Bu özellik, çok oyunculu oyun veya fotoğraf paylaşım uygulaması gibi kullanıcılar arasında veri paylaşan uygulamalar için kullanışlıdır.

Wi-Fi P2P API'leri aşağıdaki ana bölümlerden oluşur:

• Benzerleri keşfetme, talep etme ve onlarla bağlantı kurma yöntemleri olan sizin gibi WifiP2pManager sınıfı.
• WifiP2pManager yöntem çağrılarının başarılı veya başarısız olduğuyla ilgili bildirim almanıza olanak tanıyan dinleyiciler. WifiP2pManager yöntemleri çağrılırken her yöntem, parametre olarak iletilen belirli bir dinleyici alabilir.
• Wi-Fi P2P tarafından algılanan belirli etkinlikleri size bildiren amaçlar neden olabilir.

Genellikle API'lerin bu üç ana bileşenini birlikte kullanacaksınız. Örneğin, ActionListener.onSuccess() ve ActionListener.onFailure() yöntemlerinin sizi bilgilendirebilmesi için discoverPeers() çağrısına bir WifiP2pManager.ActionListener sağlayabilirsiniz. discoverPeers() yöntemi, eşler listesinin değiştiğini tespit ederse WIFI_P2P_PEERS_CHANGED_ACTION intent'i de yayınlanır.

API'ye genel bakış

WifiP2pManager sınıfı, Benzerleri keşfetmek ve onlara bağlanmak gibi işlemler için cihazınızdaki kablosuz donanım seçeneğini kullanabilirsiniz. Aşağıdaki işlemler kullanılabilir:

Tablo 1. Wi-Fi P2P Yöntemleri

WifiP2pManager yöntem Wi-Fi P2P çerçevesinin etkinliğinizi bildirebilmesi için bir dinleyiciye geçersiniz bir görünüm oluşturabilirsiniz. Kullanılabilir dinleyici arayüzleri ve dinleyicileri kullanan ilgili WifiP2pManager yöntem çağrıları tablo 2'de açıklanmıştır.

Tablo 2. Kablosuz P2P Dinleyicileri

Kablosuz P2P API'leri, yeni bir eş bulunulduğunda veya bir cihazın kablosuz bağlantı durumu değiştiğinde gibi belirli kablosuz P2P etkinlikleri gerçekleştiğinde yayınlanan intent'leri tanımlar. Aşağıdaki amaçları işleyen bir yayın alıcı oluşturarak uygulamanızda bu amaçları almaya kaydolabilirsiniz:

Tablo 3. Kablosuz P2P Intent'leri

Kablosuz P2P amaçları için yayın alıcı oluşturma

Yayın alıcı, Android sistemi tarafından yayınlanan intent'leri almanıza olanak tanır. Böylece uygulamanız, ilgilendiğiniz etkinliklere yanıt verebilir. P2P kablosuz ağını kullanmak için yayın alıcı oluşturmaya ilişkin temel adımlar amaçlar aşağıdaki gibidir:

1. BroadcastReceiver sınıfını genişleten bir sınıf oluşturun. Sınıfın kurucusu için WifiP2pManager, WifiP2pManager.Channel ve bu yayın alıcısının kaydedileceği etkinlikle ilgili parametreleri kullanırsınız. Bu, yayın alıcısının güncellemeleri kablosuz donanımına ve iletişim ağına erişebilir, tavsiyelerde bulunun.

2. Yayın alıcıda, ilgilendiğiniz amaçları kontrol edin onReceive() yöntemidir. Alınan amaca bağlı olarak gerekli işlemleri gerçekleştirin. Örneğin, yayın alıcı bir WIFI_P2P_PEERS_CHANGED_ACTION intent'i alırsa şu anda keşfedilen eşlerin listesini almak için requestPeers() yöntemini çağırabilirsiniz.

Aşağıdaki kodda, tipik bir yayın alıcısının nasıl oluşturulacağı gösterilmektedir. İlgili içeriği oluşturmak için kullanılan yayın alıcı, bağımsız değişken olarak bir WifiP2pManager nesnesi ve bir etkinlik alır ve gerekli işlemleri doğru şekilde yapmak için bu iki sınıfı kullanır. Yayın alıcı bir niyet alır:

/**
* 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 ve sonraki sürümleri çalıştıran cihazlarda aşağıdaki yayın amaçları şunlardır: yapışkan olmayan:

WIFI_P2P_CONNECTION_CHANGED_ACTION

Uygulamalar, mevcut bağlantı bilgilerini almak için requestConnectionInfo(), requestNetworkInfo() veya requestGroupInfo() kullanabilir.

WIFI_P2P_THIS_DEVICE_CHANGED_ACTION

Uygulamalar, mevcut bağlantı bilgilerini almak için requestDeviceInfo() kullanabilir.

Kablosuz P2P uygulaması oluşturma

Kablosuz P2P uygulaması oluşturmak, bir yayın oluşturmayı ve kaydettirmeyi içerir alıcıyı bulması, benzerleri keşfetmesi, bir benzerle bağlantı kurması ve eşlere veri aktarımı yapabilirsiniz. Aşağıdaki bölümlerde bunun nasıl yapılacağı açıklanmaktadır.

İlk kurulum

Wi-Fi P2P API'lerini kullanmadan önce uygulamanızın donanıma erişebildiğinden ve cihazın kablosuz P2P protokolünü desteklediğinden emin olun. Kablosuz P2P destekleniyorsa WifiP2pManager örneği alabilir, yayın alıcınızı oluşturup kaydedebilir ve kablosuz P2P API'lerini kullanmaya başlayabilirsiniz.

1. Cihazdaki kablosuz donanımı kullanma izni isteyin ve Android manifest dosyasında uygulamanızın doğru minimum SDK sürümüne sahip olduğunu belirtin:

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

   Aşağıdaki API'ler, önceki izinlerin yanı sıra konum modunun da etkinleştirilmesini gerektirir:

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

2. Kablosuz P2P özelliğinin açık olup olmadığını ve desteklenip desteklenmediğini kontrol edin. Bunu kontrol etmenin iyi bir yolu, WIFI_P2P_STATE_CHANGED_ACTION intent'ini aldığında yayın alıcınızda kontrol etmektir. Wi-Fi P2P etkinliğinizi bildirme tepki verin ve buna göre tepki verin:

   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. Etkinliğinizin onCreate() metodunda WifiP2pManager örneği alın ve initialize()'i çağırarak uygulamanızı kablosuz P2P çerçevesine kaydedin. Bu yöntem, uygulamanızı kablosuz P2P çerçevesine bağlamak için kullanılan bir WifiP2pManager.Channel döndürür. Yayınınızın bir örneğini de alıcı, WifiP2pManager ve WifiP2pManager.Channel nesneleriyle birlikte tıklayın. Bu sayede yayın alıcınız, ilgi çekici etkinlikler hakkında etkinliğinizi bilgilendirebilir ve buna göre güncelleyebilir. Aynı zamanda Gerektiğinde cihazın kablosuz ağ durumunu değiştirmenize olanak tanır:

   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. Bir intent filtresi oluşturun ve yayın alıcınızın kontrol ettiği intent'leri ekleyin:

   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. Yayın alıcısını etkinliğinizin onResume() yöntemine kaydedin ve etkinliğinizin onPause() yönteminde kaydını silin:

   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 alıp bir yayın ayarladığınızda alıcı, uygulamanız kablosuz P2P yöntemi çağrıları yapabilir ve kablosuz bağlantı alabilir P2P amaçları.

7. Wi-Fi P2P özelliklerini kullanarak uygulamanızı uygulamak için WifiP2pManager içinde farklı yöntemler kullanır.

Sonraki bölümlerde, eşleri bulma ve eşlere bağlanma gibi sık kullanılan işlemlerin nasıl yapılacağı açıklanmaktadır.

Benzer kullanıcıları keşfetme

discoverPeers() çağrısı, kapsam içi ve bağlantı için hazır olan mevcut eşleri algılar. Bu işlev çağrısı eşzamanlı değildir ve WifiP2pManager.ActionListener oluşturduysanız başarı veya başarısızlık, onSuccess() ve onFailure() ile uygulamanıza iletilir. onSuccess() yöntemi yalnızca keşif sürecinin başarılı olduğunu bildirir ve keşfettiği gerçek eşler (varsa) hakkında herhangi bir bilgi sağlamaz. Aşağıdakiler kod örneği, bunun nasıl ayarlanacağını gösterir.

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) {
       ...
   }
});

Keşif süreci başarılı olur ve benzerleri tespit ederse sistem, Bir yayında dinleyebileceğiniz WIFI_P2P_PEERS_CHANGED_ACTION intent alıcıyı kullanarak benzerlerin listesini alabilirsiniz. Başvurunuz WIFI_P2P_PEERS_CHANGED_ACTION intent, keşfedilenlerin listesini isteyebilirsiniz requestPeers() ile benzer. Aşağıdaki kodda bunun nasıl ayarlanacağı gösterilmektedir.

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() yöntemi de eşzamansız olup etkinliğinizi bildirebilir benzerlerinden oluşan bir liste mevcut olduğunda onPeersAvailable(), (WifiP2pManager.PeerListListener arayüzünde tanımlanır). İlgili içeriği oluşturmak için kullanılan onPeersAvailable() yöntemi, WifiP2pDeviceList, tekrarlayarak bağlantı kuracağınız eşi bulabilirsiniz.

Eşdeğerlerle bağlantı kurma

Olası eşlerin listesini aldıktan ve bağlanılacak bir cihaz seçtikten sonra cihaza bağlanmak için connect() yöntemini çağırın. Bu yöntem çağrısı, bağlanılacak cihazla ilgili bilgileri içeren bir WifiP2pConfig nesnesi gerektirir. WifiP2pManager.ActionListener, bağlantının başarılı veya başarısız olduğunu size bildirebilir. Aşağıdaki kodda bir cihazla nasıl bağlantı oluşturacağınız gösterilmektedir.

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

Verileri aktarma

Bağlantı kurulduktan sonra şuna sahip cihazlar arasında veri aktarabilirsiniz: soketler. Veri aktarımının temel adımları şunlardır:

1. Bir ServerSocket oluşturun. Bu priz belirtilen bağlantı noktasındaki bir istemciden bağlantı kurulmasını bekler ve bağlantı kuruluna kadar engeller Bu nedenle bunu bir arka plan ileti dizisinde yapın.
2. İstemci oluşturun Socket. İstemci, sunucu cihazına bağlanmak için sunucu soketinin IP adresini ve bağlantı noktasını kullanır.
3. İstemciden sunucuya veri gönderin. İstemci soketi sunucu soketine başarıyla bağlandığında, bayt akışlarıyla istemciden sunucuya veri gönderebilirsiniz.
4. Sunucu soketi, istemci bağlantısı bekler (accept() yöntemiyle). Bu görüşme Bir istemci bağlanana kadar bloke eder. Bu nedenle, bunu başka bir iş parçacığında çağırın. Bir sunucu cihazı, istemciden veri alabilir.

Aşağıdaki örnek, Wi-Fi P2P Demo, bu istemci-sunucu yuvası iletişimini ve bu istemciyi Bir istemciden hizmet içeren bir sunucuya JPEG resimleri. Tam bir çalışma örneği için demoyu derleyip çalıştırın.

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

İstemcide, istemci yuvasıyla sunucu yuvasına bağlanın ve verileri dışı verilerdir. Bu örnekte, istemci cihazın dosya sistemine bir JPEG dosyası aktarılır.

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