Android多媒体功能开发——使用MediaPlayer类播放音频

Posted 2023-03-30 nanoage

android播放音频资源主要有两个类：MediaPlayer和SoundPool。

MediaPlayer用于实现对一个音频的播放控制，侧重于启动、停止、暂停、位置控制等操作。不支持同时播放多个音频，占用资源较多，延迟时间较长，适于播放较大的音频，比如背景音乐。

SoundPool用于实现对多个音频的播放管理，侧重于多个音频的实时播放。支持同时播放多个音频，占用资源少，延迟时间短，适于播放音效。最大只能申请1M内存，只能播放较短的音频。最好使用OGG格式。

使用MediaPlayer播放音频的基本流程是创建MediaPlayer对象、设置音频数据源、准备、开始播放、停止播放、释放资源。播放过程中可以暂停和继续，停止播放后可以重新准备再次播放，也可以重置音频数据源再播放其他音频。其流程图和对应的代码如下：

MediaPlayer可以使用的音频数据源有三种：

• res/raw下的资源
• 存储设备上的文件
• 网络Uri

MediaPlayer类提供了获取/设置播放位置的方法，也可以设置是否循环播放。当播放停止后必须再次准备才能再播放。重置将MediaPlayer恢复到初始状态，此时才能再次设置数据源。release释放资源后，MediaPlayer对象无法再使用。还可以设置监听播放完毕、缓冲区变化等事件的监听器。

MediaPlayer对象的状态转换图如下：

下面编写一个播放音乐的应用，界面如下：

这个应用使用两种形式的音频源：资源文件和外部存储上音频uri。资源文件是开发时将mp3文件复制到项目res/raw目录下，外部存储上音频uri是由音频选择界面选中的音频。

首先在Activity的onCreate方法中创建一个默认的MediaPlayer对象。然后用一个AlertDialog作为选择数据源界面。根据用户选择设置数据源，并准备，设置前需要先reset。再用四个按钮进行播放控制，每个按钮对应MediaPlayer对象的相应方法。用一个CheckBox控制是否循环播放。用一个OnCompletionListener监听播放完毕事件。用一个ProgressBar显示播放进度，用Handler实现一个定时器，每秒钟更新一次进度，通过音频总长度和当前播放位置计算进度条位置。最后，在Activity的onDestroy方法中用release释放MediaPlayer对象的资源。

主要控制代码如下：

显示播放进度是通过每秒查询并更新进度条实现的。这个定时器可以用Handler实现，这是实现定时器最简单的方式。当音乐开始播放时启动定时器，每隔1秒钟启动一次，查询播放进度并更新进度条。在播放结束或暂停时停止定时器。具体代码如下：

首先，在Activity类中声明三个成员变量：

ProgressBar progressBar;
Handler handler;
Runnable runnable;

然后，在onCreate中创建进度条和定时器，设置监听器：

progressBar = new ProgressBar(this, null, android.R.attr.progressBarStyleHorizontal);

最后，是定时器的创建与启动停止：

void initTimer()
        handler = new Handler();
        runnable = new Runnable()
            @Override
            public void run() 
                int d = player.getDuration();
                int p = player.getCurrentPosition();
                progressBar.setProgress(p*100/d);
                handler.postDelayed(runnable, 1000);
            
        ;

void startTimer()
        handler.postDelayed(runnable, 1000);

void stopTimer()
        handler.removeCallbacks(runnable);

MediaPlayer适合播放大的实时性要求不高的音频，其主要方法有：

• static MediaPlayer create(Context context,int resid)：创建MediaPlayer对象，用resid指定的资源作为要播放的音频
• void setDataSource(String path)：设置要播放的音频文件位置，参数path为文件路径或Uri
• void prepare()：setDataSource并不载入资源，需要调用此方法准备资源
• void start()：开始/恢复播放
• void stop()：停止播放，调用后无法再播放
• void pause()：暂停播放，可以再用start恢复播放
• void reset()：重置到刚刚创建后的状态
• void release()：释放掉相关的资源
• void seekTo(int msec)：从指定位置播放，参数为用毫秒定义的位置
• int getCurrentPosition()：得到当前播放位置，即播放的毫秒数
• int getDuration()：得到音频长度，即总的毫秒数
• boolean isPlaying()：得到当前音频是否正在播放
• void setLooping(boolean looping) / boolean isLooping()：循环播放
• void setVolume(float leftVolume, float rightVolume)：设置音量

MediaPlayer支持的一些事件：

• setOnPreparedListener(MediaPlayer.OnPreparedListener listener)：音频源准备好后调用
• setOnCompletionListener(MediaPlayer.OnCompletionListener listener)：音频播放完毕后调用
• setOnBufferingUpdateListener(MediaPlayer.OnBufferingUpdateListener listener)：网络流缓冲的状态变化时调用
• setOnSeekCompleteListener(MediaPlayer.OnSeekCompleteListener listener)：Seek操作完成后调用
• setOnErrorListener(MediaPlayer.OnErrorListener listener)：发生错误时调用

例子的完整代码如下：

