Configurar o Bluetooth

Antes que o app possa se comunicar por Bluetooth ou Bluetooth de baixa energia, é preciso verificar se o Bluetooth é compatível com o dispositivo e, se for, garantir que ele esteja ativado. Essa verificação só é necessária se o atributo android:required na entrada do arquivo de manifesto <uses-feature.../> estiver definido como false.

Se o Bluetooth não for compatível, desative todos os recursos dele. Se o Bluetooth for compatível, mas estiver desativado, você poderá solicitar que o usuário o ative sem sair do app.

A primeira etapa é adicionar as permissões de Bluetooth ao arquivo de manifesto para usar as APIs a seguir.

Depois que as permissões forem concedidas, a configuração do Bluetooth será realizada em duas etapas usando o BluetoothAdapter:

  1. Gere o BluetoothAdapter.

    A permissão BluetoothAdapter é necessária para todas as atividades do Bluetooth. O BluetoothAdapter representa o adaptador Bluetooth do próprio dispositivo (o rádio Bluetooth). Para receber um BluetoothAdapter, primeiro você precisa ter um Context. Use esse contexto para receber uma instância do serviço do sistema BluetoothManager. Chamar BluetoothManager#getAdapter vai fornecer um objeto BluetoothAdapter. Se getAdapter() retornar nulo, o dispositivo não é compatível com Bluetooth.

    Exemplo:

    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. Ative o Bluetooth.

    Em seguida, verifique se o Bluetooth está ativado. Chame isEnabled() para verificar se o Bluetooth está ativado. Se esse método retornar falso, o Bluetooth estará desativado. Para solicitar que o Bluetooth seja ativado, chame startActivityForResult(), transmitindo uma ação de intent ACTION_REQUEST_ENABLE. Essa chamada emite uma solicitação para ativar o Bluetooth nas configurações do sistema (sem interromper o app).

    Exemplo:

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

Uma caixa de diálogo vai aparecer solicitando permissão do usuário para ativar o Bluetooth, como mostrado na Figura 1. Se o usuário conceder permissão, o sistema vai ativar o Bluetooth, e o foco vai retornar ao app quando o processo for concluído (ou falhar).

Caixa de diálogo do sistema pedindo permissão para ativar o Bluetooth
Figura 1. A caixa de diálogo de ativação do Bluetooth.

A constante REQUEST_ENABLE_BT transmitida para startActivityForResult() é um número inteiro definido localmente que precisa ser maior ou igual a 0. O sistema transmite essa constante de volta para você na implementação de onActivityResult() como o parâmetro requestCode.

Se a ativação do Bluetooth for bem-sucedida, sua atividade vai receber o código de resultado RESULT_OK no callback onActivityResult(). Se o Bluetooth não tiver sido ativado devido a um erro (ou se o usuário tiver respondido "Negar"), o código de resultado será RESULT_CANCELED.

Como opção, o app também pode detectar a intent de transmissão ACTION_STATE_CHANGED, que o sistema transmite sempre que o estado do Bluetooth muda. Essa transmissão contém os campos extras EXTRA_STATE e EXTRA_PREVIOUS_STATE, que contêm os estados novos e antigos do Bluetooth, respectivamente. Os valores possíveis para esses campos extras são STATE_TURNING_ON, STATE_ON, STATE_TURNING_OFF e STATE_OFF. Ouvir essa transmissão pode ser útil se o app precisar detectar mudanças no estado do Bluetooth durante a execução.

Depois que o Bluetooth estiver ativado no dispositivo, você poderá usar o Bluetooth clássico e o Bluetooth de baixa energia.

Para o Bluetooth clássico, é possível encontrar dispositivos Bluetooth e se conectar a eles.

Para o Bluetooth de baixa energia, é possível encontrar dispositivos BLE, conectar-se a um servidor GATT e transferir dados BLE.