Wi-Fi Direct (P2P) की मदद से, ज़रूरी हार्डवेयर वाले डिवाइस एक-दूसरे से सीधे तौर पर कनेक्ट हो सकते हैं. इसके लिए, किसी इंटरमीडिएट ऐक्सेस पॉइंट की ज़रूरत नहीं होती. इन एपीआई का इस्तेमाल करके, अन्य डिवाइसों को खोजा जा सकता है और उनसे कनेक्ट किया जा सकता है. इसके लिए, हर डिवाइस पर वाई-फ़ाई पी2पी की सुविधा चालू होनी चाहिए. इसके बाद, ब्लूटूथ कनेक्शन की तुलना में ज़्यादा दूरी पर मौजूद डिवाइसों के साथ तेज़ कनेक्शन के ज़रिए कम्यूनिकेट किया जा सकता है. यह उन ऐप्लिकेशन के लिए काम का है जो लोगों के बीच डेटा शेयर करते हैं. जैसे, मल्टीप्लेयर गेम या फ़ोटो शेयर करने वाला ऐप्लिकेशन.
Wi-Fi P2P API में ये मुख्य चीज़ें शामिल होती हैं:
- ये ऐसे तरीके हैं जिनसे आपको अन्य लोगों के बारे में पता चलता है, उनसे जुड़ने का अनुरोध किया जा सकता है, और उनसे कनेक्ट किया जा सकता है. इन्हें
WifiP2pManager
क्लास में तय किया गया है. - ऐसे लिसनर जो आपको
WifiP2pManager
तरीके के कॉल के सफल या असफल होने की सूचना देते हैं.WifiP2pManager
तरीकों को कॉल करते समय, हर तरीका एक खास लिसनर को पैरामीटर के तौर पर पास कर सकता है. - ये इंटेंट, वाई-फ़ाई पी2पी फ़्रेमवर्क से पता लगाए गए कुछ इवेंट के बारे में आपको सूचना देते हैं. जैसे, कनेक्शन टूट जाना या नया पीयर डिवाइस मिलना.
अक्सर, आपको एपीआई के इन तीन मुख्य कॉम्पोनेंट का एक साथ इस्तेमाल करना होगा. उदाहरण के लिए, discoverPeers()
को कॉल करने के लिए WifiP2pManager.ActionListener
दिया जा सकता है, ताकि ActionListener.onSuccess()
और ActionListener.onFailure()
तरीके आपको सूचना दे सकें. अगर discoverPeers()
तरीके को पता चलता है कि पियर की सूची बदल गई है, तो WIFI_P2P_PEERS_CHANGED_ACTION
इंटेंट भी ब्रॉडकास्ट किया जाता है.
एपीआई के बारे में खास जानकारी
WifiP2pManager
क्लास, ऐसे तरीके उपलब्ध कराती है जिनकी मदद से, डिवाइस के वाई-फ़ाई हार्डवेयर से इंटरैक्ट किया जा सकता है. जैसे, आस-पास के डिवाइसों को ढूंढना और उनसे कनेक्ट करना.
ये कार्रवाइयां की जा सकती हैं:
पहली टेबल. वाई-फ़ाई पीयर-टू-पीयर (P2P) के तरीके
तरीका | ब्यौरा |
initialize()
|
यह कुकी, ऐप्लिकेशन को वाई-फ़ाई फ़्रेमवर्क के साथ रजिस्टर करती है. किसी अन्य वाई-फ़ाई P2P तरीके को कॉल करने से पहले, इसे कॉल करें. |
connect()
|
यह फ़ंक्शन, तय किए गए कॉन्फ़िगरेशन वाले डिवाइस के साथ पीयर-टू-पीयर कनेक्शन शुरू करता है. |
cancelConnect()
|
पीयर-टू-पीयर ग्रुप के साथ चल रही किसी भी बातचीत को रद्द करता है. |
requestConnectInfo()
|
यह कुकी, डिवाइस के कनेक्शन की जानकारी का अनुरोध करती है. |
createGroup()
|
यह कमांड, पीयर-टू-पीयर ग्रुप बनाती है. इसमें मौजूदा डिवाइस को ग्रुप का मालिक बनाया जाता है. |
removeGroup()
|
इससे मौजूदा पीयर-टू-पीयर ग्रुप हट जाता है. |
requestGroupInfo()
|
यह कुकी, पीयर-टू-पीयर ग्रुप की जानकारी का अनुरोध करती है. |
discoverPeers()
|
इससे आस-पास के डिवाइसों का पता लगाया जाता है. |
requestPeers()
|
डिस्कवर किए गए मौजूदा साथियों की सूची का अनुरोध करता है. |
WifiP2pManager
तरीकों से, आपको एक लिसनर पास करने की सुविधा मिलती है. इससे Wi-Fi P2P फ़्रेमवर्क, कॉल की स्थिति के बारे में आपकी गतिविधि को सूचना दे सकता है. टेबल 2 में, उपलब्ध लिसनर इंटरफ़ेस और उनसे जुड़े WifiP2pManager
तरीके के कॉल के बारे में बताया गया है.
टेबल 2. वाई-फ़ाई P2P लिसनर
लिसनर इंटरफ़ेस | इससे जुड़ी कार्रवाइयां |
WifiP2pManager.ActionListener
|
connect() , cancelConnect() ,
createGroup() , removeGroup() , और
discoverPeers()
|
WifiP2pManager.ChannelListener
|
initialize()
|
WifiP2pManager.ConnectionInfoListener
|
requestConnectInfo()
|
WifiP2pManager.GroupInfoListener
|
requestGroupInfo()
|
WifiP2pManager.PeerListListener
|
requestPeers()
|
Wi-Fi P2P API, ऐसे इंटेंट तय करते हैं जिन्हें कुछ Wi-Fi P2P इवेंट होने पर ब्रॉडकास्ट किया जाता है. जैसे, जब किसी नए पीयर का पता चलता है या जब किसी डिवाइस का वाई-फ़ाई स्टेटस बदलता है. अपने ऐप्लिकेशन में इन इंटेंट को पाने के लिए रजिस्टर किया जा सकता है. इसके लिए, ब्रॉडकास्ट रिसीवर बनाएं. यह रिसीवर इन इंटेंट को हैंडल करेगा:
टेबल 3. 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 सिस्टम से ब्रॉडकास्ट किए गए इंटेंट पाए जा सकते हैं. इससे आपका ऐप्लिकेशन, आपकी पसंद के इवेंट के हिसाब से काम कर सकता है. वाई-फ़ाई P2P इंटेंट को मैनेज करने के लिए, ब्रॉडकास्ट रिसीवर बनाने का बुनियादी तरीका यहां दिया गया है:
BroadcastReceiver
क्लास को बढ़ाने वाली क्लास बनाएं. क्लास के कंस्ट्रक्टर के लिए, आपकोWifiP2pManager
,WifiP2pManager.Channel
, और उस गतिविधि के लिए पैरामीटर इस्तेमाल करने होंगे जिसमें यह ब्रॉडकास्ट रिसीवर रजिस्टर किया जाएगा. इससे ब्रॉडकास्ट रिसीवर, गतिविधि को अपडेट भेज सकता है. साथ ही, ज़रूरत पड़ने पर वाई-फ़ाई हार्डवेयर और कम्यूनिकेशन चैनल को ऐक्सेस कर सकता है.ब्रॉडकास्ट रिसीवर में, उन इंटेंट की जांच करें जिनमें आपकी दिलचस्पी है. इसके लिए,
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 } } } }
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 } } }
Android 10 और इसके बाद के वर्शन पर काम करने वाले डिवाइसों पर, ये ब्रॉडकास्ट इंटेंट नॉन-स्टिकी होते हैं:
WIFI_P2P_CONNECTION_CHANGED_ACTION
- ऐप्लिकेशन, कनेक्शन की मौजूदा जानकारी पाने के लिए
requestConnectionInfo()
,requestNetworkInfo()
याrequestGroupInfo()
का इस्तेमाल कर सकते हैं. WIFI_P2P_THIS_DEVICE_CHANGED_ACTION
- ऐप्लिकेशन, कनेक्शन की मौजूदा जानकारी पाने के लिए
requestDeviceInfo()
का इस्तेमाल कर सकते हैं.
Wi-Fi P2P ऐप्लिकेशन बनाना
Wi-Fi P2P ऐप्लिकेशन बनाने के लिए, आपको ये काम करने होंगे: अपने ऐप्लिकेशन के लिए ब्रॉडकास्ट रिसीवर बनाना और उसे रजिस्टर करना, आस-पास के डिवाइसों का पता लगाना, किसी डिवाइस से कनेक्ट करना, और किसी डिवाइस पर डेटा ट्रांसफ़र करना. यहां दिए गए सेक्शन में, ऐसा करने का तरीका बताया गया है.
शुरुआती सेट अप
Wi-Fi P2P API का इस्तेमाल करने से पहले, आपको यह पक्का करना होगा कि आपका ऐप्लिकेशन हार्डवेयर को ऐक्सेस कर सकता हो और डिवाइस पर Wi-Fi P2P प्रोटोकॉल काम करता हो. अगर वाई-फ़ाई P2P की सुविधा काम करती है, तो WifiP2pManager
का इंस्टेंस पाया जा सकता है. साथ ही, ब्रॉडकास्ट रिसीवर बनाया और रजिस्टर किया जा सकता है. इसके बाद, वाई-फ़ाई P2P एपीआई का इस्तेमाल किया जा सकता है.
डिवाइस पर वाई-फ़ाई हार्डवेयर का इस्तेमाल करने की अनुमति का अनुरोध करें. साथ ही, 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" />
ऊपर दी गई अनुमतियों के अलावा, इन एपीआई के लिए भी जगह की जानकारी का मोड चालू होना ज़रूरी है:
देखें कि वाई-फ़ाई P2P चालू हो और काम कर रहा हो. इसकी जांच करने के लिए सबसे सही जगह, ब्रॉडकास्ट रिसीवर में होती है. ऐसा तब होता है, जब उसे
WIFI_P2P_STATE_CHANGED_ACTION
इंटेंट मिलता है. वाई-फ़ाई 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 } } } } ... }
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 } } ... }
अपनी गतिविधि के
onCreate()
तरीके में,WifiP2pManager
का इंस्टेंस पाएं. साथ ही,initialize()
को कॉल करके, अपने ऐप्लिकेशन को Wi-Fi P2P फ़्रेमवर्क के साथ रजिस्टर करें. यह तरीकाWifiP2pManager.Channel
दिखाता है. इसका इस्तेमाल, अपने ऐप्लिकेशन को वाई-फ़ाई पी2पी फ़्रेमवर्क से कनेक्ट करने के लिए किया जाता है. आपको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) } }
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); ... }
एक इंटेंट फ़िल्टर बनाएं और उसमें वे इंटेंट जोड़ें जिनकी जांच आपका ब्रॉडकास्ट रिसीवर करता है:
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); ... }
ब्रॉडकास्ट रिसीवर को अपनी गतिविधि के
onResume()
तरीके में रजिस्टर करें और इसे अपनी गतिविधि केonPause()
तरीके में अनरजिस्टर करें:Kotlin
/* register the broadcast receiver with the intent values to be matched */ override fun onResume() { super.onResume() receiver?.also { receiver -> registerReceiver(receiver, intentFilter) } } /* unregister the broadcast receiver */ override fun onPause() { super.onPause() receiver?.also { receiver -> unregisterReceiver(receiver) } }
Java
/* register the broadcast receiver with the intent values to be matched */ @Override protected void onResume() { super.onResume(); registerReceiver(receiver, intentFilter); } /* unregister the broadcast receiver */ @Override protected void onPause() { super.onPause(); unregisterReceiver(receiver); }
WifiP2pManager.Channel
पाने और ब्रॉडकास्ट रिसीवर सेट अप करने के बाद, आपका ऐप्लिकेशन वाई-फ़ाई P2P तरीके से कॉल कर सकता है और वाई-फ़ाई P2P इंटेंट पा सकता है.WifiP2pManager
में दिए गए तरीकों को कॉल करके, Wi-Fi P2P की सुविधाओं का इस्तेमाल करके अपना ऐप्लिकेशन लागू करें.
अगले सेक्शन में, सामान्य कार्रवाइयां करने का तरीका बताया गया है. जैसे, अन्य उपयोगकर्ताओं को ढूंढना और उनसे कनेक्ट करना.
मिलते-जुलते ऐप्लिकेशन खोजना
discoverPeers()
को कॉल करके, आस-पास मौजूद उन डिवाइसों का पता लगाएं जो कनेक्ट किए जा सकते हैं. इस फ़ंक्शन को एसिंक्रोनस तरीके से कॉल किया जाता है. अगर आपने WifiP2pManager.ActionListener
बनाया है, तो onSuccess()
और onFailure()
की मदद से, आपके ऐप्लिकेशन को कॉल के पूरा होने या न होने की सूचना दी जाती है. onSuccess()
तरीका सिर्फ़ आपको यह सूचना देता है कि डिवाइसों का पता लगाने की प्रोसेस पूरी हो गई है. साथ ही, यह उन डिवाइसों के बारे में कोई जानकारी नहीं देता जिनका पता लगाया गया है. नीचे दिए गए कोड के सैंपल में, इसे सेट अप करने का तरीका बताया गया है.
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) { ... } });
अगर डिवाइसों को खोजने की प्रोसेस पूरी हो जाती है और आस-पास के डिवाइसों का पता चल जाता है, तो सिस्टम 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 } } ... } }
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); } }
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 } } )}
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 } });
डेटा ट्रांसफ़र करें
कनेक्शन बन जाने के बाद, सॉकेट वाले डिवाइसों के बीच डेटा ट्रांसफ़र किया जा सकता है. डेटा ट्रांसफ़र करने का तरीका यहां दिया गया है:
ServerSocket
बनाएं. यह सॉकेट, किसी तय पोर्ट पर क्लाइंट से कनेक्शन का इंतज़ार करता है और तब तक ब्लॉक रहता है, जब तक ऐसा नहीं होता. इसलिए, इसे बैकग्राउंड थ्रेड में करें.- क्लाइंट
Socket
बनाएं. क्लाइंट, सर्वर डिवाइस से कनेक्ट करने के लिए सर्वर सॉकेट के आईपी पते और पोर्ट का इस्तेमाल करता है. - क्लाइंट से सर्वर को डेटा भेजें. जब क्लाइंट सॉकेट, सर्वर सॉकेट से कनेक्ट हो जाता है, तब बाइट स्ट्रीम की मदद से क्लाइंट से सर्वर को डेटा भेजा जा सकता है.
- सर्वर सॉकेट, क्लाइंट कनेक्शन का इंतज़ार करता है. इसके लिए,
accept()
तरीके का इस्तेमाल किया जाता है. यह कॉल तब तक ब्लॉक रहती है, जब तक कोई क्लाइंट कनेक्ट नहीं हो जाता. इसलिए, इसे किसी अन्य थ्रेड में कॉल करें. कनेक्शन होने पर, सर्वर डिवाइस को क्लाइंट से डेटा मिल सकता है.
नीचे दिए गए उदाहरण में, क्लाइंट-सर्वर सॉकेट कम्यूनिकेशन बनाने और किसी सेवा के साथ क्लाइंट से सर्वर पर JPEG इमेज ट्रांसफ़र करने का तरीका बताया गया है. यह उदाहरण, Wi-Fi P2P डेमो में बदलाव करके बनाया गया है. काम करने वाले पूरे उदाहरण के लिए, डेमो को कंपाइल करें और चलाएं.
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); } } }
क्लाइंट पर, क्लाइंट सॉकेट की मदद से सर्वर सॉकेट से कनेक्ट करें और डेटा ट्रांसफ़र करें. इस उदाहरण में, क्लाइंट डिवाइस के फ़ाइल सिस्टम पर मौजूद 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() } }
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 } } } }