Android 实时监听耳机按钮事件

写作背景：最近在做视频播放器，客户提出两项新需求：

• 插耳机看视频，拔出耳机，视频需要暂停。(Android 实时监听耳机拔出事件)
• 视频播放时，按耳机按钮，视频暂停播放；再按耳机按钮，视频暂停。

如何实时的监听耳机按钮的事件，使得视频可以播放或者暂停呢？

step1：点击耳机按钮，我们会收到什么样的Intent？

点击耳机按钮（Media Button）后，会发送ACTION_MEDIA_BUTTON这个Intent Action，定义如下：

/**
     * Broadcast Action:  The "Media Button" was pressed.  Includes a single
     * extra field, {@link #EXTRA_KEY_EVENT}, containing the key event that
     * caused the broadcast.
     */
    @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION)
    public static final String ACTION_MEDIA_BUTTON = "android.intent.action.MEDIA_BUTTON";

从以上定义可以看到，在intent上包含一个额外的附加值：EXTRA_KEY_EVENT。这个附加值就是点击Media Button时的按键码（previous/next/pause）。通过获取这个按键码（KeyEvent）来判断用户点击了哪个按键，从而作相应的操作。

   //获得触发的Action 
   String action = intent.getAction() ;
   //获取KeyEvent对象
   KeyEvent event = intent.getParcelableExtra(Intent.EXTRA_KEY_EVENT);
   //获取按键触发的时间
   long eventtime = event.getEventTime();
   //获得按键码  
   int keycode = event.getKeyCode();

至此，我们知道了点击Media Button我们会收到什么样的intent，并且知道了如何获取intent上附带的按键码，接下来，我们需要了解，我们如何获取到这个intent，并根据不同按键码控制视频/音乐呢？

step2：如何获得Media Button发送的intent，并根据keycode不同作出不同的响应？

Android并没有定义“响应和接收耳机按钮事件”的广播类，但我们可以自定义一个MediaButtonReceiver类来完成这一功能。MediaButtonReceiver显然必须是一个广播接收器，继承BroadbcastReceiver类，并重写onReceive方法。同时，MediaButtonReceiver类需要用AudioManager注册，使它能成为Media Button的唯一接收器。
下面代码举例整个过程：

1. 在AndroidManifest.xml中声明自定义的广播类:

        <receiver android:name="MediaButtonReceiver">
            <intent-filter >
                <action android:name="android.intent.action.MEDIA_BUTTON"/>
            </intent-filter>
        </receiver>

2. 自定义MediaButtonReceiver类继承自BroadcastReceiver类

import android.content.BroadcastReceiver;  
import android.content.Context;  
import android.content.Intent;  
import android.util.Log;  
import android.view.KeyEvent;  
  
public class MediaButtonReceiver extends BroadcastReceiver {  
    private static String TAG = "MediaButtonReceiver";  

    @Override
    public void onReceive(Context context, Intent intent) {

        String action = intent.getAction();

        // 获得KeyEvent对象
        KeyEvent event = intent.getParcelableExtra(Intent.EXTRA_KEY_EVENT);

        if (Intent.ACTION_MEDIA_BUTTON.equals(action)) {

            // 获得按键码
            int keycode = event.getKeyCode();

            switch (keycode) {
                case KeyEvent.KEYCODE_MEDIA_NEXT:
                    //播放下一首
                    break;
                case KeyEvent.KEYCODE_MEDIA_PREVIOUS:
                    //播放上一首
                    break;
                case KeyEvent.KEYCODE_HEADSETHOOK:
                    //中间按钮,暂停or播放
                    //可以通过发送一个新的广播通知正在播放的视频页面,暂停或者播放视频
                    break;
                default:
                    break;
            }
        }
    }
}  

3.注册和注销自定义的MediaButtonReceiver类
在视频播放界面,注册监听类,实现在该页面可以接收到耳机按钮的广播事件......

//获得AudioManager对象  
AudioManager mAudioManager =(AudioManager) getSystemService(Context.AUDIO_SERVICE);     

//构造一个ComponentName，指向MediaoButtonReceiver类  
ComponentName  mComponent = new ComponentName(getPackageName(), MediaButtonReceiver.class.getName());  

//注册一个MediaButtonReceiver广播监听  
mAudioManager.registerMediaButtonEventReceiver(mComponent);  

//注销方法
mAudioManager.unregisterMediaButtonEventReceiver(mComponent);

至此，第二个需求已经完成，感谢收看！
END

如果你一不小心，已经看完了，恭喜你，并没有彩蛋。
我只能祝福你成为
一个年轻的梦想者，
热爱代码，
不受束缚！