BluetoothHeadset name is the phone name instead of the Bluetooth device name

[Airsaid]

Describe the bug
When using LiveKit's AudioSwitchHandler to retrieve available audio devices, the Bluetooth device name returned on certain devices is incorrect.
On Xiaomi MI 9 connected to QCY-T5 Bluetooth earbuds, the name reported by BluetoothHeadset (surfaced through room.audioSwitchHandler.availableAudioDevices) is the phone’s Bluetooth name "MI 9", not the actual Bluetooth device name "QCY-T5".

This causes incorrect identification of the connected Bluetooth audio route.

---

To Reproduce
Steps to reproduce the behavior:

1. Use a Xiaomi MI 9 device running Android 11.
2. Pair and connect QCY-T5 Bluetooth earbuds.
3. Join a room and query audio devices via:

   room.audioSwitchHandler.availableAudioDevices

4. Inspect the returned Bluetooth device name.
5. The name appears as "MI 9" instead of "QCY-T5".

Example code:

room.audioSwitchHandler.availableAudioDevices.forEach { device ->
    Log.d("BT", "device.name = ${device.name}")
}

Observed output:

device.name = MI 9

---

Expected behavior
The SDK should return the actual connected Bluetooth device name, such as:

QCY-T5

instead of the phone's own name.

---

Screenshots
(Logs or screenshots can be provided if needed.)

---

Device Info:

• Device: Xiaomi MI 9
• OS: Android 11
• Live: 2.23.1

---

[adrian-niculescu]

I dug into how the SDK retrieves Bluetooth device names. The LiveKit Android SDK uses a fork of Twilio's audioswitch library for audio device management. The device name comes from BluetoothHeadset.connectedDevices and then accessing the name property on each BluetoothDevice.

Similar issue upstream

This looks similar to a bug reported in twilio/audioswitch#28 (bug 2), where a user reported that "Sometimes the name for bluetooth is not correct" - in that case, a Fitbit watch name ("Inspire") was returned instead of the connected AirPods. The issue was described as "very random" and couldn't be consistently reproduced.

That issue was closed, but the "wrong name" bug was never formally tracked or resolved. #31 addressed device switching failures, #32 addressed AirPods detection. The root cause was identified as a multi-device limitation (see #15) - the library only tracks one Bluetooth device at a time, so when multiple devices are connected, the wrong device's name may be returned.

Regarding BLUETOOTH_CONNECT permission

Since you're on Android 11 (API 30), BLUETOOTH_CONNECT isn't required - that permission is only needed for Android 12+ (API 31+). The legacy BLUETOOTH permission that the SDK declares with maxSdkVersion="30" should be sufficient for your device.

For reference, the audioswitch library:

• Does check for BLUETOOTH_CONNECT on Android 12+ before accessing Bluetooth APIs
• Does not declare BLUETOOTH_CONNECT in its manifest - apps must add it themselves per the Android Bluetooth permissions documentation

Root cause hypothesis

The fact that BluetoothDevice.name returns "MI 9" (your phone's Bluetooth name) instead of "QCY-T5" (your earbuds) suggests the connectedDevices list contains an unexpected device. Given the audioswitch library's single-device limitation, if your phone has multiple active Bluetooth connections (MI Band, smartwatch, or other accessories common on Xiaomi devices), the library may be selecting the wrong device from the list.

Questions

1. Does this happen consistently, or only sometimes (as in the upstream issue)?
2. Have you tested with other Bluetooth devices to see if the issue persists?
3. Do you have other Bluetooth devices connected (smartwatch, fitness band, etc.)?