Android 蓝牙使用

原文地址: Android 蓝牙使用 - Stars-One的杂货小窝

公司项目需求需要实现监听蓝牙耳机连接,且要获取蓝牙耳机电量功能,翻了不少官方文档,记录下技术调研代码

注:本文没有研究蓝牙配对功能

关于蓝牙权限适配

Android12以后,申请蓝牙权限需要申请一组,如新增的几个权限,需要一起申请

参考: 蓝牙权限  |  Connectivity  |  Android Developers

val permissionList =  if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.S) {
   //android12及以上版本,这2个权限申请只会弹出一个对话框
   listOf(Permission.BLUETOOTH_CONNECT, Permission.BLUETOOTH_SCAN)
} else {
	//android12以下版本申请,默认是同意的,不会有权限弹窗
   listOf(Permission.BLUETOOTH_CONNECT)
}

打开蓝牙开关

注意,如果是Android12及以上版本,蓝牙开关打开操作需要有Bluetooth_Connect权限才能执行操作

效果就是直接打开蓝牙开关

val bluetoothAdapter = context.getSystemService(BluetoothManager::class.java).adapter

//需要权限android.permission.BLUETOOTH_CONNECT才能执行操作
bluetoothAdapter.enable()

不过Android还是有提供另外的一个方法供我们使用,就是下面的方法

此方法是API 5 就有的方法,和上面一样,Android12及以上版本,就是需要有Bluetooth_Connect权限才能执行成功,否则会抛出异常

兼容低版本和高版本,此方法兼容,调用此方法,系统会弹出一个是否允许打开蓝牙的对话提示框

val intent = Intent(BluetoothAdapter.ACTION_REQUEST_ENABLE)
//这里写你对应的Activity,我这里只是个例子
Activity.startActivityForResult(intent,7777)

至于接收回调,则是在对应的Activity中的onActivityResult()方法中处理返回结果:

• 返回结果RESULT_OK,蓝牙模块打开成功
• 返回结果RESULT_CANCELED,蓝牙模块打开失败

PS: 测试的时候,用的华为手机,系统为鸿蒙4,Android Studio显示为Android12,但是使用bluetoothAdapter.enable()却是能够正常弹出申请蓝牙是否打开的对话框

获取已配对的蓝牙设备列表

val bluetoothAdapter = getSystemService(BluetoothManager::class.java).adapter
val bluetoothDevices = bluetoothAdapter.bondedDevices

//获取已配对的蓝牙设备列表
bluetoothDevices.forEach { device->
	val text = when(device.type){
		BluetoothDevice.DEVICE_TYPE_UNKNOWN -> "传统蓝牙"
		BluetoothDevice.DEVICE_TYPE_CLASSIC -> "传统蓝牙"
		BluetoothDevice.DEVICE_TYPE_LE -> "低功耗蓝牙"
		BluetoothDevice.DEVICE_TYPE_DUAL -> "传统/低功耗双模式蓝牙"
		else->"未知类型"
	}
	LogUtils.d("蓝牙设备名称: ${device.name} 蓝牙设备地址: ${device.address} 设备类型: $text")

}

获取蓝牙耳机设备列表

fun getEarPhoneDevices(context: Context): List<BluetoothDevice> {
	val bluetoothAdapter = context.getSystemService(BluetoothManager::class.java).adapter

	val bluetoothDevices = bluetoothAdapter.bondedDevices
	val types = listOf(
		BluetoothClass.Device.AUDIO_VIDEO_HEADPHONES,
		BluetoothClass.Device.AUDIO_VIDEO_WEARABLE_HEADSET,
		BluetoothClass.Device.AUDIO_VIDEO_CAR_AUDIO,
		BluetoothClass.Device.AUDIO_VIDEO_HANDSFREE
	)
	return bluetoothDevices.filter { device ->
		types.any { it == device.bluetoothClass.deviceClass }
	}
}

PS: 测试过程中,发现漫步者耳机的类型识别不了为上述的四个类型...

获取当前已连接蓝牙耳机

一般只能连接一个蓝牙耳机

val bluetoothAdapter = getSystemService(BluetoothManager::class.java).adapter
//如果在连接了蓝牙耳机的情况,这里会进入到里面获取到数据
bluetoothAdapter.getProfileProxy(this@EarphoneActivity, object : ServiceListener {
	override fun onServiceConnected(p0: Int, p1: BluetoothProfile?) {
		p1?.apply {
			//获取蓝牙耳机的设备列表
			val devices = this.connectedDevices
			devices.forEach { device ->
				val text = when (device.type) {
					BluetoothDevice.DEVICE_TYPE_UNKNOWN -> "传统蓝牙"
					BluetoothDevice.DEVICE_TYPE_CLASSIC -> "传统蓝牙"
					BluetoothDevice.DEVICE_TYPE_LE -> "低功耗蓝牙"
					BluetoothDevice.DEVICE_TYPE_DUAL -> "传统/低功耗双模式蓝牙"
					else -> "未知类型"
				}
				LogUtils.d("蓝牙设备名称: ${device.name} 蓝牙设备地址: ${device.address} 设备类型: $text")
			}
		}
		LogUtils.d("设备连接")
	}

	override fun onServiceDisconnected(p0: Int) {

	}
}, BluetoothProfile.HEADSET)
}

获取蓝牙耳机电量

此方法适应市面上大多数蓝牙耳机,但如果是AirPods,则无效果,下一章节会讲到获取AirPods电量方法

(虽然参考的文章说这个是AirPods的扩展AT命令,但实际对于正版AirPods无效果,反倒是我同事的华强北AirPods支持...)

通过注册广播,来获取到对应的AT命令,在参数可以取值

