Android Bluetooth（一）— 扫描和配对附近的设备-五八三

现在大部分手机都有蓝牙功能，可以与其他有蓝牙功能的设备连接、传输数据等。本文介绍如何使用蓝牙框架API扫描和配对附近的设备。

申请权限

如果要在App中使用蓝牙功能，需要申请多个权限，具体如下：

targetSdk 31（Android 12）及以上

<manifest xmlns:android="http://schemas.android.com/apk/res/android">









    <!--允许App连接到配对的蓝牙设备（兼容低版本）-->
    <uses-permission

        android:name="android.permission.BLUETOOTH"
        android:maxSdkVersion="30" />

    <!--允许App发现和配对蓝牙设备（兼容低版本）-->
    <uses-permission
        android:name="android.permission.BLUETOOTH_ADMIN"
        android:maxSdkVersion="30" />

    <!--若App需要扫描蓝牙设备，申请此权限-->
    <uses-permission android:name="android.permission.BLUETOOTH_SCAN" />


    <!--若App使当前设备可供其他蓝牙设备发现，申请此权限-->
    <uses-permission android:name="android.permission.BLUETOOTH_ADVERTISE" />


    <!--若App与蓝牙设备配对、通讯，申请此权限-->
    <uses-permission android:name="android.permission.BLUETOOTH_CONNECT" />
    
    <!--若App通过蓝牙扫描结果获取物理位置，申请此权限-->
    <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
</manifest>

确定不会使用蓝牙扫描结果获取物理位置时，设置BLUETOOTH_SCAN权限的usesPermissionFlags，就无需再申请ACCESS_FINE_LOCATION权限。

<manifest xmlns:android="http://schemas.android.com/apk/res/android">


    <!--若App需要扫描蓝牙设备，申请此权限-->
    <!--当usesPermissionFlags设置为neverForLocation时，无需再申请ACCESS_FINE_LOCATION权限-->
    <uses-permission

        android:name="android.permission.BLUETOOTH_SCAN"
        android:usesPermissionFlags="neverForLocation" />
</manifest>

需要注意的是，BLUETOOTH_SCAN、BLUETOOTH_ADVERTISE、BLUETOOTH_CONNECT均为运行时权限，需要申请并获得用户同意后，才能扫描附近蓝牙设备、被其他蓝牙设备发现或与其他蓝牙设备配对和通信，代码如下：

class BluetoothExampleActivity : AppCompatActivity() {












    private val requestMultiplePermissionLauncher = registerForActivityResult(ActivityResultContracts.RequestMultiplePermissions()) { permissions: Map<String, Boolean> ->
        val noGrantedPermissions = ArrayList<String>()
        permissions.entries.forEach {
            if (!it.value) {
                noGrantedPermissions.add(it.key)
            }
        }
        if (noGrantedPermissions.isEmpty()) {
            // 所有申请权限通过，可以执行后续操作
        } else {
            //未同意授权
            noGrantedPermissions.forEach {
                if (!shouldShowRequestPermissionRationale(it)) {
                    //用户拒绝权限并且系统不再弹出请求权限的弹窗
                    //这时需要我们自己处理，比如自定义弹窗告知用户为何必须要申请这个权限
                }
            }
        }
    }

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        val requestPermissionNames = arrayOf(Manifest.permission.BLUETOOTH_SCAN, Manifest.permission.BLUETOOTH_ADVERTISE, Manifest.permission.BLUETOOTH_CONNECT)
        if (requestPermissionNames.find { ActivityCompat.checkSelfPermission(this, it) != PackageManager.PERMISSION_GRANTED } != null) {
            requestMultiplePermissionLauncher.launch(requestPermissionNames)
        } else {
            // 所有申请权限通过，可以执行后续操作
        }
    }
}

targetSdk 30（Android 11）及以下

<manifest xmlns:android="http://schemas.android.com/apk/res/android">









    <!--允许App请求连接、接受连接或传输数据-->
    <uses-permission android:name="android.permission.BLUETOOTH"/>

    <!--允许App发现和配对蓝牙设备-->
    <uses-permission android:name="android.permission.BLUETOOTH_ADMIN" />
    
    <!--在Android 11（30）及以下版本中，位置权限是必须的-->
    <!--在Android 9（28）及以下版本中，可以使用ACCESS_COARSE_LOCATION权限替代ACCESS_FINE_LOCATION权限-->
    <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
</manifest>

需要注意的是，位置权限为运行时权限，需要申请并获得用户同意后，才能扫描附近蓝牙设备，代码如下：

