如何用ImageButton与ExoPlayer实现离开Activity后的音频播放控制

我已经在Activity中使用ExoPlayer实现了音频播放功能，同时集成了MediaSessionCompat.Callback来支持通过通知及App Widget控制音频播放，相关代码如下：

PendingIntent playPausePendingIntent = MediaButtonReceiver.buildMediaButtonPendingIntent(context, PlaybackStateCompat.ACTION_PLAY_PAUSE);
views.setOnClickPendingIntent(R.id.btnPlay, playPausePendingIntent);
views.setImageViewResource(R.id.btnPlay, icon);

现在遇到的问题是：离开该Activity后，无法通过ImageButton控制正在播放的音频，该如何解决？

核心问题在于：你的播放逻辑（ExoPlayer + MediaSession）当前是绑定在Activity生命周期上的，当Activity被销毁后，对应的上下文和回调都会失效，自然无法响应来自通知或Widget的控制事件。要解决这个问题，你需要把播放逻辑迁移到后台Service中，具体步骤如下：

1. 将ExoPlayer和MediaSession迁移到Service #

创建一个继承自Service的媒体播放服务（比如MediaPlaybackService），把ExoPlayer的初始化、播放控制、MediaSession的配置全部放在这个Service里。Service是后台组件，能在Activity销毁后继续运行，确保播放任务和控制逻辑不中断。

示例代码片段：

public class MediaPlaybackService extends Service {
    private ExoPlayer exoPlayer;
    private MediaSessionCompat mediaSession;

    @Override
    public void onCreate() {
        super.onCreate();
        // 初始化ExoPlayer
        exoPlayer = new ExoPlayer.Builder(this).build();
        
        // 初始化MediaSession并设置回调
        mediaSession = new MediaSessionCompat(this, "AudioPlaybackSession");
        mediaSession.setCallback(new MediaSessionCompat.Callback() {
            @Override
            public void onPlay() {
                exoPlayer.play();
                updatePlaybackState(PlaybackStateCompat.STATE_PLAYING);
                updateAppWidgetAndNotification();
            }

            @Override
            public void onPause() {
                exoPlayer.pause();
                updatePlaybackState(PlaybackStateCompat.STATE_PAUSED);
                updateAppWidgetAndNotification();
            }
        });
        // 激活MediaSession，使其能接收媒体按钮事件
        mediaSession.setActive(true);
    }

    // 更新MediaSession的播放状态
    private void updatePlaybackState(int state) {
        PlaybackStateCompat.Builder stateBuilder = new PlaybackStateCompat.Builder()
                .setActions(PlaybackStateCompat.ACTION_PLAY_PAUSE);
        stateBuilder.setState(state, exoPlayer.getCurrentPosition(), 1.0f);
        mediaSession.setPlaybackState(stateBuilder.build());
    }

    @Nullable
    @Override
    public IBinder onBind(Intent intent) {
        return null;
    }

    @Override
    public void onDestroy() {
        super.onDestroy();
        exoPlayer.release();
        mediaSession.release();
    }
}

2. 更新PendingIntent的目标为Service #

原来的PendingIntent是基于Activity的Context创建的，现在需要修改为指向你的媒体播放Service，这样点击通知或Widget的ImageButton时，事件会发送到后台Service，而不是已经销毁的Activity。

修改PendingIntent的创建代码：

// 在Service或WidgetProvider中创建PendingIntent
ComponentName mediaServiceComponent = new ComponentName(context, MediaPlaybackService.class);
PendingIntent playPausePendingIntent = MediaButtonReceiver.buildMediaButtonPendingIntent(
        context,
        PlaybackStateCompat.ACTION_PLAY_PAUSE,
        mediaServiceComponent
);

3. 实现App Widget和通知的UI更新 #

当播放状态变化时（播放/暂停），需要主动更新App Widget和通知的ImageButton图标，确保用户看到的UI和实际播放状态一致。在Service中添加更新逻辑：

private void updateAppWidgetAndNotification() {
    // 更新App Widget
    AppWidgetManager appWidgetManager = AppWidgetManager.getInstance(this);
    RemoteViews widgetViews = new RemoteViews(getPackageName(), R.layout.your_widget_layout);
    
    int playPauseIcon = exoPlayer.isPlaying() ? R.drawable.ic_pause : R.drawable.ic_play;
    widgetViews.setImageViewResource(R.id.btnPlay, playPauseIcon);
    // 重新设置PendingIntent（确保指向Service）
    ComponentName serviceComponent = new ComponentName(this, MediaPlaybackService.class);
    PendingIntent intent = MediaButtonReceiver.buildMediaButtonPendingIntent(
            this, PlaybackStateCompat.ACTION_PLAY_PAUSE, serviceComponent);
    widgetViews.setOnClickPendingIntent(R.id.btnPlay, intent);
    
    appWidgetManager.updateAppWidget(new ComponentName(this, YourWidgetProvider.class), widgetViews);

    // 更新通知（如果使用前台服务）
    NotificationCompat.Builder notificationBuilder = new NotificationCompat.Builder(this, "your_channel_id")
            .setSmallIcon(R.drawable.ic_audio)
            .setContentTitle("正在播放")
            .setContentIntent(PendingIntent.getActivity(this, 0, new Intent(this, YourMainActivity.class), PendingIntent.FLAG_UPDATE_CURRENT))
            .addAction(playPauseIcon, "播放/暂停", intent);
    
    // 启动前台服务（Android 8.0+要求后台音频播放使用前台服务）
    startForeground(1, notificationBuilder.build());
}

4. 配置Service的生命周期 #

为了确保Service在后台稳定运行，建议使用前台服务（Android 8.0及以上版本，后台音频播放必须使用前台服务，否则会被系统限制）。在Service的onStartCommand中返回START_STICKY，这样即使系统内存不足杀死Service，后续也会尝试重启它。

@Override
public int onStartCommand(Intent intent, int flags, int startId) {
    // 处理来自MediaButtonReceiver的事件
    MediaButtonReceiver.handleIntent(mediaSession, intent);
    return START_STICKY;
}

最后一步：在Manifest中注册Service #

别忘了在AndroidManifest.xml中注册你的媒体播放Service，并声明必要的权限：

<uses-permission android:name="android.permission.FOREGROUND_SERVICE" />
<uses-permission android:name="android.permission.FOREGROUND_SERVICE_MEDIA_PLAYBACK" />

<application ...>
    <service android:name=".MediaPlaybackService"
             android:foregroundServiceType="mediaPlayback" />
</application>

这样改造后，即使离开原Activity，后台的Service依然会持有ExoPlayer和MediaSession，通知和Widget的ImageButton点击事件会被Service接收并处理，就能正常控制音频播放了。

内容的提问来源于stack exchange，提问作者Jean-Pascal MEWENEMESSE