Znajdź urządzenia Bluetooth

Za pomocą BluetoothAdapter możesz znaleźć zdalne urządzenia Bluetooth, wykrywając je lub wysyłając zapytanie do listy sparowanych urządzeń.

Zanim spróbujesz znaleźć urządzenia Bluetooth, upewnij się, że masz odpowiednie uprawnienia Bluetooth i skonfiguruj aplikację do korzystania z Bluetootha.

Wykrywanie urządzeń to procedura skanowania, która wyszukuje urządzenia z włączoną funkcją Bluetooth w pobliżu i prosi o podanie informacji o każdym z nich. Ten proces jest czasami nazywany wykrywaniem, wysyłaniem zapytań lub skanowaniem. Urządzenie Bluetooth w pobliżu odpowiada na żądanie wykrycia tylko wtedy, gdy jest wykrywalne i akceptuje żądania informacji. Jeśli urządzenie jest wykrywalne, odpowiada na żądanie wykrycia, udostępniając pewne informacje, takie jak nazwa urządzenia, jego klasa i unikalny adres MAC. Korzystając z tych informacji, urządzenie, które przeprowadza proces wykrywania, może zainicjować połączenie z wykrytym urządzeniem.

Ponieważ wykrywalne urządzenia mogą ujawniać informacje o lokalizacji użytkownika, proces wykrywania urządzeń wymaga dostępu do lokalizacji. Jeśli aplikacja jest używana na urządzeniu z Androidem 8.0 (API na poziomie 26) lub nowszym, rozważ użycie interfejsu Menedżer urządzeń towarzyszących API. Ten interfejs API wykrywa urządzenia w imieniu aplikacji, dzięki czemu nie musi ona prosić o dostęp do lokalizacji.

Gdy po raz pierwszy połączysz się z urządzeniem zdalnym, automatycznie pojawi się prośba o sparowanie. Po sparowaniu podstawowe informacje o urządzeniu, takie jak jego nazwa, klasa i adres MAC, są zapisywane i można je odczytać za pomocą interfejsów API Bluetooth.

Korzystając ze znanego adresu MAC sparowanego urządzenia, możesz w każdej chwili zainicjować połączenie bez konieczności wykrywania, pod warunkiem że urządzenie jest nadal w zasięgu.

Pamiętaj, że istnieje różnica między sparowaniem a połączeniem:

  • Sparowanie oznacza, że 2 urządzenia wiedzą o swoim istnieniu, mają wspólny klucz połączenia, który może być używany do uwierzytelniania, i mogą nawiązać ze sobą szyfrowane połączenie.
  • Połączenie oznacza, że urządzenia obecnie współdzielą kanał RFCOMM i mogą przesyłać dane między sobą. Obecne interfejsy API Bluetootha wymagają sparowania urządzeń, zanim będzie można nawiązać połączenie RFCOMM. Parowanie jest wykonywane automatycznie po zainicjowaniu zaszyfrowanego połączenia za pomocą interfejsów API Bluetooth.

W sekcjach poniżej opisano, jak znaleźć sparowane urządzenia i jak wykrywać nowe urządzenia za pomocą funkcji wykrywania urządzeń.

Zapytanie o sparowane urządzenia

Przed rozpoczęciem wykrywania urządzeń warto sprawdzić zestaw sparowanych urządzeń, aby zobaczyć, czy urządzenie, którego szukasz, jest już znane. Aby to zrobić, zadzwoń pod numer getBondedDevices(). Zwraca zbiór obiektów BluetoothDevice reprezentujących sparowane urządzenia. Możesz na przykład wysłać zapytanie o wszystkie sparowane urządzenia i uzyskać nazwę oraz adres MAC każdego z nich, jak pokazano w tym fragmencie kodu:

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

Aby zainicjować połączenie z urządzeniem Bluetooth, potrzebujesz tylko adresu MAC z powiązanego obiektu BluetoothDevice. Możesz go pobrać, wywołując funkcję getAddress(). Więcej informacji o tworzeniu połączenia znajdziesz w artykule Łączenie urządzeń Bluetooth.

