Ringkasan Wi-Fi Langsung (peer-to-peer atau P2P)

Wi-Fi Langsung (P2P) memungkinkan perangkat dengan hardware yang sesuai terhubung langsung satu sama lain melalui Wi-Fi tanpa titik akses perantara. Dengan API ini, Anda dapat menemukan dan terhubung ke perangkat lain jika setiap perangkat mendukung Wi-Fi P2P, lalu berkomunikasi melalui koneksi cepat melintasi jarak yang jauh lebih lama daripada koneksi Bluetooth. Hal ini berguna untuk aplikasi yang berbagi data dengan pengguna, seperti game multiplayer atau aplikasi berbagi foto.

Wi-Fi P2P API terdiri dari beberapa bagian utama berikut:

  • Metode yang memungkinkan Anda menemukan, meminta, dan terhubung ke pembanding, yang ditentukan dalam class WifiP2pManager.
  • Pemroses yang memungkinkan Anda diberi tahu tentang berhasil atau gagalnya panggilan metode WifiP2pManager. Saat memanggil metode WifiP2pManager, setiap metode dapat menerima pemroses tertentu yang diteruskan sebagai parameter.
  • Intent yang memberi tahu Anda tentang peristiwa tertentu yang terdeteksi oleh framework Wi-Fi P2P, seperti koneksi yang terputus atau pembanding yang baru ditemukan.

Anda akan sering menggunakan tiga komponen utama API ini secara bersamaan. Misalnya, Anda dapat memberikan WifiP2pManager.ActionListener ke panggilan ke discoverPeers() sehingga metode ActionListener.onSuccess() dan ActionListener.onFailure() dapat memberi tahu Anda. Intent WIFI_P2P_PEERS_CHANGED_ACTION juga disiarkan jika metode discoverPeers() menemukan bahwa daftar peer telah berubah.

Ringkasan API

Class WifiP2pManager menyediakan metode yang memungkinkan Anda berinteraksi dengan hardware Wi-Fi di perangkat untuk melakukan hal-hal seperti menemukan dan terhubung ke pembanding. Tindakan berikut tersedia:

Tabel 1. Metode P2P Wi-Fi

Metode Deskripsi
initialize() Mendaftarkan aplikasi dengan framework Wi-Fi. Panggil ini sebelum memanggil metode P2P Wi-Fi lainnya.
connect() Memulai koneksi peer-to-peer dengan perangkat dengan konfigurasi tertentu.
cancelConnect() Membatalkan negosiasi grup peer-to-peer yang berlangsung.
requestConnectInfo() Meminta informasi koneksi perangkat.
createGroup() Membuat grup peer-to-peer dengan perangkat saat ini sebagai pemilik grup.
removeGroup() Menghapus grup peer-to-peer saat ini.
requestGroupInfo() Meminta informasi grup peer-to-peer.
discoverPeers() Menginisiasi penemuan pembanding.
requestPeers() Meminta daftar peer yang ditemukan saat ini.

Metode WifiP2pManager memungkinkan Anda meneruskan pemroses, sehingga framework P2P Wi-Fi dapat memberi tahu aktivitas tentang status panggilan. Antarmuka pemroses yang tersedia dan panggilan metode WifiP2pManager terkait yang menggunakan pemroses dijelaskan dalam tabel 2.

Tabel 2. Pemroses P2P Wi-Fi

Antarmuka pemroses Tindakan terkait
WifiP2pManager.ActionListener connect(), cancelConnect(), createGroup(), removeGroup(), dan discoverPeers()
WifiP2pManager.ChannelListener initialize()
WifiP2pManager.ConnectionInfoListener requestConnectInfo()
WifiP2pManager.GroupInfoListener requestGroupInfo()
WifiP2pManager.PeerListListener requestPeers()

Wi-Fi P2P API menentukan intent yang disiarkan saat peristiwa P2P Wi-Fi tertentu terjadi, seperti saat peer baru ditemukan atau saat status Wi-Fi perangkat berubah. Anda dapat mendaftar untuk menerima intent ini di aplikasi dengan membuat penerima siaran yang menangani intent ini:

Tabel 3. Intent P2P Wi-Fi

Intent Deskripsi
WIFI_P2P_CONNECTION_CHANGED_ACTION Menyiarkan saat status koneksi Wi-Fi perangkat berubah.
WIFI_P2P_PEERS_CHANGED_ACTION Siarkan saat Anda menelepon discoverPeers(). Anda biasanya akan memanggil requestPeers() untuk mendapatkan daftar pembanding yang diperbarui jika menangani intent ini dalam aplikasi Anda.
WIFI_P2P_STATE_CHANGED_ACTION Menyiarkan saat Wi-Fi P2P diaktifkan atau dinonaktifkan pada perangkat.
WIFI_P2P_THIS_DEVICE_CHANGED_ACTION Menyiarkan saat detail perangkat berubah, seperti nama perangkat.

