Android耳机线控-播放/暂停/上一曲/下一曲
起因
前一阵子完成了用有线耳机控制Android手机App的音频播放，具体实现了用耳机线的按键完成播放、暂停、上一曲、下一曲的功能。在网上查阅了一些资料，但不是特别尽如人意，记得有一篇写的很不错的这方面的文章里有两处很细微的错误，我不经分辨拿来用的时候没有达到我想要的线控效果。后来从头做起，每写完一块代码，就进行打Log测试，查看输出日志是否实现了我期待的结果。就这样一步一步，最后完美解决。我想这种方式可能是我以后处理问题的一种可以遵循的步骤，故此在这里简略记录我当时的操作过程，也许未来于己于人有细微的帮助呢~
初始状态
- 耳机为有线耳机，耳机上共有3个按键，分别是音量+键，暂停/播放键，音量-键；
- app播放音频，耳机音量+/-键可控制系统音量，app内的音频音量亦增/减
- 按压耳机播放/暂停键，启动系统的音乐播放器，app内音频无影响
期待的状态
- 在耳机上中下3按键分别是音量+、播放/暂停、音量-的功能时，单击中键实现暂停/播放，双击中键实现下一曲，三连击中键实现上一曲
- 在耳机上中下3按键分别是上一曲、播放/暂停、下一曲的功能时，单击上键实现上一曲，单击中键实现播放/暂停，单击下键实现下一曲
- App在后台播放音频时，依然接收耳机按键的控制
尝试1
在AndroidManifest.xml 中添加：
".audio.PlayerService.HeadsetButtonReceiver">
"1000">
"android.intent.action.MEDIA_BUTTON" />
- 解释上述代码：
- 许多线控或者无线耳机都会有许多媒体播放控制按钮，例如：播放，停止，暂停，下一曲，上一曲等。无论用户按下设备上任意一个控制按钮，系统都会广播一个带有ACTION_MEDIA_BUTTON的Intent。为了正确地响应这些操作，需要在Manifest文件中注册一个针对于该Action的BroadcastReceiver（ 详见）。
- 第一行：声明要接收到MEDIA_BUTTON广播的广播接收器，该接收器是一个类，需要程序猿在对应的位置新建这样的广播接收器
- 第二行：注册Intent Filter过滤器，设置该App接收到MEDIA_BUTTON广播的优先级为1000
-
第三行：设置该接收器要接收的广播
在程序的对应位置新建类：
public class HeadsetButtonReceiver extends BroadcastReceiver {
@Override
public void onReceive(Context context, Intent intent) {
Log.e("headSet","HeadsetButtonReceiver："+"onReceive");
if(Intent.ACTION_MEDIA_BUTTON.equals(intent.getAction())){
Log.e("headSet","HeadsetButtonReceiver："+"onReceive:"+"if:");
KeyEvent keyEvent = (KeyEvent) intent.getParcelableExtra(Intent.EXTRA_KEY_EVENT);
if(keyEvent.KEYCODE_MEDIA_PLAY == keyEvent.getKeyCode()){
Log.e("headSet","HeadsetButtonReceiver："+"onReceive:"+"if:"+"if");
}
}
}
}- 解释上述代码：
- 在新建的广播接收器HeadsetButtonReceiver中重写onReceive()方法，当耳机按键广播被该接收器接收到后，将进入onReceive()中
- 在实现中，需要判断这个广播来自于哪一个按钮，Intent通过EXTRA_KEY_EVENT这一Key包含了该信息，另外，KeyEvent类包含了一系列诸如KEYCODE_MEDIA_*的静态变量来表示不同的媒体按钮，例如KEYCODE_MEDIA_PLAY_PAUSE 与 KEYCODE_MEDIA_NEXT。
- 根据三层不同的嵌套深度，分别输出日志，意欲判断程序运行时按压耳机按键，程序会执行到哪一步。
尝试1的结果
并不能拦截按键事件，启动App音频后点击耳机”播放“键，直接启动系统音乐播放器，而不是暂停App音频。
尝试2
继续网络搜索，发现需要首先注册/取消注册receiver，故在HeadsetButtonReceiver类中添加如下两个方法：
public void registerHeadsetReceiver(Context context) {
AudioManager audioManager = (AudioManager) context.getSystemService(Context.AUDIO_SERVICE);// 另说context.AUDIO_SERVICE
ComponentName name = new ComponentName(context.getPackageName(), HeadsetButtonReceiver.class.getName());// 另说MediaButtonReceiver.class.getName()
audioManager.registerMediaButtonEventReceiver(name);
}
public void unregisterHeadsetReceiver(Context context){
AudioManager audioManager = (AudioManager) context.getSystemService(Context.AUDIO_SERVICE);
ComponentName name = new ComponentName(context.getPackageName(), HeadsetButtonReceiver.class.getName());
audioManager.unregisterMediaButtonEventReceiver(name);
}- 解释上述代码：
- 两个方法的功能分别是注册该广播接收器、销毁该广播接收器。
- 注意到registerHeadsetReceiver()方法中的第一行和第二行的注释，第一行的注释为之前看过某篇文档的写法；第二行注释提醒说ComponentName(参数1，参数2)中参数2是当前广播接收器的类名。
之后在App定义的音频播放类的onCreate方法中调用registerHeadsetReceiver，在该类的onDestroy方法中调用un registerHeadsetReceiver。
尝试2的结果
打开app，按压耳机的”播放“按钮，可以监听到：
03-01 15:08:16.432 11059-11059/com.xxxxx.xxx E/headSet: HeadsetButtonReceiver：onReceive
03-01 15:08:16.432 11059-11059/com.xxxxx.xxx E/headSet: HeadsetButtonReceiver：onReceive:if:
尝试3
因为尝试2的结果只打印出了两个Log，程序不满足第三个if的判断条件。故更新该类（广播接收器）中的onReceive方法如下：
public void onReceive(Context context, Intent intent) {
Log.e("headSet","HeadsetButtonReceiver："+"onReceive");
if(Intent.ACTION_MEDIA_BUTTON.equals(intent.getAction())){
Log.e("headSet","HeadsetButtonReceiver："+"onReceive:"+"if:");
KeyEvent keyEvent = (KeyEvent) intent.getParcelableExtra(Intent.EXTRA_KEY_EVENT);
if(keyEvent.KEYCODE_MEDIA_PLAY == keyEvent.getKeyCode()){
Log.e("headSet","HeadsetButtonReceiver："+"onReceive:"+"if:"+"if");
}else {
Log.e("headSet","keyEvent="+keyEvent);
}
}
}尝试3的结果
打开app，按压耳机的”播放“按钮，可以监听到：
03-01 15:08:16.432 11059-11059/com.xxxxx.xxx E/headSet: HeadsetButtonReceiver：onReceive
03-01 15:08:16.432 11059-11059/com.xxxxx.xxx E/headSet: HeadsetButtonReceiver：onReceive:if:
03-01 15:08:16.435 11059-11059/com.xxxxx.xxx E/headSet: keyEvent=KeyEvent { action=ACTION_DOWN, keyCode=KEYCODE_HEADSETHOOK, scanCode=164, metaState=0, flags=0x8, repeatCount=0, eventTime=19326753, downTime=19326534, deviceId=4, source=0x101 }
03-01 15:08:16.445 11059-11059/com.xxxxx.xxx E/headSet: HeadsetButtonReceiver：onReceive
03-01 15:08:16.445 11059-11059/com.xxxxx.xxx E/headSet: HeadsetButtonReceiver：onReceive:if:
03-01 15:08:16.445 11059-11059/com.xxxxx.xxx E/headSet: keyEvent=KeyEvent { action=ACTION_UP, keyCode=KEYCODE_HEADSETHOOK, scanCode=164, metaState=0, flags=0x8, repeatCount=0, eventTime=19326753, downTime=19326534, deviceId=4, source=0x101 }
从输出的Log日志可以看到，按压耳机的播放/暂停键时，广播接收器接收到了两个动作，分别是action=ACTION_DOWN和action=ACTION_UP，keyCode均为keyCode=KEYCODE_HEADSETHOOK。故此修改尝试3中的代码，并充实onReceive方法。要实现的功能是播放/暂停，下一曲，上一曲。针对市面上有线耳机按键大多数包括两个+-键，一个功能键，需要处理两种情况：1）+-为音量键，单击功能键实现播放/暂停，双击实现下一曲，三连击实现上一曲。2）+-为下一曲/上一曲键，单击功能键实现播放/暂停。如下：
@Override
public void onReceive(Context context, Intent intent) {
Log.e("headSet","HeadsetButtonReceiver："+"onReceive:");
if(Intent.ACTION_MEDIA_BUTTON.equals(intent.getAction())) {
Log.e("headSet","HeadsetButtonReceiver："+"onReceive:"+"if:");
KeyEvent keyEvent = intent.getParcelableExtra(Intent.EXTRA_KEY_EVENT);
if (keyEvent.getKeyCode() == KeyEvent.KEYCODE_HEADSETHOOK && keyEvent.getAction() == KeyEvent.ACTION_UP) {
Log.e("headSet","HeadsetButtonReceiver："+"onReceive:"+"if:"+"if"+" HEADSETHOOK");
} else if (keyEvent.getKeyCode() == KeyEvent.KEYCODE_MEDIA_NEXT) {
Log.e("headSet","HeadsetButtonReceiver："+"onReceive:"+"if:"+"if"+" KEYCODE_HEADSETHOOK");
} else if (keyEvent.getKeyCode() == KeyEvent.KEYCODE_MEDIA_PREVIOUS) {
Log.e("headSet","HeadsetButtonReceiver："+"onReceive:"+"if:"+"if"+ " KEYCODE_MEDIA_PREVIOUS");
}
}
}打开app，按压耳机的”播放“按钮，可以监听到Log: “HeadsetButtonReceiver：onReceive:if:if KEYCODE_HEADSETHOOK”
尝试4
到目前为止，可以收到耳机按键广播，并可进入指定位置。接下来开始实现具体功能，即：三连击中键，实现上一曲；双击中键，实现下一曲；单击中键，实现播放/暂停。要求在1000ms内监听按中键的次数，并将监听按键次数的动作、响应按键次数的事件放到子线程中执行。故丰富onReceive()方法，新建定时器类HeadsetTimerTask，执行定时结束后的响应；新建子线程，由子线程执行具体的响应。
@Override
public void onReceive(Context context, Intent intent) {
if(Intent.ACTION_MEDIA_BUTTON.equals(intent.getAction())) {
KeyEvent keyEvent = intent.getParcelableExtra(Intent.EXTRA_KEY_EVENT);
if (keyEvent.getKeyCode() == KeyEvent.KEYCODE_HEADSETHOOK && keyEvent.getAction() == KeyEvent.ACTION_UP) {
clickCount = clickCount + 1;
if(clickCount == 1){
HeadsetTimerTask headsetTimerTask = new HeadsetTimerTask();
timer.schedule(headsetTimerTask,1000);
}
} else if (keyEvent.getKeyCode() == KeyEvent.KEYCODE_MEDIA_NEXT) {
handler.sendEmptyMessage(2);
} else if (keyEvent.getKeyCode() == KeyEvent.KEYCODE_MEDIA_PREVIOUS) {
handler.sendEmptyMessage(3);
}
}
}
class HeadsetTimerTask extends TimerTask {
@Override
public void run() {
try{
if(clickCount==1){
handler.sendEmptyMessage(1);
}else if(clickCount==2){
handler.sendEmptyMessage(2);
}else if(clickCount>=3){
handler.sendEmptyMessage(3);
}
clickCount=0;
}catch (Exception e){
e.printStackTrace();
}
}
}
Handler handler = new Handler() {
@Override
public void handleMessage(Message msg) {
super.handleMessage(msg);
try {
if (msg.what == 1) {
headsetListener.playOrPause();
}else if(msg.what == 2){
headsetListener.playNext();
}else if(msg.what == 3){
headsetListener.playPrevious();
}
}catch (Exception e){
e.printStackTrace();
}
}
};
interface onHeadsetListener{
void playOrPause();
void playNext();
void playPrevious();
}
public void setOnHeadsetListener(onHeadsetListener newHeadsetListener){
headsetListener = newHeadsetListener;
}- 上述代码解释：
- onHeadsetListener是一个接口，内中定义的抽象方法应在对应的音频管理类中实现。
总结
耳机线控一共分为三部分：
第一部分
在AndroidManifest.xml中定义广播接收器，以及需要接收的广播：
".audio.PlayerService.HeadsetButtonReceiver">
"1000">
"android.intent.action.MEDIA_BUTTON" />
第二部分
实现该广播接收器：
package com.wdbible.app.wedevotebible.audio.PlayerService;
import android.content.BroadcastReceiver;
import android.content.ComponentName;
import android.content.Context;
import android.content.Intent;
import android.media.AudioManager;
import android.os.Handler;
import android.os.Message;
import android.view.KeyEvent;
import java.util.Timer;
import java.util.TimerTask;
/**
* Created by Jerre on 2018/3/1.
*/
public class HeadsetButtonReceiver extends BroadcastReceiver {
private Context context;
private Timer timer = new Timer();
private static int clickCount;
private static onHeadsetListener headsetListener;
public HeadsetButtonReceiver(){
super();
}
public HeadsetButtonReceiver(Context ctx){
super();
context = ctx;
headsetListener = null;
registerHeadsetReceiver();
}
@Override
public void onReceive(Context context, Intent intent) {
if(Intent.ACTION_MEDIA_BUTTON.equals(intent.getAction())) {
KeyEvent keyEvent = intent.getParcelableExtra(Intent.EXTRA_KEY_EVENT);
if (keyEvent.getKeyCode() == KeyEvent.KEYCODE_HEADSETHOOK && keyEvent.getAction() == KeyEvent.ACTION_UP) {
clickCount = clickCount + 1;
if(clickCount == 1){
HeadsetTimerTask headsetTimerTask = new HeadsetTimerTask();
timer.schedule(headsetTimerTask,1000);
}
} else if (keyEvent.getKeyCode() == KeyEvent.KEYCODE_MEDIA_NEXT) {
handler.sendEmptyMessage(2);
} else if (keyEvent.getKeyCode() == KeyEvent.KEYCODE_MEDIA_PREVIOUS) {
handler.sendEmptyMessage(3);
}
}
}
class HeadsetTimerTask extends TimerTask {
@Override
public void run() {
try{
if(clickCount==1){
handler.sendEmptyMessage(1);
}else if(clickCount==2){
handler.sendEmptyMessage(2);
}else if(clickCount>=3){
handler.sendEmptyMessage(3);
}
clickCount=0;
}catch (Exception e){
e.printStackTrace();
}
}
}
Handler handler = new Handler() {
@Override
public void handleMessage(Message msg) {
super.handleMessage(msg);
try {
if (msg.what == 1) {
headsetListener.playOrPause();
}else if(msg.what == 2){
headsetListener.playNext();
}else if(msg.what == 3){
headsetListener.playPrevious();
}
}catch (Exception e){
e.printStackTrace();
}
}
};
interface onHeadsetListener{
void playOrPause();
void playNext();
void playPrevious();
}
public void setOnHeadsetListener(onHeadsetListener newHeadsetListener){
headsetListener = newHeadsetListener;
}
public void registerHeadsetReceiver() {
AudioManager audioManager = (AudioManager) context.getSystemService(Context.AUDIO_SERVICE);
ComponentName name = new ComponentName(context.getPackageName(), HeadsetButtonReceiver.class.getName());
audioManager.registerMediaButtonEventReceiver(name);
}
public void unregisterHeadsetReceiver(){
AudioManager audioManager = (AudioManager) context.getSystemService(Context.AUDIO_SERVICE);
ComponentName name = new ComponentName(context.getPackageName(), HeadsetButtonReceiver.class.getName());
audioManager.unregisterMediaButtonEventReceiver(name);
}
}- 第三部分
-
在音频管理类中的构造方法中新建该广播接收器的实例对象（新建实例对象的过程中已完成该接收器的注册），在该类的onDestory()或者close()方法中注销该广播接收器。
- 在音频管理类中实现接口onHeadsetListener，并重写其中的抽象方法。
以上。