Android应用界面开发——BroadcastReceiver（实现基于Service的音乐播放器）

BroadcastReceiver：广播接收者，Android四大组件之一，这个组件本质上就是一个全局监听器，用于监听系统全局的广播消息。由于BroadcastReceiver是一个全局监听器，因此它可以方便的实现系统中不同组件之间的通信。

BroadcastReceiver简介

BroadcastReceiver用于接收程序（开发者开发的程序和系统程序）发出的Broadcast Intent，程序启动BroadcastReceiver需要两步：

创建需要启动的BroadcastReceiver的Intent。
调用Context的sendBroadcast()或sendOrderedBroadcast()方法来启动指定的BroadcastReceiver。

实现BroadcastReceiver只要重写BroadcastReceiver的onReceive(Context context, Intent intent)方法即可。

实现了BroadcastReceiver，接着应该指定该BroadcastReceiver能匹配的Intent，有两种方式：

静态注册：

在AndroidManifest.xml中配置：

<receiver android:name=".MyReceiver">
          <intent-filter>
              <action android:name="com.trampcr.musicplayer.PLAY_ACTION"/>
          </intent-filter>
</receiver>

动态注册：

使用代码进行指定，调用BroadcastReceiver的Context的registerReceiver(BroadcastReceiver receiver, IntentFilter filter)方法指定：

IntentFilter intentFilter = new IntentFilter("com.trampcr.musicplayer.PLAY_ACTION");
MyReceiver receiver = new MyReceiver();
registerReceiver(receiver, intentFilter);

每次系统广播事件发生后，系统会创建对应的BroadcastReceiver实例，并自动触发它的onReceiver()方法，如果onReceiver()方法不能在10秒内完成，Android就会认为该程序无响应（所以onReceiver()方法中不能进行耗时操作）。onReceiver()方法执行完后，BroadcastReceiver实例就会被销毁。

如果需要根据Broadcast完成比较耗时的操作，则应该考虑通过Intent启动一个Service来完成，不考虑使用新线程完成耗时操作的原因：
BroadcastReceiver本身的生命周期很短，很可能子线程还没有结束，BroadcastReceiver就已经退出了。

发送广播

调用Context的sendBroadcast(Intent intent)方法发送广播，这条广播将会启动intent参数所对应的BroadcastReceiver。

该程序的Activity界面包含一个按钮，用于向外发送广播。代码如下：

public class MainActivity extends AppCompatActivity {
    
    private Button mSendBroadcast;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        
        mSendBroadcast = (Button) findViewById(R.id.send_broadcast);
        
        mSendBroadcast.setOnClickListener(new View.OnClickListener() {
            @Override
            public void onClick(View v) {
                Intent intent = new Intent();
                //设置Intent的Action属性
                intent.setAction("com.trampcr.musicplayer.PLAY_ACTION");
                intent.putExtra("msg", "simple message");
                //发送广播
                sendBroadcast(intent);
            }
        });
    }
}

上述程序用于创建一个Intent对象，并使用该Intent对象对外发送了一条广播。

发送了广播，就得接收广播，接收广播代码如下：

public class MyReceiver extends BroadcastReceiver {
    @Override
    public void onReceive(Context context, Intent intent) {
        String action = intent.getAction();
        String[] msg = intent.getStringArrayExtra("msg");
        Toast.makeText(context, "接收的Intent的Action为：" + action + "\n消息内容是" + msg, Toast.LENGTH_SHORT).show();
    }
}

当符合该MyReceiver的广播出现时，MyReceiver的onReceiver()方法就会被触发，从而在该方法中显示广播所携带的消息。

发送广播时Intent的Action为com.trampcr.musicplayer.PLAY_ACTION，这就需要配置MyReceiver应监听Action为该字符串的Intent，在AndroidManifest.xml中配置：

<receiver android:name=".MyReceiver">
            <intent-filter>
                <action android:name="com.trampcr.musicplayer.PLAY_ACTION"/>
            </intent-filter>
</receiver>

点击发送广播按钮，可以看到收到广播的提示，如下：

广播类型

广播分为两种：

