Skonfiguruj Bluetooth

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:

  1. Pobierz BluetoothAdapter.

    BluetoothAdapter jest wymagane do korzystania z Bluetootha. BluetoothAdapter reprezentuje własną kartę Bluetooth urządzenia (radio Bluetooth). Aby otrzymać BluetoothAdapter, musisz najpierw mieć Context. Użyj tego kontekstu, aby uzyskać instancję usługi systemowej BluetoothManager. Wywołanie BluetoothManager#getAdapter zwróci obiekt BluetoothAdapter. Jeśli getAdapter() 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
    }
    

  2. 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łaj startActivityForResult(), przekazując działanie intencji ACTION_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.

Okno systemowe z prośbą o zgodę na włączenie Bluetootha
Rysunek 1. Okno dialogowe włączania Bluetootha.

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.