3行代码实现视频倍速播放：JiaoZiVideoPlayer变速技巧全解析

你是否还在为视频播放速度无法调节而烦恼？无论是学习课程需要慢速细看，还是追剧时想快速跳过剧情，播放速率控制都是提升观看体验的关键功能。本文将详解如何基于JiaoZiVideoPlayer实现从0.5x到2.0x的全范围播放速率调节，仅需简单几步即可为你的视频播放器添加专业级变速功能。

倍速功能实现原理

JiaoZiVideoPlayer通过自定义JzvdStd子类实现播放速率控制，核心原理是通过mediaInterface.setSpeed()方法调节播放速度。项目中已提供JzvdStdSpeed.java示例类，该类扩展了标准播放器并添加速率切换逻辑，支持0.5x、0.75x、1.0x、1.25x、1.5x、1.75x和2.0x七种速率。

快速集成步骤

1. 布局文件添加速率控制按钮

在播放器布局中添加速率选择按钮，推荐使用layout_std_speed.xml作为自定义布局，该文件在标准布局基础上增加了tv_speed TextView：

<TextView
    android:id="@+id/tv_speed"
    android:layout_width="wrap_content"
    android:layout_height="wrap_content"
    android:text="倍速"
    android:textColor="#ffffff"
    android:layout_marginRight="10dp"
    android:clickable="true"/>

2. 实现速率切换逻辑

继承JzvdStd实现自定义播放器类，核心代码如下：

public class JzvdStdSpeed extends JzvdStd {
    TextView tvSpeed;
    int currentSpeedIndex = 2; // 默认1.0x

    @Override
    public void init(Context context) {
        super.init(context);
        tvSpeed = findViewById(R.id.tv_speed);
        tvSpeed.setOnClickListener(v -> {
            currentSpeedIndex = (currentSpeedIndex + 1) % 7; // 循环切换
            float speed = getSpeedFromIndex(currentSpeedIndex);
            mediaInterface.setSpeed(speed);
            tvSpeed.setText(speed + "X");
        });
    }

    private float getSpeedFromIndex(int index) {
        float[] speeds = {0.5f, 0.75f, 1.0f, 1.25f, 1.5f, 1.75f, 2.0f};
        return speeds[index];
    }
}

3. 在Activity中使用自定义播放器

在布局文件中引用自定义播放器：

<cn.jzvd.demo.CustomJzvd.JzvdStdSpeed
    android:id="@+id/jz_video"
    android:layout_width="match_parent"
    android:layout_height="200dp"/>

在代码中设置视频源并启动播放：

JzvdStdSpeed jzvd = findViewById(R.id.jz_video);
jzvd.setUp(new JZDataSource("video_url", "标题"), Jzvd.SCREEN_NORMAL);

高级配置与优化

速率状态保存

通过JZDataSource的objects属性保存当前速率索引，实现屏幕旋转或切换时的状态保持：

// 保存速率状态
jzDataSource.objects = new Object[]{currentSpeedIndex};

// 恢复速率状态
if (jzDataSource.objects != null) {
    currentSpeedIndex = (int) jzDataSource.objects[0];
}

适配不同屏幕模式

在全屏模式下显示速率按钮，普通模式下隐藏：

@Override
public void setScreenFullscreen() {
    super.setScreenFullscreen();
    tvSpeed.setVisibility(View.VISIBLE);
}

public void setScreenNormal() {
    super.setScreenNormal();
    tvSpeed.setVisibility(View.GONE);
}

常见问题解决

1. 低版本兼容性处理

对于Android 6.0以下系统，需添加版本判断：

if (android.os.Build.VERSION.SDK_INT >= android.os.Build.VERSION_CODES.M) {
    tvSpeed.setVisibility(View.VISIBLE);
}

2. 速率切换闪烁问题

通过延迟加载和UI状态同步优化：

mediaInterface.setSpeed(speed);
tvSpeed.post(() -> tvSpeed.setText(speed + "X"));

实际效果展示

倍速控制按钮位于播放器右下角，点击循环切换速率：

注：实际效果请参考项目demo中的变速播放示例ActivityApi.java

总结与扩展

通过本文介绍的方法，你已掌握JiaoZiVideoPlayer的播放速率自定义技巧。该实现支持全范围速率调节，且与播放器其他功能完全兼容。如需更多自定义样式，可修改layout_std_speed.xml布局文件，或参考JzvdStd.java的控制逻辑进行扩展。

项目完整代码和更多示例请查看官方仓库，建议结合demo中的CustomJzvd目录下的其他自定义播放器实现，探索更多高级功能。

收藏本文，下次开发视频播放功能时即可快速集成倍速控制！关注项目更新，获取更多实用技巧。