# iPlayer

**Repository Path**: lasereset/iPlayer

## Basic Information

- **Project Name**: iPlayer
- **Description**: 支持IJKPlayer、ExoPlayer、MediaPlayer和其它更多解码器切换、支持静音、镜像、渲染模式、倍速设置等功能的轻便级播放器，支持自定义解码器、控制器、UI交互组件和悬浮窗播放能力等
- **Primary Language**: Android
- **License**: Apache-2.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 64
- **Created**: 2023-02-10
- **Last Updated**: 2023-02-10

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# **iPlayer**

#### 一、SDK基础功能
* 支持网络地址、直播流、本地Assets和Raw音视频资源文件播放</br>
* 支持播放倍速、缩放模式、静音、镜像等功能设置</br>
* 支持自定义视频解码器、控制器、UI交互组件、视频画面渲染器</br>
* 支持多播放器同时播放</br>
* SDK默认控制器(局部UI交互可自定义)支持手势控制、付费试看等交互</br>
* 支持重力感应横竖屏旋转及开关设置</br>
* 支持任意位置启动Activity级别悬浮窗口播放</br>
* 支持任意位置启动全局悬浮窗口播放</br>
* 窗口播放器支持自动吸附悬停</br>
* 支持任意位置直接启动全屏播放</br>
* 支持连续播放视频列表</br>
* Demo：列表或组件之间无缝转场播放</br>
* Demo：全局悬浮窗播放转场跳转Activity</br>
* Demo：MediaPlayer、IjkPlayer、ExoPlayer三种解码器切换</br>
* Demo：仿抖音，支持视频缓存、秒播</br>
* Demo：弹幕交互</br>
* Demo：Android8.0+画中画示例</br>

#### 二、[历史版本][1]
[1]:https://gitee.com/hty527/iPlayer/wiki/Version "历史版本"

#### 三、SDK集成
* 建议集成前先[下载apk][2]体验，找到自己想要实现的功能模块，后续集成可参考demo源码。

[2]:https://amuse-1259486925.cos.ap-hongkong.myqcloud.com/apk/iPlayer-2.1.2.apk?version=2.1.2 "下载apk"

