如何用Kotlin开发作为A2DP设备的Android蓝牙外设应用？

核心前提 #

Android从**API 29（Android 10）**开始，官方开放了让设备充当A2DP Sink（音频接收端，类似蓝牙耳机的外设角色）的API；而A2DP Source（音频发送端）是Android设备默认支持的基础功能。如果你的需求是让设备作为可被其他设备连接的音频接收外设，重点关注A2DP Sink的实现。

实现步骤（以A2DP Sink为例） #

1. 声明权限 #

在AndroidManifest.xml中添加必要权限：

<uses-permission android:name="android.permission.BLUETOOTH" />
<uses-permission android:name="android.permission.BLUETOOTH_ADMIN" />
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
<!-- Android 12+ 新增权限 -->
<uses-permission android:name="android.permission.BLUETOOTH_CONNECT" />
<uses-permission android:name="android.permission.BLUETOOTH_ADVERTISE" />

注意：Android 6.0+需动态申请位置权限，Android 12+需动态申请蓝牙连接、广播权限，否则无法完成蓝牙扫描或连接操作。

2. 初始化A2DP代理并启用Sink角色 #

通过BluetoothProfile.ServiceListener获取A2DP服务代理，再启用Sink模式：

private val bluetoothAdapter: BluetoothAdapter? = BluetoothAdapter.getDefaultAdapter()
private var bluetoothA2dp: BluetoothA2dp? = null

// 获取A2DP服务代理
private fun getA2dpProxy() {
    bluetoothAdapter?.let { adapter ->
        val bluetoothManager = getSystemService(Context.BLUETOOTH_SERVICE) as BluetoothManager
        bluetoothManager.adapter.getProfileProxy(this, object : BluetoothProfile.ServiceListener {
            override fun onServiceConnected(profile: Int, proxy: BluetoothProfile) {
                if (profile == BluetoothProfile.A2DP) {
                    bluetoothA2dp = proxy as BluetoothA2dp
                    enableA2dpSink()
                }
            }

            override fun onServiceDisconnected(profile: Int) {
                if (profile == BluetoothProfile.A2DP) {
                    bluetoothA2dp = null
                }
            }
        }, BluetoothProfile.A2DP)
    }
}

// 启用A2DP Sink角色，让设备可被其他设备搜索并连接
private fun enableA2dpSink() {
    bluetoothA2dp?.let { a2dp ->
        if (a2dp.isSinkRoleSupported) {
            // 设置设备名称，方便其他设备识别
            bluetoothAdapter?.setName("My A2DP Sink Device")
            // 开启设备可发现性
            bluetoothAdapter?.startDiscovery()
            // 设置连接优先级，允许其他设备连接
            bluetoothAdapter?.bondedDevices?.forEach { device ->
                a2dp.setPriority(device, BluetoothProfile.PRIORITY_ON)
            }
        } else {
            Toast.makeText(this, "当前设备硬件不支持A2DP Sink模式", Toast.LENGTH_SHORT).show()
        }
    }
}

3. 音频路由配置 #

当A2DP连接建立后，需要将音频路由到当前设备的输出设备：

private fun setupAudioRouting() {
    val audioManager = getSystemService(Context.AUDIO_SERVICE) as AudioManager
    // 设置音频模式为蓝牙通信模式
    audioManager.mode = AudioManager.MODE_IN_COMMUNICATION
    // 强制音频输出到A2DP连接
    audioManager.isBluetoothA2dpOn = true
}

关键限制 #

• 硬件支持：部分低端Android设备的蓝牙模块不支持A2DP Sink角色，需提前验证设备兼容性。
• 系统版本：仅Android 10及以上版本可实现A2DP Sink外设，低版本系统无官方API支持。
• 权限管控：Android 12+对蓝牙权限的校验更严格，必须确保动态权限申请流程正确。

补充：A2DP Source角色实现 #

如果需求是让设备作为音频发送端（给蓝牙耳机、音箱等外设传音频），属于Android默认支持的功能，只需通过BluetoothA2dp连接目标设备，再用MediaPlayer播放音频即可，核心代码示例：

// 连接目标A2DP设备并播放音频
fun connectAndPlayAudio(targetDevice: BluetoothDevice) {
    bluetoothA2dp?.connect(targetDevice)
    val mediaPlayer = MediaPlayer.create(this, R.raw.audio_file)
    mediaPlayer.start()
}

内容的提问来源于stack exchange，提问作者shin