A partir de 27 de março de 2025, recomendamos usar android-latest-release em vez de aosp-main para criar e contribuir com o AOSP. Para mais informações, consulte Mudanças no AOSP.
Bluetooth
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
O Android oferece uma pilha Bluetooth padrão que é compatível com o Bluetooth clássico e o Bluetooth
de baixa energia (BLE). Usando o Bluetooth, os dispositivos Android podem criar redes de área pessoal para enviar
e receber dados com dispositivos Bluetooth próximos.
No Android 4.3 e versões mais recentes, a pilha Bluetooth do Android oferece a capacidade de implementar
BLE. Para usar totalmente as APIs BLE, siga os
Requisitos de HCI do Bluetooth do Android. Dispositivos Android com um chipset qualificado podem implementar o Bluetooth clássico ou os dois. O BLE não é compatível com versões anteriores de chipsets Bluetooth.
No Android 8.0, a pilha Bluetooth é totalmente qualificada para Bluetooth 5. Para usar os recursos disponíveis do Bluetooth 5, o dispositivo precisa ter um chipset qualificado para Bluetooth 5.
Arquitetura do Android
Um app Bluetooth se comunica com o processo Bluetooth usando o Binder. O processo do Bluetooth usa a Java Native Interface (JNI) para se comunicar com a pilha do Bluetooth e oferece aos desenvolvedores acesso a vários perfis do Bluetooth. Este diagrama mostra a estrutura geral da pilha do Bluetooth:
Figura 1. Arquitetura do Bluetooth do Android.
- framework de app
-
No nível do framework do app, há o código do app, que usa as
APIs
android.bluetooth
para interagir com o hardware Bluetooth. Internamente, esse código chama o processo
Bluetooth pelo mecanismo Binder IPC.
- App Bluetooth
-
O app Bluetooth, localizado em
packages/modules/Bluetooth/android/app,
é empacotado como um app Android e implementa os perfis Bluetooth na camada
do framework Android. Esse app chama a pilha Bluetooth usando a JNI.
- JNI
-
O código JNI associado a
android.bluetooth está localizado em
packages/modules/Bluetooth/android/app/jni. O código JNI chama a
pilha Bluetooth quando determinadas operações Bluetooth ocorrem, como quando os dispositivos são
descobertos.
- Pilha Bluetooth
-
A pilha Bluetooth padrão é fornecida no AOSP e está localizada em
packages/modules/Bluetooth/system. A pilha implementa a HAL genérica do Bluetooth e a personaliza com extensões e mudanças de configuração.
- implementação do fornecedor
-
Os dispositivos do fornecedor interagem com a pilha Bluetooth usando a linguagem de
definição de interface HAL (HIDL).
HIDL
O HIDL define a interface entre a
pilha Bluetooth e a implementação do fornecedor. Para gerar os arquivos HIDL do Bluetooth, transmita os arquivos de interface do Bluetooth para a ferramenta de geração do HIDL. Os arquivos de interface estão localizados em
hardware/interfaces/bluetooth.
Desenvolvimento de pilha Bluetooth
A pilha Bluetooth do Android é totalmente qualificada. A lista de qualificação está no site da Bluetooth SIG (requer login) em QDID 169365.
A pilha Bluetooth principal reside em
packages/modules/Bluetooth. O desenvolvimento acontece no AOSP, e as contribuições são bem-vindas.
O conteúdo e os exemplos de código nesta página estão sujeitos às licenças descritas na Licença de conteúdo. Java e OpenJDK são marcas registradas da Oracle e/ou suas afiliadas.
Última atualização 2025-08-22 UTC.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Não contém as informações de que eu preciso","missingTheInformationINeed","thumb-down"],["Muito complicado / etapas demais","tooComplicatedTooManySteps","thumb-down"],["Desatualizado","outOfDate","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Problema com as amostras / o código","samplesCodeIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-08-22 UTC."],[],[],null,["# Bluetooth\n\nAndroid provides a default Bluetooth stack that supports both Classic Bluetooth and Bluetooth\nLow Energy (BLE). Using Bluetooth, Android devices can create personal area networks to send\nand receive data with nearby Bluetooth devices.\n\n\nIn Android 4.3 and higher, the Android Bluetooth stack provides the ability to implement\nBLE. To fully use the BLE APIs, follow the\n[Android Bluetooth HCI Requirements](/docs/core/connect/bluetooth/hci_requirements). Android devices with a qualified chipset can implement either Classic Bluetooth or both\nClassic Bluetooth and BLE. BLE isn't backward compatible with older Bluetooth chipsets.\n\n\nIn Android 8.0, the Bluetooth stack is fully qualified for Bluetooth 5. To use\navailable Bluetooth 5 features, the device needs to have a Bluetooth 5 qualified chipset.\n\nAndroid architecture\n--------------------\n\n\nA Bluetooth app communicates with the Bluetooth process through Binder. The Bluetooth\nprocess uses Java Native Interface (JNI) to communicate with the Bluetooth stack and provides\ndevelopers with access to various Bluetooth profiles. This diagram shows the general\nstructure of the Bluetooth stack:\n\n**Figure 1.** Android Bluetooth architecture.\n\napp framework\n:\n At the app framework level is app code, which uses the\n [`android.bluetooth`](http://developer.android.com/reference/android/bluetooth/package-summary.html)\n APIs to interact with the Bluetooth hardware. Internally, this code calls the Bluetooth\n process through the Binder IPC mechanism.\n\nBluetooth app\n:\n The Bluetooth app, located in `packages/modules/Bluetooth/android/app`,\n is packaged as an Android app and implements the Bluetooth profiles at the Android framework\n layer. This app calls into the Bluetooth stack through JNI.\n\nJNI\n:\n The JNI code associated with `android.bluetooth` is located in\n `packages/modules/Bluetooth/android/app/jni`. The JNI code calls into the\n Bluetooth stack when certain Bluetooth operations occur, such as when devices are\n discovered.\n\nBluetooth stack\n:\n The default Bluetooth stack is provided in AOSP and is located in\n `packages/modules/Bluetooth/system`. The stack implements the generic Bluetooth\n HAL and customizes it with extensions and configuration changes.\n\nvendor implementation\n:\n Vendor devices interact with the Bluetooth stack using the HAL interface definition\n language (HIDL).\n\n### HIDL\n\n\n[HIDL](/docs/core/architecture/hidl) defines the interface between the\nBluetooth stack and the vendor implementation. To generate the Bluetooth HIDL files, pass the\nBluetooth interface files into the HIDL generation tool. The interface files are located in\n[`hardware/interfaces/bluetooth`](https://android.googlesource.com/platform/hardware/interfaces/+/android16-release/bluetooth/).\n\n### Bluetooth stack development\n\n\nThe Android Bluetooth stack is a fully qualified Bluetooth stack. The qualification listing is\non the Bluetooth SIG website (requires sign-in) under\n[QDID 169365](https://launchstudio.bluetooth.com/ListingDetails/130825).\n\n\nThe core Bluetooth stack resides in\n[packages/modules/Bluetooth](https://cs.android.com/android/platform/superproject/+/android-latest-release:packages/modules/Bluetooth/). Development happens in AOSP, and contributions are welcome."]]