Membuat penerima siaran untuk intent Wi-Fi P2P

Penerima siaran memungkinkan Anda menerima siaran intent yang disiarkan oleh sistem Android, sehingga aplikasi Anda dapat merespons peristiwa yang diminati Anda. Langkah-langkah dasar untuk membuat penerima siaran guna menangani intent P2P Wi-Fi adalah sebagai berikut:

  1. Buat class yang memperluas class BroadcastReceiver. Untuk konstruktor class, Anda akan menggunakan parameter untuk WifiP2pManager, WifiP2pManager.Channel, dan aktivitas tempat penerima siaran ini akan didaftarkan. Hal ini memungkinkan penerima siaran untuk mengirim update ke aktivitas serta memiliki akses ke hardware Wi-Fi dan saluran komunikasi jika diperlukan.

  2. Pada penerima siaran, periksa intent yang Anda inginkan dalam metode onReceive(). Lakukan tindakan yang diperlukan bergantung pada intent yang diterima. Misalnya, jika penerima siaran menerima intent WIFI_P2P_PEERS_CHANGED_ACTION, Anda dapat memanggil metode requestPeers() untuk mendapatkan daftar pembanding yang saat ini ditemukan.

Kode berikut menunjukkan kepada Anda cara membuat penerima siaran yang khas. Penerima siaran mengambil objek WifiP2pManager dan aktivitas sebagai argumen dan menggunakan dua class ini untuk melakukan tindakan yang diperlukan dengan tepat saat penerima siaran menerima intent:

Kotlin

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

Java

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

Pada perangkat yang menjalankan Android 10 dan yang lebih tinggi, intent siaran berikut tidak melekat:

WIFI_P2P_CONNECTION_CHANGED_ACTION
Aplikasi dapat menggunakan requestConnectionInfo(), requestNetworkInfo(), atau requestGroupInfo() untuk mengambil informasi koneksi saat ini.
WIFI_P2P_THIS_DEVICE_CHANGED_ACTION
Aplikasi dapat menggunakan requestDeviceInfo() untuk mengambil informasi koneksi saat ini.

Membuat Wi-Fi P2P

Membuat aplikasi Wi-Fi P2P melibatkan pembuatan dan pendaftaran penerima siaran untuk aplikasi Anda, menemukan peer, terhubung ke peer, dan mentransfer data ke peer. Bagian berikut menjelaskan cara melakukannya.

Penyiapan awal

Sebelum menggunakan Wi-Fi P2P API, Anda harus memastikan bahwa aplikasi dapat mengakses hardware dan perangkat mendukung protokol Wi-Fi P2P. Jika Wi-Fi P2P didukung, Anda dapat memperoleh instance WifiP2pManager, membuat dan mendaftarkan penerima siaran, serta mulai menggunakan Wi-Fi P2P API.

  1. Minta izin untuk menggunakan hardware Wi-Fi pada perangkat dan deklarasikan aplikasi Anda memiliki versi SDK minimum yang benar dalam manifes 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" />
    

    Selain izin sebelumnya, API berikut juga memerlukan Mode Lokasi untuk diaktifkan:

  2. Periksa untuk melihat apakah Wi-Fi P2P aktif dan didukung. Tempat yang baik untuk memeriksa hal ini adalah di penerima siaran Anda saat menerima intent WIFI_P2P_STATE_CHANGED_ACTION. Beri tahu aktivitas Anda tentang status P2P Wi-Fi dan berikan reaksi yang sesuai:

    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. Dalam metode onCreate() aktivitas, dapatkan instance WifiP2pManager dan daftarkan aplikasi dengan framework Wi-Fi P2P dengan memanggil initialize(). Metode ini menampilkan WifiP2pManager.Channel, yang digunakan untuk menghubungkan aplikasi Anda ke framework Wi-Fi P2P. Anda juga harus membuat instance penerima siaran dengan objek WifiP2pManager dan WifiP2pManager.Channel beserta referensi ke aktivitas Anda. Hal ini memungkinkan penerima siaran Anda memberi tahu aktivitas Anda tentang peristiwa menarik dan memperbaruinya. Hal ini juga memungkinkan Anda memanipulasi status Wi-Fi perangkat jika diperlukan:

    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. Buat filter intent dan tambahkan intent yang sama dengan yang diperiksa oleh penerima siaran:

    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. Daftarkan penerima siaran dalam metode onResume() aktivitas Anda dan batalkan pendaftarannya dalam metode onPause() aktivitas Anda:

    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. Setelah mendapatkan WifiP2pManager.Channel dan menyiapkan penerima siaran, aplikasi Anda dapat melakukan panggilan metode Wi-Fi P2P dan menerima intent P2P Wi-Fi.

  7. Implementasikan aplikasi Anda menggunakan fitur Wi-Fi P2P dengan memanggil metode di WifiP2pManager.

