在应用可以通过蓝牙或低功耗蓝牙进行通信之前,您需要验证设备是否支持蓝牙,如果支持,请确保蓝牙已启用。请注意,只有在 <uses-feature.../> 清单文件条目中的 android:required 属性设置为 false 时,才需要进行此项检查。
如果不支持蓝牙,则应妥善停用所有蓝牙功能。如果设备支持蓝牙,但蓝牙处于停用状态,您可以在不离开应用的情况下请求用户启用蓝牙。
第一步是添加蓝牙权限到清单文件中,以便使用以下 API。
设置好权限后,即可使用 BluetoothAdapter 通过两个步骤完成蓝牙设置:
获取
BluetoothAdapter。任何和所有蓝牙活动都需要
BluetoothAdapter。BluetoothAdapter表示设备自身的蓝牙适配器(蓝牙无线装置)。如需获取BluetoothAdapter,您首先需要拥有Context。使用此上下文获取BluetoothManager系统服务的实例。调用BluetoothManager#getAdapter会为您提供一个BluetoothAdapter对象。 如果getAdapter()返回 null,则表示设备不支持蓝牙。例如:
Kotlin
val bluetoothManager: BluetoothManager = getSystemService(BluetoothManager::class.java) val bluetoothAdapter: BluetoothAdapter? = bluetoothManager.getAdapter() if (bluetoothAdapter == null) { // Device doesn't support Bluetooth }Java
BluetoothManager bluetoothManager = getSystemService(BluetoothManager.class); BluetoothAdapter bluetoothAdapter = bluetoothManager.getAdapter(); if (bluetoothAdapter == null) { // Device doesn't support Bluetooth }启用蓝牙。
接下来,您需要确保蓝牙已启用。调用
isEnabled()以检查蓝牙当前是否已启用。如果此方法返回 false,则表示蓝牙已停用。如需请求启用蓝牙,请调用startActivityForResult(),并传入ACTION_REQUEST_ENABLEintent 操作。此调用会发出请求,以通过系统设置启用蓝牙(而不会停止您的应用)。例如:
Kotlin
if (bluetoothAdapter?.isEnabled == false) { val enableBtIntent = Intent(BluetoothAdapter.ACTION_REQUEST_ENABLE) startActivityForResult(enableBtIntent, REQUEST_ENABLE_BT) }Java
if (!bluetoothAdapter.isEnabled()) { Intent enableBtIntent = new Intent(BluetoothAdapter.ACTION_REQUEST_ENABLE); startActivityForResult(enableBtIntent, REQUEST_ENABLE_BT); }
系统会显示一个对话框,请求用户授予启用蓝牙的用户权限,如图 1 所示。如果用户授予权限,系统便会开始启用蓝牙,并在该过程完成(或失败)后将焦点返回到您的应用。
传递给 startActivityForResult() 的 REQUEST_ENABLE_BT 常量是本地定义的整数,必须大于或等于 0。系统会在您的 onActivityResult() 实现中将此常量作为 requestCode 参数传回给您。
如果成功启用蓝牙,您的 activity 会在 onActivityResult() 回调中收到 RESULT_OK 结果代码。如果由于错误而未启用蓝牙(或用户响应“拒绝”),则结果代码为 RESULT_CANCELED。
(可选)您的应用还可以监听 ACTION_STATE_CHANGED 广播 intent,每当蓝牙状态发生变化时,系统都会广播此 intent。此广播包含 extra 字段 EXTRA_STATE 和 EXTRA_PREVIOUS_STATE,分别包含新的和旧的蓝牙状态。这些额外字段的可能值为 STATE_TURNING_ON、STATE_ON、STATE_TURNING_OFF 和 STATE_OFF。如果您的应用需要检测在运行时对蓝牙状态所做的更改,则监听此广播会很有用。
在设备上启用蓝牙后,您便可以同时使用传统蓝牙和低功耗蓝牙。
对于低功耗蓝牙,您可以查找 BLE 设备、连接到 GATT 服务器以及传输 BLE 数据。