Configurar Bluetooth

Antes de que tu app pueda comunicarse por Bluetooth o Bluetooth de bajo consumo, debes verificar que el dispositivo admita Bluetooth y, si es así, asegurarte de que esté habilitado. Ten en cuenta que esta verificación solo es necesaria si el atributo android:required de la entrada del archivo de manifiesto <uses-feature.../> se establece en false.

Si no se admite Bluetooth, debes inhabilitar correctamente todas las funciones de Bluetooth. Si el Bluetooth es compatible, pero está inhabilitado, puedes solicitar que el usuario lo habilite sin salir de tu app.

El primer paso es agregar los permisos de Bluetooth a tu archivo de manifiesto para usar las siguientes APIs.

Una vez que se hayan otorgado los permisos, la configuración de Bluetooth se realizará en dos pasos con BluetoothAdapter:

  1. Obtén los BluetoothAdapter.

    El BluetoothAdapter es obligatorio para todas las actividades de Bluetooth. El objeto BluetoothAdapter representa el adaptador Bluetooth del dispositivo (la radio Bluetooth). Para obtener un BluetoothAdapter, primero debes tener un Context. Usa este contexto para obtener una instancia del servicio del sistema BluetoothManager. Si llamas a BluetoothManager#getAdapter, obtendrás un objeto BluetoothAdapter. Si getAdapter() devuelve un valor nulo, el dispositivo no admite Bluetooth.

    Por ejemplo:

    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. Habilita el Bluetooth.

    A continuación, debes asegurarte de que el Bluetooth esté habilitado. Llama a isEnabled() para verificar si el Bluetooth está habilitado. Si este método devuelve false, significa que el Bluetooth está inhabilitado. Para solicitar que se habilite el Bluetooth, llama a startActivityForResult() y pasa una acción de intent ACTION_REQUEST_ENABLE. Esta llamada emite una solicitud para habilitar el Bluetooth a través de la configuración del sistema (sin detener tu app).

    Por ejemplo:

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

Aparecerá un diálogo en el que se solicitará el permiso del usuario para habilitar el Bluetooth, como se muestra en la figura 1. Si el usuario otorga el permiso, el sistema comienza a habilitar el Bluetooth y el enfoque vuelve a tu app una vez que se completa (o falla) el proceso.

Diálogo del sistema en el que se solicita permiso para activar el Bluetooth
Figura 1: El diálogo para habilitar el Bluetooth.

La constante REQUEST_ENABLE_BT que se pasa a startActivityForResult() es un número entero definido de forma local que debe ser mayor o igual que 0. El sistema te devuelve esta constante en tu implementación de onActivityResult() como el parámetro requestCode.

Si se habilita el Bluetooth correctamente, tu actividad recibirá el código de resultado RESULT_OK en la devolución de llamada onActivityResult(). Si no se habilitó el Bluetooth debido a un error (o el usuario respondió "Rechazar"), el código de resultado es RESULT_CANCELED.

De manera opcional, tu app también puede escuchar el intent de transmisión ACTION_STATE_CHANGED, que el sistema transmite cada vez que cambia el estado de Bluetooth. Esta transmisión contiene los campos adicionales EXTRA_STATE y EXTRA_PREVIOUS_STATE, que contienen los estados de Bluetooth nuevos y antiguos, respectivamente. Los valores posibles para estos campos adicionales son STATE_TURNING_ON, STATE_ON, STATE_TURNING_OFF y STATE_OFF. Escuchar esta transmisión puede ser útil si tu app necesita detectar cambios en el tiempo de ejecución realizados en el estado de Bluetooth.

Una vez que se habilita el Bluetooth en el dispositivo, puedes usar tanto el Bluetooth clásico como el Bluetooth de bajo consumo.

En el caso de Bluetooth clásico, puedes buscar dispositivos Bluetooth y conectarte a ellos.

En el caso de Bluetooth de bajo consumo, puedes buscar dispositivos BLE, conectarte a un servidor GATT y transferir datos BLE.