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 doğrudan birbirine bağlanmasına olanak tanır. Bu API'leri kullanarak her cihaz Wi-Fi P2P'yi desteklediğinde diğer cihazları keşfedip bunlara bağlanabilir, ardından Bluetooth bağlantısından çok daha uzun mesafelerde hızlı bir bağlantı üzerinden iletişim kurabilirsiniz. Bu, kullanıcılar arasında veri paylaşan uygulamalar (ör. çok oyunculu oyun veya fotoğraf paylaşım uygulaması) için faydalıdır.

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

• WifiP2pManager sınıfında tanımlanan, diğer kullanıcıları keşfetmenize, onlardan istekte bulunmanıza ve onlarla bağlantı kurmanıza olanak tanıyan yöntemler.
• WifiP2pManager yöntem çağrılarının başarılı veya başarısız olması konusunda bildirim almanızı sağlayan dinleyiciler. WifiP2pManager yöntemleri çağrılırken her yöntem, parametre olarak iletilen belirli bir dinleyiciyi alabilir.
• Wi-Fi P2P çerçevesi tarafından algılanan belirli etkinlikler (ör. bağlantının düşmesi veya yeni keşfedilen bir eş) hakkında sizi bilgilendiren amaçlar.

API'lerin bu üç ana bileşenini genellikle birlikte kullanırsınız. Örneğin, WifiP2pManager.ActionListener yöntemini discoverPeers() yöntemine yapılan bir çağrıya sağlayabilirsiniz. Böylece ActionListener.onSuccess() ve ActionListener.onFailure() yöntemleri sizi bilgilendirebilir. A WIFI_P2P_PEERS_CHANGED_ACTION discoverPeers() yöntemi, eşler listesinin değiştiğini tespit ederse de amaç yayınlanır.

API'ye genel bakış

WifiP2pManager sınıfı, cihazınızdaki Wi-Fi donanımıyla etkileşim kurarak eşleri keşfetme ve onlara bağlanma gibi işlemler yapmanızı sağlayan yöntemler sunar. Aşağıdaki işlemler kullanılabilir:

Tablo 1. Kablosuz P2P Yöntemleri

WifiP2pManager yöntemleri, dinleyici iletmenize olanak tanır. Böylece, Wi-Fi P2P çerçevesi, etkinliğinizi aramanın durumu hakkında bilgilendirebilir. 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 İşleyiciler

Kablosuz P2P API'leri, belirli kablosuz P2P etkinlikleri (ör. yeni bir eş bulunduğunda veya bir cihazın kablosuz durumu değiştiğinde) gerçekleştiğinde yayınlanan amaçları tanımlar. Bu amaçları uygulamanızda almak için bu amaçları işleyen bir yayın alıcısı oluşturarak kaydolabilirsiniz:

Tablo 3. Kablosuz P2P Amaçları

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

Yayın alıcısı, Android sistemi tarafından yayınlanan amaçları almanıza olanak tanır. Böylece uygulamanız, ilgilendiğiniz etkinliklere yanıt verebilir. Wi-Fi P2P amaçlarını işlemek için yayın alıcısı oluşturmayla ilgili temel adımlar şunlardır:

1. BroadcastReceiver sınıfını genişleten bir sınıf oluşturun. Sınıfın oluşturucusu için WifiP2pManager, WifiP2pManager.Channel ve bu yayın alıcının kaydedileceği etkinliğe yönelik parametreler kullanacaksınız. Bu, yayın alıcının etkinliğe güncellemeler göndermesine ve gerekirse kablosuz donanım ile iletişim kanalına erişmesine olanak tanır.

2. Yayın alıcısında, onReceive() yönteminde ilgilendiğiniz amaçları kontrol edin. Alınan amaca bağlı olarak gerekli işlemleri gerçekleştirin. Örneğin, yayın alıcısı bir WIFI_P2P_PEERS_CHANGED_ACTION intent'i aldığında, ş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. Yayın alıcısı, bağımsız değişken olarak bir WifiP2pManager nesnesi ve bir etkinlik alır. Yayın alıcısı bir amaç aldığında gerekli işlemleri uygun şekilde gerçekleştirmek için bu iki sınıfı kullanı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ümlerin yüklü olduğu cihazlarda aşağıdaki yayın amaçları yapışkan değildir:

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 için uygulamanızda bir yayın alıcısı oluşturup kaydetmeniz, eşleri bulmanız, bir eşe bağlanmanız ve eşe veri aktarmanız gerekir. Bunu nasıl yapacağınız aşağıdaki bölümlerde açıklanmaktadır.

İlk kurulum

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

