MediaMusicPlayer

java.lang.Object
- snow.player.audio.AbstractMusicPlayer
- - snow.player.audio.MediaMusicPlayer

所有已实现的接口:

MusicPlayer
```
public class MediaMusicPlayer
extends AbstractMusicPlayer
```
封装了一个 MediaPlayer。

嵌套类概要
- 从接口继承的嵌套类/接口 snow.player.audio.MusicPlayer
  MusicPlayer.OnBufferingUpdateListener, MusicPlayer.OnCompletionListener, MusicPlayer.OnErrorListener, MusicPlayer.OnPreparedListener, MusicPlayer.OnRepeatListener, MusicPlayer.OnSeekCompleteListener, MusicPlayer.OnStalledListener

构造器概要

构造器
构造器和说明
`MediaMusicPlayer(android.content.Context context, android.net.Uri uri)` 创建一个 `MediaMusicPlayer` 对象。
`MediaMusicPlayer(android.content.Context context, android.net.Uri uri, java.util.Map<java.lang.String,java.lang.String> headers)` 创建一个 `MediaMusicPlayer` 对象。
`MediaMusicPlayer(android.content.Context context, android.net.Uri uri, java.util.Map<java.lang.String,java.lang.String> headers, java.util.List<java.net.HttpCookie> cookies)` 创建一个 `MediaMusicPlayer` 对象。

方法概要

所有方法实例方法具体方法
限定符和类型	方法和说明
`int`	`getAudioSessionId()` 获取音频会话 ID。
`int`	`getDuration()` 获取当前音频文件的持续时间（单位：毫秒）。
`int`	`getProgress()` 获取当前的播放进度（单位：毫秒）。
`boolean`	`isInvalid()` 当前音乐播放器是否已失效（对于新创建的对象，该方法默认返回 false）。
`boolean`	`isLooping()` 判断是否循环播放（默认为 false）。
`boolean`	`isPlaying()` 判断播放器是否正在播放。
`boolean`	`isStalled()` 判断当前播放器是否处于 stalled 状态。
`void`	`pauseEx()` 暂停播放。
`void`	`prepare()` 准备音乐播放器。
`void`	`releaseEx()` 释放音乐播放器。
`void`	`seekTo(int pos)` 调整播放器的播放进度。
`void`	`setLooping(boolean looping)` 设置是否循环播放。
`void`	`setOnBufferingUpdateListener(MusicPlayer.OnBufferingUpdateListener listener)` 设置一个 `MusicPlayer.OnBufferingUpdateListener` 监听器。
`void`	`setOnCompletionListener(MusicPlayer.OnCompletionListener listener)` 设置一个 `MusicPlayer.OnCompletionListener` 监听器。
`void`	`setOnErrorListener(MusicPlayer.OnErrorListener listener)` 设置一个 `MusicPlayer.OnErrorListener` 监听器。
`void`	`setOnPreparedListener(MusicPlayer.OnPreparedListener listener)` 设置一个 `MusicPlayer.OnPreparedListener` 监听器。
`void`	`setOnRepeatListener(MusicPlayer.OnRepeatListener listener)` 设置一个 `MusicPlayer.OnRepeatListener` 监听器。
`void`	`setOnSeekCompleteListener(MusicPlayer.OnSeekCompleteListener listener)` 设置一个 `MusicPlayer.OnSeekCompleteListener` 监听器。
`void`	`setOnStalledListener(MusicPlayer.OnStalledListener listener)` 设置一个 `MusicPlayer.OnStalledListener` 监听器。
`void`	`setSpeed(float speed)` 设置音乐播放器的播放速度。
`void`	`setVolume(float leftVolume, float rightVolume)` 设置音量为当前音量的百分比，范围为 [0.0 ~ 1.0] 的闭区间。
`void`	`startEx()` 开始播放。
`void`	`stopEx()` 停止播放。

从类继承的方法 snow.player.audio.AbstractMusicPlayer
dismissQuiet, pause, quiet, release, start, stop

从类继承的方法 java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- 构造器详细资料
  - MediaMusicPlayer
```
public MediaMusicPlayer(@NonNull
                        android.content.Context context,
                        @NonNull
                        android.net.Uri uri)
```
    创建一个 MediaMusicPlayer 对象。
    
    参数:
    
    context - Context 对象，不能为 null
    
    uri - 要播放的歌曲的 URI，不能为 null
  - MediaMusicPlayer
```
public MediaMusicPlayer(@NonNull
                        android.content.Context context,
                        @NonNull
                        android.net.Uri uri,
                        @Nullable
                        java.util.Map<java.lang.String,java.lang.String> headers)
```
    创建一个 MediaMusicPlayer 对象。
    
    参数:
    
    context - Context 对象，不能为 null
    
    uri - 要播放的歌曲的 URI，不能为 null
    
    headers - HTTP 首部
  - MediaMusicPlayer