Normal Broadcast（普通广播）：完全异步，可以在同一时刻被所有接收者接收到。
- sendBroadcast()：发送Normal Broadcast。
Ordered Broadcast（有序广播）：接收者按预先声明的优先级依次接收Broadcast。
- 优先级声明在<intent-filter.../>元素的android:priority属性中，数越大优先级越高。
- Ordered Broadcast接收者可以调用abortBroadcast()方法终止Broadcast Intent的传播，一旦终止，后面的接收者就无法接收到Broadcast。
- sendOrderedBroadcast()：发送Ordered Broadcast。

上面发送广播中举了一个发送普通广播的例子，这里再举一个发送有序分广播的例子：

该程序的Activity界面只有一个按钮，用于发送一条有序广播，代码如下：

public class MainActivity extends AppCompatActivity {

    private Button mSendBroadcast;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        mSendBroadcast = (Button) findViewById(R.id.send_broadcast);

        mSendBroadcast.setOnClickListener(new View.OnClickListener() {
            @Override
            public void onClick(View v) {
                Intent intent = new Intent();
                //设置Intent的Action属性
                intent.setAction("com.trampcr.musicplayer.PLAY_ACTION");
                intent.putExtra("msg", "simple message");
                //发送有序广播
                sendOrderedBroadcast(intent, null);
            }
        });
    }
}

代码中指定了Intent的Action属性，再调用sendOrderedBroadcast()方法来发送有序广播。对于有序广播，它会按优先级依次触发每个BroadcastReceiver的onReceiver()方法。

第一个BroadcastReceiver代码：

public class MyReceiver extends BroadcastReceiver {
    @Override
    public void onReceive(Context context, Intent intent) {
        String action = intent.getAction();
        String msg = intent.getStringExtra("msg");
        Toast.makeText(context, "接收的Intent的Action为：" + action + "\n消息内容是" + msg, Toast.LENGTH_SHORT).show();
        //创建一个Bundle对象，并存入数据
        Bundle bundle = new Bundle();
        bundle.putString("first", "第一个BroadcastReceiver存入的消息");
        //将bundle放入结果中
        setResultExtras(bundle);
        //取消Broadcast的继续传播
        //abortBroadcast();
    }
}

MyReceiver不仅处理了它所接收的消息，而且向处理结果中存入了key为first的消息，这个消息将可以被第二个BroadcastReceiver解析出来。

abortBroadcast()用于取消广播，如果这条代码生效，那么优先级比MyReceiver低的BroadcastReceiver都将不会被触发。

在AndroidManifest.xml中部署该BroadcastReceiver，并指定其优先级为20，代码如下：

<receiver android:name=".MyReceiver">
            <intent-filter android:priority="20">
                <action android:name="com.trampcr.musicplayer.PLAY_ACTION"/>
            </intent-filter>
</receiver>

接下来提供第二个BroadcastReceiver，将会解析前一个BroadcastReceiver存入的key为first的消息，代码如下：

public class MyReceiver2 extends BroadcastReceiver {
    @Override
    public void onReceive(Context context, Intent intent) {
        Bundle bundle = getResultExtras(true);
        //解析前一个BroadcastReceiver所存入的key为first的消息
        String first = bundle.getString("first");
        Toast.makeText(context, "第一个Broadcast存入的消息为：" + first, Toast.LENGTH_SHORT).show();
    }
}

解析出前一个BroadcastReceiver存入结果中的key为first的消息。

在AndroidManifest.xml中配置MyReceiver2的优先级为0，如下：

<receiver android:name=".MyReceiver2">
            <intent-filter android:priority="0">
                <action android:name="com.trampcr.musicplayer.PLAY_ACTION" />
            </intent-filter>
</receiver>

先注释掉abortBroadcast()，点击发送有序广播按钮，可以看到先显示第一个广播接收器中的内容，再显示第二个广播接收器中的内容，如下：

如果不注释abortBroadcast()，将会阻止消息广播，消息将传不到MyReceiver2。

系统广播

广播接收器除了可以接收用户发送的广播，还可以接收系统广播，常用的系统广播如下：

