Android 多媒体控制 来电监听-耳机插拔监听-耳机按钮监听-MediaSession-MediaStyle

这个系列仅仅包含控制部分 , 不包含音频操作代码 , 如 pauseAudio(); 我不会说这个方法里是怎么操作的 , 大家需要结合自己的音频播放处理来实现.

Android多媒体控制

一个完整的多媒体播放器应该有的基础功能:

• 通过耳机按钮来控制歌曲 播放/暂停 上/下一首歌曲
• 当有线耳机/蓝牙耳机 断开连接和重新连接的时候 我们应该对应做出 暂停音频 恢复音频
• 使用系统提供的Notification.MediaStyle来控制歌曲 , 可以顺利兼容 android 4.x ~ android 7.x 现在的系统样式

[[广告]] https://github.com/ocwvar/DarkPurple

需要代码样例的同学可以在我的这个项目中查看 这个项目是个完整的音频播放器 这里的代码均是从里面提取 , 同时还有均衡器调节 频谱动画显示等.. 目前正在不断完善中 , 但由于上班 , 代码更新可能不及时.

###1. 创建 MediaSessionCompat 对象

MediaSessionCompat sessionCompat = new MediaSessionCompat();

在这个构造方法中 , 我们使用这个:

MediaSessionCompat(Context context, String tag, ComponentName mbrComponent, PendingIntent mbrIntent)

//第一个参数 context: 这个没有什么好讲的,大家都懂的
//第二个参数 tag: 这个是用于调试用的,随便填写即可
//第三个参数 mbrComponent: 这个是用于API21以下的时候传递耳机按钮事件用的MediaSessionCompat.
//第四个参数 mbrIntent: 这个是给API21以下传递的时候携带的,一般设为 NULL即可

//例如:
//其中的HeadsetButtonReceiver是我们的API21以下实用的监听器 , 我们稍候再讲
ComponentName cn = new ComponentName(this.context.getApplicationContext().getPackageName(),
          HeadsetButtonReceiver.class.getName())
sessionCompat = new MediaSessionCompat(this.context.getApplicationContext(), "test", cn, null);

参数设置

sessionCompat = new MediaSessionCompat(...);

//设置MediaSession回调监听,主要用于设置API21+的耳机按钮监听
sessionCompat.setCallback(new MediaSessionCallback());

//设置FLAG,FLAG的用途一看名字就知道了
sessionCompat.setFlags(MediaSessionCompat.FLAG_HANDLES_MEDIA_BUTTONS);

//设置MediaSession启动 (很重要,不启动则无法接受到数据)
sessionCompat.setActive(true);

2. 耳机多媒体按钮监听

API 21+ 的方式 MediaSessionCompat.Callback

//创建完成后用MediaSessionCompat.setCallback设置上即可使用

private class MediaSessionCallback extends MediaSessionCompat.Callback {

        @Override
        public boolean onMediaButtonEvent(Intent mediaButtonEvent) {

            //接收到监听事件

        }

    }

API21- 的方式 HeadsetButtonReceiver

//在代码中创建一个单独的类文件,而不能作为一个内部类

public class HeadsetButtonReceiver extends BroadcastReceiver {

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

        //接收到监听事件

    }

}

//然后在注册文件中注册这个接收器

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

//最后在创建MediaSessionCompat对象的时候使用即可

3. Notification.MediaStyle 的创建

MediaStyle是什么样子的Notification呢?

在**Android 4.x**的是这样的 

在**Android 5.x ~ 6.x** 的是这样的 

在**Android 7.0** 的是这样的  MediaStyle使用的都是系统资源 , 除了布局之外 , 可以自定义的有: > 封面图片 标题 副标题 按钮样式 背景颜色 使用MediaStyle的优点是不用担心因系统变化而导致布局的变化 , 以及可以使用MediaSession作为我们的控制中介 , 虽然这部分不能自定义但个人认为还是挺值得的 .

