# HPlayer

**Repository Path**: zzhhz/HPlayer

## Basic Information

- **Project Name**: HPlayer
- **Description**: 多媒体文件播放
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2022-03-22
- **Last Updated**: 2023-07-04

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 不在维护    --> https://gitee.com/zzhhz/HMedia

# About
在刚开始使用android中的MediaPlayer的时候由于对整个播放的流程不太熟悉会经常在不合适的状态下调用了某个方法导致异常，这个库对MediaPlayer
进行了封装，内部会处理各种状态下的是否合法调用处理，并且定义了播放的各种状态，使用起来更方便

## Gradle
[![](https://jitpack.io/v/zzhhz/player.svg)](https://jitpack.io/#zzhhz/player)

## 常用方法
```java
mPlayer.setOnStateChangeCallback(new HMediaPlayer.OnStateChangeCallback()
{
    @Override
    public void onStateChanged(HMediaPlayer.State oldState, HMediaPlayer.State newState, HMediaPlayer player)
    {
        //状态变化回调
    }
});
mPlayer.setOnProgressCallback(new HMediaPlayer.OnProgressCallback()
{
    @Override
    public void onProgress(int currentPosition, int totalDuration, HMediaPlayer player)
    {
        //设置播放进度回调，每隔250毫秒触发一次此方法，用于更新播放进度
    }
});
mPlayer.setDataRawResId(R.raw.cbg, this); //设置要播放的数据
mPlayer.setDataPath("http://xxx.xxx.mp4"); //设置在线视频地址或者本地文件路径

mPlayer.start(); //播放
mPlayer.pause(); //暂停
mPlayer.stop(); //停止
mPlayer.performPlayPause(); // 调用此方法会在 播放和暂停之间切换
mPlayer.performPlayStop(); //调用此方法会在 播放和停止之间切换

mPlayer.setLooping(true); //循环播放
mPlayer.getDuration(); //返回总时长（毫秒）
mPlayer.getCurrentPosition(); //返回当前播放的进度位置（毫秒）
mPlayer.setDisplay(sfv_media.getHolder()); //设置SurfaceHolder
mPlayer.setVolume(1, 1); //设置左右声道音量
mPlayer.getVideoWidth(); //返回视频宽度
mPlayer.getVideoHeight(); //返回视频高度

mPlayer.reset(); //重置
mPlayer.release(); //释放，释放后如果需要重新使用需要调用init()方法重新初始化
```
## 播放器状态
```java
public enum State
{
    /**
     * 已经释放资源
     */
    Released,
    /**
     * 空闲，还没设置dataSource
     */
    Idle,
    /**
     * 已经设置dataSource，还未播放
     */
    Initialized,
    /**
     * 准备中
     */
    Preparing,
    /**
     * 准备完毕
     */
    Prepared,
    /**
     * 已经启动播放
     */
    Playing,
    /**
     * 已经暂停播放
     */
    Paused,
    /**
     * 已经播放完毕
     */
    Completed,
    /**
     * 调用stop方法后的状态
     */
    Stopped;
}
```

## App 视频缓存

    对AndroidVideoCache开源库的补充，支持预加载短视频数据的能力。
AndroidVideoCache只支持边下边播以及缓存的能力，但是一般情况下，为了短视频首帧能秒出，以MP4为例，如果不提前预加载的数据的情况下，播放器需要先下载MP4格式的头部数据以及几帧数据之后才开始渲染，这其中无疑下载的耗时最大的决定了首帧出现的时间，从而在秒出效果上是有影响的。因此提前做预加载就显得有必要。

#### 几个重要的类
考虑到一种场景如feed信息流中就不乏存在短视频，在点击某个短视频进入全屏页面的时候，一般也像抖音那样可以上下滑动列表的全屏列表页。

因此VideoPreload库涉及几个类：

1. VideoPreLoadFuture：每个需要用到短视频列表的页面需要初始化， 后续拿着该实例进行相应操作（如下两个方法）
```
/**
  * @param  context
  * @param  preloadBusId 每个页面对应一个preloadBusId
 /
public VideoPreLoadFuture(Context context, String preloadBusId)
// 增量添加视频列表
public void addUrls(List<String> urls);
// 全量添加视频列表
public void updateUrls(List<String> urls)；
```

2. PreloadManager: 预加载VideoPreLoadFuture能力管理类
```
// 为方便管理，使用者可通过preloadBusId获取VideoPreLoadFuture实例，可选调用
public VideoPreLoadFuture getVideoPreLoadFuture(String preloadBusId)；

/**
  *接入者的播放组件在开始播放的时候调用该方法，参数preloadBusId和VideoPreLoadFuture
  * 初始化的VideoPreLoadFuture保持一致，url为短视频播放地址
*/
public void currentVideoPlay(String preloadBusId, String url) 
```

#### 接入例子
1. 在某个Activity或者Fragment下，初始化VideoPreLoadFuture
```
  if (videoPreMultiLoadFuture == null) {
       videoPreMultiLoadFuture = new VideoPreLoadFuture(context, "test");
  }
```
2. 请求完短视频列表数据之后，进行增量或者全量设置视频url列表，用于预加载
```
  videoPreMultiLoadFuture.addUrls(Arrays.asList(PreloadManager.MOCK_DATA));
```
或
```
  PreLoadManager.getInstance(context).getVideoPreLoadFuture("test").addUrls(Arrays.asList(PreloadManager.MOCK_DATA));
```
3. 在播放组件中，如XXXVideoView（一般情况，每个业务方都会有关于播放器的封装view）的开始播放方法如start方法设置当前正在播放的url，
   PreloadManager的currentVideoPlay会根据当前播放url对应所在url列表中的位置，进行附近url的提前预加载
```
  public void start() {
    // 通过该方法可打印出对应url是否已经预加载完成并存在相关的数据
    if (PreloadManager.getInstance().hasEnoughCache(url)) {
            Log.d(PreloadManager.TAG, url + " has a cache");
    }
    
    // 参数preloadBusId和VideoPreLoadFuture初始化的VideoPreLoadFuture保持一致，url为当前短视频播放地址
    PreloadManager.getInstance().currentVideoPlay(preloadBusId, url);
  }
```

很简单的几步就可以完成短视频数据的预加载，而且也完美的配合AndroidVideoCache的能力