MediaPlayer使用以及常见问题

Posted 2022-09-21 Jason_Lee155

前面已经写过一篇类似的文章，但是还不够细致：

采用Android的MediaPlayer+SurfaceView设计视频播放器

这里我们重新理一下，并记录一点实际运用时遇到的问题。

MediaPlayer特性

MediaPlayer类用于控制音频文件、视频文件和流的播放。

MediaPlayer播放的文件来源:

• 应用中自带的resource资源。

MediaPlayer.create(this, R.raw.video);

• 存储在SD卡或其他文件路径下的媒体文件。

mediaPlayer.setDataSource(“/sdcard/video.mp4”);

• 网络上的流媒体文件。

mediaPlayer.setDataSource("http://www.citynorth.cn/music/video.mp4");

MediaPlayer的setDataSource一共四个方法：

1. setDataSource (String path)
2. setDataSource (FileDescriptor fd)
3. setDataSource (Context context, Uri uri)
4. setDataSource (FileDescriptor fd, long offset, long length)

其中使用FileDescriptor时，需要将文件放到与res文件夹平级的assets文件夹 里，然后使用：

AssetFileDescriptor fileDescriptor = getAssets().openFd("rain.mp3");
m_mediaPlayer.setDataSource(fileDescriptor.getFileDescriptor(),
                            fileDescriptor.getStartOffset(), 
                            fileDescriptor.getLength());

MediaPlayer生命周期

MediaPlayer对象播放控制生命周期状态图如下所示（这个图尽量记住，记不住开发的时候也要经对照注意）：

这张状态转换图清晰的描述了MediaPlayer的各个状态，也列举了主要的方法的调用时序，每种方法只能在一些特定的状态下使用，如果使用时MediaPlayer的状态不正确则会引发IllegalStateException异常。

Idle 状态：当使用new()方法创建一个MediaPlayer对象或者调用了其reset()方法时，该MediaPlayer对象处于idle状态。这两种方法的一个重要差别就是：如果在这个状态下调用了getDuration()等方法（相当于调用时机不正确），通过reset()方法进入idle状态的话会触发OnErrorListener.onError()，并且MediaPlayer会进入Error状态；如果是新创建的MediaPlayer对象，则并不会触发onError(),也不会进入Error状态。

End 状态：通过release()方法可以进入End状态，只要MediaPlayer对象不再被使用，就应当尽快将其通过release()方法释放掉，以释放相关的软硬件组件资源，这其中有些资源是只有一份的（相当于临界资源）。如果MediaPlayer对象进入了End状态，则不会在进入任何其他状态了。

Initialized 状态：这个状态比较简单，MediaPlayer调用setDataSource()方法就进入Initialized状态，表示此时要播放的文件已经设置好了。

Prepared 状态：初始化完成之后还需要通过调用prepare()或prepareAsync()方法，这两个方法一个是同步的一个是异步的，只有进入Prepared状态，才表明MediaPlayer到目前为止都没有错误，可以进行文件播放。

Preparing 状态：这个状态比较好理解，主要是和prepareAsync()配合，如果异步准备完成，会触发OnPreparedListener.onPrepared()，进而进入Prepared状态。

Started 状态：显然，MediaPlayer一旦准备好，就可以调用start()方法，这样MediaPlayer就处于Started状态，这表明MediaPlayer正在播放文件过程中。可以使用isPlaying()测试MediaPlayer是否处于了Started状态。如果播放完毕，而又设置了循环播放，则MediaPlayer仍然会处于Started状态，类似的，如果在该状态下MediaPlayer调用了seekTo()或者start()方法均可以让MediaPlayer停留在Started状态。

Paused 状态：Started状态下MediaPlayer调用pause()方法可以暂停MediaPlayer，从而进入Paused状态，MediaPlayer暂停后再次调用start()则可以继续MediaPlayer的播放，转到Started状态，暂停状态时可以调用seekTo()方法，这是不会改变状态的。

Stop 状态：Started或者Paused状态下均可调用stop()停止MediaPlayer，而处于Stop状态的MediaPlayer要想重新播放，需要通过prepareAsync()和prepare()回到先前的Prepared状态重新开始才可以。

