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:
Obtén los
BluetoothAdapter.El
BluetoothAdapteres obligatorio para todas las actividades de Bluetooth. El objetoBluetoothAdapterrepresenta el adaptador Bluetooth del dispositivo (la radio Bluetooth). Para obtener unBluetoothAdapter, primero debes tener unContext. Usa este contexto para obtener una instancia del servicio del sistemaBluetoothManager. Si llamas aBluetoothManager#getAdapter, obtendrás un objetoBluetoothAdapter. SigetAdapter()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 }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 astartActivityForResult()y pasa una acción de intentACTION_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.
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.