Android MediaPlayer 音频倍速播放，调整播放速度

本文链接： Android MediaPlayer 音频倍速播放，调整播放速度

现在市面上的很多音视频 App 都有倍速播放的功能，例如把播放速度调整为 0.5、1.5、2 倍等等。

从 Android API 23 (Android M)开始，MediaPlayer 支持调整播放速度。
使用的方法是 setPlaybackParams，传入一个代表播放属性的类 PlaybackParams。

本文介绍如何使用 MediaPlayer 调整播放速度。

MediaPlayer.setPlaybackParams 说明

播放速度设置在 PlaybackParams 对象中，再将此对象传入 setPlaybackParams。

setPlaybackParams 是一个 native 方法。
如果 MediaPlayer 没有准备（在 prepared 之前），调用此方法并不会改变 MediaPlayer 的状态。
在 MediaPlayer 成功 prepare 之后，如果设置的速度为 0，相当于调用了 pause 方法；如果设置速度不为 0，相当于调用了 start 方法。

异常情况

如果 MediaPlayer 没有初始化或者已经被释放，即处于 Idle 或 End 状态，调用 setPlaybackParams 方法会抛出 IllegalStateException 异常。

如果传入的 PlaybackParams 不被支持，则抛出 IllegalArgumentException 异常。

如果设置速度小于 0，则抛出 java.lang.IllegalArgumentException 异常。

MediaPlayer.setPlaybackParams 方法示例

设置播放速度。先判断当前系统版本。

private boolean setPlaySpeed(float speed) {
    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.M) {
        PlaybackParams params = mediaPlayer.getPlaybackParams();
        params.setSpeed(speed);
        mediaPlayer.setPlaybackParams(params);
        return true;
    }
    return false;
}

getPlaybackParams 可以获取到 MediaPlayer 当前的 PlaybackParams 对象。
也可以给这个方法加上 try catch，结合返回的 boolean 值判断设置速度是否成功。

private boolean setPlaySpeed(float speed) {
    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.M) {
        try {
            PlaybackParams params = mediaPlayer.getPlaybackParams();
            params.setSpeed(speed);
            mediaPlayer.setPlaybackParams(params);
            return true;
        } catch (Exception e) {
            Log.e(TAG, "setPlaySpeed: ", e);
            return false;
        }
    }
    return false;
}

参考代码 https://github.com/RustFisher/android-MediaPlayer

PlaybackParams 包含的速度值

调整 MediaPlayer 播放速度时，我们使用了 PlaybackParams 对象。AudioTrack 也会用到这个类。

PlaybackParams 包含着播放时候的一些属性。例如 speed 就是播放速度。

PlaybackParams.setSpeed(float speed)

传入速度倍率值。会标记当前设置过了速度。

public PlaybackParams setSpeed(float speed) {
    mSpeed = speed;
    mSet |= SET_SPEED;
    return this;
}

PlaybackParams.getSpeed()

获取已设置的速度值。如果之前没设置过速度，则抛出 IllegalStateException 异常。

public float getSpeed() {
    if ((mSet & SET_SPEED) == 0) {
        throw new IllegalStateException("speed not set");
    }
    return mSpeed;
}