在 Android 中使用 MediaPlayer 播放音频文件

Posted 小陈乱敲代码

tags:

篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了在 Android 中使用 MediaPlayer 播放音频文件相关的知识,希望对你有一定的参考价值。

前言

在本篇文章中,我们将学习如何在 android 中播放音频文件。

音乐会代替言语说话。

在 Android 应用程序中添加音频文件有多种方法。例如,您可以使用 ExoPlayer 或 MediaPlayer 在 Android 应用程序中播放音频文件。

在本文中,您将学习如何在 Android 中使用MediaPlayer播放音频文件。以下是您将在此博客中学习的内容:

  • 媒体播放器介绍
  • MediaPlayer的状态图
  • 准备()与准备异步()
  • 使用后释放 MediaPlayer
  • 两行 MediaPlayer 示例
  • 更高级的例子
  • 结束语

让我们开始吧。

媒体播放器介绍

为了在 Android 中播放音频或视频文件,Android 多媒体框架包括对 MediaPlayer API 的支持。因此,通过使用 MediaPlayer API,您可以播放 Android 文件系统中的音频/视频文件或播放应用程序资源文件中的文件,甚至可以像 Spotify 一样流式传输音频/视频文件。

以下是可以使用 MediaPlayer 执行的操作:

  • 准备媒体文件:要播放媒体文件,您需要先准备它,即您需要加载文件进行播放。用于执行此操作的方法是prepare()、prepareAsync()和setDataSource()。
  • 开始/暂停播放:加载媒体文件后,您可以使用start()方法开始播放媒体文件。同样,您可以使用pause()方法暂停正在播放的媒体文件。
  • 停止播放:您可以使用reset()方法停止播放。当我们想要停止播放然后准备另一个播放进行播放时使用此方法。
  • 查找位置:您可以使用seekTo(position)方法直接跳到媒体文件中的特定位置(以毫秒为单位)。
  • 歌曲长度:您可以使用getDuration()方法找到特定歌曲的长度(以毫秒为单位)。
  • 歌曲的当前位置:可以通过getCurrentPosition()方法获取当前播放位置。
  • 资源释放:您可以使用release()方法释放媒体播放器使用的内存和资源。

这些是可以使用 MediaPlayer API 执行的一些操作。那么,我们应该开始为 MediaPlayer 编写代码吗?不,一个很大的不。在进入代码之前,让我们看一下 MediaPlayer 的状态图,因为了解状态图非常重要,否则,您的应用程序可能会导致一些不必要的崩溃。

MediaPlayer的状态图

在本节中,我们将了解从开始播放到停止播放的不同状态。这些状态是:

  • 空闲状态:当您使用new关键字创建 MediaPlayer 对象时,该对象处于空闲状态。此外,当您调用reset()方法时,对象将进入空闲状态。在空闲状态下,MediaPlayer 对象没有任何反应。它仅表示对象已准备好播放某些媒体文件。因此,在空闲状态下,如果您尝试使用getCurrentPosition()方法获取歌曲的当前位置,或者您尝试使用pause()、start()、stop()、setVolume(), getDuration等方法,那么您将遇到一些不必要的应用程序崩溃。
  • 错误状态:如果您在使用reset()方法后在空闲状态中使用上述方法,则将调用OnErrorListener.onError()并将您的对象转移到错误状态。但是如果您使用“ new”关键字,则不会调用 OnErrorListener.onError() 并且状态将保持不变。要重用存在于错误状态中的对象,您需要调用reset()方法。
  • 结束状态:当您调用release()方法时,MediaPlayer 对象占用的所有资源都将被释放,对象将进入结束状态。如果对象处于结束状态,则无法将对象回调到其他状态。
  • 初始化状态: MediaPlayer 对象的整个生命周期介于空闲和结束状态之间。在空闲状态之后,您需要提供您要使用的数据源,即媒体源。因此,setDataSource()方法用于相同目的,之后,对象将进入初始化状态。当应用程序处于空闲状态时,应始终使用 setDataSource(),否则将通过 IllegalStateException。
  • 准备状态:在开始播放音乐之前,需要将 MediaPlayer 对象置于准备状态。在准备状态下,您可以调整视频/音频的循环或设置音量。因此,要将对象从初始化状态带入准备状态,您可以使用prepare()方法直接将对象转移到准备状态,也可以使用一种称为准备状态的中间状态。要从初始化状态进入准备状态,可以调用prepareAsync()方法将对象传输到准备状态,当准备完成时,调用OnPreparedListener接口的onPrepared()方法并将对象转移到准备状态。prepare()和prepareAsync()必须仅在此状态下调用,否则将通过 IllegalStateException。
  • 开始状态:在准备状态之后,如果你使用start()方法播放任何音频/视频文件,则对象进入开始状态,在这里你可以应用一些方法,如seekTo()或start()。如果您在start 状态下使用start(),那很好,不会发生任何事情。
  • 暂停状态:在播放音频或视频文件时,如果您暂停媒体,则它会进入暂停状态。您可以使用pause()方法将媒体置于暂停状态。为了恢复媒体,您可以使用start()方法。恢复的播放位置与暂停的位置相同,使用start()方法后,播放将恢复,对象将移动到启动状态。在暂停状态下调用pause()方法没有任何效果。
  • 停止状态:当您从准备、启动、暂停或播放完成状态使用stop()方法时, MediaPlayer 对象将进入停止状态,为了再次播放音频/视频,您需要将对象发送到通过调用prepare()或prepareAsync()方法准备好的状态。在停止状态下调用stop()方法没有任何效果。
  • PlaybackCompleted 状态:如果循环设置为真,即您想一次又一次地播放媒体文件,则对象应保持在启动状态。如果循环设置为false,则OnCompletion.onCompletion()将在媒体文件完成后调用,并且对象将进入PlaybackCompleted状态。为了重新开始播放,您可以调用start()方法。