val bluetoothIntentFilter = IntentFilter().apply {
	addAction(BluetoothDevice.ACTION_ACL_CONNECTED)
	addAction(BluetoothDevice.ACTION_ACL_DISCONNECTED)

+	addCategory(BluetoothHeadset.VENDOR_SPECIFIC_HEADSET_EVENT_COMPANY_ID_CATEGORY+"."+BluetoothAssignedNumbers.APPLE)
+	addAction(BluetoothHeadset.ACTION_VENDOR_SPECIFIC_HEADSET_EVENT)
}
registerReceiver(BlueToothReceiver(), bluetoothIntentFilter)

广播详情说明可看此链接蓝牙耳机 | 安卓开发者

之后在Receiver可以获取对应的AT命令参数,如下代码:

//蓝牙耳机的广播监听
if (BluetoothHeadset.ACTION_VENDOR_SPECIFIC_HEADSET_EVENT == action) {
	Log.d(TAG, "onReceive: 蓝牙设备AT命令")

	//蓝牙设备
	val blueDevice = if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.TIRAMISU) {
		intent.getParcelableExtra(BluetoothDevice.EXTRA_DEVICE, BluetoothDevice::class.java)
	} else {
		intent.getParcelableExtra(BluetoothDevice.EXTRA_DEVICE)
	}
	blueDevice?.apply {
		val device = this
		val text = when (device.type) {
			BluetoothDevice.DEVICE_TYPE_UNKNOWN -> "传统蓝牙"
			BluetoothDevice.DEVICE_TYPE_CLASSIC -> "传统蓝牙"
			BluetoothDevice.DEVICE_TYPE_LE -> "低功耗蓝牙"
			BluetoothDevice.DEVICE_TYPE_DUAL -> "传统/低功耗双模式蓝牙"
			else -> "未知类型"
		}
		LogUtils.d("蓝牙设备名称: ${device.name} 蓝牙设备地址: ${device.address} 设备类型: $text")
	}

	intent.extras?.apply {
		val cmd = getString(BluetoothHeadset.EXTRA_VENDOR_SPECIFIC_HEADSET_EVENT_CMD,"")
		val cmdType = getInt(BluetoothHeadset.EXTRA_VENDOR_SPECIFIC_HEADSET_EVENT_CMD_TYPE,0)
		//根据命令行类型,会有不同的参数
		val cmdTypeStr = when (cmdType) {
			BluetoothHeadset.AT_CMD_TYPE_ACTION -> {"AT_CMD_TYPE_ACTION"}
			BluetoothHeadset.AT_CMD_TYPE_BASIC -> {"AT_CMD_TYPE_BASIC"}
			BluetoothHeadset.AT_CMD_TYPE_READ -> {"AT_CMD_TYPE_READ"}
			BluetoothHeadset.AT_CMD_TYPE_SET -> {"AT_CMD_TYPE_SET"}
			BluetoothHeadset.AT_CMD_TYPE_TEST -> {"AT_CMD_TYPE_TEST"}
			else -> {""}
		}

		val args = get(BluetoothHeadset.EXTRA_VENDOR_SPECIFIC_HEADSET_EVENT_ARGS) as Array<Any>

		LogUtils.d("""
	   接收到的AT命令:  AT $cmd $cmdTypeStr ${args.joinToString(",") { it.toString() }}
	""".trimIndent())

		if (cmd == "+IPHONEACCEV") {
				//电量等级说明 0:10% 9:100%
				val param = args.map { it.toString().toInt() }
				val level = param.last()

				   //电量
			val battery = (level + 1) * 10
		}
	}

}

AT+IPHONEACCEV命令

该命令是用来提示蓝牙配件的电池状态，可以提示两方面：一方面是电池的电量百分比，一当面是蓝牙配件的当前的充电状态。该命令的说明见下方：

格式：AT+IPHONEACCEV=Number of key/value pairs,key1,val1,key2,val2,…

附带的参数的含义分别是：①键值对的数目：接下来的参数文本的数量；②接下来就是键值对分别是：键值为1表示的是电量，该键所对应的值就是电量百分比，使用字串”0“到”9“表示；键值为2表示的是充电状态，0表示不在充电，1表示正在充电。

举例：AT+IPHONEACCEV=1,1,3 该AT指令就说明附带了一个键值对（第一个参数是1）；键是1，那么表示的是电量，且电量是40%（因为使用的是0~9，这里3就对应的百分比是40%）。

有个疑问,AirPods在电量变化后,会主动发送AT命令吗?还是说是在连接后才会发一次,之后便不再发送了?

AT +XAPL AT_CMD_TYPE_SET AB-12-0100,18

AirPods耳机电量

起初一致没找到方案,最终在github上输入了AirPods关键字,发现了有几个对于对应的开源库,测试发现下面这个能够符合要求(不过测试的时候,电量有些误差,充电仓在iphone手机上显示为8%,而android这边则显示为5%)

• adolfintel/OpenPods: The Free and Open Source app for monitoring your AirPods on Android

app原理则是通过蓝牙扫描,获取到蓝牙设备对应的设备厂商数据,并区分型号,然后做对应的处理从而获取到电量(比如说左耳机,右耳机,耳机仓)

通过蓝牙的adapter获取scanner,调用扫描方法,之后在扫描的回调里处理返回结果, 从而得到对应的电量数据

蓝牙扫描还需要一个获取定位的权限(在Android12版本之下需要),不然无法扫描

参考

• Android状态栏显示蓝牙耳机电量 - CodeAntenna
• 苹果公司对蓝牙免提AT指令的扩充 - WestMountain - 博客园
• Bluetooth (Android) 之自定义 AT 指令 – xmamiga
• 如何获得蓝牙耳机的电池电量？
• adolfintel/OpenPods: The Free and Open Source app for monitoring your AirPods on Android