PlaybackCompleted状态：文件正常播放完毕，而又没有设置循环播放的话就进入该状态，并会触发OnCompletionListener的onCompletion()方法。此时可以调用start()方法重新从头播放文件，也可以stop()停止MediaPlayer，或者也可以seekTo()来重新定位播放位置。

Error状态：如果由于某种原因MediaPlayer出现了错误，会触发OnErrorListener.onError()事件，此时MediaPlayer即进入Error状态，及时捕捉并妥善处理这些错误是很重要的，可以帮助我们及时释放相关的软硬件资源，也可以改善用户体验。通过setOnErrorListener(android.media.MediaPlayer.OnErrorListener)可以设置该监听器。如果MediaPlayer进入了Error状态，可以通过调用reset()来恢复，使得MediaPlayer重新返回到Idle状态。

加粗的都表示开发过程里遇到的，如果不这样做，就有异常出现。

MediaPlayer的使用

MediaPlayer其实是一个封装的很好的音频、视频流媒体操作类，如果查看其源码，会发现其内部是调用的native方法，所以它其实是有C++实现的。

既然是一个流媒体操作类，那么必然涉及到，播放、暂停、停止等操作，实际上MediaPlayer也为我们提供了相应的方法来直接操作流媒体。

• void statr()：开始或恢复播放。
• void stop()：停止播放。
• void pause()：暂停播放。　　

通过上面三个方法，只要设定好流媒体数据源，即可在应用中播放流媒体资源，为了更好的操作流媒体，MediaPlayer还为我们提供了一些其他的方法，这里列出一些常用的，详细内容参阅官方文档。

• int getDuration()：获取流媒体的总播放时长，单位是毫秒。
• int getCurrentPosition()：获取当前流媒体的播放的位置，单位是毫秒。
• void seekTo(int msec)：设置当前MediaPlayer的播放位置，单位是毫秒。
• void setLooping(boolean looping)：设置是否循环播放。
• boolean isLooping()：判断是否循环播放。
• boolean  isPlaying()：判断是否正在播放。
• void prepare()：同步的方式装载流媒体文件。
• void prepareAsync()：异步的方式装载流媒体文件。
• void release ()：回收流媒体资源。 
• void setAudiostreamType(int streamtype)：设置播放流媒体类型。
• void setWakeMode(Context context, int mode)：设置CPU唤醒的状态。
• setNextMediaPlayer(MediaPlayer next)：设置当前流媒体播放完毕，下一个播放的MediaPlayer。

大部分方法的看方法名就可以理解，但是有几个方法需要单独说明一下。

在使用MediaPlayer播放一段流媒体的时候，需要使用prepare()或prepareAsync()方法把流媒体装载进MediaPlayer，才可以调用start()方法播放流媒体。　　　　　　　　　　　　　　　　　

setAudioStreamType()方法用于指定播放流媒体的类型，它传递的是一个int类型的数据，均以常量定义在AudioManager类中， 一般我们播放音频文件，设置为AudioManager.STREAM_MUSIC即可。

除了上面介绍的一些方法外，MediaPlayer还提供了一些事件的回调函数，这里介绍几个常用的：

• setOnCompletionListener(MediaPlayer.OnCompletionListener listener)：当流媒体播放完毕的时候回调。
• setOnErrorListener(MediaPlayer.OnErrorListener listener)：当播放中发生错误的时候回调。
• setOnPreparedListener(MediaPlayer.OnPreparedListener listener)：当装载流媒体完毕的时候回调。
• setOnSeekCompleteListener(MediaPlayer.OnSeekCompleteListener listener)：当使用seekTo()设置播放位置的时候回调。
• setOnBufferingUpdateListener：网络上的媒体资源缓存进度更新的时候会触发。
• setOnVideoSizeChangedListener：视频宽高发生改变的时候会触发。当所设置的媒体资源没有视频图像、MediaPlayer没有设置展示的holder或者视频大小还没有被测量出来时，获取宽高得到的都是0.