ACTION_TIME_CHANGED：系统时间被改变。
ACTION_DATE_CHANGED：系统日期被改变。
ACTION_TIMEZONE_CHANGED：系统时区被改变。
ACTION_BOOT_COMPLETED：系统启动完成。
ACTION_PACKAGE_ADDED：系统添加包。
ACTION_PACKAGE_CHANGED：系统的包改变。
ACTION_PACKAGE_REMOVED：系统的包被删除。
ACTION_PACKAGE_RESTARTED：系统的包被重启。
ACTION_PACKAGE_DATA_CLEARED：系统的包数据被清空。
ACTION_BATTERY_CHANGED：电池电量改变。
ACTION_BATTERY_LOW：电池电量低。
ACTION_POWER_CONNECTED：系统连接电源。
ACTION_POWER_DISCONNECTED：系统与电源断开。
ACTION_SHUTDOWN：系统被关闭。

基于Service的音乐播放器

这里开发一个基于Service的音乐播放器，音乐由后台运行的Service负责播放，当后台的播放状态发生变化时，程序将会通过发送广播通知前台Activity更新界面；当点击Activity的界面按钮时，系统将通过发送广播通知后台Service来改变播放状态。

前台Activity界面有两个按钮，分别用于控制播放/暂停、停止，另外还有两个文本框，用于显示正在播放的歌曲名、歌手名。前台Activity的代码如下：

public class MainActivity extends AppCompatActivity implements View.OnClickListener{

    private ImageButton mStart;
    private ImageButton mStop;
    private TextView mMusicName;
    private TextView mSongerName;
    private ActivityReceiver mActivityReceiver;
    public static final String CTL_ACTION = "com.trampcr.action.CTL_ACTION";
    public static final String UPDATE_ACTION = "com.trampcr.action.UPDATE_ACTION";

    //定义音乐播放状态，0x11代表没有播放，0x12代表正在播放，0x13代表暂停
    int status = 0x11;
    String[] musicNames = new String[]{"完美生活", "那一年", "故乡"};
    String[] songerNames = new String[]{"许巍", "许巍", "许巍"};


    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        mStart = (ImageButton) findViewById(R.id.start);
        mStop = (ImageButton) findViewById(R.id.stop);
        mMusicName = (TextView) findViewById(R.id.music_name);
        mSongerName = (TextView) findViewById(R.id.songer_name);

        mStart.setOnClickListener(this);
        mStop.setOnClickListener(this);

        mActivityReceiver = new ActivityReceiver();
        //创建IntentFilter
        IntentFilter filter = new IntentFilter();
        //指定BroadcastReceiver监听的Action
        filter.addAction(UPDATE_ACTION);
        //注册BroadcastReceiver
        registerReceiver(mActivityReceiver, filter);

        Intent intent = new Intent(MainActivity.this, MusicService.class);
        //启动后台Service
        startService(intent);
    }

    public class ActivityReceiver extends BroadcastReceiver {
        @Override
        public void onReceive(Context context, Intent intent) {
            //获取Intent中的update消息，update代表播放状态
            int update = intent.getIntExtra("update", -1);
            //获取Intent中的current消息，current代表当前正在播放的歌曲
            int current = intent.getIntExtra("current", -1);
            if (current >= 0){
                mMusicName.setText(musicNames[current]);
                mSongerName.setText(songerNames[current]);
            }
            switch (update){
                case 0x11:
                    mStart.setBackgroundResource(R.drawable.play);
                    status = 0x11;
                    break;
                //控制系统进入播放状态
                case 0x12:
                    //在播放状态下设置使用暂停图标
                    mStart.setBackgroundResource(R.drawable.pause);
                    status = 0x12;
                    break;
                case 0x13:
                    //在暂停状态下设置使用播放图标
                    mStart.setBackgroundResource(R.drawable.play);
                    status = 0x13;
                    break;
            }
        }
    }

    @Override
    public void onClick(View v) {
        Intent intent = new Intent(CTL_ACTION);
        switch (v.getId()){
            case R.id.start:
                intent.putExtra("control", 1);
                break;
            case R.id.stop:
                intent.putExtra("control", 2);
                break;
        }
        //发送广播，将被Service中的BroadcastReceiver接收到
        sendBroadcast(intent);
    }
}

ActivityReceiver()用于响应后台Service所发出的广播，该程序将会根据广播Intent里的消息来改变播放状态，并更新程序界面中按钮的图标。