对应的一个还有一个是Style是 **DecoratedMediaCustomViewStyle** 这个是可以提供部分自定义 , 但是修改部分仅是标题文字那部分的布局而已 , 并没有什么太大的作用 .

####**Notification.MediaStyle 创建代码** PS:我们分开一段段讲 ( 代码太长了不好排版…. )

####**Part.1 基础部分**

//创建 Notification 构建器
final NotificationCompat.Builder builder = new NotificationCompat.Builder(context);

//创建 MediaStyle 对象
final NotificationCompat.MediaStyle mediaStyle = new NotificationCompat.MediaStyle(builder);

    //在折叠的视图中显示的按钮序号  根据下面设置的ACTION顺序相关
    mediaStyle.setShowActionsInCompactView(0,1);

    //设置上面创建的MediaSession    
    mediaStyle.setMediaSession(sessionCompat.getSessionToken());

    //设置 MediaStyle 风格
    builder.setStyle(mediaStyle);

    //不显示默认的通知开始时间
    builder.setShowWhen(false);

    //仅通知一次
    builder.setOnlyAlertOnce(true);

    //设置为当前正在运行状态,不能清除
    builder.setOngoing(true);

    //设置点击时不隐藏Notification
    builder.setAutoCancel(false);

    //设置状态栏上面显示的小图标
    builder.setSmallIcon(R.drawable.ic_action_small_icon);

    //设置锁屏是否显示 在 Android5.0+ 的锁屏界面可以隐藏Notification内容
    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.LOLLIPOP) {
        builder.setVisibility(Notification.VISIBILITY_PUBLIC);
    }

    //设置通知优先度,让我们的 Notification 显示在最上面
    builder.setPriority(Notification.PRIORITY_MAX);

    //设置通知类别为服务
    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.LOLLIPOP) {
        builder.setCategory(Notification.CATEGORY_SERVICE);
    }

    //点击通知操作 使得用户点击Notification空白区域的时候打开指定的Activity
    Intent intent = new Intent(context, SelectMusicActivity.class);
    intent.setAction(Intent.ACTION_MAIN);
    intent.addCategory(Intent.CATEGORY_LAUNCHER);
    PendingIntent pendingIntent = PendingIntent.getActivity(context, 0, intent, 0);
    builder.setContentIntent(pendingIntent);

Part.2 创建和设置Action按钮

    /** * 生成按钮Action * * @param icon 图标资源 * @param intentAction 按钮产生的广播Action * @return 按钮Action */
    private NotificationCompat.Action generateAction(int icon, String intentAction ) {
        return new NotificationCompat.Action( icon, intentAction, PendingIntent.getBroadcast(context, 0, new Intent(intentAction), PendingIntent.FLAG_CANCEL_CURRENT) );
    }

//根据播放状态不同 , 设置不同主按钮样式 , 这里的设置顺序影响到折叠界面显示的顺序

//上一首 按钮ACTION
builder.addAction(generateAction(android.R.drawable.ic_media_previous,MediaNotificationReceiver.BUTTON_PREV));
switch (audioStatus) {
    case Paused:
        //播放 按钮ACTION
        builder.addAction(generateAction(android.R.drawable.ic_media_play,MediaNotificationReceiver.BUTTON_PLAY));
        break;
    case Playing:
        //暂停 按钮ACTION
        builder.addAction(generateAction(android.R.drawable.ic_media_pause,MediaNotificationReceiver.BUTTON_PAUSE));
        break;
    }
//下一首 按钮ACTION
builder.addAction(generateAction(android.R.drawable.ic_media_next,MediaNotificationReceiver.BUTTON_NEXT));

####**Part.3 设置显示歌曲信息**

//更新标题
builder.setContentTitle(songItem.getTitle());
//更新作者
builder.setContentText(songItem.getArtist());
//更新封面
builder.setLargeIcon( 歌曲封面的Bitmap对象 );