MediaPlayer使用技巧

1、在使用start()播放流媒体之前，需要装载流媒体资源。这里建议使用prepareAsync()用异步的方式装载流媒体资源。因为流媒体资源的装载是会消耗系统资源的，在一些硬件不理想的设备上，如果使用prepare()同步的方式装载资源，可能会造成UI界面的卡顿，这是非常影响用于体验的。因为推荐使用异步装载的方式，为了避免还没有装载完成就调用start()而报错的问题，需要绑定MediaPlayer.setOnPreparedListener()事件，它将在异步装载完成之后回调。异步装载还有一个好处就是避免装载超时引发ANR（(Application Not Responding）错误。

                mediaPlayer = new MediaPlayer();
                mediaPlayer.setDataSource(path);
                mediaPlayer.setAudioStreamType(AudioManager.STREAM_MUSIC);


                // 通过异步的方式装载媒体资源
               mediaPlayer.prepareAsync();
                 mediaPlayer.setOnPreparedListener(new OnPreparedListener()                   
                    @Override
                     public void onPrepared(MediaPlayer mp) 
                       // 装载完毕回调
                        mediaPlayer.start();
                   
                 );

2、使用完MediaPlayer需要回收资源。MediaPlayer是很消耗系统资源的，所以在使用完MediaPlayer，不要等待系统自动回收，最好是主动回收资源。

        if (mediaPlayer != null && mediaPlayer.isPlaying()) 
           mediaPlayer.stop();
           mediaPlayer.release();
           mediaPlayer = null;
       

3、使用MediaPlayer可以使用一个Service来使用，并且在Service的onDestory()方法中回收MediaPlayer资源，实际上，就算是直接使用Activity承载MediaPlayer，也应该在销毁的时候判断一下MediaPlayer是否被回收，如果未被回收，回收其资源，因为底层调用的native方法，如果不销毁还是会在底层继续播放，而承载的组件已经被销毁了，这个时候就无法获取到这个MediaPlayer进而控制它。

   @Override
    protected void onDestroy() 
         if (mediaPlayer != null && mediaPlayer.isPlaying()) 
            mediaPlayer.stop();
            mediaPlayer.release();
            mediaPlayer = null;
        
        super.onDestroy();
   

4、对于单曲循环之类的操作，除了可以使用setLooping()方法进行设置之外，还可以为MediaPlayer注册回调函数，MediaPlayer.setOnCompletionListener()，它会在MediaPlayer播放完毕被回调。

                // 设置循环播放
                //mediaPlayer.setLooping(true);
                mediaPlayer.setOnCompletionListener(new OnCompletionListener() 

                    @Override
                     public void onCompletion(MediaPlayer mp) 
                         // 在播放完毕被回调
                         play();                       
                     
                 );

5、因为MediaPlayer一直操作的是一个流媒体，所以无可避免的可能一段流媒体资源，前半段可以正常播放，而中间一段因为解析或者源文件错误等问题，造成中间一段无法播放问题，需要我们处理这个错误，否则会影响Ux（用户体验）。可以为MediaPlayer注册回调函数setOnErrorListener()来设置出错之后的解决办法，一般重新播放或者播放下一个流媒体即可。

 mediaPlayer.setOnErrorListener(new OnErrorListener() 

                    @Override
                     public boolean onError(MediaPlayer mp, int what, int extra) 
                        playNext();
                        return false;
                     
                );

AudioManager简介

AudioManager类提供了访问音量和振铃器mode控制。使用Context.getSystemService（Context.AUDIO_SERVICE）来得到这个类的一个实例。

常用方法说明：

void  adjustStreamVolume(int streamType,int direction, int flags)

调整手机指定类型的声音。其中第一个参数streamType指定声音类型，该参数可接受如下几个值。

• int    STREAM_ALARM：手机闹铃的声音。
• int    STREAM_DTMF：DTMF音调的声音。
• int    STREAM_MUSIC：手机音乐的声音。
• int    STREAM_NOTIFICATION：系统提示的声音。
• int    STREAM_RING ：电话铃声的声音。
• int    STREAM_SYSTEM：手机系统的声音。
• int    STREAM_VOICE_CALL：语音电话的声音。

第二个参数指定对声音进行增大、还是减小该参数可接受如下几个值：

• ADJUST_LOWER 降低音量
• ADJUST_RAISE 升高音量      
• ADJUST_SAME 保持不变,这个主要用于向用户展示当前的音量   

第三个参数是调整声音时的标志，例如指定FLAG_SHOW_UI，则指定调整声音时显示音量进度条。

void setMicrophoneMute(booleanon)

设置是否让麦克风静音。设置为true将麦克风静音;false关闭静音

void  setMode(intmode)

设置声音模式。可设置的值有 NORMAL,RINGTONE, 和IN_CALL。

void setRingerMode(intringerMode)

设置手机电话铃声的模式。可支持如下几个属性值。

• int    RINGER_MODE_NORMAL：正常的手机铃声。
• int    RINGER_MODE_SILENT：手机铃声静音。
• int    RINGER_MODE_VIBRATE：手机震动。

void setSpeakerphoneOn(booleanon)

设置扬声器打开或关闭。设置为true开启免提通话;false关闭免提。

void setStreamMute(intstreamType,booleanstate)

将手机的指定类型的声音调整为静音。其中streamType参数与adjustStreamVolume方法中第一个参数的意义相同。

void setStreamVolume (int streamType, int index, int flags)

直接设置手机的指定类型的音量值。其中streamType参数与adjustStreamVolume方法中第一个参数的意义相同。

播放视频常见问题讨论

1. 有声音没有图像 

视频播放有声音没图像也许是在使用MediaPlayer最容易出现的问题，几乎所有使用MediaPlayer的新手都会遇到。视频播放的图像呈现需要一个载体，需要利用MediaPlayer.setDisplay设置一个展示视频画面的SurfaceHolder，最终视频的每一帧图像是要绘制在Surface上面的。通常，设置给MediaPlayer的SurfaceHolder未被创建，视频播放就注定没有图像。 比如你先调用了setDisplay，但是这个时候holder是没有被创建的。视频就没有图像了。或者你在setDisplay的时候确保了holder是被创建了，但是当因为一些原因holder被销毁了，视频也就没有图像了。再者，你没有给展示视频的view设置合适的大小，比如都设置wrap_content，或者都设置0，也会导致SurfaceHolder不能被创建，视频也就没有图像了。 

2. 视频图像变形 

Surface展示视频图像的时候，是不会去主动保证和呈现出来的图像和原始图像的宽高比例是一致的，所以我们需要自己去设置展示视频的View的宽高，以保证视频图像展示出来的时候不会变形。我认为比较合适的做法就是利用FrameLayout嵌套一个SurfaceView或者其他拥有Surface的View来作为视频图像播放的载体View，然后再OnVideoSizeChangeListener的监听回调中，对载体View的大小做更改。 

3. 切入后台后声音还在继续播放 

这个问题只需要在onPause中暂停播放即可 

4. 切入后台再切回来，视频黑屏 

诸如此类的黑屏问题，多是因为surfaceholder被销毁了，再切回来时，需要重新给MediaPlayer设置holder。 

5. 播放时会有一小段时间的黑屏 

视频准备完成后，调用play进行播放视频，承载视频播放的View会是黑屏状态，我们只需要在播放前，给对应的Surface绘制一张图即可。 

6.MediaPlayer: error (1, -2147483648)

error的第一个参数1表示未知错误。
错误码-2147483648是十进制表示的，对应16进制的0x80000000。
它定义在文件：/frameworks/native/include/utils/Errors.h
UNKNOWN_ERROR  = 0x80000000,
此错误一般是在framework的libmediaplayerservice，libstagefright目录中抛出的。在执行某个动作时被取消或者中断，就会抛出此错误。
报这个错的时候通常是因为解码失败。

7.MediaPlayer: error (-38,0)

这个error一般是因为状态不对，比如prepareAsync的时候还没有回调onPrepared，就开始getDuration或者开始调用start，尤其是多线程调用的时候要注意。