Wi-Fi Direct (পিয়ার-টু-পিয়ার বা P2P) ওভারভিউ

Wi-Fi ডাইরেক্ট (P2P) উপযুক্ত হার্ডওয়্যার সহ ডিভাইসগুলিকে কোনও মধ্যবর্তী অ্যাক্সেস পয়েন্ট ছাড়াই Wi-Fi-এর মাধ্যমে সরাসরি একে অপরের সাথে কানেক্ট করার অনুমতি দেয়। এইসব API ব্যবহার করে, আপনি অন্যান্য ডিভাইস খুঁজে পেতে এবং কানেক্ট করতে পারবেন যখন প্রতিটি ডিভাইস Wi-Fi P2P সাপোর্ট করে, তারপর ব্লুটুথ কানেকশনের চেয়ে অনেক বেশি দূরত্বে দ্রুত কানেকশনের মাধ্যমে যোগাযোগ করতে পারবেন। এটি এমন অ্যাপ্লিকেশনের জন্য উপযোগী যা ব্যবহারকারীদের মধ্যে ডেটা শেয়ার করে, যেমন মাল্টিপ্লেয়ার গেম বা ফটো-শেয়ারিং অ্যাপ্লিকেশন।

Wi-Fi P2P API-তে নিম্নলিখিত প্রধান অংশগুলি থাকে:

  • এমন পদ্ধতি যা আপনাকে পিয়ার খুঁজে পেতে, অনুরোধ করতে এবং কানেক্ট করতে দেয়, যা WifiP2pManager ক্লাসে সংজ্ঞায়িত করা আছে।
  • লিসনার যা আপনাকে WifiP2pManager মেথড কলের সাফল্য বা ব্যর্থতা সম্পর্কে বিজ্ঞপ্তি পেতে দেয়। WifiP2pManager মেথড কল করার সময়, প্রতিটি মেথড প্যারামিটার হিসেবে পাস করা নির্দিষ্ট লিসেনার পেতে পারে।
  • Wi-Fi P2P ফ্রেমওয়ার্কের মাধ্যমে শনাক্ত করা নির্দিষ্ট ইভেন্ট সম্পর্কে আপনাকে জানানো ইনটেন্ট, যেমন কানেকশন ড্রপ হওয়া বা নতুন কোনও পিয়ার খুঁজে পাওয়া।

আপনি প্রায়ই API-এর এই তিনটি প্রধান কম্পোনেন্ট একসাথে ব্যবহার করবেন। যেমন, discoverPeers()-এ কল করার জন্য আপনি WifiP2pManager.ActionListener প্রদান করতে পারেন, যাতে ActionListener.onSuccess() এবং ActionListener.onFailure() পদ্ধতি আপনাকে বিজ্ঞপ্তি পাঠাতে পারে। discoverPeers() পদ্ধতি যদি দেখে যে পিয়ারের তালিকা পরিবর্তন হয়েছে, তাহলে WIFI_P2P_PEERS_CHANGED_ACTION ইনটেন্টও ব্রডকাস্ট করা হয়।

API ওভারভিউ

WifiP2pManager ক্লাস আপনাকে এমন পদ্ধতি প্রদান করে যার মাধ্যমে আপনি নিজের ডিভাইসে ওয়াই-ফাই হার্ডওয়্যারের সাথে ইন্টার‍্যাক্ট করতে পারবেন। এর ফলে আপনি পিয়ার ডিসকভার ও কানেক্ট করার মতো কাজ করতে পারবেন। নিম্নলিখিত অ্যাকশনগুলি উপলভ্য:

টেবিল ১. ওয়াই-ফাই P2P পদ্ধতি