##### 1、项目根build.gradle配置</br>
```
    allprojects {
        repositories {
            maven { url 'https://jitpack.io' }
        }
    }
```
##### 2、模块build.gradle配置</br>
```
    dependencies {
        //播放器(无UI交互)
        implementation 'com.github.hty527.iPlayer:iplayer:2.1.20'
        //UI交互组件,可根据需要使用
        implementation 'com.github.hty527.iPlayer:widget:2.1.20'

        //音视频预缓存+边播边存,根据需要使用
        //implementation 'com.github.hty527.iPlayer:cache:2.1.20'

        //ijk音视频解码器,根据需要使用
        //implementation 'com.github.hty527.iPlayer:ijk:2.1.20'
        //exo音视频解码器,根据需要使用
        //implementation 'com.github.hty527.iPlayer:exo:2.1.20'
        //选择exo音视频解码器时需引用
        //以下为必须项，SDK内部已引用，集成时无需引用
        //implementation 'com.google.android.exoplayer:exoplayer:2.18.1'//（必需）
        //implementation 'com.google.android.exoplayer:exoplayer-core:2.18.1'//核心功能（必需）
        //implementation "com.google.android.exoplayer:extension-rtmp:2.18.1"//rtmp直播流解码协议//（必需）
        //exo音视频解码器，以下为可选依赖，请根据需要实现
        //implementation 'com.google.android.exoplayer:exoplayer-dash:2.18.1'//支持DASH内容
        //implementation "com.google.android.exoplayer:exoplayer-hls:2.18.1"//支持HLS内容
        //implementation "com.google.android.exoplayer:exoplayer-rtsp:2.18.1"//rtsp直播流解码协议
    }
```
##### 3、在需要播放视频的xml中添加如下代码,或在适合的位置new VideoPlayer()</br>
```
    <com.android.iplayer.widget.VideoPlayer
        android:id="@+id/video_player"
        android:layout_width="match_parent"
        android:layout_height="200dp"/>
```
##### 4、播放器准备及开始播放</br>
```
    mVideoPlayer = (VideoPlayer) findViewById(R.id.video_player);
    mVideoPlayer.getLayoutParams().height= getResources().getDisplayMetrics().widthPixels * 9 /16;//固定播放器高度，或高度设置为:match_parent
    //使用SDK自带控制器+各UI交互组件
    VideoController controller = new VideoController(mVideoPlayer.getContext());//创建一个默认控制器
    mVideoPlayer.setController(controller);//将播放器绑定到控制器
    WidgetFactory.bindDefaultControls(controller);//一键使用默认UI交互组件绑定到控制器(需集成：implementation 'com.github.hty527.iPlayer:widget:lastversion')
    //设置视频标题(仅横屏状态可见)
    controller.setTitle("测试地址播放");
    //设置播放源
    mVideoPlayer.setDataSource("https://upload.dongfeng-nissan.com.cn/nissan/video/202204/4cfde6f0-bf80-11ec-95c3-214c38efbbc8.mp4");
    //异步开始准备播放
    mVideoPlayer.prepareAsync();
```
##### 5、生命周期处理</br>
```
    @Override
    protected void onResume() {
        super.onResume();
        mVideoPlayer.onResume();
    }

    @Override
    protected void onPause() {
        super.onPause();
        mVideoPlayer.onPause();
    }

    @Override
    public void onBackPressed() {
        if(mVideoPlayer.isBackPressed()){
            super.onBackPressed();
        }
    }

    @Override
    protected void onDestroy() {
        super.onDestroy();
        mVideoPlayer.onDestroy();
    }
```
##### 6、常用API、更换解码器、自定义解码器、UI交互组件和悬浮窗口播放等功能请阅读[wiki][3]</br>
[3]:https://gitee.com/hty527/iPlayer/wiki "wiki"
#### 四、遇到问题
* 1、阅读接入文档[wiki][3]
* 2、提交 [issue](https://gitee.com/hty527/iPlayer/issues)
* 3、联系作者：584312311@qq.com
* 4、项目无法下载或下载缓慢请至[码云][4]下载
* 5、播放器框架结构图[点击][5]查看

[4]:https://gitee.com/hty527/iPlayer "码云"
[5]:https://gitee.com/hty527/iPlayer/wiki "点击"
#### 五、SDK及Demo部分功能预览
<div align="center">
    <img src="https://amuse-1259486925.cos.ap-hongkong.myqcloud.com/image/src1.jpg?q=1" width="270",height="585">
    <img src="https://amuse-1259486925.cos.ap-hongkong.myqcloud.com/image/src2.jpg?q=2" width="270",height="585">
</div>
<div align="center">
    <img src="https://amuse-1259486925.cos.ap-hongkong.myqcloud.com/image/src3.jpg?q=3" width="270",height="585">
    <img src="https://amuse-1259486925.cos.ap-hongkong.myqcloud.com/image/src4.jpg?q=4" width="270",height="585">
</div>
<div align="center">
    <img src="https://amuse-1259486925.cos.ap-hongkong.myqcloud.com/image/src5.jpg?q=5" width="270",height="585">
    <img src="https://amuse-1259486925.cos.ap-hongkong.myqcloud.com/image/src6.jpg?q=6" width="270",height="585">
</div>
<div align="center">
    <img src="https://amuse-1259486925.cos.ap-hongkong.myqcloud.com/image/src7.jpg?q=7" width="270",height="585">
    <img src="https://amuse-1259486925.cos.ap-hongkong.myqcloud.com/image/src8.jpg?q=8" width="270",height="585">
</div>

#### 六、鸣谢
* [ijkplayer][6]
* [ExoPlayer][7]
* [AndroidVideoCache][8]
* Demo演示视频列表模块api使用的是开眼api，本项目只做学习使用。禁止任何人应用于任何商业用途，由此带来的法律风险由应用于商业用途的一方承担！

[6]:https://github.com/bilibili/ijkplayer "ijkplayer"
[7]:https://github.com/google/ExoPlayer "ExoPlayer"
[8]:https://github.com/danikula/AndroidVideoCache "AndroidVideoCache"