1. Cihazdaki kablosuz donanımını kullanmak için izin isteyin ve uygulamanızın Android manifest dosyasında doğru minimum SDK sürümüne sahip olduğunu beyan edin:

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

   Yukarıdaki izinlerin yanı sıra aşağıdaki API'ler için de Konum Modu'nun etkinleştirilmesi gerekir:

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

2. Kablosuz P2P'nin açık ve desteklenip desteklenmediğini kontrol edin. Bunu kontrol etmek için iyi bir yer, WIFI_P2P_STATE_CHANGED_ACTION amacını aldığında yayın alıcınızdır. Etkinliğinizi Wi-Fi P2P durumu hakkında bilgilendirin 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() yönteminde WifiP2pManager örneği alın ve initialize() yöntemini çağırarak uygulamanızı Wi-Fi 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. Ayrıca, WifiP2pManager ve WifiP2pManager.Channel nesneleriyle birlikte etkinliğinize referans vererek yayın alıcınızın bir örneğini oluşturmanız gerekir. Bu, yayın alıcınızın etkinliğinizi ilginç etkinlikler hakkında bilgilendirmesini ve etkinliği buna göre güncellemesini sağlar. Ayrıca, gerekirse cihazın kablosuz durumunu değiştirmenize de 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 amaç filtresi oluşturun ve yayın alıcınızın kontrol ettiği amaçları 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önteminde 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 aldıktan ve yayın alıcısını ayarladıktan sonra uygulamanız, kablosuz P2P yöntemi çağrıları yapabilir ve kablosuz P2P amaçlarını alabilir.

7. WifiP2pManager içindeki yöntemleri çağırarak uygulamanızı Wi-Fi P2P özelliklerini kullanarak uygulayın.

Sonraki bölümlerde, yaygın işlemlerin (ör. eşleri keşfetme ve bunlara bağlanma) nasıl yapılacağı açıklanmaktadır.

Benzerleri keşfetme

Kapsama alanında olan ve bağlantı için kullanılabilen mevcut eşleri algılamak üzere discoverPeers() işlevini çağırın. Bu işlevin çağrılması asenkron olarak yapılır ve WifiP2pManager.ActionListener oluşturduysanız başarı veya başarısızlık onSuccess() ve onFailure() ile uygulamanıza bildirilir. onSuccess() yöntemi yalnızca keşif sürecinin başarılı olduğunu bildirir ve keşfedilen gerçek eşler hakkında herhangi bir bilgi sağlamaz. Aşağıdaki kod örneğinde, bu ayarın nasıl yapılacağı gösterilmektedir.

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ı olursa ve eşler algılanırsa sistem, WIFI_P2P_PEERS_CHANGED_ACTION amacını yayınlar. Eşlerin listesini almak için yayın alıcısında bu amaca yönelik dinleme yapabilirsiniz. Uygulamanız WIFI_P2P_PEERS_CHANGED_ACTION amacını aldığında requestPeers() ile keşfedilen eşlerin listesini isteyebilirsiniz. Aşağıdaki kodda bu ayarın nasıl yapılacağı 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ızdır ve WifiP2pManager.PeerListListener arayüzünde tanımlanan onPeersAvailable() ile bir eşler listesi kullanılabilir olduğunda etkinliğinizi bildirebilir. onPeersAvailable() yöntemi, bağlanılacak eşi bulmak için yineleyebileceğiniz bir WifiP2pDeviceList sağlar.

Benzerlerle 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ğuna dair sizi bilgilendirebilir. Aşağıdaki kod, bir cihaza nasıl bağlantı oluşturacağınızı gösterir.

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 aktarın

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

1. ServerSocket oluşturun. Bu soket, belirtilen bağlantı noktasında bir istemciden gelen bağlantıyı bekler ve bu bağlantı gerçekleşene kadar engellenir. Bu nedenle, bu işlemi arka plan iş parçacığında yapın.
2. Müşteri oluşturma 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önderme İstemci soketi sunucu soketine başarıyla bağlandığında, istemciden sunucuya bayt akışlarıyla veri gönderebilirsiniz.
4. Sunucu soketi, istemci bağlantısı bekler (accept() yöntemiyle). Bu çağrı, bir istemci bağlanana kadar engellenir. Bu nedenle, bunu başka bir iş parçacığında çağırın. Bağlantı gerçekleştiğinde sunucu cihaz, istemciden verileri alabilir.

Wi-Fi P2P Demo'dan değiştirilerek oluşturulan aşağıdaki örnekte, bu istemci-sunucu soket iletişiminin nasıl oluşturulacağı ve bir hizmetle JPEG resimlerinin istemciden sunucuya nasıl aktarılacağı gösterilmektedir. Çalışan bir örneğin tamamı 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 soketiyle sunucu soketine bağlanın ve verileri aktarın. Bu örnek, istemci cihazın dosya sistemindeki bir JPEG dosyasını aktarı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
           }
       }
   }
}