Wykrywanie urządzeń

Aby rozpocząć wykrywanie urządzeń, wywołaj startDiscovery(). Proces jest asynchroniczny i zwraca wartość logiczną wskazującą, czy wykrywanie zostało pomyślnie rozpoczęte. Proces wykrywania zwykle obejmuje skanowanie zapytania przez około 12 sekund, a następnie skanowanie strony każdego znalezionego urządzenia w celu pobrania jego nazwy Bluetooth.

Aby otrzymywać informacje o każdym wykrytym urządzeniu, aplikacja musi zarejestrować BroadcastReceiver dla intencji ACTION_FOUND. System wysyła tę intencję dla każdego urządzenia. Intencja zawiera dodatkowe pola EXTRA_DEVICE i EXTRA_CLASS, które z kolei zawierają odpowiednio BluetoothDevice i BluetoothClass. Poniższy fragment kodu pokazuje, jak zarejestrować się, aby obsługiwać transmisję po wykryciu urządzeń:

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

Aby zainicjować połączenie z urządzeniem Bluetooth, wywołaj getAddress() na BluetoothDevice, aby pobrać powiązany adres MAC.

Włączanie wykrywalności

Aby urządzenie lokalne było wykrywalne dla innych urządzeń, wywołaj startActivityForResult(Intent, int) z intencją ACTION_REQUEST_DISCOVERABLE. Spowoduje to wysłanie żądania włączenia trybu wykrywalności systemu bez konieczności przechodzenia do aplikacji Ustawienia, co spowodowałoby zatrzymanie Twojej aplikacji. Domyślnie urządzenie jest wykrywalne przez 2 minuty. Możesz określić inny czas trwania (do 5 minut), dodając parametr dodatkowy EXTRA_DISCOVERABLE_DURATION.

Poniższy fragment kodu ustawia urządzenie jako wykrywalne przez 5 minut:

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);
Okno systemowe z prośbą o pozwolenie na wykrywanie urządzenia
Rysunek 1. Okno umożliwiające włączenie wykrywalności.

Wyświetli się okno z prośbą o zgodę użytkownika na wykrywanie urządzenia, jak pokazano na rysunku 1. Jeśli użytkownik odpowie „Zezwól”, urządzenie będzie wykrywalne przez określony czas. Twoja aktywność otrzyma wtedy wywołanie zwrotne onActivityResult() z kodem wyniku równym czasowi, przez który urządzenie jest wykrywalne. Jeśli użytkownik kliknął „Odrzuć” lub wystąpił błąd, kod wyniku to RESULT_CANCELED.

Urządzenie pozostaje w trybie wykrywalnym przez określony czas. Aby otrzymywać powiadomienia o zmianie trybu wykrywalności, zarejestruj BroadcastReceiver dla intencji ACTION_SCAN_MODE_CHANGED. Ta intencja zawiera dodatkowe pola EXTRA_SCAN_MODE i EXTRA_PREVIOUS_SCAN_MODE, które odpowiednio udostępniają nowy i stary tryb skanowania. Możliwe wartości dla każdego dodatku:

SCAN_MODE_CONNECTABLE_DISCOVERABLE
Urządzenie jest w trybie wykrywalnym.
SCAN_MODE_CONNECTABLE
Urządzenie nie jest w trybie wykrywania, ale nadal może odbierać połączenia.
SCAN_MODE_NONE
Urządzenie nie jest w trybie wykrywania i nie może odbierać połączeń.

Jeśli inicjujesz połączenie z urządzeniem zdalnym, nie musisz włączać wykrywania urządzenia. Włączenie wykrywalności jest konieczne tylko wtedy, gdy chcesz, aby aplikacja hostowała gniazdo serwera, które akceptuje połączenia przychodzące, ponieważ urządzenia zdalne muszą mieć możliwość wykrywania innych urządzeń przed zainicjowaniem połączeń z nimi.