first commit

项目文档/同力/蓝牙音乐/蓝牙音乐模块流程与开发指南.md

@@ -0,0 +1,84 @@
+# 蓝牙音乐模块流程与开发指南
+
+> 这是入口文档。  
+> 本次排版已去掉 Mermaid 图，改为“纯文本流程块 + 编号步骤表 + 拆分文档”，适合 Obsidian 直接阅读。
+
+## 推荐阅读顺序
+
+| 顺序 | 文档 | 先看什么 |
+|---|---|---|
+| 1 | [[00_总览_一页看懂]] | 先建立模块整体印象。 |
+| 2 | [[01_启动初始化流程]] | 看蓝牙音乐 SDK 是怎么启动的。 |
+| 3 | [[02_A2DP连接与断开流程]] | 看“有没有声音通道”怎么判断。 |
+| 4 | [[03_AVRCP歌曲信息与播放状态流程]] | 看歌名、歌手、播放状态从哪里来。 |
+| 5 | [[04_播放控制与音频焦点流程]] | 看播放、暂停、切歌、焦点抢占。 |
+| 6 | [[05_Launcher卡片流程]] | 看桌面卡片怎么显示和控制蓝牙音乐。 |
+| 7 | [[06_开发入口_风险点_测试清单]] | 开发前定位文件、风险点和测试项。 |
+
+## 最短主链路
+
+### 用户点击播放
+
+```text
+用户
+  ↓
+BluetoothMusicActivity.onClick()
+  ↓
+BtMusicViewModel.playBtMusic()
+  ↓
+BtMusicControlManager.playBtMusic()
+  ↓
+BtMusicManager.requestFocus()
+  ↓
+BtMusicAudioManager.requestAudioFocus()
+  ↓
+BtMusicManager.playBtMusic()
+  ↓
+BluetoothAvrcpClient.play()
+  ↓
+MediaControllerCompat.TransportControls.play()
+  ↓
+手机音乐 App 开始播放
+```
+
+### 手机切歌后刷新页面
+
+```text
+手机音乐 App 切歌
+  ↓
+Android 蓝牙栈 AVRCP 元数据变化
+  ↓
+MediaBrowserClient.onMetadataChanged()
+  ↓
+BluetoothAvrcpClient.onMetadataChanged()
+  ↓
+BtMusicManager 解析歌曲信息
+  ↓
+BtMusicViewModel.mLiveDataMusicInfo
+  ↓
+BluetoothMusicActivity 更新歌名/歌手/封面/时长
+  ↓
+BtInfoPushManager.sendMusicInfoToLauncher()
+  ↓
+Launcher 蓝牙音乐卡片更新
+```
+
+## 当前代码根路径
+
+```text
+F:\zdCode\tongli
+```
+
+## 蓝牙音乐最核心文件
+
+| 文件 | 作用 |
+|---|---|
+| `YX_BlueTooth\src\main\java\com\yaxon\bluetooth\main\BluetoothMusicActivity.java` | 蓝牙音乐页面。 |
+| `YX_BlueTooth\src\main\java\com\yaxon\bluetooth\viewmodel\BtMusicViewModel.java` | 页面状态和控制转发。 |
+| `YX_BluetoothSDK\src\main\java\com\yaxon\bluetoothsdk\manager\BtMusicControlManager.java` | 对外音乐控制入口。 |
+| `YX_BluetoothSDK\src\main\java\com\yaxon\bluetoothsdk\modules\BtMusicManager.java` | 蓝牙音乐核心业务。 |
+| `YX_BluetoothSDK\src\main\java\com\yaxon\bluetoothsdk\platform\BluetoothA2dpSinkClient.java` | A2DP 音频连接。 |
+| `YX_BluetoothSDK\src\main\java\com\yaxon\bluetoothsdk\platform\BluetoothAvrcpClient.java` | AVRCP 控制和歌曲信息。 |
+| `YX_BluetoothSDK\src\main\java\com\yaxon\bluetoothsdk\audio\BtMusicAudioManager.java` | 音频焦点和媒体按键。 |
+| `YX_Launcher\src\main\java\com\yaxon\launcher\card\BluetoothMusicCardView.java` | Launcher 蓝牙音乐卡片。 |
+