下图是我们在本博客上述部分讨论的内容的总结。在使用 MediaPlayer 之前了解它的状态非常重要,因为有些方法必须仅在特定状态下调用,否则会出现异常。因此,最好了解所有状态。

准备()与准备异步()

在上面的部分中,我们已经看到要将 MediaPlayer 对象从初始化状态带入准备状态,我们有两个选择,即我们可以使用prepare()方法,对象将直接进入准备状态,或者我们可以使用中间状态,即准备状态将对象发送到准备状态。要从初始化状态进入准备状态,我们可以使用prepareAsync()方法。那么, prepare()和prepareAsync()方法有什么区别呢?

如果您正在调用prepare()方法,那么它将获取并解码您的媒体数据,此过程可能需要一些时间。因此,如果您从应用程序的 UI 线程调用此prepare()方法,那么这可能会导致您的应用程序出现延迟,最终您将失去用户。因此,您可以在其他线程上运行它,而不是在 UI 线程上运行prepare()方法,当媒体数据的获取和解码完成后,该线程应通知主线程,主线程将执行休息。所以,这个过程是在prepareAsync()方法的帮助下完成的。

发布媒体播放器

在上一节中,我们已经看到了 MediaPlayer 的所有状态。在继续之前,我想提一下我们都应该遵循的重要一点,即在使用 MediaPlayer 对象后释放它。

每当我们使用 MediaPlayer 时,MediaPlayer 都会获取各种系统资源。因此,当您使用完 MediaPlayer 后,您应该通过调用release()方法释放 MediaPlayer 获取的所有资源。此外,如果您没有在后台运行媒体应用程序,那么您应该在应用程序处于onPause()状态时释放所有资源。释放资源是重要的一步,因为如果您不执行此操作,那么您的应用程序可能会导致糟糕的用户体验。

两行 MediaPlayer 示例

在这一部分,我将讨论 MediaPlayer 的一个基本示例,即如何仅通过打开一个活动来播放媒体文件。在这里,我不会处理 MediaPlayer 的任何状态,也不会使用与 MediaPlayer 相关的任何高级方法,即 seekTo()、getCurrentPosition()、getDuration() 等。所以,让我们看一下 MediaPlayer 的两行示例。

使用 EmptyActivity 模板在 Android Studio 中创建一个新项目。在这里,在这个例子中,我们将拥有一个音频文件,我们将在我们的应用程序中使用这个文件。因此,在app/res目录中,通过右键单击 res 目录创建原始目录,然后单击新建,然后单击Android Resource Directory。将资源类型选择为raw,然后单击OK。在您创建的原始目录中,放置您的音频文件,我们稍后将使用此音频文件。

如果要流式传输音频文件,则必须在AndroidManifest.xml文件中允许 Internet 权限。

<uses-permission android:name="android.permission.INTERNET" />

现在,要从您的资源目录 ( raw ) 播放音频文件,只需添加以下两行代码,您就可以使用您的两行音乐应用程序了。

