Visão geral do Bluetooth

A plataforma Android inclui suporte para a pilha de rede Bluetooth, que permite que um dispositivo troque dados sem fio com outros dispositivos Bluetooth. O framework do app fornece acesso à funcionalidade do Bluetooth pelas APIs Bluetooth. Essas APIs permitem que os apps se conectem a outros dispositivos Bluetooth, possibilitando recursos sem fio ponto a ponto e multiponto.

Usando as APIs Bluetooth, um app pode:

  • Procure outros dispositivos Bluetooth.
  • Consultar o adaptador Bluetooth local para encontrar dispositivos Bluetooth pareados.
  • Estabelecer canais RFCOMM.
  • Conecte-se a outros dispositivos usando a descoberta de serviços.
  • Transferir dados de e para outros dispositivos.
  • Gerenciar várias conexões.

Este documento se concentra no Bluetooth clássico. O Bluetooth clássico é a escolha certa para operações que consomem mais bateria, como streaming e comunicação entre dispositivos. Para dispositivos Bluetooth com requisitos de baixa energia, use conexões Bluetooth de baixa energia.

Esta documentação descreve diferentes perfis de Bluetooth e explica como usar as APIs Bluetooth para realizar as quatro principais tarefas necessárias para se comunicar usando o Bluetooth:

  • Configurando o Bluetooth.
  • Encontrar dispositivos pareados ou disponíveis na área local.
  • Conectando dispositivos.
  • Transferência de dados entre dispositivos.

Noções básicas

Para que os dispositivos com Bluetooth transmitam dados entre si, eles precisam primeiro formar um canal de comunicação usando um processo de pareamento. Um dispositivo, detectável, se disponibiliza para solicitações de conexão de entrada. Outro dispositivo encontra o dispositivo detectável usando um processo de descoberta de serviços. Depois que o dispositivo detectável aceita a solicitação de pareamento, os dois dispositivos concluem um processo de vinculação em que trocam chaves de segurança. Os dispositivos armazenam essas chaves em cache para uso posterior.

Depois que os processos de pareamento e vinculação são concluídos, os dois dispositivos trocam informações. Quando a sessão é concluída, o dispositivo que iniciou a solicitação de pareamento libera o canal que o vinculou ao dispositivo detectável. No entanto, os dois dispositivos permanecem vinculados para que possam se reconectar automaticamente durante uma sessão futura, desde que estejam dentro do alcance um do outro e nenhum dispositivo tenha removido o vínculo.

Para usar as APIs Bluetooth, é necessário declarar várias permissões no arquivo de manifesto. Em seguida, acesse o BluetoothAdapter e determine se o Bluetooth está disponível no dispositivo. Se o Bluetooth estiver disponível, siga estas três etapas:

Alguns dispositivos usam um perfil Bluetooth específico que declara os dados que ele fornece.

Principais classes e interfaces

Todas as APIs Bluetooth estão disponíveis no pacote android.bluetooth. Estas são as classes e interfaces necessárias para criar conexões Bluetooth:

BluetoothAdapter
Representa o adaptador Bluetooth local (rádio Bluetooth). O BluetoothAdapter é o ponto de entrada para todas as interações do Bluetooth. Com isso, é possível descobrir outros dispositivos Bluetooth, consultar uma lista de dispositivos vinculados (pareados), instanciar um BluetoothDevice usando um endereço MAC conhecido e criar um BluetoothServerSocket para detectar comunicações de outros dispositivos.
BluetoothDevice
Representa um dispositivo Bluetooth remoto. Use essa classe para solicitar uma conexão com um dispositivo remoto por meio de um BluetoothSocket ou consultar informações sobre o dispositivo, como nome, endereço, classe e estado de vinculação.
BluetoothSocket
Representa a interface de um soquete Bluetooth (semelhante a um TCP Socket). Esse é o ponto de conexão que permite que um app troque dados com outro dispositivo Bluetooth usando InputStream e OutputStream.
BluetoothServerSocket
Representa um soquete de servidor aberto que detecta solicitações recebidas (semelhante a um ServerSocket TCP). Para conectar dois dispositivos, um deles precisa abrir um soquete de servidor com essa classe. Quando um dispositivo Bluetooth remoto faz uma solicitação de conexão para este dispositivo, ele aceita a conexão e retorna um BluetoothSocket conectado.
BluetoothClass
Descreve as características e os recursos gerais de um dispositivo Bluetooth. Esse é um conjunto de propriedades somente leitura que define as classes e os serviços do dispositivo. Embora essas informações forneçam uma dica útil sobre o tipo de um dispositivo, os atributos dessa classe não descrevem necessariamente todos os perfis e serviços Bluetooth compatíveis com o dispositivo.
BluetoothProfile
Uma interface que representa um perfil Bluetooth. Um perfil Bluetooth é uma especificação de interface sem fio para comunicação baseada em Bluetooth entre dispositivos. Um exemplo é o perfil de viva-voz. Para mais informações sobre perfis, consulte Perfis Bluetooth.
BluetoothHeadset
Oferece suporte para fones de ouvido Bluetooth serem usados com smartphones. Isso inclui os perfis de fone de ouvido Bluetooth e viva-voz (v1.5).
BluetoothA2dp
Define como o áudio de alta qualidade pode ser transmitido de um dispositivo para outro por uma conexão Bluetooth usando o perfil de distribuição de áudio avançado (A2DP, na sigla em inglês).
BluetoothHealth
Representa um proxy de perfil de dispositivo de saúde que controla o serviço Bluetooth.
BluetoothHealthCallback
Uma classe abstrata usada para implementar callbacks de BluetoothHealth. É necessário estender essa classe e implementar os métodos de callback para receber atualizações sobre mudanças no estado de registro do app e no estado do canal Bluetooth.
BluetoothHealthAppConfiguration
Representa uma configuração de app que o app de terceiros de saúde do Bluetooth registra para se comunicar com um dispositivo de saúde Bluetooth remoto.
BluetoothProfile.ServiceListener
Uma interface que notifica os clientes de comunicação entre processos (IPC, na sigla em inglês) BluetoothProfile quando eles são conectados ou desconectados do serviço interno que executa um perfil específico.