ब्लूटूथ डिवाइस ढूंढें

BluetoothAdapter का इस्तेमाल करके, ब्लूटूथ की सुविधा वाले रिमोट डिवाइसों को ढूंढा जा सकता है. इसके लिए, डिवाइस खोजने की सुविधा का इस्तेमाल किया जा सकता है या जोड़े गए डिवाइसों की सूची से क्वेरी की जा सकती है.

ब्लूटूथ डिवाइसों को ढूंढने से पहले, पक्का करें कि आपके पास ब्लूटूथ की ज़रूरी अनुमतियां हों और आपने ब्लूटूथ के लिए अपना ऐप्लिकेशन सेट अप किया हो.

डिवाइस खोजने की सुविधा, स्कैन करने की एक प्रोसेस है. यह आस-पास के इलाके में ब्लूटूथ की सुविधा वाले डिवाइसों को खोजती है और हर डिवाइस के बारे में कुछ जानकारी मांगती है. इस प्रोसेस को कभी-कभी डिस्कवर करना, पूछताछ करना या स्कैन करना भी कहा जाता है. आस-पास मौजूद कोई ब्लूटूथ डिवाइस, खोजे जाने के अनुरोध का जवाब सिर्फ़ तब देता है, जब वह खोजे जाने लायक हो और जानकारी के अनुरोध स्वीकार कर रहा हो. अगर कोई डिवाइस खोजे जाने लायक है, तो वह खोजे जाने के अनुरोध का जवाब देता है. इसके लिए, वह कुछ जानकारी शेयर करता है. जैसे, डिवाइस का नाम, उसकी क्लास, और उसका यूनीक मैक पता. इस जानकारी का इस्तेमाल करके, डिवाइस को खोजने की प्रोसेस पूरी करने वाला डिवाइस, खोजे गए डिवाइस से कनेक्शन शुरू करने का विकल्प चुन सकता है.

खोजे जाने लायक डिवाइसों से, उपयोगकर्ता की जगह की जानकारी का पता चल सकता है. इसलिए, डिवाइस खोजने की प्रोसेस के लिए, जगह की जानकारी का ऐक्सेस ज़रूरी है. अगर आपके ऐप्लिकेशन का इस्तेमाल Android 8.0 (एपीआई लेवल 26) या इसके बाद के वर्शन वाले डिवाइस पर किया जा रहा है, तो इसके बजाय कंपैनियन डिवाइस मैनेजर एपीआई का इस्तेमाल करें. यह एपीआई आपके ऐप्लिकेशन की ओर से डिवाइस का पता लगाता है. इसलिए, आपके ऐप्लिकेशन को जगह की जानकारी की अनुमति का अनुरोध करने की ज़रूरत नहीं होती.

किसी रिमोट डिवाइस से पहली बार कनेक्ट करने पर, डिवाइस को जोड़ने का अनुरोध अपने-आप दिखता है. डिवाइसों को जोड़ने के बाद, डिवाइस की बुनियादी जानकारी सेव हो जाती है. जैसे, डिवाइस का नाम, क्लास, और मैक पता. इस जानकारी को ब्लूटूथ एपीआई की मदद से पढ़ा जा सकता है.

जोड़े गए डिवाइस के मैक पते का इस्तेमाल करके, किसी भी समय कनेक्शन शुरू किया जा सकता है. इसके लिए, डिवाइस को खोजने की ज़रूरत नहीं होती. हालांकि, इसके लिए ज़रूरी है कि डिवाइस अब भी रेंज में हो.

ध्यान दें कि डिवाइसों को जोड़ने और उन्हें कनेक्ट करने में अंतर होता है:

  • दूसरे डिवाइस से जोड़ने का मतलब है कि दोनों डिवाइसों को एक-दूसरे की मौजूदगी का पता है. साथ ही, उनके पास एक शेयर की गई लिंक-की है, जिसका इस्तेमाल पुष्टि करने के लिए किया जा सकता है. इसके अलावा, वे एक-दूसरे के साथ एन्क्रिप्ट (सुरक्षित) किया गया कनेक्शन बना सकते हैं.
  • कनेक्ट होने का मतलब है कि डिवाइस, फ़िलहाल आरएफ़सीओएमएम चैनल शेयर कर रहे हैं और एक-दूसरे के साथ डेटा शेयर कर सकते हैं. मौजूदा ब्लूटूथ एपीआई के लिए, आरएफ़सीओएमएम कनेक्शन बनाने से पहले डिवाइसों को जोड़ना ज़रूरी है. ब्लूटूथ एपीआई के साथ एन्क्रिप्ट यानी सुरक्षित किया गया कनेक्शन शुरू करने पर, डिवाइस अपने-आप जुड़ जाता है.

नीचे दिए गए सेक्शन में, जोड़े गए डिवाइसों को ढूंढने का तरीका बताया गया है. साथ ही, डिवाइस खोजने की सुविधा का इस्तेमाल करके नए डिवाइसों को ढूंढने का तरीका बताया गया है.

जोड़े गए डिवाइसों के बारे में क्वेरी करना