```
public MediaMusicPlayer(@NonNull
                        android.content.Context context,
                        @NonNull
                        android.net.Uri uri,
                        @Nullable
                        java.util.Map<java.lang.String,java.lang.String> headers,
                        @Nullable
                        java.util.List<java.net.HttpCookie> cookies)
```
    创建一个 MediaMusicPlayer 对象。
    
    参数:
    
    context - Context 对象，不能为 null
    
    uri - 要播放的歌曲的 URI，不能为 null
    
    headers - HTTP 首部
    
    cookies - HTTP cookies
- 方法详细资料
  - prepare
```
public void prepare()
             throws java.lang.Exception
```
    从接口复制的说明: MusicPlayer
    
    准备音乐播放器。
    该方法会在主线程上执行，如果准备操作是个耗时操作，你应该在异步线程中执行它。
    在实现该方法时，建议先检查 MusicPlayer.isInvalid() 状态，如果返回 true，说明当前 MusicPlayer 已失效，此时因立即从该方法中返回，不应该再调用任何方法。
    
    抛出:
    
    java.lang.Exception
  - setLooping
```
public void setLooping(boolean looping)
```
    从接口复制的说明: MusicPlayer
    
    设置是否循环播放。
    如果播放器处于循环播放状态，则应返回 true，否则返回 false。对于新创建的 MusicPlayer 对象来说，该方法默认返回 false。
    
    参数:
    
    looping - 是否循环播放（默认返回 false）。
  - isLooping
```
public boolean isLooping()
```
    从接口复制的说明: MusicPlayer
    
    判断是否循环播放（默认为 false）。
    
    返回:
    
    是否循环播放（默认为 false）。
  - isStalled
```
public boolean isStalled()
```
    从接口复制的说明: MusicPlayer
    
    判断当前播放器是否处于 stalled 状态。
    stalled 状态用于表示当前缓冲区是否有足够的数据继续播放，如果缓冲区没有足够的数据支撑继续播放，则该方法会返回 true，如果缓冲区有足够的数据可以继续播放，则返回 false。
    
    返回:
    
    当前播放器是否处于 stalled 状态
  - isPlaying
```
public boolean isPlaying()
```
    从接口复制的说明: MusicPlayer
    
    判断播放器是否正在播放。
    该方法的返回值只受 MusicPlayer.start()、MusicPlayer.pause()、MusicPlayer.stop()、发生错误或者 MusicPlayer.release() 的影响。调用 MusicPlayer.start() 方法后，该方法应该返回 true，并且只在调用 MusicPlayer.pause()、 MusicPlayer.stop()、播放器发生错误或者调用了 MusicPlayer.release() 方法时才返回 false。调用了 MusicPlayer.start() 方法后，即使缓冲区没有足够的数据支持继续播放，只要没有没有调用 MusicPlayer.pause()、MusicPlayer.stop()、发生错误或者调用 MusicPlayer.release() 方法，该方法就应该返回 true，即使当前缓冲区没有足够的数据，播放器正在缓冲。
    
    返回:
    
    播放器是否正在播放音乐
  - getDuration
```
public int getDuration()
```
    从接口复制的说明: MusicPlayer
    
    获取当前音频文件的持续时间（单位：毫秒）。
    
    返回:
    
    当前音频文件的持续时间（单位：毫秒），如果持续时间未知，则返回 -1。
  - getProgress
```
public int getProgress()
```
    从接口复制的说明: MusicPlayer
    
    获取当前的播放进度（单位：毫秒）。
    
    返回:
    
    返回当前的播放进度（单位：毫秒）
  - startEx
```
public void startEx()
```
    从类复制的说明: AbstractMusicPlayer
    
    开始播放。
    
    指定者:
    
    startEx 在类中 AbstractMusicPlayer
  - pauseEx
```
public void pauseEx()
```
    从类复制的说明: AbstractMusicPlayer
    
    暂停播放。
    
    指定者:
    
    pauseEx 在类中 AbstractMusicPlayer
  - stopEx
```
public void stopEx()
```
    从类复制的说明: AbstractMusicPlayer
    
    停止播放。
    
    指定者:
    
    stopEx 在类中 AbstractMusicPlayer
  - seekTo
```
public void seekTo(int pos)
```
    从接口复制的说明: MusicPlayer
    
    调整播放器的播放进度。
    
    参数:
    
    pos - 要调整到的播放位置（单位：毫秒）
  - setVolume
```
public void setVolume(float leftVolume,
                      float rightVolume)
```
    从接口复制的说明: MusicPlayer
    
    设置音量为当前音量的百分比，范围为 [0.0 ~ 1.0] 的闭区间。
    如果你的播放器实现不打算支持单独分别设置左右声道的音量，则全部使用 leftVolume 参数的值即可。
    
    参数:
    
    leftVolume - 左声道的音量百分比（范围为 [0.0 ~ 1.0] 的闭区间）
    
    rightVolume - 右声道的音量百分比（范围为 [0.0 ~ 1.0] 的闭区间）
  - setSpeed
