第3章 MediaPlaybackBinder实现：Binder接口设计、远程回调、跨进程通信要点

3.1 原理概述

MediaPlaybackBinder 是 MediaSession 框架中连接客户端（如 UI Activity）与后台播放服务（MediaPlaybackService）的核心 Binder 组件。它通过 Android Binder 驱动实现跨进程通信（IPC），允许客户端向服务发送播放控制指令，并实时接收播放状态回调。其设计需要遵循 Android Binder 接口规范，包括：

• 接口定义：使用 AIDL 声明服务端暴露的方法和客户端回调接口。
• 远程回调：将回调接口作为 Binder 对象传递给服务端，服务端在子线程同步或异步调用。
• 跨进程约束：处理线程模型、数据序列化、TRANSACTION_TOO_LARGE 异常及生命周期管理。

3.2 Binder 接口设计

定义 IMediaPlaybackService.aidl 描述服务端能力，以及 IPlaybackCallback.aidl 用于服务端向客户端发送状态变化。

// IMediaPlaybackService.aidl
package com.example.mediaplayer;
import com.example.mediaplayer.PlaybackState;
import com.example.mediaplayer.IPlaybackCallback;

interface IMediaPlaybackService {
    void play(int sessionId);
    void pause(int sessionId);
    void stop(int sessionId);
    void seekTo(int sessionId, long positionMs);
    int getCurrentPosition(int sessionId);
    void registerCallback(int sessionId, IPlaybackCallback callback);
    void unregisterCallback(int sessionId, IPlaybackCallback callback);
}

// IPlaybackCallback.aidl
package com.example.mediaplayer;

interface IPlaybackCallback {
    void onPlaybackStateChanged(in PlaybackState state);
    void onError(int errorCode, String message);
    void onBufferingUpdate(int percent);
}

PlaybackState 需要实现 Parcelable 接口，以便跨进程传输。

// PlaybackState.java
public class PlaybackState implements Parcelable {
    public int state;               // 0: idle, 1: playing, 2: paused, 3: stopped
    public long positionMs;
    public long durationMs;
    // ... Parcelable 实现省略
}

3.3 远程回调实现

服务端 MediaPlaybackService 内部维护一个 Binder 子类 PlaybackBinder 继承自 IMediaPlaybackService.Stub。当客户端通过 registerCallback 传入回调 Binder 时，服务端将其存储在 Map 中，并在状态变化时远程调用。

// 服务端 Binder 实现片段
public class PlaybackBinder extends IMediaPlaybackService.Stub {
    private final SparseArray<IPlaybackCallback> callbacks = new SparseArray<>();

    @Override
    public void registerCallback(int sessionId, IPlaybackCallback callback) throws RemoteException {
        synchronized (callbacks) {
            callbacks.put(sessionId, callback);
            // 可添加 DeathRecipient 监控回调 Binder 死亡
            callback.asBinder().linkToDeath(() -> {
                unregisterCallback(sessionId, callback);
            }, 0);
        }
    }

    public void notifyStateChanged(int sessionId, PlaybackState state) {
        synchronized (callbacks) {
            IPlaybackCallback cb = callbacks.get(sessionId);
            if (cb != null) {
                try {
                    cb.onPlaybackStateChanged(state);
                } catch (DeadObjectException e) {
                    callbacks.remove(sessionId);
                } catch (RemoteException e) {
                    // 日志记录
                }
            }
        }
    }
}

客户端绑定服务后，通过 asInterface 获取服务端代理，并注册回调。

// 客户端绑定与回调注册
private ServiceConnection connection = new ServiceConnection() {
    @Override
    public void onServiceConnected(ComponentName name, IBinder service) {
        IMediaPlaybackService playerService = IMediaPlaybackService.Stub.asInterface(service);
        try {
            playerService.registerCallback(sessionId, new IPlaybackCallback.Stub() {
                @Override
                public void onPlaybackStateChanged(PlaybackState state) throws RemoteException {
                    // UI 更新（需 post 到主线程）
                    runOnUiThread(() -> updateUI(state));
                }
                @Override
                public void onError(int errorCode, String message) throws RemoteException {
                    Log.e(TAG, "Remote error: " + message);
                }
                @Override
                public void onBufferingUpdate(int percent) throws RemoteException {
                    // 更新进度条
                }
            });
        } catch (RemoteException e) {
            e.printStackTrace();
        }
    }
    @Override
    public void onServiceDisconnected(ComponentName name) {
        // 服务异常终止，清理
    }
};

3.4 跨进程通信要点

oneway void onPlaybackStateChanged(in PlaybackState state);

3.5 跨进程通信架构图

3.6 调试方法

• Binder 日志：启用 Binder 事务跟踪 adb shell dumpsys binder 查看所有活跃 Binder 对象及事务统计；使用 android.os.Debug.startMethodTracing() 捕获调用栈。
• TransactionTooLargeException 检测：在 Android 9+ 可通过 StrictMode 设置 penaltyDeath() 提前在开发阶段抛出异常。
• 回调存活检查：为回调 Binder 注册 DeathRecipient，在服务端 linkToDeath 时打印日志，确认回调未意外断开。

// 启用 StrictMode 检测大事务（放在 Application.onCreate 中）
StrictMode.setVmPolicy(new StrictMode.VmPolicy.Builder()
        .detectActivityLeaks()
        .detectLeakedClosableObjects()
        .detectLeakedSqlLiteObjects()
        .penaltyLog()
        .build());

// 注册 DeathRecipient 示例
callback.asBinder().linkToDeath(() -> {
    Log.w(TAG, "Client callback died, sessionId=" + sessionId);
    callbacks.remove(sessionId);
}, 0);

3.7 常见错误与解决方案

3.8 性能与稳定性优化

• 减少跨进程拷贝：传递大量数据（如音频列表）时，使用 android.os.MemoryFile 或 ParcelFileDescriptor 共享内存，避免序列化整个集合。
• 批处理回调：对于高频状态变更（如进度更新），服务端可合并多次状态后一次性回调，使用 oneway 避免客户端 ANR。
• 对象池复用 Parcelable：在 onPlaybackStateChanged 回调中，服务端创建 PlaybackState 时使用静态对象池，减少 GC。

// 服务端使用对象池示例
public class PlaybackStatePool {
    private static final ArrayPool<PlaybackState> pool = new ArrayPool<>(5);
    public static PlaybackState obtain() { return pool.acquire() != null ? pool.acquire() : new PlaybackState(); }
    public static void recycle(PlaybackState state) { pool.release(state); }
}

• 异步通知：服务端的 notifyStateChanged 应在 HandlerThread 中执行，避免阻塞 Binder 线程池。