var mediaPlayer: MediaPlayer? = MediaPlayer.create(context, R.raw.sample_media)
mediaPlayer?.start() // no need to call prepare(); create() does that for you

运行您的应用程序并欣赏音乐

在从文件系统播放音乐的情况下,您可以使用getDataSource()方法并将您的 URI 作为参数传递给它。

val sampleUri: Uri = .... // your uri here
val mediaPlayer: MediaPlayer? = MediaPlayer().apply 
    setAudiostreamType(AudioManager.STREAM_MUSIC)
    setDataSource(applicationContext, sampleUri) //to set media source and send the object to the initialized state
    prepare() //to send the object to prepared state
    start() //to start the music and send the object to the started state

此外,要从 URL 播放某些媒体文件,您可以使用上述 URI 过程来完成,并且可以在 URI 的位置放置音频文件的 URL。

val sampleUrl = "http://........" // your URL here
val mediaPlayer: MediaPlayer? = MediaPlayer().apply 
    setAudioStreamType(AudioManager.STREAM_MUSIC) //to send the object to the initialized state
    setDataSource(sampleUrl) //to set media source and send the object to the initialized state
    prepare() //to send the object to the prepared state, this may take time for fetching and decoding
    start() //to start the music and send the object to started state

在上面的例子中,我们缺少一些推荐的步骤,即我们没有在使用对象后释放它。此外,我们不会处理 MediaPlayer 的所有状态。那么,让我们看一下使用所有功能的 MediaPlayer 的一些高级示例。

更高级的例子

在此示例中,我们将构建一个媒体播放器,在该媒体播放器中,我们可以播放、暂停和停止媒体文件。此外,我们可以将搜索栏移动到某个位置以从该位置播放音乐。在这个例子中,我将只关注逻辑部分。那么,让我们开始吧。

在您的app/res/raw目录中,粘贴您的音频文件。

现在,为播放、暂停和停止制作三个按钮。同时,您可以添加一个搜索栏来显示音频文件的计时器(这是一个可选步骤)。

现在,在MainActivity.kt文件中,您需要制作 MediaPlayer 的对象。

private lateinit var mediaPlayer: MediaPlayer

现在,对于播放按钮,有两种情况:

  1. 音频处于暂停状态:当音频处于暂停状态时,您必须使用 getC urrentPosition找到音频的当前位置,然后启动媒体播放器。
  2. 音频处于准备状态:当音频处于准备状态时,您可以使用 start() 方法启动音频。
    以下是相同的代码:
// Start the media player
playBtn.setOnClickListener
    if(pause) //initially, pause is set to false
        mediaPlayer.seekTo(mediaPlayer.currentPosition)
        mediaPlayer.start()
        pause = false
        //playing audio when in paused state
    else
        mediaPlayer = MediaPlayer.create(applicationContext,R.raw.demo)
        mediaPlayer.start()
        //playing audio when in prepared state
    

对于暂停按钮,只有一种情况,即如果正在播放音频,那么您只需使用pause()方法暂停音频。以下是相同的代码:

if(mediaPlayer.isPlaying)
    mediaPlayer.pause()
    pause = true
    //audio is paused here

对于停止按钮,您必须检查音频是否仍在播放或处于暂停状态,因为在进入停止状态之前,音频可能处于启动或暂停状态。如果是这样,那么stop(),reset(),最后是release()播放器。以下是相同的代码:

if(mediaPlayer.isPlaying || pause.equals(true))
    pause = false
    mediaPlayer.stop()
    mediaPlayer.reset()
    mediaPlayer.release()
    //audio is stopped here

就是这样,你会适合使用MediaPlayer。

结束语

在这篇文章中,我们了解了 MediaPlayer 以及如何使用它。我们看到了 MediaPlayer 对象的生命周期。我们看到了 prepare() 和 prepareAsync() 之间的区别。最后,我们看到了一些 MediaPlayer 的例子。

以上是关于在 Android 中使用 MediaPlayer 播放音频文件的主要内容,如果未能解决你的问题,请参考以下文章

Android 音频开发之 MediaPlayer

Android -- MediaPlayer内部实现简析

Android:MediaPlayer 未发布就完成了

Android -- 多媒体播放之MediaPlayer使用内部实现简析

无法在 android 中使用 MediaPlayer 播放 MediaStore.Audio 歌曲

Mediaplayer没有在android中启动