डिवाइस खोजने से पहले, जोड़े गए डिवाइसों के सेट के बारे में क्वेरी करना फ़ायदेमंद होता है. इससे यह पता चलता है कि आपको जो डिवाइस चाहिए वह पहले से मौजूद है या नहीं. ऐसा करने के लिए, getBondedDevices() को कॉल करें. इससे BluetoothDevice ऑब्जेक्ट का एक सेट मिलता है, जो जोड़े गए डिवाइसों को दिखाता है. उदाहरण के लिए, आप सभी जोड़े गए डिवाइसों के बारे में क्वेरी कर सकते हैं और हर डिवाइस का नाम और मैक पता पा सकते हैं. जैसा कि यहां दिए गए कोड स्निपेट में दिखाया गया है:

Kotlin

val pairedDevices: Set<BluetoothDevice>? = bluetoothAdapter?.bondedDevices
pairedDevices?.forEach { device ->
   val deviceName = device.name
   val deviceHardwareAddress = device.address // MAC address
}

Java

Set<BluetoothDevice> pairedDevices = bluetoothAdapter.getBondedDevices();

if (pairedDevices.size() > 0) {
   // There are paired devices. Get the name and address of each paired device.
   for (BluetoothDevice device : pairedDevices) {
       String deviceName = device.getName();
       String deviceHardwareAddress = device.getAddress(); // MAC address
   }
}

किसी ब्लूटूथ डिवाइस से कनेक्शन शुरू करने के लिए, उससे जुड़े BluetoothDevice ऑब्जेक्ट से सिर्फ़ मैक पता चाहिए होता है. इसे getAddress() को कॉल करके वापस पाया जा सकता है. ब्लूटूथ डिवाइसों को कनेक्ट करना लेख में, कनेक्शन बनाने के बारे में ज़्यादा जानकारी मिल सकती है.

डिवाइसों को ढूंढना

डिवाइसों को खोजने के लिए, startDiscovery() को कॉल करें. यह प्रोसेस एसिंक्रोनस है और बूलियन वैल्यू दिखाती है. इससे पता चलता है कि डिस्कवरी की प्रोसेस शुरू हो गई है या नहीं. डिवाइस खोजने की प्रोसेस में, आम तौर पर करीब 12 सेकंड का इंक्वायरी स्कैन शामिल होता है. इसके बाद, मिले हर डिवाइस का पेज स्कैन किया जाता है, ताकि उसका ब्लूटूथ नाम पता चल सके.

खोजे गए हर डिवाइस के बारे में जानकारी पाने के लिए, आपके ऐप्लिकेशन को ACTION_FOUND इंटेंट के लिए, BroadcastReceiver को रजिस्टर करना होगा. सिस्टम, हर डिवाइस के लिए इस इंटेंट को ब्रॉडकास्ट करता है. इंटेंट में अतिरिक्त फ़ील्ड EXTRA_DEVICE और EXTRA_CLASS शामिल होते हैं. इनमें क्रमशः BluetoothDevice और BluetoothClass शामिल होते हैं. यहां दिए गए कोड स्निपेट से पता चलता है कि डिवाइसों का पता चलने पर, ब्रॉडकास्ट को मैनेज करने के लिए कैसे रजिस्टर किया जा सकता है:

Kotlin

override fun onCreate(savedInstanceState: Bundle?) {
   ...

   // Register for broadcasts when a device is discovered.
   val filter = IntentFilter(BluetoothDevice.ACTION_FOUND)
   registerReceiver(receiver, filter)
}

// Create a BroadcastReceiver for ACTION_FOUND.
private val receiver = object : BroadcastReceiver() {

   override fun onReceive(context: Context, intent: Intent) {
       val action: String = intent.action
       when(action) {
           BluetoothDevice.ACTION_FOUND -> {
               // Discovery has found a device. Get the BluetoothDevice
               // object and its info from the Intent.
               val device: BluetoothDevice =
                       intent.getParcelableExtra(BluetoothDevice.EXTRA_DEVICE)
               val deviceName = device.name
               val deviceHardwareAddress = device.address // MAC address
           }
       }
   }
}

override fun onDestroy() {
   super.onDestroy()
   ...

   // Don't forget to unregister the ACTION_FOUND receiver.
   unregisterReceiver(receiver)
}

Java

@Override
protected void onCreate(Bundle savedInstanceState) {
   ...

   // Register for broadcasts when a device is discovered.
   IntentFilter filter = new IntentFilter(BluetoothDevice.ACTION_FOUND);
   registerReceiver(receiver, filter);
}

// Create a BroadcastReceiver for ACTION_FOUND.
private final BroadcastReceiver receiver = new BroadcastReceiver() {
   public void onReceive(Context context, Intent intent) {
       String action = intent.getAction();
       if (BluetoothDevice.ACTION_FOUND.equals(action)) {
           // Discovery has found a device. Get the BluetoothDevice
           // object and its info from the Intent.
           BluetoothDevice device = intent.getParcelableExtra(BluetoothDevice.EXTRA_DEVICE);
           String deviceName = device.getName();
           String deviceHardwareAddress = device.getAddress(); // MAC address
       }
   }
};

