Introducción general a Bluetooth

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:

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 de BluetoothDevice con una dirección MAC conocida y crear un BluetoothServerSocket 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 mediante InputStream y OutputStream.
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 un BluetoothSocket 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.