class BluetoothExampleActivity : AppCompatActivity() {












    private val requestPermissionName = Manifest.permission.ACCESS_FINE_LOCATION

    private val requestSinglePermissionLauncher = registerForActivityResult(ActivityResultContracts.RequestPermission()) { granted: Boolean ->
        if (granted) {
            // 申请权限通过，可以执行后续操作
        } else {
            if (!shouldShowRequestPermissionRationale(requestPermissionName)) {
                //用户拒绝权限并且系统不再弹出请求权限的弹窗
                //这时需要我们自己处理，比如自定义弹窗告知用户为何必须要申请这个权限
            }
        }
    }


    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        if (ActivityCompat.checkSelfPermission(this, requestPermissionName) == PackageManager.PERMISSION_GRANTED) {
            // 申请权限通过，可以执行后续操作
        } else {
            requestSinglePermissionLauncher.launch(requestPermissionName)
        }
    }
}

检查与开启蓝牙

检查是否支持蓝牙功能

要使用蓝牙功能，首先需要确定当前设备是否支持蓝牙功能，代码如下：

class BluetoothExampleActivity : AppCompatActivity() {





    
    override fun onCreate(savedInstanceState: Bundle?) {

        super.onCreate(savedInstanceState)

        val bluetoothAdapter = (getSystemService(Context.BLUETOOTH_SERVICE) as BluetoothManager).adapter

        if (bluetoothAdapter != null) {
            // 当前设备支持蓝牙功能    
        }
    }
}

开启蓝牙

确认当前设备支持蓝牙功能后，检测蓝牙是否开启，未开启的话可以调用系统方法开启蓝牙，代码如下：

class BluetoothExampleActivity : AppCompatActivity() {












    private val intentLauncher = registerForActivityResult(ActivityResultContracts.StartActivityForResult()) { activityResult ->
        if (activityResult.resultCode == Activity.RESULT_OK) {
            // 成功开启蓝牙
        }
    }

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        val bluetoothAdapter = (getSystemService(Context.BLUETOOTH_SERVICE) as BluetoothManager).adapter
        if (bluetoothAdapter != null) {
            if (bluetoothAdapter.isEnabled != true) {
                // 蓝牙未开启，通过系统启用蓝牙
                intentLauncher.launch(Intent(BluetoothAdapter.ACTION_REQUEST_ENABLE))
            }
        }
    }
}

扫描和配对附近的设备

权限已申请完毕、蓝牙功能开启后，可以扫描附近的设备，进行配对。

获取已配对过的设备

当前设备可能已经与某些蓝牙设备配对过，获取已配对过的设备的代码如下：

class BluetoothExampleActivity : AppCompatActivity() {












    override fun onCreate(savedInstanceState: Bundle?) {

        super.onCreate(savedInstanceState)

        val bluetoothAdapter = (getSystemService(Context.BLUETOOTH_SERVICE) as BluetoothManager).adapter

        // 已绑定的设备
        val bondedDevices: Set<BluetoothDevice>? = bluetoothAdapter?.bondedDevices
    }
}

扫描附近设备并进行配对

注册广播接收者，监听扫描结果，使用startDiscovery扫描附近其他蓝牙设备。可以使用BluetoothDevice的createBond方法进行配对，代码如下：

class BluetoothExampleActivity : AppCompatActivity() {












    private val scanResultReceiver = object : BroadcastReceiver() {
        override fun onReceive(context: Context?, intent: Intent?) {
            when (intent?.action) {
                BluetoothDevice.ACTION_FOUND -> {
                    // 发现的蓝牙设备
                    val device: BluetoothDevice? = intent.getParcelableExtra(BluetoothDevice.EXTRA_DEVICE)
                    // 如果已经找到想要的设备，可以停止扫描
                    bluetoothAdapter?.cancelDiscovery()
                    
                    // 与发现的蓝牙设备配对
                    device?.createBond()
                }
            }
        }
    }


    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        // 注册蓝牙设备扫描结果监听
        registerReceiver(scanResultReceiver, IntentFilter().apply {
            addAction(BluetoothDevice.ACTION_FOUND)
        })
        val bluetoothAdapter = (getSystemService(Context.BLUETOOTH_SERVICE) as BluetoothManager).adapter
        bluetoothAdapter?.startDiscovery()
    }

    override fun onDestroy() {
        super.onDestroy()
        // 取消扫描结果监听
        unregisterReceiver(scanResultReceiver)
    }
}