HDMediaPlayer

Introduction: Android MediaPlayer 播放器,一行代码实现播放本地音视频以及网络音视频。支持对字节流的播放,用于视频的加解密方案(不会产生缓存文件)。
More: Author   ReportBugs   
Tags:

Platform Feature LICENSE

该类包依托于谷歌 Mediaplayer 二次封装,一行代码就可以实现播放的逻辑。
谷歌中国 API 链接: Google 官网 API

特性

  • 该类支持播放格式有:音乐(.mp3、.wav、.ogg)、视频(.mp4、.3gp)

  • 支持播放本地音频、视频

  • 支持播放 Assets 目录下的音频、视频

  • 支持播放网络流媒体(仅限上述格式)

  • 支持对字节流的播放,用于视频的加解密方案(不会产生缓存文件)

  • 提供完整的视频流加解密输出与播放的案例

如何快速集成

导入方式

在工程级别的build.gradle添加

allprojects {
    repositories {
        ...
        maven { url 'https://jitpack.io' }
    }
}

在应用级别的build.gradle添加

api 'com.github.yinhaide:HDMediaPlayer:0.1.2'

如何使用

  • 一行代码实现播放 Assets 目录下的 mp4:
MediaPlayerHelper.getInstance().setSurfaceView(surfaceView).playAssetVideo(context,"test.mp4");
  • 一行代码实现播放 Assets 目录下的 mp3:
MediaPlayerHelper.getInstance().playAssetMusic(context,"test.mp3");
  • 一行代码实现播放网络流媒体或者本地全路径流媒体:
/**
 * urlString 可为网络流媒体连接,也可以为本地存储全路径链接
 */
MediaPlayerHelper.getInstance().setSurfaceView(surfaceView).playLocal(context,urlString);
MediaPlayerHelper.getInstance().setSurfaceView(surfaceView).playUrl(context,urlString);
  • 一行代码实现播放字节流(用于读取加密字节流,经过解密之后直接播放,不产生缓存文件):

    MediaPlayerHelper.getInstance().setSurfaceView(surfaceView).playVideoDataSource (byte[] videoBuffer);
    
  • 如果想得到详细的回调信息:

MediaPlayerHelper.getInstance().setOnStatusMediaCallBack(new MediaPlayerHelper.MediaPlayerHelperCallBack() {
    @Override
    public void onCallBack(MediaPlayerHelper.CallBackState state, Object... args) {
        Log.v(TAG,"--"+state.toString());
        if(state== MediaPlayerHelper.CallBackState.PROGRESS){
            int percent=(int)args[0];
            Log.v(TAG,"--progress:"+percent);
        }
    }
});
  • 更多的用法请查看 demo:
/** 设置播放进度回调时间间隔 */
MediaPlayerHelper.getInstance().setProgressInterval(msec);
/** 获得 MediaPlayer 对象,进行更多的自定义的操作 */
MediaPlayerHelper.getInstance().getMediaPlayer().pause();
MediaPlayerHelper.getInstance().getMediaPlayer().start();
MediaPlayerHelper.getInstance().getMediaPlayer().stop();

注意点

1、播放结束后到下次播放有黑屏现象

在部分配置比较低的电视或者手机设备中,视频播放完毕到下次播放之间可能存在 1s 左右的黑屏现象,原因是部分机器软解吗能力较弱,需要将数据解码放在内存当中导致黑屏。解决方案是开启手机的硬件加速能力,让硬件协助解码,消除黑屏现象。

<application
    android:hardwareAccelerated="true"
    ...
</application>

2、部分机型/电视存在黑屏有声音的现象 在部分机型中,会有播放没画面的,原因是因为 SurfaceHolder 可能在创建的时候尺寸不对,需要动态赋值。这个操作必须在主线程中进行。

@Override
public void surfaceCreated(SurfaceHolder holder) {
    ...
    if(holder != null && uiHolder.surfaceView != null){
        uiHolder.surfaceView.post(() -> holder.setFixedSize(uiHolder.surfaceView.getWidth(),uiHolder.surfaceView.getHeight()));
    }
    ...
}

3、低配置机型只能播放一次,下次再次播放直接黑屏 部分底端机型(小米电视 32 寸 1G+4G 配置),只能播放一次,第二次尝试柏昂都是失败的。解决办法:每次播放之前需要释放之前的 MediaPlayer,重新创建新的对象。MediaPlayer 需要比较多的内存,特别是低端机出问题的时候尝试释放资源再重新创建是有效的。

mediaPlayerHelper.reCreateMediaPlayer();

4、低配置机型在播放完毕之后会黑屏 部分底端机型(天猫魔盒),在视频播放完毕之后直接黑屏,而不是停留在最后一帧。解决办法就是不让它播放完毕,在播放到最后几十到一百毫秒的时候执行 pause()操作。

//进度间隔
mediaPlayerHelper.setProgressInterval(50);
//进度回调
mediaPlayerHelper.setOnStatusCallbackListener((state, args) -> {
    if(state == MediaPlayerHelper.CallBackState.PROGRESS){
        int videoDuration = mediaPlayerHelper.getMediaPlayer().getDuration();
        int videoPositionDuration = mediaPlayerHelper.getMediaPlayer().getCurrentPosition();
        int differ = videoDuration - videoPositionDuration;
        //播放到左后前面指定时间停止,防止黑屏
        if(differ < 180){
            this.mediaPlayerHelper.getMediaPlayer().pause();
        }
    }
});

这个项目会持续更新中...

都看到这里了,如果觉得写的可以或者对你有帮助的话,顺手给个星星点下 Star~

这个控件内部采用一个 Fragment 框架,如果有兴趣的话可以去了解一下

关于我

LICENSE

Copyright 2019 haide.yin(123302687@qq.com)

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

    http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
Apps
About Me
GitHub: Trinea
Facebook: Dev Tools