onClick中根据点击的按钮发送广播，发送广播时会把所按下的按钮标识发送出来。

接下来是后台Service，会在播放状态发生改变时对外发送广播。代码如下：

public class MusicService extends Service {

    MyReceiver serviceReceiver;
    AssetManager mAssetManager;
    String[] musics = new String[]{"prefectLife.mp3", "thatYear.mp3", "country.mp3"};
    MediaPlayer mMediaPlayer;
    int status = 0x11;
    int current = 0; // 记录当前正在播放的音乐

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

    @Override
    public void onCreate() {
        super.onCreate();
        mAssetManager = getAssets();
        serviceReceiver = new MyReceiver();
        //创建IntentFilter
        IntentFilter filter = new IntentFilter();
        filter.addAction(MainActivity.CTL_ACTION);
        registerReceiver(serviceReceiver, filter);
        //创建MediaPlayer
        mMediaPlayer = new MediaPlayer();
        //为MediaPlayer播放完成事件绑定监听器
        mMediaPlayer.setOnCompletionListener(new MediaPlayer.OnCompletionListener() {
            @Override
            public void onCompletion(MediaPlayer mp) {
                current++;
                if (current >= 3) {
                    current = 0;
                }
                //发送广播通知Activity更改文本框
                Intent sendIntent = new Intent(MainActivity.UPDATE_ACTION);
                sendIntent.putExtra("current", current);
                //发送广播，将被Activity中的BroadcastReceiver接收到
                sendBroadcast(sendIntent);
                //准备并播放音乐
                prepareAndPlay(musics[current]);
            }
        });
    }

    public class MyReceiver extends BroadcastReceiver {
        @Override
        public void onReceive(Context context, Intent intent) {
            int control = intent.getIntExtra("control", -1);
            switch (control){
                case 1: // 播放或暂停
                    //原来处于没有播放状态
                    if (status ==0x11){
                        //准备播放音乐
                        prepareAndPlay(musics[current]);
                        status = 0x12;
                    }
                    //原来处于播放状态
                    else if (status == 0x12){
                        //暂停
                        mMediaPlayer.pause();
                        status = 0x13; // 改变为暂停状态
                    }
                    //原来处于暂停状态
                    else if (status == 0x13){
                        //播放
                        mMediaPlayer.start();
                        status = 0x12; // 改变状态
                    }
                    break;
                //停止声音
                case 2:
                    //如果原来正在播放或暂停
                    if (status == 0x12 || status == 0x13){
                        //停止播放
                        mMediaPlayer.stop();
                        status = 0x11;
                    }
            }
            //广播通知Activity更改图标、文本框
            Intent sendIntent = new Intent(MainActivity.UPDATE_ACTION);
            sendIntent.putExtra("update", status);
            sendIntent.putExtra("current", current);
            //发送广播，将被Activity中的BroadcastReceiver接收到
            sendBroadcast(sendIntent);
        }
    }

    private void prepareAndPlay(String music) {
        try {
            //打开指定的音乐文件
            AssetFileDescriptor assetFileDescriptor = mAssetManager.openFd(music);
            mMediaPlayer.reset();
            //使用MediaPlayer加载指定的声音文件
            mMediaPlayer.setDataSource(assetFileDescriptor.getFileDescriptor(), assetFileDescriptor.getStartOffset(), assetFileDescriptor.getLength());
            mMediaPlayer.prepare(); // 准备声音
            mMediaPlayer.start(); // 播放
        } catch (IOException e) {
            e.printStackTrace();
        }
    }
}

MyReceiver用于接收前台Activity所发出的广播，并根据广播的消息内容改变Service的播放状态，当播放状态改变时，该Service对外发送一条广播，广播消息将会被前台Activity接收，前台Activity将会根据广播消息更新界面。

为了让该音乐播放器能按顺序依次播放歌曲，程序为MediaPlayer增加了OnCompletionListener监听器，当MediaPlayer播放完成后将自动播放下一首歌曲。

运行程序，效果图如下：

最后编辑于：2017.12.04 00:50:39

