Android开发实战：利用BluetoothDevice精准获取蓝牙设备地址

1. 蓝牙设备地址的基础认知在开始动手写代码之前我们先要搞清楚蓝牙设备地址到底是什么。简单来说蓝牙设备地址就像是每个蓝牙设备的身份证号码全球唯一且不会重复。它由6个字节组成通常表示为12个十六进制数字中间用冒号分隔比如00:11:22:33:44:55。我在开发智能家居App时经常需要根据这个地址来区分不同的设备。比如用户家里可能有多个同型号的智能灯泡这时候设备名称可能都一样但地址绝对不同。这就像小区里可能有多个叫张三的人但他们的身份证号肯定不一样。蓝牙设备地址分为三种类型公共地址由IEEE统一分配全球唯一随机地址设备随机生成主要用于隐私保护静态地址设备重启后保持不变在Android开发中我们最常用到的是通过BluetoothDevice类获取设备的公共地址。这个地址在设备生命周期内通常不会改变除非厂商特意做了修改所以非常适合用来唯一标识设备。2. 开发前的准备工作2.1 权限配置首先要在AndroidManifest.xml中添加蓝牙权限。这里有个坑我踩过从Android 12开始除了常规的蓝牙权限还需要声明精确位置权限才能扫描到蓝牙设备。uses-permission android:nameandroid.permission.BLUETOOTH/ uses-permission android:nameandroid.permission.BLUETOOTH_ADMIN/ !-- Android 12及以上需要额外添加 -- uses-permission android:nameandroid.permission.ACCESS_FINE_LOCATION/2.2 运行时权限处理在代码中我们需要动态请求这些权限。我建议在Activity的onCreate方法中处理private static final int PERMISSION_REQUEST_CODE 100; private void checkPermissions() { if (Build.VERSION.SDK_INT Build.VERSION_CODES.M) { if (checkSelfPermission(Manifest.permission.ACCESS_FINE_LOCATION) ! PackageManager.PERMISSION_GRANTED) { requestPermissions( new String[]{Manifest.permission.ACCESS_FINE_LOCATION}, PERMISSION_REQUEST_CODE ); } } } Override public void onRequestPermissionsResult(int requestCode, NonNull String[] permissions, NonNull int[] grantResults) { super.onRequestPermissionsResult(requestCode, permissions, grantResults); if (requestCode PERMISSION_REQUEST_CODE) { if (grantResults.length 0 grantResults[0] PackageManager.PERMISSION_GRANTED) { // 权限获取成功可以继续蓝牙操作 } else { // 权限被拒绝需要提示用户 Toast.makeText(this, 需要位置权限才能使用蓝牙功能, Toast.LENGTH_SHORT).show(); } } }3. 获取蓝牙适配器实例BluetoothAdapter是Android蓝牙功能的入口点相当于蓝牙系统的总开关。获取实例的方法很简单BluetoothAdapter bluetoothAdapter BluetoothAdapter.getDefaultAdapter();但这里有几个注意事项有些设备可能没有蓝牙模块所以要先检查返回的是否为null模拟器通常不支持蓝牙真机测试是必须的在Android 4.3以下版本这个方法可能会抛出异常需要try-catch我建议封装一个安全的获取方法public static BluetoothAdapter getBluetoothAdapter(Context context) { try { BluetoothAdapter adapter BluetoothAdapter.getDefaultAdapter(); if (adapter null) { Toast.makeText(context, 该设备不支持蓝牙, Toast.LENGTH_SHORT).show(); } return adapter; } catch (Exception e) { Log.e(BluetoothUtils, 获取蓝牙适配器失败, e); return null; } }4. 启用蓝牙功能获取到适配器后需要确保蓝牙已开启。这里有两种情况处理4.1 直接启用蓝牙如果确定用户不会拒绝开启蓝牙可以直接启用if (!bluetoothAdapter.isEnabled()) { bluetoothAdapter.enable(); }但这种方法没有用户确认可能会被认为不友好。4.2 请求用户启用更推荐的做法是弹出系统对话框让用户确认private static final int REQUEST_ENABLE_BT 1; if (!bluetoothAdapter.isEnabled()) { Intent enableBtIntent new Intent(BluetoothAdapter.ACTION_REQUEST_ENABLE); startActivityForResult(enableBtIntent, REQUEST_ENABLE_BT); } Override protected void onActivityResult(int requestCode, int resultCode, Intent data) { super.onActivityResult(requestCode, resultCode, data); if (requestCode REQUEST_ENABLE_BT) { if (resultCode RESULT_OK) { // 用户已启用蓝牙 } else { // 用户拒绝启用蓝牙 } } }5. 获取已配对设备列表获取已配对设备是最常用的方法特别适合那些需要长期连接的设备比如智能手环、蓝牙键盘等。SetBluetoothDevice pairedDevices bluetoothAdapter.getBondedDevices();这里返回的是一个Set集合我通常会用List来存储以便后续操作ListBluetoothDevice deviceList new ArrayList(pairedDevices);5.1 设备筛选技巧实际开发中我们往往需要筛选特定设备。除了按名称筛选还可以按设备类筛选for (BluetoothDevice device : pairedDevices) { if (device.getBluetoothClass().getDeviceClass() BluetoothClass.Device.AUDIO_VIDEO_HEADPHONES) { // 找到蓝牙耳机设备 } }按地址前缀筛选某些厂商设备有固定前缀if (device.getAddress().startsWith(00:11:22)) { // 特定厂商设备 }6. 通过扫描发现设备对于未配对的设备我们需要先扫描发现它们。这个过程稍微复杂一些6.1 创建广播接收器private final BroadcastReceiver receiver new BroadcastReceiver() { Override public void onReceive(Context context, Intent intent) { String action intent.getAction(); if (BluetoothDevice.ACTION_FOUND.equals(action)) { BluetoothDevice device intent.getParcelableExtra(BluetoothDevice.EXTRA_DEVICE); String deviceName device.getName(); String deviceAddress device.getAddress(); // 处理发现的设备 } } };6.2 注册接收器并开始扫描IntentFilter filter new IntentFilter(BluetoothDevice.ACTION_FOUND); registerReceiver(receiver, filter); bluetoothAdapter.startDiscovery();6.3 停止扫描和注销接收器bluetoothAdapter.cancelDiscovery(); unregisterReceiver(receiver);重要提示扫描过程比较耗电应该尽量缩短扫描时间一般10-12秒就足够了。7. 精准获取设备地址的最佳实践在实际项目中我总结了几个获取设备地址的可靠方法7.1 缓存设备信息对于频繁连接的设备可以将地址存储在SharedPreferences中SharedPreferences prefs getSharedPreferences(BluetoothPrefs, MODE_PRIVATE); SharedPreferences.Editor editor prefs.edit(); editor.putString(my_device_address, deviceAddress); editor.apply();7.2 多条件验证不要仅依赖设备名称应该结合多种信息public boolean isTargetDevice(BluetoothDevice device) { return device.getName() ! null device.getName().equals(HC-05) device.getAddress().startsWith(00:11:22) device.getBluetoothClass().getMajorDeviceClass() BluetoothClass.Device.Major.UNCATEGORIZED; }7.3 处理地址变化虽然蓝牙地址通常不变但有些设备会使用随机地址。对于这种情况在配对时记录原始地址实现持久化连接避免重复配对使用设备提供的唯一标识符如果有8. 常见问题与解决方案8.1 获取不到设备地址可能原因没有正确获取蓝牙权限蓝牙未开启设备未配对或不在范围内解决方案检查权限是否全部获取添加蓝牙状态监听private final BroadcastReceiver stateReceiver new BroadcastReceiver() { Override public void onReceive(Context context, Intent intent) { final int state intent.getIntExtra(BluetoothAdapter.EXTRA_STATE, BluetoothAdapter.ERROR); switch (state) { case BluetoothAdapter.STATE_ON: // 蓝牙已开启可以继续操作 break; } } };8.2 地址显示为null这种情况通常发生在低功耗蓝牙设备(BLE)上。解决方法先建立GATT连接通过BluetoothGattCallback获取设备信息在onConnectionStateChange回调中处理8.3 不同Android版本的兼容性问题Android各版本蓝牙API有所变化我建议使用AndroidX的蓝牙库添加版本判断if (Build.VERSION.SDK_INT Build.VERSION_CODES.LOLLIPOP) { // 使用新API } else { // 使用旧API }9. 实际应用案例以智能家居App为例完整的设备连接流程应该是检查并请求所有必要权限确保蓝牙已开启扫描或获取已配对设备列表通过名称、地址等多条件筛选目标设备将验证通过的设备地址存储到本地建立连接时直接从存储中读取地址public class BluetoothManager { private static final String PREF_DEVICE_ADDRESS pref_device_address; public static void saveDeviceAddress(Context context, String address) { PreferenceManager.getDefaultSharedPreferences(context) .edit() .putString(PREF_DEVICE_ADDRESS, address) .apply(); } public static String getSavedDeviceAddress(Context context) { return PreferenceManager.getDefaultSharedPreferences(context) .getString(PREF_DEVICE_ADDRESS, null); } public static BluetoothDevice findDeviceByAddress( BluetoothAdapter adapter, String address) { if (adapter null || address null) return null; // 先从已配对设备中查找 SetBluetoothDevice pairedDevices adapter.getBondedDevices(); for (BluetoothDevice device : pairedDevices) { if (address.equals(device.getAddress())) { return device; } } // 如果没找到可能需要先扫描 // 这里省略扫描代码... return null; } }10. 性能优化建议减少扫描时间蓝牙扫描非常耗电每次扫描不要超过15秒使用缓存对于已知设备直接使用缓存地址避免重复扫描后台处理长时间连接建议使用Service但要注意Android 8.0以上的限制错误重试连接失败时实现指数退避算法比如第一次重试等1秒第二次等2秒第三次等4秒...private void connectWithRetry(BluetoothDevice device, int retryCount) { try { // 尝试连接 BluetoothSocket socket device.createRfcommSocketToServiceRecord(MY_UUID); socket.connect(); } catch (IOException e) { if (retryCount 0) { long delay (long) Math.pow(2, MAX_RETRIES - retryCount) * 1000; new Handler().postDelayed(() - connectWithRetry(device, retryCount - 1), delay); } else { // 最终失败处理 } } }在开发健康监测设备应用时我发现蓝牙连接稳定性至关重要。通过实现上述重试机制连接成功率从70%提升到了95%以上。同时合理设置连接超时时间通常8-10秒也能显著改善用户体验。