ब्लूटूथ या ब्लूटूथ लो एनर्जी की मदद से, आपके ऐप्लिकेशन को किसी डिवाइस से कनेक्ट करने से पहले, आपको यह पुष्टि करनी होगी कि उस डिवाइस पर ब्लूटूथ की सुविधा काम करती है या नहीं. अगर काम करती है, तो पक्का करें कि वह चालू हो. ध्यान दें कि यह जांच सिर्फ़ तब ज़रूरी है, जब <uses-feature.../> मेनिफ़ेस्ट फ़ाइल एंट्री में android:required एट्रिब्यूट को false पर सेट किया गया हो.
अगर ब्लूटूथ की सुविधा काम नहीं करती है, तो आपको ब्लूटूथ की सभी सुविधाओं को बंद कर देना चाहिए. अगर ब्लूटूथ की सुविधा काम करती है, लेकिन बंद है, तो उपयोगकर्ता से ब्लूटूथ चालू करने का अनुरोध किया जा सकता है. इसके लिए, उपयोगकर्ता को आपका ऐप्लिकेशन छोड़ने की ज़रूरत नहीं है.
इन एपीआई का इस्तेमाल करने के लिए, सबसे पहले अपनी मेनिफ़ेस्ट फ़ाइल में ब्लूटूथ की अनुमतियां जोड़ें.
अनुमतियां मिलने के बाद, BluetoothAdapter का इस्तेमाल करके ब्लूटूथ सेटअप को दो चरणों में पूरा किया जाता है:
BluetoothAdapterपाएं.ब्लूटूथ से जुड़ी किसी भी गतिविधि के लिए,
BluetoothAdapterकी ज़रूरत होती है.BluetoothAdapter, डिवाइस के ब्लूटूथ अडैप्टर (ब्लूटूथ रेडियो) को दिखाता है.BluetoothAdapterपाने के लिए, आपके पास पहलेContextहोना चाहिए.BluetoothManagerसिस्टम सर्विस का इंस्टेंस पाने के लिए, इस कॉन्टेक्स्ट का इस्तेमाल करें.BluetoothManager#getAdapterको कॉल करने पर, आपको एकBluetoothAdapterऑब्जेक्ट मिलेगा. अगरgetAdapter()से null मिलता है, तो इसका मतलब है कि डिवाइस पर ब्लूटूथ की सुविधा काम नहीं करती.उदाहरण के लिए:
Kotlin
val bluetoothManager: BluetoothManager = getSystemService(BluetoothManager::class.java) val bluetoothAdapter: BluetoothAdapter? = bluetoothManager.getAdapter() if (bluetoothAdapter == null) { // Device doesn't support Bluetooth }Java
BluetoothManager bluetoothManager = getSystemService(BluetoothManager.class); BluetoothAdapter bluetoothAdapter = bluetoothManager.getAdapter(); if (bluetoothAdapter == null) { // Device doesn't support Bluetooth }ब्लूटूथ चालू करें.
इसके बाद, पक्का करें कि ब्लूटूथ चालू हो.
isEnabled()को कॉल करके देखें कि ब्लूटूथ चालू है या नहीं. अगर यह तरीका false दिखाता है, तो इसका मतलब है कि ब्लूटूथ बंद है. ब्लूटूथ चालू करने का अनुरोध करने के लिए,startActivityForResult()को कॉल करें. साथ ही,ACTION_REQUEST_ENABLEइंटेंट ऐक्शन पास करें. यह कॉल, सिस्टम सेटिंग के ज़रिए ब्लूटूथ को चालू करने का अनुरोध करता है. इसके लिए, आपके ऐप्लिकेशन को बंद करने की ज़रूरत नहीं होती.उदाहरण के लिए:
Kotlin
if (bluetoothAdapter?.isEnabled == false) { val enableBtIntent = Intent(BluetoothAdapter.ACTION_REQUEST_ENABLE) startActivityForResult(enableBtIntent, REQUEST_ENABLE_BT) }Java
if (!bluetoothAdapter.isEnabled()) { Intent enableBtIntent = new Intent(BluetoothAdapter.ACTION_REQUEST_ENABLE); startActivityForResult(enableBtIntent, REQUEST_ENABLE_BT); }
ब्लूटूथ चालू करने के लिए, उपयोगकर्ता की अनुमति मांगने वाला एक डायलॉग बॉक्स दिखता है. जैसा कि इमेज 1 में दिखाया गया है. अगर उपयोगकर्ता अनुमति देता है, तो सिस्टम ब्लूटूथ चालू करना शुरू कर देता है. प्रोसेस पूरी होने या फ़ेल होने के बाद, फ़ोकस आपके ऐप्लिकेशन पर वापस आ जाता है.
startActivityForResult() को पास किया गया REQUEST_ENABLE_BT कॉन्सटेंट, स्थानीय तौर पर तय किया गया एक पूर्णांक है. यह 0 से बड़ा या उसके बराबर होना चाहिए. सिस्टम, इस कॉन्सटैंट को आपके onActivityResult() लागू करने के तरीके में, requestCode पैरामीटर के तौर पर वापस भेजता है.
अगर ब्लूटूथ चालू हो जाता है, तो आपकी गतिविधि को onActivityResult() कॉलबैक में RESULT_OK रिज़ल्ट कोड मिलता है. अगर किसी गड़बड़ी की वजह से ब्लूटूथ चालू नहीं किया गया था या उपयोगकर्ता ने "अस्वीकार करें" जवाब दिया, तो नतीजे का कोड RESULT_CANCELED होगा.
इसके अलावा, आपका ऐप्लिकेशन ACTION_STATE_CHANGED ब्रॉडकास्ट इंटेंट को भी सुन सकता है. ब्लूटूथ की स्थिति बदलने पर, सिस्टम इसे ब्रॉडकास्ट करता है. इस ब्रॉडकास्ट में अतिरिक्त फ़ील्ड EXTRA_STATE और EXTRA_PREVIOUS_STATE शामिल हैं. इनमें क्रमशः ब्लूटूथ की नई और पुरानी स्थितियां शामिल हैं. इन अतिरिक्त फ़ील्ड के लिए संभावित वैल्यू STATE_TURNING_ON, STATE_ON, STATE_TURNING_OFF, और STATE_OFF हैं. अगर आपके ऐप्लिकेशन को ब्लूटूथ की स्थिति में रनटाइम के दौरान किए गए बदलावों का पता लगाना है, तो इस ब्रॉडकास्ट को सुनना मददगार हो सकता है.
डिवाइस पर ब्लूटूथ चालू होने के बाद, ब्लूटूथ क्लासिक और ब्लूटूथ लो एनर्जी, दोनों का इस्तेमाल किया जा सकता है.
ब्लूटूथ क्लासिक के लिए, ब्लूटूथ डिवाइसों को ढूंढा जा सकता है और ब्लूटूथ डिवाइसों से कनेक्ट किया जा सकता है.
ब्लूटूथ लो एनर्जी के लिए, BLE डिवाइसों को ढूंढा जा सकता है, GATT सर्वर से कनेक्ट किया जा सकता है, और BLE डेटा ट्रांसफ़र किया जा सकता है.