Android蓝牙扫描设备

Android蓝牙扫描设备踩坑

最近做iOS和Android的蓝牙打印功能，蓝牙打印少不了扫描附近的蓝牙设置，本博主要讲解Android开发中扫描蓝牙设备遇到的坑和解决方法

• 所需权限

BLUETOOTH ，BLUETOOTH_ADMIN
发起蓝牙连接，接受蓝牙连接和传输数据，允许程序发现和配对蓝牙设备需要该权限

ACCESS_FINE_LOCATION
扫描蓝牙设备需要， 如果工程设置的target 位Android 9 (API level 28) 或更低, 可以声明ACCESS_COARSE_LOCATION 权限来代替ACCESS_FINE_LOCATION，两个权限的区别就是获取地理位置的精度不同。

知道了需要的权限后，我们在AndroidManifest.xml中加入

    <uses-permission android:name="android.permission.BLUETOOTH" />
    <uses-permission android:name="android.permission.BLUETOOTH_ADMIN" />
    <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
    <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />

权限加好后，我们开始coding，代码如下

 private fun initBluetooth() {
        val bluetoothAdapter = BluetoothAdapter.getDefaultAdapter()
        if (null == bluetoothAdapter) {
            ToastUtils.createByDefault(requireActivity(), R.string.phone_not_support_bluetooth)
        } else {
            if (!bluetoothAdapter.isEnabled) {
                Intent(BluetoothAdapter.ACTION_REQUEST_ENABLE).also {
                    startActivityForResult(it, REQUEST_ENABLE_BT)
                }
            } else {
                discoverBluetoothDevice()
            }
        }
    }

功能很简单，注意先判断设置是否支持蓝牙，如果不支持提示，如果支持蓝牙但未开启，发起一个Intent开启蓝牙，否则开始进入扫描设备的，我们来看下扫描发现设备的实现discoverBluetoothDevice

private fun discoverBluetoothDevice() {
        val bluetoothAdapter = BluetoothAdapter.getDefaultAdapter() ?: return
        if (bluetoothAdapter.isDiscovering) {
            bluetoothAdapter.cancelDiscovery()
        }

        val needsPermission = mutableListOf<String>()

        if (!AndPermission.hasPermissions(requireActivity(), Permission.ACCESS_COARSE_LOCATION)) {
            needsPermission.add(Permission.ACCESS_COARSE_LOCATION)
        }
        if (!AndPermission.hasPermissions(requireActivity(), Permission.ACCESS_FINE_LOCATION)) {
            needsPermission.add(Permission.ACCESS_FINE_LOCATION)
        }
        if (needsPermission.isEmpty()) {
            bluetoothAdapter.startDiscovery()
        } else {
            AndPermission.with(requireActivity()).runtime()
                .permission(needsPermission.toTypedArray())
                .onGranted {
                    bluetoothAdapter.startDiscovery()
                }
                .onDenied {
                    Toast.makeText(activity, "没有获取到相关权限，该功能无法使用", Toast.LENGTH_SHORT)
                        .show()

                    //true，弹窗再次向用户索取权限
                    if (AndPermission.hasAlwaysDeniedPermission(activity, it)) {
                        // 第一种：用默认的提示语。
                        AlertDialog.Builder(requireActivity())
                            .setTitle("权限申请被拒绝")
                            .setMessage("需要开通相关权限才能操作，去设置权限页开通？")
                            .setPositiveButton(
                                "好的"
                            ) { dialog, _ ->
                                dialog.cancel()
                                AndPermission.with(activity)
                                    .runtime()
                                    .setting()
                                    .start(0)
                            }
                            .setNegativeButton("拒绝") { dialog, _ ->
                                dialog.cancel()
                            }
                            .show()
                    }

                }.start()
        }
    }

注意功能是判断是否开启了ACCESS_COARSE_LOCATION，ACCESS_FINE_LOCATION权限，这两个权限是危险权限，Android 6.0以后需要手动申请，项目配置的不同需要的权限不同，以下为我负责的项目配置

compileSdkVersion = 29
targetSdkVersion = 29

这个为了方便同时申请了两个权限，根据build.gradle配置申请其中的一个，具体用什么权限可以看官方文档

https://developer.android.google.cn/guide/topics/connectivity/bluetooth/permissions?hl=en
申请权限用的是AndPermission框架，不熟悉的可以网上搜索下，没啥好说的，
扫描的功能开发完了，我们怎么获取扫描到的设备信息呢，这时就需要我们注册广播了，BluetoothAdapter扫描到设备就会发一个Action为BluetoothDevice.ACTION_FOUND的广播， 直接上代码

private val mFindBluetoothReceiver = object : BroadcastReceiver() {
        override fun onReceive(context: Context, intent: Intent) {
            when (intent.action) {
                BluetoothDevice.ACTION_FOUND -> {
                    val device =
                        intent.getParcelableExtra<BluetoothDevice>(BluetoothDevice.EXTRA_DEVICE)
                    if (device.type != BluetoothDevice.DEVICE_TYPE_LE) {
                        BluetoothDeviceInfo(
                            macAddress = device.address,
                            name = device.name ?: "unknown"
                        ).also {
                            mDeviceListAdapter.onDiscoveredDevice(it)
                        }
                    }

                    Log.i("Bluetooth", "onReceive: ===============>${device}")
                }
            }
        }
    }


 override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)

        requireActivity().registerReceiver(
            mFindBluetoothReceiver,
            IntentFilter(BluetoothDevice.ACTION_FOUND).apply {
                addAction(
                    BluetoothAdapter.ACTION_DISCOVERY_FINISHED
                )
            })
    }

其中遇到一个恶心问题就是，运行后导致ANR（应用无响应），换了几个设备都没找到原因，最后有一个手机在这里崩溃才找到是因为null传给kotlin的非可空变量才导致的， 完全懵逼，这跟ANR联系上我也是醉了

data class BluetoothDeviceInfo(val macAddress: String, val name: String)
BluetoothDeviceInfo(
      macAddress = device.address,
      name = device.name ?: "unknown"
      )

解决这个问题后，我测试的手机都能正常扫描到蓝牙设备了，
但别高兴的太早，部分Android 10机型就是扫描不到任何蓝牙设备，这时候一通百度，都说没申请权限之类的，最后无果跑官网把蓝牙权限相关的看了一遍，发现了一段

Services running on Android 10 and higher cannot discover Bluetooth
devices unless they have the ACCESS_BACKGROUND_LOCATION permission.
For more information on this requirement, see Access location in the
background.

意思是Android 10以上的设备除非拥有ACCESS_BACKGROUND_LOCATION权限，否则扫描不到蓝牙设备，坑，我测试的真机就是Android 10的能搜索到, 但不是所有的都能扫描到，看到这条信息松了口气，再权限申请的地方加上这条

        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.Q && !AndPermission.hasPermissions(requireActivity(), Permission.ACCESS_BACKGROUND_LOCATION)) {
            needsPermission.add(Permission.ACCESS_BACKGROUND_LOCATION)
        }

加完激动的运行，结果果断的崩溃了，我靠忘记AndroidManifest.xml加权限了，好吧加上后允许一切正常。

到这里应该也到了结速的时候了，但今天又发现了一个vivo S5 Android 10的系统就是扫描不到蓝牙设备，又撸了一遍官网关于蓝牙的文档，没有任何发现，最后折腾了两小时通过打开手机GPS解决了问题