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:
- Encontrar dispositivos Bluetooth por perto, sejam eles novos ou já pareados.
- Conectar-se a um dispositivo Bluetooth.
- Transferir dados com o dispositivo conectado.
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 umBluetoothDeviceusando um endereço MAC conhecido e criar umBluetoothServerSocketpara 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
BluetoothSocketou 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 usandoInputStreameOutputStream. BluetoothServerSocket- Representa um soquete de servidor aberto que detecta solicitações recebidas (semelhante
a um
ServerSocketTCP). 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 umBluetoothSocketconectado. 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)
BluetoothProfilequando eles são conectados ou desconectados do serviço interno que executa um perfil específico.