La plataforma de Android admite la pila de red Bluetooth, que permite que un dispositivo intercambie datos de forma inalámbrica con otros dispositivos Bluetooth. El framework de la app proporciona acceso a la funcionalidad de Bluetooth a través de las APIs de Bluetooth. Estas APIs permiten que las apps se conecten a otros dispositivos Bluetooth, lo que habilita funciones inalámbricas punto a punto y multipunto.
Con las APIs de Bluetooth, una app puede realizar lo siguiente:
- Busca otros dispositivos Bluetooth.
- Consulta el adaptador local de Bluetooth en busca de dispositivos Bluetooth vinculados.
- Establecer canales RFCOMM
- Conéctate a otros dispositivos mediante el descubrimiento de servicios.
- Transfiere datos hacia y desde otros dispositivos.
- Administrar varias conexiones
Este tema se enfoca en el Bluetooth clásico. La versión clásica de Bluetooth es la opción correcta para las operaciones que consumen más batería, como la transmisión y la comunicación entre dispositivos. Para dispositivos Bluetooth con bajos requisitos de energía, considera usar conexiones de Bluetooth de bajo consumo.
En esta documentación, se describen diferentes perfiles de Bluetooth y se explica cómo usar las APIs de Bluetooth para realizar las cuatro tareas principales necesarias a fin de comunicarse mediante Bluetooth:
- Configurando Bluetooth.
- Se están buscando dispositivos sincronizados o disponibles en el área local.
- Conexión de dispositivos.
- Transferir datos entre dispositivos
Para ver una demostración de cómo usar las APIs de Bluetooth, consulta la app de ejemplo Chat de Bluetooth.
Conceptos básicos
Para que los dispositivos con Bluetooth puedan transmitir datos entre sí, primero deben formar un canal de comunicación mediante un proceso de vinculación. Un dispositivo, un dispositivo detectable, está disponible para las solicitudes de conexión entrantes. Otro dispositivo encuentra el dispositivo detectable mediante un proceso de descubrimiento de servicios. Después de que el dispositivo detectable acepta la solicitud de vinculación, los dos dispositivos completan un proceso de vinculación en el que intercambian llaves de seguridad. Los dispositivos almacenan estas claves en caché para usarlas más adelante. Una vez finalizados los procesos de vinculación y vinculación, los dos dispositivos intercambian información. Cuando se completa la sesión, el dispositivo que inició la solicitud de vinculación libera el canal que lo había vinculado al dispositivo detectable. Sin embargo, los dos dispositivos permanecen vinculados, de modo que pueden volver a conectarse automáticamente durante una sesión futura, siempre y cuando estén dentro del rango del otro y ninguno de los dispositivos haya eliminado la vinculación.
El uso de las APIs de Bluetooth requiere declarar varios permisos en tu archivo de manifiesto. Una vez que tu app tenga permiso para usar Bluetooth, deberá acceder a BluetoothAdapter
y determinar si Bluetooth está disponible en el dispositivo.
Si la conexión Bluetooth está disponible, sigue estos tres pasos para establecer una conexión:
- Encuentra dispositivos Bluetooth cercanos, ya sean dispositivos que ya estén vinculados o nuevos.
- Conéctate a un dispositivo Bluetooth.
- Cómo transferir datos con el dispositivo conectado
Algunos dispositivos usan un perfil de Bluetooth específico que declara los datos que proporciona.
Clases fundamentales e interfaces
Todas las APIs de Bluetooth están disponibles en el paquete android.bluetooth
.
A continuación, se indican las clases e interfaces que necesitas para crear conexiones Bluetooth:
BluetoothAdapter
- Representa el adaptador local de Bluetooth (radio Bluetooth). El
BluetoothAdapter
es el punto de entrada de todas las interacciones Bluetooth. De esta manera, puedes descubrir otros dispositivos Bluetooth, consultar una lista de dispositivos vinculados (vinculados), crear una instancia deBluetoothDevice
con una dirección MAC conocida y crear unBluetoothServerSocket
para escuchar las comunicaciones de otros dispositivos. BluetoothDevice
- Representa un dispositivo Bluetooth remoto. Úsalo para solicitar una conexión con un dispositivo remoto a través de un
BluetoothSocket
o para consultar información sobre el dispositivo, como su nombre, dirección, clase y estado de conexión. BluetoothSocket
- Representa la interfaz de un socket Bluetooth (similar a un
Socket
de TCP). Este es el punto de conexión que permite que una app intercambie datos con otro dispositivo Bluetooth medianteInputStream
yOutputStream
. BluetoothServerSocket
- Representa un socket de servidor abierto que escucha las solicitudes entrantes (similar a un
ServerSocket
de TCP). Para conectar dos dispositivos, un dispositivo debe abrir un socket de servidor con esta clase. Cuando un dispositivo Bluetooth remoto envía una solicitud de conexión a este dispositivo, este la acepta y devuelve unBluetoothSocket
conectado. BluetoothClass
- Describe las características y capacidades generales de un dispositivo Bluetooth. Se trata de un conjunto de propiedades de solo lectura que define las clases y los servicios del dispositivo. Si bien esta información brinda una sugerencia útil sobre el tipo de dispositivo, los atributos de esta clase no necesariamente describen todos los perfiles y servicios de Bluetooth que admite el dispositivo.
BluetoothProfile
- Interfaz que representa un perfil de Bluetooth. Un perfil de Bluetooth es una especificación de interfaz inalámbrica para la comunicación entre dispositivos basada en Bluetooth. Un ejemplo es el perfil de manos libres. Para obtener más información sobre los perfiles, consulta Perfiles de Bluetooth.
BluetoothHeadset
- Proporciona compatibilidad con auriculares Bluetooth para usarlos con teléfonos móviles. Esto incluye el perfil de auriculares Bluetooth y el perfil de manos libres (v1.5).
BluetoothA2dp
- Define el modo en que se puede transmitir audio de alta calidad de un dispositivo a otro a través de una conexión Bluetooth mediante el perfil de distribución de audio avanzada (A2DP).
BluetoothHealth
- Representa un proxy de perfil de dispositivos de salud que controla el servicio Bluetooth.
BluetoothHealthCallback
- Es una clase abstracta que se usa para implementar devoluciones de llamada de
BluetoothHealth
. Debes extender esta clase e implementar los métodos de devolución de llamada para recibir actualizaciones sobre los cambios en el estado de registro de la app y el estado del canal de Bluetooth. BluetoothHealthAppConfiguration
- Representa la configuración de una app que la app de salud de terceros de Bluetooth registra para comunicarse con un dispositivo de salud Bluetooth remoto.
BluetoothProfile.ServiceListener
- Una interfaz que notifica a los clientes de comunicación entre procesos (IPC) de
BluetoothProfile
cuando se conectan al servicio interno que ejecuta un perfil en particular o se desconectan de este.