使用 BluetoothAdapter,您可以通过设备发现或查询已配对的设备列表来查找远程蓝牙设备。
在尝试查找蓝牙设备之前,请确保您拥有适当的蓝牙权限,并为您的应用设置蓝牙。
设备发现是一个扫描过程,它会搜索本地区域内已启用蓝牙的设备,并请求获取每台设备的一些信息。此过程有时称为发现、查询或扫描。 只有当附近的蓝牙设备当前处于可检测状态并接受信息请求时,才会响应检测请求。如果设备可检测到,它会通过分享一些信息(例如设备的名称、类别及其唯一 MAC 地址)来响应检测请求。然后,执行发现过程的设备可以使用此信息选择启动与所发现设备的连接。
由于可检测到的设备可能会泄露用户的位置信息,因此设备检测过程需要位置信息访问权限。如果您的应用在搭载 Android 8.0(API 级别 26)或更高版本的设备上使用,请考虑改用 Companion Device Manager API。此 API 会代表您的应用执行设备发现,因此您的应用无需请求位置信息权限。
首次连接到远程设备时,系统会自动显示配对请求。配对后,基本设备信息(例如设备的名称、类别和 MAC 地址)会保存下来,并可通过蓝牙 API 读取。
使用已配对的设备的已知 MAC 地址,您可以随时发起连接,而无需执行发现操作(前提是该设备仍在范围内)。
请注意,配对和连接之间存在差异:
- 配对是指两台设备知道彼此的存在,拥有可用于身份验证的共享链路密钥,并且能够与对方建立加密连接。
- 已连接意味着设备当前共享 RFCOMM 通道,并且能够相互传输数据。当前的蓝牙 API 要求先配对设备,然后才能建立 RFCOMM 连接。当您使用 Bluetooth API 发起加密连接时,系统会自动执行配对。
以下部分介绍了如何查找已配对的设备,以及如何使用设备发现功能发现新设备。
查询已配对的设备
在执行设备发现之前,值得查询一组已配对的设备,了解您想要的设备是否已为人所知。为此,请调用 getBondedDevices()。这会返回一组代表已配对的设备的 BluetoothDevice 对象。例如,您可以查询所有已配对的设备,并获取每个设备的名称和 MAC 地址,如以下代码段所示:
Kotlin
val pairedDevices: Set<BluetoothDevice>? = bluetoothAdapter?.bondedDevices
pairedDevices?.forEach { device ->
val deviceName = device.name
val deviceHardwareAddress = device.address // MAC address
}
Java
Set<BluetoothDevice> pairedDevices = bluetoothAdapter.getBondedDevices();
if (pairedDevices.size() > 0) {
// There are paired devices. Get the name and address of each paired device.
for (BluetoothDevice device : pairedDevices) {
String deviceName = device.getName();
String deviceHardwareAddress = device.getAddress(); // MAC address
}
}
如需发起与蓝牙设备的连接,关联的 BluetoothDevice 对象只需要 MAC 地址,您可以通过调用 getAddress() 来检索该地址。如需详细了解如何创建连接,请参阅连接蓝牙设备。
发现设备
如需开始发现设备,请调用 startDiscovery()。该过程是异步的,会返回一个布尔值,指示发现是否已成功启动。发现过程通常包括大约 12 秒的查询扫描,然后对找到的每个设备进行页面扫描,以检索其蓝牙名称。
如需接收有关所发现的每台设备的信息,您的应用必须为 ACTION_FOUND intent 注册 BroadcastReceiver。系统会针对每个设备广播此 intent。该 intent 包含 extra 字段 EXTRA_DEVICE 和 EXTRA_CLASS,它们分别包含 BluetoothDevice 和 BluetoothClass。以下代码段展示了如何注册以在发现设备时处理广播:
Kotlin
override fun onCreate(savedInstanceState: Bundle?) {
...
// Register for broadcasts when a device is discovered.
val filter = IntentFilter(BluetoothDevice.ACTION_FOUND)
registerReceiver(receiver, filter)
}
// Create a BroadcastReceiver for ACTION_FOUND.
private val receiver = object : BroadcastReceiver() {
override fun onReceive(context: Context, intent: Intent) {
val action: String = intent.action
when(action) {
BluetoothDevice.ACTION_FOUND -> {
// Discovery has found a device. Get the BluetoothDevice
// object and its info from the Intent.
val device: BluetoothDevice =
intent.getParcelableExtra(BluetoothDevice.EXTRA_DEVICE)
val deviceName = device.name
val deviceHardwareAddress = device.address // MAC address
}
}
}
}
override fun onDestroy() {
super.onDestroy()
...
// Don't forget to unregister the ACTION_FOUND receiver.
unregisterReceiver(receiver)
}
Java
@Override
protected void onCreate(Bundle savedInstanceState) {
...
// Register for broadcasts when a device is discovered.
IntentFilter filter = new IntentFilter(BluetoothDevice.ACTION_FOUND);
registerReceiver(receiver, filter);
}
// Create a BroadcastReceiver for ACTION_FOUND.
private final BroadcastReceiver receiver = new BroadcastReceiver() {
public void onReceive(Context context, Intent intent) {
String action = intent.getAction();
if (BluetoothDevice.ACTION_FOUND.equals(action)) {
// Discovery has found a device. Get the BluetoothDevice
// object and its info from the Intent.
BluetoothDevice device = intent.getParcelableExtra(BluetoothDevice.EXTRA_DEVICE);
String deviceName = device.getName();
String deviceHardwareAddress = device.getAddress(); // MAC address
}
}
};
@Override
protected void onDestroy() {
super.onDestroy();
...
// Don't forget to unregister the ACTION_FOUND receiver.
unregisterReceiver(receiver);
}
如需发起与蓝牙设备的连接,请对 BluetoothDevice 调用 getAddress(),以检索关联的 MAC 地址。
启用可检测性
如需让本地设备可被其他设备检测到,请使用 ACTION_REQUEST_DISCOVERABLE intent 调用 startActivityForResult(Intent, int)。这会发出启用系统可检测到模式的请求,而无需前往“设置”应用(这会停止您自己的应用)。默认情况下,设备会在两分钟内处于可检测到状态。您可以通过添加 EXTRA_DISCOVERABLE_DURATION extra 来定义不同的时长(最长 5 分钟)。
以下代码段会将设备设置为在 5 分钟内可检测到:
Kotlin
val requestCode = 1;
val discoverableIntent: Intent = Intent(BluetoothAdapter.ACTION_REQUEST_DISCOVERABLE).apply {
putExtra(BluetoothAdapter.EXTRA_DISCOVERABLE_DURATION, 300)
}
startActivityForResult(discoverableIntent, requestCode)
Java
int requestCode = 1;
Intent discoverableIntent =
new Intent(BluetoothAdapter.ACTION_REQUEST_DISCOVERABLE);
discoverableIntent.putExtra(BluetoothAdapter.EXTRA_DISCOVERABLE_DURATION, 300);
startActivityForResult(discoverableIntent, requestCode);
系统会显示一个对话框,请求用户授予使设备可检测到的权限,如图 1 所示。如果用户回答“允许”,则设备在指定的时间内可被检测到。然后,您的 activity 会收到对 onActivityResult() 回调的调用,其结果代码等于设备可检测到的时长。如果用户回答“拒绝”或发生错误,则结果代码为 RESULT_CANCELED。
设备会在分配的时间内静默保持可检测到模式。如需在可检测到模式发生变化时收到通知,请为 ACTION_SCAN_MODE_CHANGED intent 注册一个 BroadcastReceiver。此 intent 包含 extra 字段 EXTRA_SCAN_MODE 和 EXTRA_PREVIOUS_SCAN_MODE,分别提供新旧扫描模式。每个 extra 的可能值如下:
SCAN_MODE_CONNECTABLE_DISCOVERABLE- 设备处于可检测到模式。
SCAN_MODE_CONNECTABLE- 设备未处于可检测到模式,但仍可接收连接。
SCAN_MODE_NONE- 设备未处于可检测到模式,无法接收连接。
如果您要发起与远程设备的连接,则无需启用设备可检测性。只有在您希望应用托管接受传入连接的服务器端套接字时,才需要启用可检测性,因为远程设备必须能够检测到其他设备,然后才能发起与这些其他设备的连接。