Service无法获取AVRCP焦点以正常接收媒体按键事件的问题咨询

嘿，我之前也遇到过几乎一模一样的问题！这本质上是Android系统的AudioFocus机制和媒体按键事件的分发优先级在搞事情。当有活跃的媒体播放器Activity在前台时，它会优先抢占AudioFocus和媒体按键事件，导致你的Service收不到信号。下面是我实测有效的解决步骤：

1. 先给你的Service拿下AudioFocus #

Android系统会把媒体按键事件优先分给持有AudioFocus的组件——哪怕你的Service根本不播放音频，只要拿到这个焦点，就能获得事件的优先处理权。

给你一段我用过的代码参考：

private AudioManager audioManager;
private AudioFocusRequest audioFocusRequest;

@Override
public void onCreate() {
    super.onCreate();
    audioManager = (AudioManager) getSystemService(AUDIO_SERVICE);
    
    // 构建AudioFocus请求，按媒体类属性来配置
    audioFocusRequest = new AudioFocusRequest.Builder(AudioManager.AUDIOFOCUS_GAIN)
            .setAudioAttributes(new AudioAttributes.Builder()
                    .setUsage(AudioAttributes.USAGE_MEDIA)
                    .setContentType(AudioAttributes.CONTENT_TYPE_MUSIC)
                    .build())
            .setOnAudioFocusChangeListener(focusChangeListener)
            .build();
    
    // 申请焦点，成功了再注册媒体按键接收器
    int result = audioManager.requestAudioFocus(audioFocusRequest);
    if (result == AudioManager.AUDIOFOCUS_REQUEST_GRANTED) {
        registerMediaButtonReceiver();
    }
}

// 监听焦点变化，及时注册/注销接收器
private AudioManager.OnAudioFocusChangeListener focusChangeListener = new AudioManager.OnAudioFocusChangeListener() {
    @Override
    public void onAudioFocusChange(int focusChange) {
        switch (focusChange) {
            case AudioManager.AUDIOFOCUS_LOSS:
                // 彻底失去焦点，清理资源
                unregisterMediaButtonReceiver();
                audioManager.abandonAudioFocusRequest(audioFocusRequest);
                break;
            case AudioManager.AUDIOFOCUS_LOSS_TRANSIENT:
                // 暂时失去焦点，先注销接收器，等焦点回来再注册
                unregisterMediaButtonReceiver();
                break;
            case AudioManager.AUDIOFOCUS_GAIN:
                // 重新拿到焦点，恢复监听
                registerMediaButtonReceiver();
                break;
        }
    }
};

2. 给你的广播接收器拉满优先级 #

动态注册媒体按键接收器的时候，把优先级设到最高，这样就算有其他接收器，你的Service也能先拿到事件。别忘了处理完事件后拦截它，别再传给媒体播放器了。

代码参考：

private BroadcastReceiver mediaButtonReceiver = new BroadcastReceiver() {
    @Override
    public void onReceive(Context context, Intent intent) {
        if (Intent.ACTION_MEDIA_BUTTON.equals(intent.getAction())) {
            KeyEvent event = intent.getParcelableExtra(Intent.EXTRA_KEY_EVENT);
            if (event != null && event.getAction() == KeyEvent.ACTION_DOWN) {
                // 这里处理你的按键逻辑，比如播放/暂停、切歌
                switch (event.getKeyCode()) {
                    case KeyEvent.KEYCODE_MEDIA_PLAY_PAUSE:
                        // 你的处理逻辑
                        break;
                    case KeyEvent.KEYCODE_MEDIA_NEXT:
                        // 你的处理逻辑
                        break;
                }
                // 关键！拦截事件，不让它再传给其他应用
                abortBroadcast();
            }
        }
    }
};

private void registerMediaButtonReceiver() {
    IntentFilter filter = new IntentFilter(Intent.ACTION_MEDIA_BUTTON);
    // 设置系统最高优先级
    filter.setPriority(IntentFilter.SYSTEM_HIGH_PRIORITY);
    registerReceiver(mediaButtonReceiver, filter);
}

private void unregisterMediaButtonReceiver() {
    try {
        unregisterReceiver(mediaButtonReceiver);
    } catch (IllegalArgumentException e) {
        // 接收器没注册的话，直接忽略就行
    }
}

3. 收尾工作要做好 #

在你的Service销毁的时候，一定要记得释放AudioFocus并注销广播接收器，避免内存泄漏：

@Override
public void onDestroy() {
    super.onDestroy();
    unregisterMediaButtonReceiver();
    audioManager.abandonAudioFocusRequest(audioFocusRequest);
}

为啥之前没启动媒体播放器时正常？ #

很简单——那时候系统里没有其他高优先级的媒体组件，所以你的Service的接收器就能稳稳拿到事件。但媒体播放器Activity启动后，它会默认注册高优先级的接收器，还会抢占AudioFocus，自然就把事件截胡了。

内容的提问来源于stack exchange，提问作者br.