📚 课程目录第1章 MediaSession基础架构

1. MediaSession基础架构：组件职责、核心类关系、后台调度核心流程

1.1 组件职责与核心类一览

MediaSession 是 Android 多媒体后台调度的中枢，其架构围绕三个核心角色展开：MediaSession（会话）、MediaController（控制器）和 MediaSession.Callback（回调）。三者通过 Binder IPC 实现跨进程通信，使 UI 组件（如通知、锁屏、蓝牙设备）能够安全地操控后台播放器。

组件	职责	所在进程	生命周期
MediaSession	管理播放状态、元数据、播放控制接口，对外暴露	播放器进程（通常为 Service）	Service 创建 – 销毁
MediaController	通过与 Session 绑定，发送控制命令、接收状态回调	UI 进程（Activity / Fragment / 通知）	绑定 Session 后持续存活，解绑后释放
MediaSession.Callback	处理播放、暂停、跳过、搜索等指令的抽象回调	播放器进程	与 MediaSession 绑定后生效
MediaBrowserService	向客户端暴露可浏览的媒体库（常用于 Auto / Wear）	播放器进程	Service 创建 – 销毁

关键要点：MediaSession 不直接控制播放器，而是通过 Callback 将命令转发给具体播放引擎。这种解耦使得同一套 Session 可同时响应通知栏、蓝牙、锁屏等多个控制器。

1.2 核心类关系与Binder桥接

下图展示了 MediaSession、MediaController 与 Callback 之间的通信架构。Session 持有 PlaybackState 和 Metadata，Controller 通过向 Session 发送 play/pause 等命令，Session 将命令分发给 Callback 执行，并广播状态变化到所有绑定的 Controller。

1.3 后台调度核心流程详解

当用户通过通知栏点击“暂停”按钮时，完整的事件调度路径如下：

控制器接收输入：系统 UI 或远程控制端调用 controller.getTransportControls().pause()。
IPC 传输：Binder 将命令序列化发送到 MediaSession 所在进程。
Session 分发：MediaSession 解析命令，调用已注册的 Callback.onPause()。
回调执行：开发者实现的 onPause() 中调用播放器暂停逻辑。
状态反馈：回调内调用 session.setPlaybackState(...) 更新最新状态。
广播回调：Session 将新状态通过 Binder 回传给所有连接的 MediaController.Callback。

调试技巧：使用 adb shell dumpsys media_session 查看当前所有活跃会话、、状态及绑定 Controller 列表，是定位后台调度问题最直接的手段。

1.4 基础代码实现：创建MediaSession与注册Callback

以下代码展示了在 MusicService（前台 Service）中创建 MediaSession、注册 Callback 并关联播放器引擎的完整示例。

public class MusicService extends Service {
    private MediaSession mediaSession;
    private ExoPlayer player;

    @Override
    public void onCreate() {
        super.onCreate();
        
        // 1. 创建 MediaSession（需要唯一标识）
        mediaSession = new MediaSession(this, "MusicServiceSession");
        
        // 2. 设置标记：支持媒体控制、传输控制
        mediaSession.setFlags(
            MediaSession.FLAG_HANDLES_MEDIA_BUTTONS |
            MediaSession.FLAG_HANDLES_TRANSPORT_CONTROLS
        );
        
        // 3. 设置回调
        mediaSession.setCallback(new MediaSession.Callback() {
            @Override
            public void onPlay() {
                player.setPlayWhenReady(true);
                updatePlaybackState(PlaybackState.STATE_PLAYING);
            }
            
            @Override
            public void onPause() {
                player.setPlayWhenReady(false);
                updatePlaybackState(PlaybackState.STATE_PAUSED);
            }
            
            @Override
            public void onSeekTo(long pos) {
                player.seekTo(pos);
                updatePlaybackState(PlaybackState.STATE_PLAYING);
            }
        });
        
        // 4. 初始化 ExoPlayer
        player = new ExoPlayer.Builder(this).build();
        
        // 5. 设置初始播放状态（默认无媒体）
        PlaybackState state = new PlaybackState.Builder()
                .setState(PlaybackState.STATE_NONE, 0, 1.0f)
                .build();
        mediaSession.setPlaybackState(state);
    }
    
    private void updatePlaybackState(int state) {
        PlaybackState ps = new PlaybackState.Builder()
                .setState(state, player.getCurrentPosition(), player.getPlaybackSpeed())
                .build();
        mediaSession.setPlaybackState(ps);
    }
    
    @Override
    public IBinder onBind(Intent intent) {
        return null; // 不提供绑定接口，使用  通信
    }
    
    @Override
    public int onStartCommand(Intent intent, int flags, int startId) {
        return START_STICKY; // Service 被杀死后自动重启
    }
    
    @Override
    public void onDestroy() {
        if (mediaSession != null) {
            mediaSession.release();
        }
        if (player != null) {
            player.release();
        }
        super.onDestroy();
    }
}

1.5 调试方法：确认后台调度是否正常工作

日志过滤：在 Callback 各方法入口添加 Log.d("MediaSession", "onPause called")，观察输出。
dumpsys 验证：执行 adb shell dumpsys media_session | grep -A 20 "MusicServiceSession"，检查状态是否更新。
通知集成测试：搭配 MediaStyle 通知，点击按钮后观察回调触发及状态同步。
常见错误：若 Service 未设为前台（startForeground），Android 8.0 以上会在几秒内杀死 Service，导致 Session 意外释放。

性能优化提示：Callback 内不应执行耗时的磁盘或网络操作，否则会阻塞 Binder 线程池。长时间操作应另开子线程或使用 Handler 异步执行。

1.6 核心流程表格：状态转换与广播

触发动作	回调方法	状态变更 (PlaybackState)	广播范围
用户点击播放	`onPlay()`	STATE_PLAYING	所有绑定的 Controller
用户点击暂停	`onPause()`	STATE_PAUSED	所有绑定的 Controller
拖动进度条	`onSeekTo(long)`	STATE_PLAYING 或 STATE_PAUSED	所有绑定的 Controller
播放完成	`onStop()`（可选）	STATE_STOPPED	所有绑定的 Controller

1.7 常见错误与避坑

缺少 FLAG：未设置 FLAG_HANDLES_TRANSPORT_CONTROLS 导致通知栏控制按钮无效。
泄漏：Activity 销毁时未释放 MediaController，造成 Session 端残留引用。
状态不同步：CallBack 内更新状态时未调用 setPlaybackState()，Controller 仍显示旧状态。
Service 进程被杀：未调用 startForeground() 导致系统在后台回收 Service，Session 消失。

掌握 MediaSession 的基础架构是设计稳定后台调度方案的前提。下一阶段我们将深入 MediaBrowserService 的绑定流程与媒体库浏览实现。