Zanim aplikacja będzie mogła komunikować się przez Bluetooth lub Bluetooth Low Energy, musisz sprawdzić, czy urządzenie obsługuje Bluetooth, a jeśli tak, upewnić się, że jest on włączony. Pamiętaj, że ta kontrola jest konieczna tylko wtedy, gdy atrybut android:required we wpisie pliku manifestu <uses-feature.../> ma wartość false.
Jeśli Bluetooth nie jest obsługiwany, należy wyłączyć wszystkie funkcje Bluetooth. Jeśli Bluetooth jest obsługiwany, ale wyłączony, możesz poprosić użytkownika o jego włączenie bez opuszczania aplikacji.
Pierwszym krokiem jest dodanie uprawnień Bluetooth do pliku manifestu, aby można było używać tych interfejsów API.
Po przyznaniu uprawnień konfiguracja Bluetooth odbywa się w 2 krokach za pomocą BluetoothAdapter:
Pobierz
BluetoothAdapter.BluetoothAdapterjest wymagane do korzystania z Bluetootha.BluetoothAdapterreprezentuje własną kartę Bluetooth urządzenia (radio Bluetooth). Aby otrzymaćBluetoothAdapter, musisz najpierw miećContext. Użyj tego kontekstu, aby uzyskać instancję usługi systemowejBluetoothManager. WywołanieBluetoothManager#getAdapterzwróci obiektBluetoothAdapter. JeśligetAdapter()zwraca wartość null, urządzenie nie obsługuje Bluetootha.Na przykład:
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 }Włącz Bluetooth.
Następnie musisz upewnić się, że Bluetooth jest włączony. Wywołaj
isEnabled(), aby sprawdzić, czy Bluetooth jest obecnie włączony. Jeśli ta metoda zwraca wartość false, Bluetooth jest wyłączony. Aby poprosić o włączenie Bluetootha, wywołajstartActivityForResult(), przekazując działanie intencjiACTION_REQUEST_ENABLE. To wywołanie wysyła prośbę o włączenie Bluetootha w ustawieniach systemu (bez zatrzymywania aplikacji).Na przykład:
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); }
Pojawi się okno z prośbą o zgodę użytkownika na włączenie Bluetootha, jak pokazano na rysunku 1. Jeśli użytkownik wyrazi zgodę, system zacznie włączać Bluetooth, a po zakończeniu (lub niepowodzeniu) tego procesu fokus wróci do aplikacji.
Stała REQUEST_ENABLE_BT przekazywana do startActivityForResult() jest lokalnie zdefiniowaną liczbą całkowitą, która musi być większa lub równa 0. System przekazuje tę stałą z powrotem do implementacji onActivityResult() jako parametr requestCode.
Jeśli włączenie Bluetooth się powiedzie, aktywność otrzyma kod wyniku RESULT_OK w wywołaniu zwrotnym onActivityResult(). Jeśli Bluetooth nie został włączony z powodu błędu (lub użytkownik wybrał „Odmów”), kodem wyniku jest RESULT_CANCELED.
Opcjonalnie aplikacja może też nasłuchiwać intencji ACTION_STATE_CHANGED, którą system wysyła, gdy zmienia się stan Bluetootha. Ta transmisja zawiera dodatkowe pola EXTRA_STATE i EXTRA_PREVIOUS_STATE, które zawierają odpowiednio nowy i stary stan Bluetootha. Możliwe wartości tych dodatkowych pól to STATE_TURNING_ON, STATE_ON, STATE_TURNING_OFF i STATE_OFF. Nasłuchiwanie tej transmisji może być przydatne, jeśli aplikacja musi wykrywać zmiany stanu Bluetootha w czasie działania.
Po włączeniu Bluetootha na urządzeniu możesz używać zarówno klasycznego Bluetootha, jak i Bluetootha Low Energy.
W przypadku klasycznego Bluetooth możesz znajdować urządzenia Bluetooth i łączyć się z urządzeniami Bluetooth.
W przypadku Bluetooth Low Energy możesz znajdować urządzenia BLE, łączyć się z serwerem GATT i przesyłać dane BLE.