```
public void setSpeed(float speed)
```
    从接口复制的说明: MusicPlayer
    
    设置音乐播放器的播放速度。
    
    参数:
    
    speed - 播放速度，最小值为 0.1。
  - releaseEx
```
public void releaseEx()
```
    从类复制的说明: AbstractMusicPlayer
    
    释放音乐播放器。
    
    指定者:
    
    releaseEx 在类中 AbstractMusicPlayer
  - isInvalid
```
public boolean isInvalid()
```
    从接口复制的说明: MusicPlayer
    
    当前音乐播放器是否已失效（对于新创建的对象，该方法默认返回 false）。
    当播放器发生错误，或者调用 MusicPlayer.release() 方法后，该方法应该返回 true。如果该方法返回 true，则不应再调用除 MusicPlayer.release() 方法以外的任何其他方法。
    
    返回:
    
    返回 true 表示当前音乐播放器已失效，此时不应再调用除 MusicPlayer.release() 方法以外的任何其他方法
  - getAudioSessionId
```
public int getAudioSessionId()
```
    从接口复制的说明: MusicPlayer
    
    获取音频会话 ID。如果失败，则返回 0。
    
    返回:
    
    音频会话 ID。如果失败，则返回 0。
  - setOnPreparedListener
```
public void setOnPreparedListener(@Nullable
                                  MusicPlayer.OnPreparedListener listener)
```
    从接口复制的说明: MusicPlayer
    
    设置一个 MusicPlayer.OnPreparedListener 监听器。
    
    参数:
    
    listener - 监听器对象，可为 null。为 null 时将清除上次设置的监听器。
  - setOnCompletionListener
```
public void setOnCompletionListener(@Nullable
                                    MusicPlayer.OnCompletionListener listener)
```
    从接口复制的说明: MusicPlayer
    
    设置一个 MusicPlayer.OnCompletionListener 监听器。
    
    参数:
    
    listener - 监听器对象，可为 null。为 null 时将清除上次设置的监听器。
  - setOnRepeatListener
```
public void setOnRepeatListener(@Nullable
                                MusicPlayer.OnRepeatListener listener)
```
    从接口复制的说明: MusicPlayer
    
    设置一个 MusicPlayer.OnRepeatListener 监听器。
    
    参数:
    
    listener - 监听器对象，可为 null。为 null 时将清除上次设置的监听器。
  - setOnSeekCompleteListener
```
public void setOnSeekCompleteListener(@Nullable
                                      MusicPlayer.OnSeekCompleteListener listener)
```
    从接口复制的说明: MusicPlayer
    
    设置一个 MusicPlayer.OnSeekCompleteListener 监听器。
    
    参数:
    
    listener - 监听器对象，可为 null。为 null 时将清除上次设置的监听器。
  - setOnStalledListener
```
public void setOnStalledListener(@Nullable
                                 MusicPlayer.OnStalledListener listener)
```
    从接口复制的说明: MusicPlayer
    
    设置一个 MusicPlayer.OnStalledListener 监听器。
    
    参数:
    
    listener - 监听器对象，可为 null。为 null 时将清除上次设置的监听器。
  - setOnBufferingUpdateListener
```
public void setOnBufferingUpdateListener(@Nullable
                                         MusicPlayer.OnBufferingUpdateListener listener)
```
    从接口复制的说明: MusicPlayer
    
    设置一个 MusicPlayer.OnBufferingUpdateListener 监听器。
    
    参数:
    
    listener - 监听器对象，可为 null。为 null 时将清除上次设置的监听器。
  - setOnErrorListener
```
public void setOnErrorListener(@Nullable
                               MusicPlayer.OnErrorListener listener)
```
    从接口复制的说明: MusicPlayer
    
    设置一个 MusicPlayer.OnErrorListener 监听器。
    
    参数:
    
    listener - 监听器对象，可为 null。为 null 时将清除上次设置的监听器。

类 MediaMusicPlayer

嵌套类概要

从接口继承的嵌套类/接口 snow.player.audio.MusicPlayer

构造器概要

方法概要

从类继承的方法 snow.player.audio.AbstractMusicPlayer

从类继承的方法 java.lang.Object

构造器详细资料

MediaMusicPlayer

MediaMusicPlayer

MediaMusicPlayer

方法详细资料

prepare

setLooping

isLooping

isStalled

isPlaying

getDuration

getProgress

startEx

pauseEx

stopEx

seekTo

setVolume

setSpeed

releaseEx

isInvalid

getAudioSessionId

setOnPreparedListener

setOnCompletionListener

setOnRepeatListener

setOnSeekCompleteListener

setOnStalledListener

setOnBufferingUpdateListener

setOnErrorListener