人面猴
序言：七十年代末，一起剥皮案震惊了整个滨河市，随后出现的几起案子，更是在滨河造成了极大的恐慌，老刑警刘岩，带你破解...
沈念sama阅读 158,847评论 4赞 362
死咒
序言：滨河连续发生了三起死亡事件，死亡现场离奇诡异，居然都是意外死亡，警方通过查阅死者的电脑和手机，发现死者居然都...
沈念sama阅读 67,208评论 1赞 292
救了他两次的神仙让他今天三更去死
文/潘晓璐我一进店门，熙熙楼的掌柜王于贵愁眉苦脸地迎上来，“玉大人，你说我怎么就摊上这事。” “怎么了？”我有些...
开封第一讲书人阅读 108,587评论 0赞 243
道士缉凶录：失踪的卖姜人
文/不坏的土叔我叫张陵，是天一观的道长。经常有香客问我，道长，这世上最难降的妖魔是什么？我笑而不...
开封第一讲书人阅读 43,942评论 0赞 205
港岛之恋（遗憾婚礼）
正文为了忘掉前任，我火速办了婚礼，结果婚礼上，老公的妹妹穿的比我还像新娘。我一直安慰自己，他们只是感情好，可当我...
茶点故事阅读 52,332评论 3赞 287
恶毒庶女顶嫁案：这布局不是一般人想出来的
文/花漫我一把揭开白布。她就那样静静地躺着，像睡着了一般。火红的嫁衣衬着肌肤如雪。梳的纹丝不乱的头发上，一...
开封第一讲书人阅读 40,587评论 1赞 218
城市分裂传说
那天，我揣着相机与录音，去河边找鬼。笑死，一个胖子当着我的面吹牛，可吹牛的内容都是我干的。我是一名探鬼主播，决...
沈念sama阅读 31,853评论 2赞 312
双鸳鸯连环套：你想象不到人心有多黑
文/苍兰香墨我猛地睁开眼，长吁一口气：“原来是场噩梦啊……” “哼！你这毒妇竟也来了？” 一声冷哼从身侧响起，我...
开封第一讲书人阅读 30,568评论 0赞 198
万荣杀人案实录
序言：老挝万荣一对情侣失踪，失踪者是张志新（化名）和其女友刘颖，没想到半个月后，有当地人在树林里发现了一具尸体，经...
沈念sama阅读 34,273评论 1赞 242
护林员之死
正文独居荒郊野岭守林人离奇死亡，尸身上长有42处带血的脓包…… 初始之章·张勋以下内容为张勋视角年9月15日...
茶点故事阅读 30,542评论 2赞 246
白月光启示录
正文我和宋清朗相恋三年，在试婚纱的时候发现自己被绿了。大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
茶点故事阅读 32,033评论 1赞 260
活死人
序言：一个原本活蹦乱跳的男人离奇死亡，死状恐怖，灵堂内的尸体忽然破棺而出，到底是诈尸还是另有隐情，我是刑警宁泽，带...
沈念sama阅读 28,373评论 2赞 253
日本核电站爆炸内幕
正文年R本政府宣布，位于F岛的核电站，受9级特大地震影响，放射性物质发生泄漏。R本人自食恶果不足惜，却给世界环境...
茶点故事阅读 33,031评论 3赞 236
男人毒药：我在死后第九天来索命
文/蒙蒙一、第九天我趴在偏房一处隐蔽的房顶上张望。院中可真热闹，春花似锦、人声如沸。这庄子的主人今日做“春日...
开封第一讲书人阅读 26,073评论 0赞 8
一桩弑父案，背后竟有这般阴谋
文/苍兰香墨我抬头看了看天上的太阳。三九已至，却和暖如春，着一层夹袄步出监牢的瞬间，已是汗流浃背。一阵脚步声响...
开封第一讲书人阅读 26,830评论 0赞 195
情欲美人皮
我被黑心中介骗来泰国打工，没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留，地道东北人。一个月前我还...
沈念sama阅读 35,628评论 2赞 274
代替公主和亲
正文我出身青楼，却偏偏与公主长得像，于是被迫代替她去往敌国和亲。传闻我的和亲对象是个残疾皇子，可洞房花烛夜当晚...
茶点故事阅读 35,537评论 2赞 269