# QSVideoPlayer **Repository Path**: linux19920212/QSVideoPayer ## Basic Information - **Project Name**: QSVideoPlayer - **Description**: 安卓视频播放器AndroidVideoplayer,架构设计优良功能丰富,支持多种解码,支持设置比例,浮窗,倍速,静音等 - **Primary Language**: Android - **License**: Apache-2.0 - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 45 - **Created**: 2024-12-18 - **Last Updated**: 2024-12-18 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README ![logo][logopng]

---
[![GitHub release][relesesvg]][relesezip] [![api][apisvg]][api] [![License][licensesvg]][license] * QSVideoView接口完善,功能丰富 * 支持设置视频比例 * 支持两种悬浮窗 * 支持扩展解码器 * 智能切换全屏 * 支持本地缓存 * 支持倍速静音等 * 架构设计优良,模块化可扩展设计,解码模块目前提供了 AndroidMedia(系统自带)、ijkMedia(基于ffmepg)+ijkExoMedia(基于exo)、ExoMedia(2.0.4)解码器 * 可选择SurfaceView和TextureView * 支持本地视频,在线视频,m3u8直播等 * 提供DemoQSVideoView成品播放器,支持手势,清晰度 * 极速DIY:只需100行java代码即可打造自己的播放器!
提供QSVideoViewHelp辅助类,该类提供了常用控件的逻辑和手势调节支持,可快速自定义ui打造自己的播放器,不用写一行播放逻辑 * 提供list视频列表自动销毁播放框架 * 提供一行代码集成弹幕框架 ![qrcode][qrpng]
[![apkurl][apkurlsvg]][apkurl] ## Preview ![](https://gitee.com/sakaue/QSVideoPayer/raw/master/source/main.png) ![](https://gitee.com/sakaue/QSVideoPayer/raw/master/source/full1.png) ![](https://gitee.com/sakaue/QSVideoPayer/raw/master/source/lsit.gif) ![](https://gitee.com/sakaue/QSVideoPayer/raw/master/source/float.png) ![](https://gitee.com/sakaue/QSVideoPayer/raw/master/source/full2.jpg) ## 使用说明 #### Gradle 自动集成 ``` allprojects { repositories { maven { url "https://jitpack.io" } } } dependencies { implementation 'com.gitee.sakaue:QSVideoPayer:2.2.9' //是否需要其他架构的ijk解码器支持,默认只有v7 //so不存在报错可以配置ndk{abiFilters 'armeabi-v7a'}或导入下面的包 //implementation 'tv.danmaku.ijk.media:ijkplayer-armv5:0.8.8' //implementation 'tv.danmaku.ijk.media:ijkplayer-arm64:0.8.8' //implementation 'tv.danmaku.ijk.media:ijkplayer-x86:0.8.8' //implementation 'tv.danmaku.ijk.media:ijkplayer-x86_64:0.8.8' } ``` #### 手动集成 下载项目 添加qsvideoplayer文件夹为自己的项目依赖即可 可根据需求自行选择需要的解码器:
默认一般简单播放视频AndroidMedia足够(体积最小,无依赖)
需求高的可选AndroidMedia+(ijkMedia+ijkExoMedia)(2MB单v7a包)
目前测试解码效果ijkMedia兼容性最好,AndroidMedia个别视频有半途中断BUG,exo无明显缺陷
ps:
如需精简删除ijk解码器: build.gradle注释掉所有依赖,media包里删除IjkBaseMedia IjkExoMedia IjkMedia三个类即可
弹幕、exo解码器在demo里,需要自行下载demo复制集成 ## QSVideoView API接口 ``` void setUp(String url, Object... objects);//设置视频地址 void play();//播放/初始化(完成自动播放) void prePlay();//初始化(完成不会播放) void pause();//暂停 void seekTo(int duration);//进度调节 void setPlayListener(PlayListener playListener);//播放监听 参数含义参照IVideoPlayer void addPlayListener(PlayListener playListener);//多播放监听 void removePlayListener(PlayListener playListener);//移除播放监听 void setAspectRatio(int aspectRatio);//设置视频比例 参数见IRenderView void setDecodeMedia(Class claxx);//设置解码模块 void openCache();//打开缓存 boolean onBackPressed();//返回键退出全屏 boolean isPlaying();//是否播放中 void enterWindowFullscreen();//全屏 void quitWindowFullscreen();//退出全屏 boolean enterWindowFloat(FloatParams floatParams);//浮窗 false没权限 void quitWindowFloat();//退出浮窗 boolean setMute(boolean isMute);//是否静音 false不支持 boolean setSpeed(float rate);//设置播放倍速,false不支持 void release();//销毁 Bitmap getCurrentFrame();//截图 int getPosition();//获取播放进度 int getDuration();//获取视频时长 int getVideoWidth();//获取视频宽 int getVideoHeight();//获取视频长 int getCurrentMode();//获得播放器当前的模式(全屏,普通,浮窗) int getCurrentState();//获得播放器当前的状态(播放,暂停,完成...) ``` ## Demo使用 ### JAVA ``` //DemoQSVideoView的ui用的jc播放器 DemoQSVideoView qsVideoView = (DemoQSVideoView) findViewById(R.id.xxx); qsVideoView.setUp(url, "这是一一一一一一一一一个标题"); //设置多个清晰度和ijk配置 //List list = new ArrayList<>(); //list.add(new IjkMedia.Option(IjkMediaPlayer.OPT_CATEGORY_PLAYER, "soundtouch", 1)); //demoVideoView.setUp( // QSVideo.Build(url).title("这是标清标题").definition("标清").resolution("标清 720P").build(), // QSVideo.Build(url).title("这是高清标题").definition("高清").resolution("高清 1080P").option(list).build()); qsVideoView.getCoverImageView().setImageResource(R.mipmap.cover);//封面 //设置监听 qsVideoView.setPlayListener(new PlayListener() { @Override public void onStatus(int status) {//播放器的ui状态 if (status == IVideoPlayer.STATE_AUTO_COMPLETE) qsVideoView.quitWindowFullscreen();//播放完成退出全屏 } @Override//全屏/普通/浮窗... public void onMode(int mode) { } @Override//播放事件 初始化完成/缓冲/出错/点击事件... public void onEvent(int what, Integer... extra) { } }); //进入全屏的模式 0横屏 1竖屏 2传感器自动横竖屏 3根据视频比例自动确定横竖屏 -1什么都不做 qsVideoView.enterFullMode=3; qsVideoView.play(); ``` ### 返回键退出全屏 ``` @Override public void onBackPressed() { if (qsVideoView.onBackPressed()) return; super.onBackPressed(); } ``` ### XML ``` ``` ### AndroidManifest ``` ``` ### 悬浮窗 ``` FloatParams floatParams = new FloatParams(); floatParams.x = 0;//浮窗中心坐标x floatParams.y = 0;//浮窗中心坐标y floatParams.w = 540;//宽 floatParams.h = 270;//高 floatParams.round = 30;//浮窗圆角 需SDK_INT >= 21 floatParams.fade = 0.8f;//透明度 需SDK_INT >= 11 floatParams.canMove = true;//是否可以拖动 floatParams.canCross = false;//是否可以越屏幕边界 floatParams.systemFloat = true;TRUE系统浮窗需要权限　FALSE界面内浮窗 if (!qsVideoView.enterWindowFloat(floatParams)) { Toast.makeText(this,"没有浮窗权限",Toast.LENGTH_LONG).show(); Intent intent = new Intent(Settings.ACTION_MANAGE_OVERLAY_PERMISSION, Uri.parse("package:" + getPackageName())); startActivityForResult(intent, 0); } } ``` ### 生命周期控制
实现后台暂停播放,超过15秒销毁,回来还原播放状态,体验好 ``` private boolean playFlag;//记录退出时播放状态 回来的时候继续播放 private int position;//记录销毁时的进度 回来继续该进度播放 private Handler handler = new Handler(); @Override public void onResume() { super.onResume(); if (playFlag) demoVideoView.play(); handler.removeCallbacks(runnable); if (position > 0) { demoVideoView.seekTo(position); position = 0; } } @Override public void onPause() { super.onPause(); if (demoVideoView.isSystemFloatMode()) return; //暂停 playFlag = demoVideoView.isPlaying(); demoVideoView.pause(); } @Override public void onStop() { super.onStop(); if (demoVideoView.isSystemFloatMode()) return; //进入后台不马上销毁,延时15秒 handler.postDelayed(runnable, 1000 * 15); } @Override public void onDestroy() { super.onDestroy();//销毁 if (demoVideoView.isSystemFloatMode()) demoVideoView.quitWindowFloat(); demoVideoView.release(); handler.removeCallbacks(runnable); } private Runnable runnable = new Runnable() { @Override public void run() { if (demoVideoView.getCurrentState() != IVideoPlayer.STATE_AUTO_COMPLETE) position = demoVideoView.getPosition(); demoVideoView.release(); } }; ``` ## DIY播放器: 0.read source code.

