197 lines
3.7 KiB
Markdown
197 lines
3.7 KiB
Markdown
# 04_播放控制与音频焦点流程
|
|
|
|
## 页面按钮控制流程
|
|
|
|
```text
|
|
1. 用户点击蓝牙音乐页面按钮
|
|
↓
|
|
2. BluetoothMusicActivity.onClick()
|
|
↓
|
|
3. 根据按钮 ID 判断动作
|
|
↓
|
|
4. 调用 BtMusicViewModel
|
|
↓
|
|
5. BtMusicViewModel 调用 BtMusicControlManager
|
|
↓
|
|
6. BtMusicControlManager 调用 BtMusicManager
|
|
↓
|
|
7. BtMusicManager 调用 BluetoothAvrcpClient
|
|
↓
|
|
8. BluetoothAvrcpClient 调用 MediaController.TransportControls
|
|
↓
|
|
9. 手机音乐 App 响应
|
|
```
|
|
|
|
## 页面按钮映射
|
|
|
|
| 控件 ID | 方法 | 最终 AVRCP 控制 |
|
|
|---|---|---|
|
|
| `iv_bt_music_pre` | `preBtMusic()` | `skipToPrevious()` |
|
|
| `iv_bt_music_state` | `playBtMusic()` / `pauseBtMusic()` | `play()` / `pause()` |
|
|
| `iv_bt_music_next` | `nextBtMusic()` | `skipToNext()` |
|
|
|
|
## 播放命令详细链路
|
|
|
|
```text
|
|
BluetoothMusicActivity.onClick()
|
|
↓
|
|
mViewModel.playBtMusic()
|
|
↓
|
|
BtMusicViewModel.playBtMusic()
|
|
↓
|
|
BtMusicControlManager.playBtMusic()
|
|
↓
|
|
BtMusicManager.requestFocus()
|
|
↓
|
|
BtMusicAudioManager.requestAudioFocus()
|
|
↓
|
|
BtMusicManager.playBtMusic()
|
|
↓
|
|
BluetoothAvrcpClient.play()
|
|
↓
|
|
TransportControls.play()
|
|
```
|
|
|
|
## 暂停命令详细链路
|
|
|
|
```text
|
|
BluetoothMusicActivity.onClick()
|
|
↓
|
|
mViewModel.pauseBtMusic()
|
|
↓
|
|
BtMusicViewModel.pauseBtMusic()
|
|
↓
|
|
BtMusicControlManager.pauseBtMusic()
|
|
↓
|
|
BtMusicManager.pauseBtMusic()
|
|
↓
|
|
BluetoothAvrcpClient.pause()
|
|
↓
|
|
TransportControls.pause()
|
|
```
|
|
|
|
## 切歌命令详细链路
|
|
|
|
```text
|
|
上一曲：
|
|
BluetoothMusicActivity
|
|
↓
|
|
BtMusicViewModel.preBtMusic()
|
|
↓
|
|
BtMusicControlManager.preBtMusic()
|
|
↓
|
|
BtMusicManager.preBtMusic()
|
|
↓
|
|
BluetoothAvrcpClient.previous()
|
|
↓
|
|
TransportControls.skipToPrevious()
|
|
|
|
下一曲：
|
|
BluetoothMusicActivity
|
|
↓
|
|
BtMusicViewModel.nextBtMusic()
|
|
↓
|
|
BtMusicControlManager.nextBtMusic()
|
|
↓
|
|
BtMusicManager.nextBtMusic()
|
|
↓
|
|
BluetoothAvrcpClient.next()
|
|
↓
|
|
TransportControls.skipToNext()
|
|
```
|
|
|
|
## 音频焦点是什么
|
|
|
|
```text
|
|
音频焦点 = 当前谁有资格出声
|
|
|
|
车机里可能同时有：
|
|
蓝牙音乐
|
|
收音机
|
|
USB 音乐
|
|
视频
|
|
导航播报
|
|
蓝牙电话
|
|
|
|
所以蓝牙音乐播放前必须申请焦点。
|
|
```
|
|
|
|
## 焦点申请流程
|
|
|
|
```text
|
|
1. 用户点击播放
|
|
↓
|
|
2. BtMusicManager.requestFocus()
|
|
↓
|
|
3. BtMusicAudioManager.requestAudioFocus()
|
|
↓
|
|
4. AudioManager.requestAudioFocus()
|
|
↓
|
|
5. 如果返回 AUDIOFOCUS_REQUEST_GRANTED
|
|
↓
|
|
6. setA2dpUnMute()
|
|
↓
|
|
7. isFocus = true
|
|
↓
|
|
8. setMediaButtonEvent()
|
|
↓
|
|
9. 允许执行 AVRCP play()
|
|
```
|
|
|
|
## 焦点变化处理
|
|
|
|
| 焦点变化 | 处理 |
|
|
|---|---|
|
|
| `AUDIOFOCUS_GAIN` | 恢复 A2DP 出声，必要时恢复播放，通知语音当前是蓝牙音乐。 |
|
|
| `AUDIOFOCUS_LOSS` | 释放焦点，暂停蓝牙音乐，清空 Launcher 蓝牙音乐信息。 |
|
|
| `AUDIOFOCUS_LOSS_TRANSIENT` | 临时失焦，A2DP 静音，暂停蓝牙音乐。 |
|
|
| `AUDIOFOCUS_LOSS_TRANSIENT_CAN_DUCK` | 降低蓝牙音乐音量。 |
|
|
|
|
## 失焦流程
|
|
|
|
```text
|
|
1. 其他音源抢焦点
|
|
↓
|
|
2. BtMusicAudioManager.mAudioFocusListener.onAudioFocusChange()
|
|
↓
|
|
3. 收到 AUDIOFOCUS_LOSS 或 AUDIOFOCUS_LOSS_TRANSIENT
|
|
↓
|
|
4. 记录当前是否正在播放
|
|
↓
|
|
5. setA2dpMute()
|
|
↓
|
|
6. BtMusicManager.pauseBtMusic()
|
|
↓
|
|
7. 手机音乐暂停
|
|
```
|
|
|
|
## 恢复焦点流程
|
|
|
|
```text
|
|
1. 蓝牙音乐重新获得焦点
|
|
↓
|
|
2. 收到 AUDIOFOCUS_GAIN
|
|
↓
|
|
3. isFocus = true
|
|
↓
|
|
4. setA2dpUnMute()
|
|
↓
|
|
5. 如果 isPlayingLossFocus == true
|
|
↓
|
|
6. BtMusicManager.playBtMusic()
|
|
↓
|
|
7. 手机音乐恢复播放
|
|
```
|
|
|
|
## 注意点
|
|
|
|
`BluetoothA2dpSinkClient` 中这两个方法底层调用目前被注释：
|
|
|
|
```text
|
|
setFluorideAudioTrackGain()
|
|
setFluorideStreaming()
|
|
```
|
|
|
|
所以焦点切换时，A2DP 静音/恢复是否真正生效，需要真机验证。
|
|
|