你封装的Android播放器真的好用吗

背景

项目中主要用的是七牛云播放器,但是因为七牛云播放器暴露出来的问题越来越多,如
弱网seek会出现anr,还有一些native层的崩溃。于是就决定换个播放器用用。之前封装过ijkplayer,但需要更改FFmpeg配置文件,以及编译so文件比较繁琐。最后选择了阿里云播放器,以阿里云播放器为主,配合原生的MediaPlayer,封装一套易扩展,易调试,易使用的播放器

设计思路

  • 使用外观模式给使用者提供简单便利的接口api,由使用者决定选择何种播放内核
  • 通过建造者模式来构建播放配置
  • 给所有播放内核抽象出统一的播放控制接口
  • 给使用者提供统一的回调接口,中间做一层默认实现,让使用者按需使用
  • 每种播放内核实现统一的播放控制接口和回调接口
  • 每种播放内核用一个包装一层,用来实现一些逻辑适配统一接口

github地址

https://github.com/xiongliangshan/LsMediaPlayer

集成方式

gradle集成

allprojects {
        repositories {
            ...
            maven { url 'https://jitpack.io' }
        }
    }
dependencies {
            implementation 'com.github.xiongliangshan:LsMediaPlayer:1.0.1'
    }

直接library依赖
把整个lsplayer模块拷贝到你的项目中作为一个libaray,然后

implementation project(':lsplayer')

使用方式

基本使用1(xml)

或者使用TextureView渲染


然后代码中开始播放

    player.setDataSource(url)
    player.prepareAndStart()
基本使用2(使用自定义渲染视图)
var player: CommonPlayer? = null
player = PlayerEngine.createPlayer(context)
player.setDisplay(surfaceView)
player.setDataSource(url)
player.prepareAndStart()
播放内核无缝切换

如果是使用xml方式,在LsVideoSurfaceView里有一个自定义属性player_type
(对应LsVideoTextureView里也是一样的),它的值是枚举类型,"ali" 和
"media",直接改这个值就可以实现切换播放内核,其他任何地方都不用改。

如果是代码动态创建播放器,默认就是使用ali播放器内核,可以传参选择

 fun createPlayer(context:Context,type:PlayerType = PlayerType.Ali):CommonPlayer{
            return when(type){
                PlayerType.Ali -> AliPlayerWrapper(context)
                PlayerType.Media -> MediaPlayerWrapper()
                else ->{
                    AliPlayerWrapper(context)
                }
            }
        }
渲染器无缝切换

如果使用xml方式,直接把 LsVideoSurfaceView 和 LsVideoTextureView 相互替换即可。

如果是代码创建的播放器实例,直接更换方法参数

player.setDisplay(surfaceView)

player.setDisplay(textureView)
绑定生命周期

在Activity或者Fragment中使用播放器的时候,可以调用如下api

player?.bindLifecycle(owner)

这样就不用关心播放器资源释放的问题了,会在onDestroy的时候自动帮你释放播放器资源

设置回调监听
player.callback = object :SimpleLsPlayerCallback(){
                override fun onVideoSizeChanged(width: Int, height: Int) {
                    super.onVideoSizeChanged(width, height)
                }

                override fun onRenderingStart() {
                    super.onRenderingStart()
                }

                override fun onInfo(info: LsInfo?) {
                    super.onInfo(info)
                }

                override fun onSnapShot(bm: Bitmap?, with: Int, height: Int) {
                    super.onSnapShot(bm, with, height)
                }

                override fun onPrepared() {
                    super.onPrepared()
                }

                override fun onCompletion() {
                    super.onCompletion()
                }

                override fun onError(info: LsInfo) {
                    super.onError(info)
                }

                override fun onBufferingBegin() {
                    super.onBufferingBegin()
                }

                override fun onBufferingProgress(percent: Int, kbps: Float) {
                    super.onBufferingProgress(percent, kbps)
                }

                override fun onBufferingEnd() {
                    super.onBufferingEnd()
                }

                override fun onSeekComplete() {
                    super.onSeekComplete()
                }

                override fun onStateChanged(state: PlayerState) {
                    super.onStateChanged(state)
                }

                override fun onFetchDurationFinished(duration: Long) {
                    super.onFetchDurationFinished(duration)
                }

                override fun onPlayProgress(percent: Int) {
                    super.onPlayProgress(percent)
                }
            }

这些方法名字取得比较形象,一般能看出来是什么意思,如果实在看不出来,从代码点击调到顶层接口定义的地方,每个方法都有注释。

设置缓存
player?.lsConfig  = LsConfig.Builder()
                .setLoop(true)
                .setCacheDir(LsCacheConfig(it.cacheDir.absolutePath+File.separator+"video"))
                .setNetConfig(LsNetConfig(5000,2))
                .build()

目前setCacheDir 和 setNetConfig,这个只有在使用ali播放内核的时候才有效。

日志监控

在整个播放器封装的关键地方都打印了日志,内部采用原生的Log。

object SLog{

    var switch = true
    var printer:LogCallback? = null

    
    fun d(tag: String?,message: String?){
        if(switch){
            Log.d(tag,message)
        }
        printer?.printMessage(LsLevel.D,message)
    }

    fun i(tag:String?,message: String?){
        if(switch){
            Log.i(tag,message)
        }
        printer?.printMessage(LsLevel.I,message)
    }

  

    fun e(tag:String?,message: String?){
        if(switch){
            Log.e(tag,message)
        }
        printer?.printMessage(LsLevel.E,message)
    }

}

一般的信息都用的info级别,打印非常频范的日志使用的是debug级别,错误但不致命的使用warn级别,错误并且中断播放的使用error级别。

这里设了一个开关 swtich 默认是打开的,可以根据项目不同环境的包配置打开后者关闭。

这里还有一个LogCallback,主要是把日志回调抛出来给使用者。可以很方便的做存储或者网络上传到服务器。

快速开始

如果只是简单的播放一个视频,可以使用LsVideoSurfaceView 和 LsVideoTextureView 的 fastStart方法,一句代码实现播放

 player?.fastStart(url,object :SimpleLsPlayerCallback(){

            })

总结:

本次播放器封装主要是解决项目中零散的播放音视频需求,让使用者更方便的切换播放器内核,容易扩展,使用起来更加方便,容易调试。目前支持阿里云播放器和MediaPlayer。有些功能统一接口可能没有暴露出来,待后续慢慢完善

你可能感兴趣的:(你封装的Android播放器真的好用吗)