পদ্ধতি বিবরণ
initialize() ওয়াই-ফাই ফ্রেমওয়ার্কের সাথে অ্যাপ্লিকেশন রেজিস্টার করে। অন্য কোনও ওয়াই-ফাই P2P পদ্ধতি কল করার আগে এটি কল করুন।
connect() নির্দিষ্ট কনফিগারেশন সহ ডিভাইসের সাথে পিয়ার-টু-পিয়ার কানেকশন শুরু করে।
cancelConnect() যেকোনও চলমান পিয়ার-টু-পিয়ার গ্রুপ নেগোসিয়েশন বাতিল করে।
requestConnectInfo() ডিভাইসের কানেকশন সংক্রান্ত তথ্য অনুরোধ করে।
createGroup() বর্তমান ডিভাইসকে গ্রুপের মালিক হিসেবে সেট করে পিয়ার-টু-পিয়ার গ্রুপ তৈরি করে।
removeGroup() বর্তমান পিয়ার-টু-পিয়ার গ্রুপ সরিয়ে দেয়।
requestGroupInfo() পিয়ার-টু-পিয়ার গ্রুপের তথ্য অনুরোধ করে।
discoverPeers() পিয়ার ডিসকভারি শুরু করে।
requestPeers() খুঁজে পাওয়া পিয়ারের বর্তমান তালিকার জন্য অনুরোধ করে।

WifiP2pManager পদ্ধতি আপনাকে লিসনার পাস করতে দেয়, যাতে ওয়াই-ফাই P2P ফ্রেমওয়ার্ক আপনার অ্যাক্টিভিটিকে কলের স্ট্যাটাস সম্পর্কে বিজ্ঞপ্তি পাঠাতে পারে। উপলভ্য লিসেনার ইন্টারফেস এবং সংশ্লিষ্ট WifiP2pManager মেথড কল যা লিসেনার ব্যবহার করে তা সারণী ২-এ বর্ণনা করা হয়েছে।

সারণী ২. Wi-Fi P2P লিসনার

লিসনার ইন্টারফেস সংশ্লিষ্ট অ্যাকশন
WifiP2pManager.ActionListener connect(), cancelConnect(), createGroup(), removeGroup() এবং discoverPeers()
WifiP2pManager.ChannelListener initialize()
WifiP2pManager.ConnectionInfoListener requestConnectInfo()
WifiP2pManager.GroupInfoListener requestGroupInfo()
WifiP2pManager.PeerListListener requestPeers()

ওয়াই-ফাই P2P API, নির্দিষ্ট ওয়াই-ফাই P2P ইভেন্ট ঘটলে ব্রডকাস্ট করা ইনটেন্টকে সংজ্ঞায়িত করে, যেমন নতুন পিয়ার খুঁজে পাওয়া গেলে অথবা ডিভাইসের ওয়াই-ফাই স্ট্যাটাস পরিবর্তন হলে। আপনি ব্রডকাস্ট রিসিভার তৈরি করে আপনার অ্যাপ্লিকেশনে এইসব ইনটেন্ট পাওয়ার জন্য রেজিস্টার করতে পারেন যা এইসব ইনটেন্ট ম্যানেজ করে:

সারণী ৩. Wi-Fi P2P ইনটেন্ট

উদ্দেশ্য বিবরণ
WIFI_P2P_CONNECTION_CHANGED_ACTION ডিভাইসের ওয়াই-ফাই কানেকশনের স্ট্যাটাস পরিবর্তন হলে ব্রডকাস্ট করুন।
WIFI_P2P_PEERS_CHANGED_ACTION discoverPeers()-এ কল করার সময় ব্রডকাস্ট করা। আপনি যদি নিজের অ্যাপ্লিকেশনে এই ইনটেন্ট ম্যানেজ করেন, তাহলে সাধারণত পিয়ারের আপডেট করা তালিকা পেতে requestPeers() কল করবেন।
WIFI_P2P_STATE_CHANGED_ACTION ডিভাইসে ওয়াই-ফাই P2P চালু বা বন্ধ করা হলে ব্রডকাস্ট করে।
WIFI_P2P_THIS_DEVICE_CHANGED_ACTION ডিভাইসের নাম সহ ডিভাইসের বিবরণ পরিবর্তন করা হলে ব্রডকাস্ট করুন।

ওয়াই-ফাই P2P ইনটেন্টের জন্য ব্রডকাস্ট রিসিভার তৈরি করুন

