Android 4.3（API 级别 18）为发挥核心作用的蓝牙低功耗 (BLE) 引入内置平台支持，并提供相应 API，方便应用发现设备、查询服务和传输信息。

常见用例包括：

与传统蓝牙不同，蓝牙低功耗 (BLE) 旨在提供显著降低的功耗。这使 Android 应用可与功率要求更严格的 BLE 设备（例如近程传感器、心率监测仪和健身设备）通信。

注意：当用户使用 BLE 将其设备与其他设备配对时，用户设备上的所有应用都可以访问在这两个设备间传输的数据。

因此，如果您的应用捕获敏感数据，您应实现应用层安全以保护此类数据的私密性。

以下是对 BLE 关键术语和概念的总结：

以下是 Android 设备与 BLE 设备交互时应用的角色和职责：

要了解两者的区别，请想象您有一部 Android 手机和一个 Activity 追踪器，该 Activity 追踪器是一个 BLE 设备。手机支持中央角色；Activity 追踪器支持外围角色（要建立 BLE 连接必须具备这两个两个角色—如果两个设备都仅支持中央或外围角色，则无法相互通信）。

手机与 Activity 追踪器建立连接后，它们便开始相互传送 GATT 数据。根据它们传送数据的种类，其中一个会充当 GATT 服务器。例如，如果 Activity 追踪器要将传感器数据汇报给手机，那么 Activity 追踪器便充当服务器。如果 Activity 追踪器要从手机接收更新，那么手机便充当服务器。

在本文档中使用的示例中，Android 应用（在 Android 设备上运行）是 GATT 客户端。该应用从 GATT 服务器获取数据，后者是一个支持 Heart Rate Profile 的心率监测仪。但您也可以设计您​的 Andr​​oid 应用，使它充当 GATT 服务器角色。如需了解详情，请参阅 BluetoothGattServer。

要在您的应用中使用蓝牙功能，您必须声明 BLUETOOTH 蓝牙权限。您需要此权限才能执行任何蓝牙通信，例如请求连接、接受连接和传输数据等。

考虑到 LE 信标通常与位置相关联，您还须声明 ACCESS_FINE_LOCATION 权限。没有此权限，扫描将无法返回任何结果。

注意：如果您的应用适配 Android 9（API 级别 28）或更低版本，则您可以声明 ACCESS_COARSE_LOCATION 权限而非 ACCESS_FINE_LOCATION 权限。

如果您想让应用启动设备发现或操纵蓝牙设置，则您还须声明 BLUETOOTH_ADMIN 权限。注意：如果使用 BLUETOOTH_ADMIN 权限，则您必须拥有 BLUETOOTH 权限。

在应用清单文件中声明蓝牙权限。例如：

如果您要声明您的应用仅适用于支持 BLE 的设备，请在应用清单中添加以下内容：

如果您希望应用适用于不支持 BLE 的设备，则您应仍将此元素添加到应用清单中，但设置 required="false"。然后您可以在运行时使用 PackageManager.hasSystemFeature() 确定 BLE 的可用性：

在您的应用程序可以通过 BLE 进行通信之前，您需验证设备是否支持 BLE，如果支持，请确保该功能已启用。请注意，仅当 设置为 false 时才需要进行此检查。

如果不支持 BLE，则应妥善停用任何 BLE 功能。如果设备支持 BLE 但已停用此功能，则您可以请求用户在不离开应用的同时启用蓝牙。借助 BluetoothAdapter，您可以分两步完成此设置。

所有蓝牙 Activity 都需要 BluetoothAdapter。BluetoothAdapter 代表设备自身的蓝牙适配器（蓝牙无线装置）。整个系统有一个蓝牙适配器，并且您的应用可使用此对象与之进行交互。以下代码段展示如何获取适配器。请注意，此方法使用 getSystemService() 返回 BluetoothManager 的实例，然后使用该实例获取适配器。Android 4.3（API 级别 18）引入 BluetoothManager：

下一步，您需要确保蓝牙已启用。调用 isEnabled()，以检查当前是否已启用蓝牙。如果此方法返回 false，则表示蓝牙处于停用状态。以下代码段会检查蓝牙是否已启用。如果并未启用，则代码段会显示错误，提示用户前往“Settings”启用蓝牙：

注意：传递给 startActivityForResult(android.content.Intent, int) 的 REQUEST_ENABLE_BT 常量是本地定义的整数（必须大于0），系统会在您的 onActivityResult(int, int, android.content.Intent) 实现中将其作为 requestCode 参数传回给您。

如要查找 BLE 设备，请使用 startLeScan() 方法。此方法将 BluetoothAdapter.LeScanCallback 作为参数。您必须实现此回调，因为这是返回扫描结果的方式。扫描非常耗电，因此您应遵循以下准则：

以下代码段展示如何启动和停止扫描：

如果您想扫描特定类型的外围设备，则可调用 startLeScan(UUID[], BluetoothAdapter.LeScanCallback)，它会提供一组 UUID 对象，用于指定您的应用支持的 GATT 服务。

以下是 BluetoothAdapter.LeScanCallback 的实现，其为用于传递 BLE 扫描结果的界面：

注意：您仅能扫描蓝牙 LE 设备或传统蓝牙设备，正如蓝牙概览中所述。您无法同时扫描蓝牙 LE 设备和传统蓝牙设备。

与 BLE 设备交互的第一步便是连接到 GATT 服务器。更具体地说，是连接到设备上的 GATT 服务器。如要连接到 BLE 设备上的 GATT 服务器，请使用 connectGatt() 方法。此方法采用三个参数：一个 Context 对象、autoConnect（布尔值，指示是否在可用时自动连接到 BLE 设备），以及对 BluetoothGattCallback 的引用：

这将连接到由 BLE 设备托管的 GATT 服务器，并返回 BluetoothGatt 实例，然后您可使用该实例执行 GATT 客户端操作。调用方（Android 应用）是 GATT 客户端。BluetoothGattCallback 用于向客户端传递结果（例如连接状态），以及任何进一步的 GATT 客户端操作。

在本例中，BLE 应用提供一个 Activity (DeviceControlActivity) 来连接、显示数据和显示设备支持的 GATT 服务和特征。根据用户输入，此 Activity 和一个名为 BluetoothLeService 的 Service 通信，该服务通过 Android BLE API 与 BLE 设备交互：

当一个特定回调被触发时，它会调用相应的 broadcastUpdate() 辅助方法并向其传递操作。请注意，本部分的数据解析参照“蓝牙心率测量”配置文件规范执行：

回到 DeviceControlActivity，这些事件由 BroadcastReceiver 处理：

当您的 Android 应用成功连接到 GATT 服务器并发现服务后，应用便可在支持的位置读取和写入属性。例如，以下代码段遍历服务器的服务和特征，并在界面中将其显示出来：

BLE 应用通常会要求在设备上的特定特征发生变化时收到通知。以下代码段展示如何使用 setCharacteristicNotification() 方法设置特征的通知：

为某个特征启用通知后，如果远程设备上的特征发生更改，则会触发 onCharacteristicChanged() 回调：

当应用完成对 BLE 设备的使用后，其应调用 close()，以便系统可以适当地释放资源：