public class MainActivity extends AppCompatActivity 
    String[] sourceStr = "music1(ResourceID)","music2(外部存储文件)";
    int sourceIndex;
    TextView tvSource;
    MediaPlayer player;
    ProgressBar progressBar;
    Handler handler;
    Runnable runnable;

    @Override
    protected void onCreate(Bundle savedInstanceState) 
        super.onCreate(savedInstanceState);
        LinearLayout ll = new LinearLayout(this);
        ll.setOrientation(LinearLayout.VERTICAL);
        setContentView(ll);

        Button btnSelect = new Button(this);
        btnSelect.setText("Select Source");
        ll.addView(btnSelect);
        btnSelect.setOnClickListener(new View.OnClickListener()
            @Override
            public void onClick(View arg0) 
                AlertDialog.Builder builder = new AlertDialog.Builder(MainActivity.this);
                builder.setTitle("Select Audio DataSource");
                DialogInterface.OnClickListener listener = new DialogInterface.OnClickListener() 
                    @Override
                    public void onClick(DialogInterface arg0, int which) 
                        if(which>=0)
                            sourceIndex = which;
                         else if(which==DialogInterface.BUTTON_POSITIVE)
                            switch(sourceIndex)
                                case 0:		// 以Resource作为音频源
                                    player = MediaPlayer.create(MainActivity.this, R.raw.music1);
                                    tvSource.setText(sourceStr[sourceIndex]);
                                    break;
                                case 1:		// 选择外部存储音频作为音频源
                                    chooseAudioFile();
                                    break;
                            
                            arg0.dismiss();
                        
                    
                ;
                builder.setSingleChoiceItems(sourceStr, sourceIndex, listener);
                builder.setNegativeButton("Cancel", null);
                builder.setPositiveButton("OK", listener);
                builder.show();
            
        );
        Button btnStart = new Button(this);
        btnStart.setText("Start");
        ll.addView(btnStart);
        btnStart.setOnClickListener(new View.OnClickListener()
            @Override
            public void onClick(View arg0) 
                if(!player.isPlaying())	
                    player.start();
                    startTimer();
                
            
        );
        Button btnStop = new Button(this);
        btnStop.setText("Stop");
        ll.addView(btnStop);
        btnStop.setOnClickListener(new View.OnClickListener()
            @Override
            public void onClick(View arg0) 
                //player.stop();	// stop后player对象不能再播放
                player.pause();
                player.seekTo(0);
                stopTimer();
            
        );
        final Button btnPause = new Button(this);
        btnPause.setText("Pause");
        ll.addView(btnPause);
        btnPause.setOnClickListener(new View.OnClickListener()
            @Override
            public void onClick(View arg0) 
                if(player.isPlaying())
                    player.pause();
                    stopTimer();
                    btnPause.setText("Continue");
                 else 
                    player.start();
                    startTimer();
                    btnPause.setText("Pause");
                
            
        );
        Button btnReset = new Button(this);
        btnReset.setText("Reset");
        ll.addView(btnReset);
        btnReset.setOnClickListener(new View.OnClickListener()
            @Override
            public void onClick(View arg0) 
                //player.reset();	// reset后需要重新设置音频来源
                player.seekTo(0);
                progressBar.setProgress(0);
            
        );

        CheckBox cbLoop = new CheckBox(this);
        cbLoop.setText("循环播放");
        ll.addView(cbLoop);
        cbLoop.setOnCheckedChangeListener(new CompoundButton.OnCheckedChangeListener()
            @Override
            public void onCheckedChanged(CompoundButton arg0, boolean arg1) 
                player.setLooping(arg1);
            
        );

        tvSource = new TextView(this);
        ll.addView(tvSource);

        progressBar = new ProgressBar(this, null, android.R.attr.progressBarStyleHorizontal);
        progressBar.setMax(100);
        ll.addView(progressBar);

        // 默认以music1作为音频源
        sourceIndex = 0;
        player = MediaPlayer.create(this, R.raw.music1);
        tvSource.setText(sourceStr[sourceIndex]);
        initTimer();

        player.setOnCompletionListener(new MediaPlayer.OnCompletionListener()
            @Override
            public void onCompletion(MediaPlayer arg0) 
                Toast.makeText(MainActivity.this, "Complete", Toast.LENGTH_SHORT).show();
                stopTimer();
            
        );
    
    @Override
    protected void onDestroy()
        super.onDestroy();
        stopTimer();
        if(player!=null) 
            player.stop();
            player.release();
        
    

    void initTimer()
        handler = new Handler();
        runnable = new Runnable()
            @Override
            public void run() 
                int d = player.getDuration();
                int p = player.getCurrentPosition();
                progressBar.setProgress(p*100/d);
                handler.postDelayed(runnable, 1000);
            
        ;
    
    void startTimer()
        handler.postDelayed(runnable, 1000);
    
    void stopTimer()
        handler.removeCallbacks(runnable);
    

    final static int PICK_AUDIO = 1;
    void chooseAudioFile()
        Intent intent = new Intent(Intent.ACTION_GET_CONTENT);
        intent.setType("audio/*");
        startActivityForResult(intent, PICK_AUDIO);
    

    @Override
    protected void onActivityResult(int requestCode, int resultCode, Intent data) 
        super.onActivityResult(requestCode, resultCode, data);
        if(requestCode==PICK_AUDIO && resultCode==RESULT_OK)
            Uri uri = data.getData();
            Log.i("zzk", "选择音频成功, uri=" + uri);
            try 
                player.reset();
                player.setDataSource(this, uri);
                player.prepare();
                tvSource.setText(sourceStr[sourceIndex]);
             catch (IOException e) 
                e.printStackTrace();