@Override
protected void onDestroy() {
   super.onDestroy();
   ...

   // Don't forget to unregister the ACTION_FOUND receiver.
   unregisterReceiver(receiver);
}

किसी ब्लूटूथ डिवाइस से कनेक्शन शुरू करने के लिए, BluetoothDevice पर getAddress() को कॉल करें. इससे, उससे जुड़े मैक पते को वापस पाया जा सकता है.

खोजे जाने लायक बनाना

लोकल डिवाइस को अन्य डिवाइसों के लिए खोजे जाने लायक बनाने के लिए, ACTION_REQUEST_DISCOVERABLE इंटेंट के साथ startActivityForResult(Intent, int) को कॉल करें. इससे सिस्टम के खोजे जाने लायक मोड को चालू करने का अनुरोध भेजा जाता है. इसके लिए, सेटिंग ऐप्लिकेशन पर जाने की ज़रूरत नहीं पड़ती. सेटिंग ऐप्लिकेशन पर जाने से आपका ऐप्लिकेशन बंद हो जाता. डिफ़ॉल्ट रूप से, डिवाइस दो मिनट के लिए खोजे जाने लायक मोड में रहता है. EXTRA_DISCOVERABLE_DURATION अतिरिक्त शुल्क देकर, पांच मिनट तक की अवधि तय की जा सकती है.

यहां दिए गए कोड स्निपेट से, डिवाइस को पांच मिनट के लिए खोजे जाने लायक बनाया जा सकता है:

Kotlin

val requestCode = 1;
val discoverableIntent: Intent = Intent(BluetoothAdapter.ACTION_REQUEST_DISCOVERABLE).apply {
   putExtra(BluetoothAdapter.EXTRA_DISCOVERABLE_DURATION, 300)
}
startActivityForResult(discoverableIntent, requestCode)

Java

int requestCode = 1;
Intent discoverableIntent =
       new Intent(BluetoothAdapter.ACTION_REQUEST_DISCOVERABLE);
discoverableIntent.putExtra(BluetoothAdapter.EXTRA_DISCOVERABLE_DURATION, 300);
startActivityForResult(discoverableIntent, requestCode);
डिवाइस को खोजने लायक बनाने की अनुमति मांगने वाला सिस्टम डायलॉग
पहली इमेज. 'खोजने लायक बनाएं' डायलॉग बॉक्स.

इसके बाद, एक डायलॉग बॉक्स दिखता है. इसमें उपयोगकर्ता से डिवाइस को खोजने लायक बनाने की अनुमति मांगी जाती है. जैसा कि पहली इमेज में दिखाया गया है. अगर उपयोगकर्ता "अनुमति दें" का जवाब देता है, तो डिवाइस तय समय के लिए खोजे जाने लायक हो जाता है. इसके बाद, आपकी गतिविधि को onActivityResult() कॉलबैक के लिए एक कॉल मिलता है. इसमें नतीजे का कोड, डिवाइस को खोजे जाने लायक बनाने की अवधि के बराबर होता है. अगर उपयोगकर्ता ने "अस्वीकार करें" जवाब दिया है या कोई गड़बड़ी हुई है, तो नतीजे वाला कोड RESULT_CANCELED होगा.

डिवाइस, तय समय तक साइलेंट मोड में खोजे जाने लायक बना रहता है. खोजे जाने लायक मोड में बदलाव होने पर सूचना पाने के लिए, ACTION_SCAN_MODE_CHANGED इंटेंट के लिए BroadcastReceiver को रजिस्टर करें. इस इंटेंट में अतिरिक्त फ़ील्ड EXTRA_SCAN_MODE और EXTRA_PREVIOUS_SCAN_MODE शामिल हैं. ये फ़ील्ड, स्कैन करने के नए और पुराने मोड की जानकारी देते हैं. हर अतिरिक्त वैल्यू के लिए, ये वैल्यू हो सकती हैं:

SCAN_MODE_CONNECTABLE_DISCOVERABLE
डिवाइस, खोजे जाने लायक मोड में हो.
SCAN_MODE_CONNECTABLE
डिवाइस, खोजे जाने लायक मोड में नहीं है. हालांकि, इसे अब भी कनेक्ट किया जा सकता है.
SCAN_MODE_NONE
डिवाइस, खोजे जाने लायक मोड में नहीं है और इससे कनेक्ट नहीं किया जा सकता.

अगर आपको किसी रिमोट डिवाइस से कनेक्शन शुरू करना है, तो आपको डिवाइस को खोजने लायक बनाने की सुविधा चालू करने की ज़रूरत नहीं है. डिवाइस को खोजने लायक बनाने की सुविधा सिर्फ़ तब चालू करनी चाहिए, जब आपको अपने ऐप्लिकेशन में ऐसा सर्वर सॉकेट होस्ट करना हो जो इनकमिंग कनेक्शन स्वीकार करता हो. ऐसा इसलिए, क्योंकि रिमोट डिवाइसों को अन्य डिवाइसों से कनेक्शन शुरू करने से पहले, उन्हें खोजने की ज़रूरत होती है.