সম্প্রচার রিসিভার আপনাকে Android সিস্টেমের মাধ্যমে সম্প্রচার করা ইনটেন্ট রিসিভ করার অনুমতি দেয়, যাতে আপনার অ্যাপ্লিকেশন আপনার আগ্রহের ইভেন্টে সাড়া দিতে পারে। Wi-Fi P2P ইনটেন্ট ম্যানেজ করার জন্য ব্রডকাস্ট রিসিভার তৈরি করার প্রাথমিক ধাপগুলি নিচে দেওয়া হল:

  1. এমন একটি ক্লাস তৈরি করুন যা BroadcastReceiver ক্লাসকে এক্সটেন্ড করে। ক্লাসের কনস্ট্রাক্টরের জন্য, আপনি WifiP2pManager, WifiP2pManager.Channel এবং এই ব্রডকাস্ট রিসিভার যে অ্যাক্টিভিটিতে রেজিস্টার করা হবে তার জন্য প্যারামিটার ব্যবহার করবেন। এটি ব্রডকাস্ট রিসিভারকে অ্যাক্টিভিটিতে আপডেট পাঠাতে এবং প্রয়োজন হলে ওয়াই-ফাই হার্ডওয়্যার এবং একটি কমিউনিকেশন চ্যানেল অ্যাক্সেস করতে দেয়।

  2. ব্রডকাস্ট রিসিভারে, আপনি যে ইনটেন্টগুলি সম্পর্কে আগ্রহী সেগুলি চেক করুন onReceive() পদ্ধতিতে। প্রাপ্ত ইনটেন্টের উপর নির্ভর করে প্রয়োজনীয় অ্যাকশন সম্পূর্ণ করুন। যেমন, ব্রডকাস্ট রিসিভার যদি WIFI_P2P_PEERS_CHANGED_ACTION ইনটেন্ট পায়, তাহলে আপনি requestPeers() মেথড কল করে বর্তমানে খুঁজে পাওয়া পিয়ারের তালিকা পেতে পারেন।

নিম্নলিখিত কোড থেকে আপনি জানতে পারবেন যে কীভাবে একটি সাধারণ সম্প্রচার রিসিভার তৈরি করতে হয়। সম্প্রচার রিসিভার আর্গুমেন্ট হিসেবে একটি WifiP2pManager অবজেক্ট এবং একটি অ্যাক্টিভিটি নেয় এবং সম্প্রচার রিসিভার কোনও ইনটেন্ট পেলে প্রয়োজনীয় অ্যাকশন যথাযথভাবে সম্পন্ন করার জন্য এই দুটি ক্লাস ব্যবহার করে:

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

জাভা