1.可直接修改DemoQSVideoView改造自己的播放器

2.继承QSVideoViewHelp参考DemoQSVideoView,源码均有注释,不用写一行播放逻辑
(1) 子类提供layout布局,布局里需要help类实现逻辑的控件,设置id为以下特定id即可 ``` //如播放按钮定义,注意: @id 没有加号,这样定义父类会自动完成该按钮逻辑 ```
(2) java代码里设置各个状态的ui即可完成自己的播放器,具体参考DemoQSVideoView

3.直接使用QSVideoView,自己写控制ui和逻辑
(继承关系:DemoQSVideoView → QSVideoViewHelp → QSVideoView) ## Log ### v2.2.9(2021-09-12) * 全屏虚拟键问题 * uri问题 * 其他优化 ### v2.2.8(2019-04-12) * 清晰度选择 * 优化 ### v2.2.7(2019-01-05) * 倍速播放 * 优化 ### v2.2.5(2018-10-24) * 支持视频缓存 ### v2.2.4(2018-9-1) * 浮窗超出屏幕回弹效果 * 优化 ### v2.2.3(2018-5-12) * +Danmaku(一行代码集成弹幕) * +getCurrentFrame(增加截图>=4.0) * +support systemfloat goback(系统浮窗可返回) * +perfect listenner(完善事件监听) ### v2.2.2(2018-2-13) * can get the floatparams after moving(可以获取移动后的浮窗参数) * 8.0 callback onInfo (804, -1004) problem(8.0断流回调onInfo(804,-1004)问题) * Immersion Demo(沉浸式Demo) ### v2.2.1(2018-1-30) * add floatwindow in activity(增加界面内悬浮窗功能,无需权限) * add event(seekbar) listener(增加seekbar事件监听) ### v2.2.0(2018-1-28) * add floatwindow(增加悬浮窗功能) ### v2.1.1(2018-1-8) * -add mute(支持静音) * -add enterfullmode(增加进入全屏的模式,根据视频自动确定横竖屏) * -support content uri(支持uri播放) * -fullwindow hide navigation(全屏隐藏虚拟按键) * -fix bug(修复bug) ## Other * 有问题请Add [issues](https://gitee.com/sakaue/QSVideoPayer/issues) * 如果项目对你有帮助的话欢迎star * logo@[mirzazulfan](https://github.com/mirzazulfan) [logopng]: https://gitee.com/sakaue/QSVideoPayer/raw/master/source/logo.png [qrpng]: https://gitee.com/sakaue/QSVideoPayer/raw/master/source/video_qrcode.png [relesesvg]: https://img.shields.io/github/release/tohodog/QSVideoPlayer.svg [relesezip]: https://codeload.github.com/tohodog/QSVideoPlayer/zip/2.2.7 [apkurlsvg]: https://img.shields.io/badge/download-demo.apk-brightgreen.svg?style=flat [apkurl]: https://gitee.com/sakaue/QSVideoPayer/raw/master/source/qsvideoplayer.apk [apisvg]: https://img.shields.io/badge/API-9+-brightgreen.svg [api]: https://android-arsenal.com/api?level=9 [licensesvg]: https://img.shields.io/badge/License-Apache--2.0-red.svg [license]: https://gitee.com/sakaue/QSVideoPayer/raw/master/LICENSE [starsvg]: https://img.shields.io/github/stars/tohodog/QSVideoPlayer.svg?style=social&label=Stars [star]: https://gitee.com/sakaue/QSVideoPayer