最后就 builder.build(); 得到最终的成品 Notification

4.监听耳机插拔事件

我们需要在耳机拔出的时候 暂停音乐 在耳机重新插入的时候 恢复音乐

耳机插入广播接收器

/** * 耳机插入广播接收器 */
public class HeadsetPlugInReceiver extends BroadcastReceiver {

    final IntentFilter filter;

    public HeadsetPlugInReceiver() {
        filter = new IntentFilter();

        if (Build.VERSION.SDK_INT >= 21) {
            filter.addAction(AudioManager.ACTION_HEADSET_PLUG);
        } else {
            filter.addAction(Intent.ACTION_HEADSET_PLUG);
        }
    }

    @Override
    public void onReceive(Context context, Intent intent) {
        if (intent != null && intent.hasExtra("state") && AppConfigs.isResumeAudioWhenPlugin) {

            //通过判断 "state" 来知道状态
            final boolean isPlugIn = intent.getExtras().getInt("state") == 1;

        }
    }

}

####耳机拔出/断开连接 广播接收器

/** * 耳机拔出广播接收器 */
private class HeadsetReceiver extends BroadcastReceiver {

    final IntentFilter filter;
    final BluetoothAdapter bluetoothAdapter;

    public HeadsetReceiver() {
        filter = new IntentFilter();
        filter.addAction(AudioManager.ACTION_AUDIO_BECOMING_NOISY); //有线耳机拔出变化
        filter.addAction(BluetoothHeadset.ACTION_CONNECTION_STATE_CHANGED); //蓝牙耳机连接变化

        bluetoothAdapter = BluetoothAdapter.getDefaultAdapter();
    }

    @Override
    public void onReceive(Context context, Intent intent) {
        if (isRunningForeground) {
            //当前是正在运行的时候才能通过媒体按键来操作音频
            switch (intent.getAction()) {
                case BluetoothHeadset.ACTION_CONNECTION_STATE_CHANGED:
                    if (
                        bluetoothAdapter != null && 
                        BluetoothProfile.STATE_DISCONNECTED == bluetoothAdapter.getProfileConnectionState(BluetoothProfile.HEADSET) && 
                        core.getCurrectStatus() == AudioCore.AudioStatus.Playing
                        ) 
                    {
                        //蓝牙耳机断开连接 同时当前音乐正在播放 则将其暂停
                        pause();
                    }
                    break;
                case AudioManager.ACTION_AUDIO_BECOMING_NOISY:
                    if (core.getCurrectStatus() == AudioCore.AudioStatus.Playing) {
                        //有线耳机断开连接 同时当前音乐正在播放 则将其暂停
                        pause();
                    }
                    break;
            }
        }
    }

}

最后用 registerReceiver() 来注册广播监听器即可

5.监听电话状态

我们需要在有电话来的时候和拨通电话的时候 暂停音频 , 在通话结束之后 恢复音频

要使得能接受到通话状态 , 我们需要注册一个权限 android.permission.READ_PHONE_STATE 这个权限在Android 6.0+上是需要用户授予的

电话状态广播接收器

/** *电话状态广播接收器 */
public class PhoneStatusReceiver extends BroadcastReceiver {

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

        if (intent != null && intent.getExtras() != null){

            final String status = intent.getStringExtra(TelephonyManager.EXTRA_STATE);

            switch (status){
                // "IDLE" 则代表通话结束或振铃结束
                case "IDLE":
                    resume();
                    break;
                //其他状态包括了拨通电话和新来电振铃
                default:
                    pause();
                    break;
            }
        }

    }

}

在代码端写完之后 , 我们还需要在注册清单中注册一下:

<receiver android:name=".PhoneStatusReceiver">
    <intent-filter>
        <action android:name="android.intent.action.PHONE_STATE"/>
    </intent-filter>
</receiver>

教程完毕!!