/**
* 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() ব্যবহার করতে পারে।

একটি ওয়াই-ফাই P2P অ্যাপ্লিকেশন তৈরি করা

ওয়াই-ফাই P2P অ্যাপ্লিকেশন তৈরি করার মধ্যে আপনার অ্যাপ্লিকেশনের জন্য সম্প্রচার রিসিভার তৈরি ও রেজিস্টার করা, পিয়ার খুঁজে বের করা, পিয়ারের সাথে কানেক্ট করা এবং পিয়ারে ডেটা ট্রান্সফার করা অন্তর্ভুক্ত। এটি কীভাবে করতে হয় তা নিম্নলিখিত বিভাগে বর্ণনা করা হয়েছে।

প্রাথমিক সেটআপ

Wi-Fi P2P API ব্যবহার করার আগে, আপনার অ্যাপ্লিকেশন হার্ডওয়্যার অ্যাক্সেস করতে পারে কিনা এবং ডিভাইস Wi-Fi P2P প্রোটোকল সাপোর্ট করে কিনা তা নিশ্চিত করতে হবে। যদি Wi-Fi P2P কাজ করে, তাহলে আপনি WifiP2pManager-এর একটি ইনস্ট্যান্স পেতে, আপনার ব্রডকাস্ট রিসিভার তৈরি ও রেজিস্টার করতে এবং Wi-Fi P2P API ব্যবহার করা শুরু করতে পারবেন।

  1. ডিভাইসে ওয়াই-ফাই হার্ডওয়্যার ব্যবহার করার জন্য অনুমতি চান এবং Android ম্যানিফেস্টে আপনার অ্যাপ্লিকেশনের সঠিক ন্যূনতম SDK ভার্সন আছে বলে ঘোষণা করুন:

    <uses-sdk android:minSdkVersion="14" />
    <uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
    <uses-permission android:name="android.permission.CHANGE_WIFI_STATE" />
    <uses-permission android:name="android.permission.CHANGE_NETWORK_STATE" />
    <uses-permission android:name="android.permission.INTERNET" />
    <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
    <!-- If your app targets Android 13 (API level 33)
         or higher, you must declare the NEARBY_WIFI_DEVICES permission. -->
    <uses-permission android:name="android.permission.NEARBY_WIFI_DEVICES"
                     <!-- If your app derives location information from
                          Wi-Fi APIs, don't include the "usesPermissionFlags"
                          attribute. -->
                     android:usesPermissionFlags="neverForLocation" />
    <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION"
                     <!-- If any feature in your app relies on precise location
                          information, don't include the "maxSdkVersion"
                          attribute. -->
                     android:maxSdkVersion="32" />
    

    পূর্ববর্তী অনুমতি ছাড়াও, নিম্নলিখিত API-এর জন্য লোকেশন মোড চালু করতে হবে:

  2. ওয়াই-ফাই P2P চালু আছে কিনা এবং কাজ করে কিনা তা চেক করে দেখুন। এটি চেক করার জন্য একটি ভাল জায়গা হল আপনার ব্রডকাস্ট রিসিভার যখন WIFI_P2P_STATE_CHANGED_ACTION ইনটেন্ট পায়। Wi-Fi P2P-এর অ্যাক্টিভিটি সম্পর্কে বিজ্ঞপ্তি দেয় স্ট্যাটাস এবং সেই অনুযায়ী প্রতিক্রিয়া জানায়:

    Kotlin

    override fun onReceive(context: Context, intent: Intent) {
    ...
    val action: String = intent.action
    when (action) {
       WifiP2pManager.WIFI_P2P_STATE_CHANGED_ACTION -> {
           val state = intent.getIntExtra(WifiP2pManager.EXTRA_WIFI_STATE, -1)
           when (state) {
               WifiP2pManager.WIFI_P2P_STATE_ENABLED -> {
                   // Wifi P2P is enabled
               }
               else -> {
                   // Wi-Fi P2P is not enabled
               }
           }
       }
    }
    ...
    }

    জাভা

    @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-এর একটি ইনস্ট্যান্স পান এবং initialize() কল করে Wi-Fi P2P ফ্রেমওয়ার্কের সাথে আপনার অ্যাপ্লিকেশন রেজিস্টার করুন। এই পদ্ধতিটি একটি WifiP2pManager.Channel রিটার্ন করে, যা আপনার অ্যাপ্লিকেশনকে Wi-Fi P2P ফ্রেমওয়ার্কের সাথে কানেক্ট করতে ব্যবহৃত হয়। এছাড়াও, আপনার অ্যাক্টিভিটির রেফারেন্স সহ WifiP2pManager এবং WifiP2pManager.Channel অবজেক্টের সাথে আপনার ব্রডকাস্ট রিসিভারের একটি ইনস্ট্যান্স তৈরি করতে হবে। এটি আপনার সম্প্রচার রিসিভারকে আকর্ষণীয় ইভেন্টের অ্যাক্টিভিটি সম্পর্কে বিজ্ঞপ্তি দিতে এবং সেই অনুযায়ী আপডেট করতে দেয়। এছাড়াও, প্রয়োজন হলে এটি আপনাকে ডিভাইসের ওয়াই-ফাই স্ট্যাটাস পরিবর্তন করতে দেয়:

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

    জাভা

    WifiP2pManager manager;
    Channel channel;
    BroadcastReceiver receiver;
    ...
    @Override
    protected void onCreate(Bundle savedInstanceState){
       ...
       manager = (WifiP2pManager) getSystemService(Context.WIFI_P2P_SERVICE);
       channel = manager.initialize(this, getMainLooper(), null);
       receiver = new WiFiDirectBroadcastReceiver(manager, channel, this);
       ...
    }
  4. ইনটেন্ট ফিল্টার তৈরি করুন এবং আপনার ব্রডকাস্ট রিসিভার যে ইনটেন্ট চেক করে, সেগুলিই যোগ করুন:

    Kotlin

    val intentFilter = IntentFilter().apply {
       addAction(WifiP2pManager.WIFI_P2P_STATE_CHANGED_ACTION)
       addAction(WifiP2pManager.WIFI_P2P_PEERS_CHANGED_ACTION)
       addAction(WifiP2pManager.WIFI_P2P_CONNECTION_CHANGED_ACTION)
       addAction(WifiP2pManager.WIFI_P2P_THIS_DEVICE_CHANGED_ACTION)
    }

    জাভা

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

    জাভা

    /* 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 মেথড কল করতে এবং ওয়াই-ফাই P2P ইনটেন্ট রিসিভ করতে পারবে।

  7. WifiP2pManager-এ মেথড কল করে ওয়াই-ফাই P2P ফিচার ব্যবহার করে আপনার অ্যাপ্লিকেশন প্রয়োগ করুন।

পরবর্তী বিভাগে, পিয়ার খুঁজে পাওয়া ও কানেক্ট করার মতো সাধারণ অ্যাকশন কীভাবে করবেন তা বর্ণনা করা হয়েছে।

সহকর্মীদের খুঁজে নিন

রেঞ্জে থাকা ও কানেকশনের জন্য উপলভ্য পিয়ার শনাক্ত করতে discoverPeers() কল করুন। এই ফাংশনে কল করা অ্যাসিঙ্ক্রোনাস এবং আপনি WifiP2pManager.ActionListener তৈরি করলে, onSuccess() ও onFailure()-এর মাধ্যমে আপনার অ্যাপ্লিকেশনে সাফল্য বা ব্যর্থতার কথা জানানো হয়। onSuccess() পদ্ধতিটি শুধুমাত্র আপনাকে জানায় যে খোঁজার প্রসেসটি সফল হয়েছে এবং এটি যে আসল পিয়ার খুঁজে পেয়েছে, যদি কিছু থাকে, তার ব্যাপারে কোনও তথ্য প্রদান করে না। নিম্নলিখিত কোডের নমুনা থেকে এটি কীভাবে সেট-আপ করতে হয় তা জানতে পারবেন।

Kotlin

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

   override fun onSuccess() {
       ...
   }

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

জাভা

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

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

ডিসকভারি প্রসেস সফল হলে এবং পিয়ার শনাক্ত করলে, সিস্টেম WIFI_P2P_PEERS_CHANGED_ACTION ইনটেন্ট ব্রডকাস্ট করে, যা আপনি পিয়ারের তালিকা পেতে ব্রডকাস্ট রিসিভারে শুনতে পারবেন। আপনার অ্যাপ্লিকেশন WIFI_P2P_PEERS_CHANGED_ACTION ইনটেন্ট পেলে, আপনি requestPeers()-এর মাধ্যমে খুঁজে পাওয়া পিয়ারের তালিকা পাওয়ার অনুরোধ করতে পারবেন। এটি কীভাবে সেট-আপ করতে হয় তা নিম্নলিখিত কোড থেকে জানতে পারবেন।

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

জাভা

PeerListListener myPeerListListener;
...
if (WifiP2pManager.WIFI_P2P_PEERS_CHANGED_ACTION.equals(action)) {

   // request available peers from the wifi p2p manager. This is an
   // asynchronous call and the calling activity is notified with a
   // callback on PeerListListener.onPeersAvailable()
   if (manager != null) {
       manager.requestPeers(channel, myPeerListListener);
   }
}

requestPeers() পদ্ধতিটি অ্যাসিঙ্ক্রোনাস এবং এটি আপনার অ্যাক্টিভিটি সম্পর্কে জানাতে পারে যখন পিয়ারের তালিকা onPeersAvailable()-এর সাথে উপলভ্য থাকে, যা WifiP2pManager.PeerListListener ইন্টারফেসে সংজ্ঞায়িত করা হয়। onPeersAvailable() পদ্ধতি আপনাকে একটি WifiP2pDeviceList প্রদান করে, যা আপনি কানেক্ট করার জন্য পিয়ার খুঁজতে ইটারেট করতে পারেন।

সহকর্মীদের সাথে কানেক্ট করুন

আপনি সম্ভাব্য পিয়ারের তালিকা পেয়ে গেলে এবং কানেক্ট করার জন্য ডিভাইস বেছে নিলে, ডিভাইসের সাথে কানেক্ট করতে connect() মেথড কল করুন। এই মেথড কলের জন্য একটি WifiP2pConfig অবজেক্ট প্রয়োজন যাতে কানেক্ট করার জন্য ডিভাইসের তথ্য থাকে। WifiP2pManager.ActionListener আপনাকে কানেকশন সফল বা ব্যর্থ হওয়ার ব্যাপারে জানাতে পারে। নিম্নলিখিত কোড থেকে আপনি জানতে পারবেন যে কীভাবে কোনও ডিভাইসের সাথে কানেকশন তৈরি করতে হয়।

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

জাভা

//obtain a peer from the WifiP2pDeviceList
WifiP2pDevice device;
WifiP2pConfig config = new WifiP2pConfig();
config.deviceAddress = device.deviceAddress;
manager.connect(channel, config, new ActionListener() {

   @Override
   public void onSuccess() {
       //success logic
   }

   @Override
   public void onFailure(int reason) {
       //failure logic
   }
});

ডেটা ট্রান্সফার করুন

কানেকশন তৈরি হয়ে গেলে, আপনি সকেটের মাধ্যমে ডিভাইসগুলির মধ্যে ডেটা ট্রান্সফার করতে পারবেন। ডেটা ট্রান্সফার করার প্রাথমিক ধাপগুলি নিচে দেওয়া হল:

  1. ServerSocket তৈরি করুন। এই সকেট নির্দিষ্ট পোর্টে ক্লায়েন্টের থেকে কানেকশনের জন্য অপেক্ষা করে এবং এটি না হওয়া পর্যন্ত ব্লক করে, তাই ব্যাকগ্রাউন্ড থ্রেডে এটি করুন।
  2. ক্লায়েন্ট Socket তৈরি করুন। সার্ভার ডিভাইসের সাথে কানেক্ট করতে ক্লায়েন্ট সার্ভার সকেটের IP অ্যাড্রেস ও পোর্ট ব্যবহার করে।
  3. ক্লায়েন্ট থেকে সার্ভারে ডেটা পাঠান। ক্লায়েন্ট সকেট সার্ভার সকেটের সাথে সফলভাবে কানেক্ট করলে, আপনি ক্লায়েন্ট থেকে সার্ভারে বাইট স্ট্রিমের মাধ্যমে ডেটা পাঠাতে পারবেন।
  4. সার্ভার সকেট ক্লায়েন্ট কানেকশনের জন্য অপেক্ষা করে (accept() পদ্ধতির মাধ্যমে)। কোনও ক্লায়েন্ট কানেক্ট না করা পর্যন্ত এই কল ব্লক করা থাকে, তাই অন্য থ্রেডে এই কল করুন। কানেকশন হলে, সার্ভার ডিভাইস ক্লায়েন্ট থেকে ডেটা পেতে পারে।

Wi-Fi P2P ডেমো থেকে পরিবর্তিত নিম্নলিখিত উদাহরণ থেকে আপনি জানতে পারবেন যে কীভাবে এই ক্লায়েন্ট-সার্ভার সকেট কমিউনিকেশন তৈরি করতে হয় এবং পরিষেবার মাধ্যমে ক্লায়েন্ট থেকে সার্ভারে JPEG ছবি ট্রান্সফার করতে হয়। সম্পূর্ণ কার্যকর উদাহরণ দেখতে, ডেমো কম্পাইল ও রান করুন।

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

জাভা

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 ফাইল ট্রান্সফার করে।

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

জাভা

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