Bagian selanjutnya menjelaskan cara melakukan tindakan umum seperti menemukan dan terhubung ke peer.

Menemukan peer

Panggil discoverPeers() untuk mendeteksi peer yang tersedia yang berada dalam jangkauan dan tersedia untuk koneksi. Panggilan ke fungsi ini bersifat asinkron dan keberhasilan atau kegagalan dikomunikasikan ke aplikasi Anda dengan onSuccess() dan onFailure() jika Anda membuat WifiP2pManager.ActionListener. Metode onSuccess() hanya memberi tahu Anda bahwa proses penemuan berhasil dan tidak memberikan informasi apa pun tentang pembanding sebenarnya yang ditemukannya, jika ada. Contoh kode berikut menunjukkan cara menyiapkannya.

Kotlin

manager?.discoverPeers(channel, object : WifiP2pManager.ActionListener {

   override fun onSuccess() {
       ...
   }

   override fun onFailure(reasonCode: Int) {
       ...
   }
})

Java

manager.discoverPeers(channel, new WifiP2pManager.ActionListener() {
   @Override
   public void onSuccess() {
       ...
   }

   @Override
   public void onFailure(int reasonCode) {
       ...
   }
});

Jika proses penemuan berhasil dan mendeteksi peer, sistem akan menyiarkan intent WIFI_P2P_PEERS_CHANGED_ACTION, yang dapat Anda proses di penerima siaran untuk mendapatkan daftar pembanding. Saat aplikasi menerima intent WIFI_P2P_PEERS_CHANGED_ACTION, Anda dapat meminta daftar peer yang ditemukan dengan requestPeers(). Kode berikut menunjukkan cara menyiapkannya.

Kotlin

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

Java

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

Metode requestPeers() juga asinkron dan dapat memberi tahu aktivitas Anda saat daftar pembanding tersedia dengan onPeersAvailable(), yang ditentukan di antarmuka WifiP2pManager.PeerListListener. Metode onPeersAvailable() memberi Anda WifiP2pDeviceList, yang dapat Anda iterasi untuk menemukan pembanding yang akan dihubungkan.

Terhubung ke peer

Setelah mendapatkan daftar kemungkinan pembanding dan memilih perangkat yang akan dihubungkan, panggil metode connect() untuk terhubung ke perangkat. Panggilan metode ini memerlukan objek WifiP2pConfig yang berisi informasi tentang perangkat yang akan dihubungkan. WifiP2pManager.ActionListener dapat memberi tahu Anda tentang keberhasilan atau kegagalan koneksi. Kode berikut menunjukkan cara membuat koneksi ke perangkat.

Kotlin

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

Java

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

Mentransfer data

Setelah koneksi dibuat, Anda dapat mentransfer data antar-perangkat dengan soket. Langkah-langkah dasar mentransfer data adalah sebagai berikut:

  1. Buat ServerSocket. Soket ini menunggu koneksi dari klien pada port yang ditentukan dan melakukan pemblokiran hingga terjadi. Jadi, lakukan hal ini di thread latar belakang.
  2. Buat Socket klien. Klien menggunakan alamat IP dan port soket server untuk terhubung ke perangkat server.
  3. Mengirim data dari klien ke server. Ketika soket klien berhasil terhubung ke soket server, Anda dapat mengirim data dari klien ke server dengan aliran byte.
  4. Soket server menunggu koneksi klien (dengan metode accept()). Panggilan ini akan diblokir hingga klien terhubung, jadi panggil ini di thread lain. Saat koneksi terjadi, perangkat server dapat menerima data dari klien.

Contoh berikut, yang dimodifikasi dari Demo Wi-Fi P2P, menunjukkan cara membuat komunikasi soket klien-server ini dan mentransfer gambar JPEG dari klien ke server dengan layanan. Untuk contoh kerja yang lengkap, kompilasi dan jalankan demo.

Kotlin

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

Java

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

Pada klien, hubungkan ke soket server dengan soket klien dan transfer data. Contoh ini mentransfer file JPEG pada sistem file perangkat klien.

Kotlin

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

Java

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