Obsidian/项目文档/同力/蓝牙音乐/03_AVRCP歌曲信息与播放状态流程.md

03_AVRCP歌曲信息与播放状态流程

AVRCP 是什么

AVRCP = 蓝牙媒体控制协议

它负责两类事情：
  1. 车机控制手机：播放、暂停、上一曲、下一曲
  2. 手机告诉车机：歌名、歌手、封面、播放状态、进度

MediaBrowser 连接流程

1. BluetoothAvrcpClient.init(context)
   ↓
2. initMediaBrowserHelper()
   ↓
3. new MediaBrowserClient(context)
   ↓
4. MediaBrowserClient 连接系统服务：
      com.android.bluetooth.avrcpcontroller.BluetoothMediaBrowserService
   ↓
5. 连接成功后创建 MediaControllerCompat
   ↓
6. 注册 MediaControllerCompat.Callback
   ↓
7. 可以接收 metadata 和 playbackState

歌曲信息流程

1. 手机音乐 App 播放或切歌
   ↓
2. 手机通过 AVRCP 上报 metadata
   ↓
3. Android 蓝牙服务接收 metadata
   ↓
4. MediaBrowserClient.mediaControlCallback.onMetadataChanged()
   ↓
5. BluetoothAvrcpClient.callback.onMetadataChanged()
   ↓
6. BtMusicManager.onMetadataChanged()
   ↓
7. 解析字段：
      artist
      title
      album
      albumUrl
      duration
   ↓
8. 保存到 MusicInfo
   ↓
9. 通知 BtMusicViewModel.onPlayMusicInfo()
   ↓
10. mLiveDataMusicInfo.postValue(musicInfo)
   ↓
11. BluetoothMusicActivity 更新 UI

播放状态流程

1. 手机音乐播放状态变化
   ↓
2. MediaBrowserClient.onPlaybackStateChanged()
   ↓
3. BluetoothAvrcpClient.onPlaybackStateChanged()
   ↓
4. BtMusicManager.onPlaybackStateChanged()
   ↓
5. 判断：
      state == PlaybackStateCompat.STATE_PLAYING
   ↓
6. 更新 MusicInfo.isPlaying
   ↓
7. 更新 MusicInfo.playPosition
   ↓
8. 通知 BtMusicViewModel.onPlayMusicState(isPlaying)
   ↓
9. BluetoothMusicActivity 更新播放按钮图标

同步给 Launcher 的流程

同样的 AVRCP 数据，还会推给桌面卡片。

BluetoothAvrcpClient.onMetadataChanged()
  ↓
BtInfoPushManager.sendMusicInfoToLauncher()
  ↓
转换为 BtMusicInfo
  ↓
DataManager.putObject(BT_MUSIC_INFO, btInfo)
  ↓
发送 ACTION_UPDATE_MUSIC_WIDGET
  ↓
Launcher 卡片刷新

播放状态也是类似：

BluetoothAvrcpClient.onPlaybackStateChanged()
  ↓
BtInfoPushManager.sendMusicStateToLauncher()
  ↓
DataManager.putObject(BT_MUSIC_INFO, btInfo)
  ↓
Launcher 卡片刷新

MusicInfo 字段

字段	含义	来源
artist	歌手	MediaMetadata.METADATA_KEY_ARTIST
title	歌曲名	MediaMetadata.METADATA_KEY_TITLE
album	专辑	MediaMetadata.METADATA_KEY_ALBUM
albumUrl	封面	MediaMetadata.METADATA_KEY_ALBUM_ART_URI
songLen	总时长	MediaMetadata.METADATA_KEY_DURATION
playPosition	当前进度	PlaybackStateCompat.getPosition()
isPlaying	是否播放	PlaybackStateCompat.STATE_PLAYING

Unknown 处理

在 BtMusicManager.onMetadataChanged() 中：

如果 artist/title/album 为空、unknow、Not Provided
  ↓
替换为 strings.xml 中的 unknow 文案

在 BluetoothMusicActivity 中：

如果 title 为空或等于 unknow
  ↓
setIsOpenApp(true)

含义：

A2DP 可能已经连接，但手机音乐 App 没有提供有效歌曲信息。
页面可能提示用户打开手机音乐 App。