{"id":13907974,"url":"https://github.com/tohodog/QSVideoPlayer","last_synced_at":"2025-07-18T06:32:17.817Z","repository":{"id":37405690,"uuid":"86548402","full_name":"tohodog/QSVideoPlayer","owner":"tohodog","description":"安卓视频播放器AndroidVideoplayer,架构设计优良功能丰富,支持多种解码,支持设置比例,浮窗,倍速,静音等","archived":false,"fork":false,"pushed_at":"2021-09-13T08:45:14.000Z","size":64799,"stargazers_count":301,"open_issues_count":8,"forks_count":63,"subscribers_count":10,"default_branch":"master","last_synced_at":"2024-08-07T23:55:12.379Z","etag":null,"topics":["android","exo","ffmpeg","ijkplayer","videoplayer"],"latest_commit_sha":null,"homepage":"","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/tohodog.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2017-03-29T06:53:39.000Z","updated_at":"2024-07-26T16:45:50.000Z","dependencies_parsed_at":"2022-08-18T06:42:48.071Z","dependency_job_id":null,"html_url":"https://github.com/tohodog/QSVideoPlayer","commit_stats":null,"previous_names":[],"tags_count":13,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tohodog%2FQSVideoPlayer","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tohodog%2FQSVideoPlayer/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tohodog%2FQSVideoPlayer/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tohodog%2FQSVideoPlayer/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/tohodog","download_url":"https://codeload.github.com/tohodog/QSVideoPlayer/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":226361629,"owners_count":17612932,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["android","exo","ffmpeg","ijkplayer","videoplayer"],"created_at":"2024-08-06T23:02:21.970Z","updated_at":"2024-11-25T16:31:16.764Z","avatar_url":"https://github.com/tohodog.png","language":"Java","funding_links":[],"categories":["HarmonyOS"],"sub_categories":["Windows Manager"],"readme":"![logo][logopng]\n\u003cbr/\u003e\n\u003cbr/\u003e\n---\n\u003cbr/\u003e\n\n[![GitHub release][relesesvg]][relesezip] [![api][apisvg]][api]  [![License][licensesvg]][license]\n\n  * QSVideoView接口完善,功能丰富\n    * 支持设置视频比例\n    * 支持两种悬浮窗\n    * 支持扩展解码器\n    * 智能切换全屏\n    * 支持本地缓存\n    * 支持倍速静音等\n  * 架构设计优良,模块化可扩展设计,解码模块目前提供了 AndroidMedia(系统自带)、ijkMedia(基于ffmepg)+ijkExoMedia(基于exo)、ExoMedia(2.0.4)解码器\n  * 可选择SurfaceView和TextureView\n  * 支持本地视频,在线视频,m3u8直播等\n  * 提供DemoQSVideoView成品播放器,支持手势,清晰度\n  * 极速DIY:只需100行java代码即可打造自己的播放器!\u003cbr/\u003e提供QSVideoViewHelp辅助类,该类提供了常用控件的逻辑和手势调节支持,可快速自定义ui打造自己的播放器,不用写一行播放逻辑\n  * 提供list视频列表自动销毁播放框架\n  * 提供一行代码集成弹幕框架\n\n![qrcode][qrpng]\n\u003cbr/\u003e\n[![apkurl][apkurlsvg]][apkurl]\n\n\n## Preview\n![](https://github.com/tohodog/QSVideoPlayer/raw/master/source/main.png)\n![](https://github.com/tohodog/QSVideoPlayer/raw/master/source/full1.png)\n![](https://github.com/tohodog/QSVideoPlayer/raw/master/source/lsit.gif)\n![](https://github.com/tohodog/QSVideoPlayer/raw/master/source/float.png)\n![](https://github.com/tohodog/QSVideoPlayer/raw/master/source/full2.jpg)\n\n\n## 使用说明\n\n#### Gradle 自动集成\n```\nallprojects {\n    repositories {\n        maven {\n            url \"https://jitpack.io\"\n        }\n    }\n}\n\ndependencies {\n    implementation 'com.github.tohodog:QSVideoPlayer:2.2.9'\n\n    //是否需要其他架构的ijk解码器支持,默认只有v7\n    //so不存在报错可以配置ndk{abiFilters 'armeabi-v7a'}或导入下面的包\n    //implementation 'tv.danmaku.ijk.media:ijkplayer-armv5:0.8.8'\n    //implementation 'tv.danmaku.ijk.media:ijkplayer-arm64:0.8.8'\n    //implementation 'tv.danmaku.ijk.media:ijkplayer-x86:0.8.8'\n    //implementation 'tv.danmaku.ijk.media:ijkplayer-x86_64:0.8.8'\n}\n```\n\n#### 手动集成\n\n下载项目 添加qsvideoplayer文件夹为自己的项目依赖即可\n可根据需求自行选择需要的解码器:\u003cbr/\u003e\n默认一般简单播放视频AndroidMedia足够(体积最小,无依赖)\u003cbr/\u003e\n需求高的可选AndroidMedia+(ijkMedia+ijkExoMedia)(2MB单v7a包)\u003cbr/\u003e\n目前测试解码效果ijkMedia兼容性最好,AndroidMedia个别视频有半途中断BUG,exo无明显缺陷\u003cbr/\u003e\nps:\u003cbr/\u003e如需精简删除ijk解码器: build.gradle注释掉所有依赖,media包里删除IjkBaseMedia IjkExoMedia IjkMedia三个类即可\u003cbr/\u003e\n弹幕、exo解码器在demo里,需要自行下载demo复制集成\n\n## QSVideoView API接口\n```\n    void setUp(String url, Object... objects);//设置视频地址\n\n    void play();//播放/初始化(完成自动播放)\n\n    void prePlay();//初始化(完成不会播放)\n\n    void pause();//暂停\n\n    void seekTo(int duration);//进度调节\n\n    void setPlayListener(PlayListener playListener);//播放监听 参数含义参照IVideoPlayer\n\n    void addPlayListener(PlayListener playListener);//多播放监听\n\n    void removePlayListener(PlayListener playListener);//移除播放监听\n\n    void setAspectRatio(int aspectRatio);//设置视频比例 参数见IRenderView\n\n    void setDecodeMedia(Class\u003c? extends BaseMedia\u003e claxx);//设置解码模块\n    \n    void openCache();//打开缓存\n\n    boolean onBackPressed();//返回键退出全屏\n\n    boolean isPlaying();//是否播放中\n\n    void enterWindowFullscreen();//全屏\n\n    void quitWindowFullscreen();//退出全屏\n\n    boolean enterWindowFloat(FloatParams floatParams);//浮窗 false没权限\n\n    void quitWindowFloat();//退出浮窗\n\n    boolean setMute(boolean isMute);//是否静音 false不支持\n\n    boolean setSpeed(float rate);//设置播放倍速,false不支持\n\n    void release();//销毁\n\n    Bitmap getCurrentFrame();//截图\n\n    int getPosition();//获取播放进度\n\n    int getDuration();//获取视频时长\n\n    int getVideoWidth();//获取视频宽\n\n    int getVideoHeight();//获取视频长\n\n    int getCurrentMode();//获得播放器当前的模式(全屏,普通,浮窗)\n\n    int getCurrentState();//获得播放器当前的状态(播放,暂停,完成...)\n\n```\n\n## Demo使用\n### JAVA\n```\n    //DemoQSVideoView的ui用的jc播放器\n    DemoQSVideoView qsVideoView = (DemoQSVideoView) findViewById(R.id.xxx);\n\n    qsVideoView.setUp(url, \"这是一一一一一一一一一个标题\");\n\n    //设置多个清晰度和ijk配置\n    //List\u003cIjkMedia.Option\u003e list = new ArrayList\u003c\u003e();\n    //list.add(new IjkMedia.Option(IjkMediaPlayer.OPT_CATEGORY_PLAYER, \"soundtouch\", 1));\n    //demoVideoView.setUp(\n    //                QSVideo.Build(url).title(\"这是标清标题\").definition(\"标清\").resolution(\"标清 720P\").build(),\n    //                QSVideo.Build(url).title(\"这是高清标题\").definition(\"高清\").resolution(\"高清 1080P\").option(list).build());\n\n    qsVideoView.getCoverImageView().setImageResource(R.mipmap.cover);//封面\n\n    //设置监听\n    qsVideoView.setPlayListener(new PlayListener() {\n            @Override\n            public void onStatus(int status) {//播放器的ui状态\n                if (status == IVideoPlayer.STATE_AUTO_COMPLETE)\n                    qsVideoView.quitWindowFullscreen();//播放完成退出全屏\n            }\n\n            @Override//全屏/普通/浮窗...\n            public void onMode(int mode) {\n\n            }\n\n            @Override//播放事件 初始化完成/缓冲/出错/点击事件...\n            public void onEvent(int what, Integer... extra) {\n\n            }\n\n        });\n    //进入全屏的模式 0横屏 1竖屏 2传感器自动横竖屏 3根据视频比例自动确定横竖屏      -1什么都不做\n    qsVideoView.enterFullMode=3;\n    qsVideoView.play();\n```\n\n### 返回键退出全屏\n```\n    @Override\n    public void onBackPressed() {\n        if (qsVideoView.onBackPressed())\n            return;\n        super.onBackPressed();\n    }\n```\n\n### XML\n```\n        \u003corg.song.videoplayer.DemoQSVideoView\n                android:id=\"@+id/xxx\"\n                android:layout_width=\"match_parent\"\n                android:layout_height=\"400dp\" /\u003e\n```\n\n### AndroidManifest\n```\n        \u003cactivity\n            android:name=\".VideoActivity\"\n            android:configChanges=\"orientation|keyboardHidden|screenSize\"\u003e\n        \u003c/activity\u003e\n```\n\n### 悬浮窗\n```\n    FloatParams floatParams = new FloatParams();\n    floatParams.x = 0;//浮窗中心坐标x\n    floatParams.y = 0;//浮窗中心坐标y\n    floatParams.w = 540;//宽\n    floatParams.h = 270;//高\n    floatParams.round = 30;//浮窗圆角 需SDK_INT \u003e= 21\n    floatParams.fade = 0.8f;//透明度 需SDK_INT \u003e= 11\n    floatParams.canMove = true;//是否可以拖动\n    floatParams.canCross = false;//是否可以越屏幕边界\n    floatParams.systemFloat = true;TRUE系统浮窗需要权限　FALSE界面内浮窗\n\n    if (!qsVideoView.enterWindowFloat(floatParams)) {\n        Toast.makeText(this,\"没有浮窗权限\",Toast.LENGTH_LONG).show();\n        Intent intent = new Intent(Settings.ACTION_MANAGE_OVERLAY_PERMISSION,\n              Uri.parse(\"package:\" + getPackageName()));\n        startActivityForResult(intent, 0);\n        }\n    }\n```\n\n\n### 生命周期控制\n\u003c/br\u003e实现后台暂停播放,超过15秒销毁,回来还原播放状态,体验好\n```\n    private boolean playFlag;//记录退出时播放状态 回来的时候继续播放\n    private int position;//记录销毁时的进度 回来继续该进度播放\n    private Handler handler = new Handler();\n\n    @Override\n    public void onResume() {\n        super.onResume();\n        if (playFlag)\n            demoVideoView.play();\n        handler.removeCallbacks(runnable);\n        if (position \u003e 0) {\n            demoVideoView.seekTo(position);\n            position = 0;\n        }\n    }\n\n    @Override\n    public void onPause() {\n        super.onPause();\n        if (demoVideoView.isSystemFloatMode())\n            return;\n        //暂停\n        playFlag = demoVideoView.isPlaying();\n        demoVideoView.pause();\n    }\n\n\n    @Override\n    public void onStop() {\n        super.onStop();\n        if (demoVideoView.isSystemFloatMode())\n            return;\n        //进入后台不马上销毁,延时15秒\n        handler.postDelayed(runnable, 1000 * 15);\n    }\n\n    @Override\n    public void onDestroy() {\n        super.onDestroy();//销毁\n        if (demoVideoView.isSystemFloatMode())\n            demoVideoView.quitWindowFloat();\n        demoVideoView.release();\n        handler.removeCallbacks(runnable);\n    }\n\n    private Runnable runnable = new Runnable() {\n        @Override\n        public void run() {\n            if (demoVideoView.getCurrentState() != IVideoPlayer.STATE_AUTO_COMPLETE)\n                position = demoVideoView.getPosition();\n            demoVideoView.release();\n        }\n    };\n```\n\n## DIY播放器:\n0.read source code.\u003cbr/\u003e\u003cbr/\u003e\n1.可直接修改DemoQSVideoView改造自己的播放器\u003cbr/\u003e\u003cbr/\u003e\n2.继承QSVideoViewHelp参考DemoQSVideoView,源码均有注释,不用写一行播放逻辑\u003cbr/\u003e\n    (1) 子类提供layout布局,布局里需要help类实现逻辑的控件,设置id为以下特定id即可\n ```\n    \u003c!--ImageView播放按钮1 2--\u003e\n    \u003citem name=\"help_start\" type=\"id\" /\u003e\n    \u003citem name=\"help_start2\" type=\"id\" /\u003e\n    \u003c!--TextView播放时间  视频时长--\u003e\n    \u003citem name=\"help_total\" type=\"id\" /\u003e\n    \u003citem name=\"help_current\" type=\"id\" /\u003e\n    \u003c!--ProgressBar进度条  SeekBar拖动条--\u003e\n    \u003citem name=\"help_progress\" type=\"id\" /\u003e\n    \u003citem name=\"help_seekbar\" type=\"id\" /\u003e\n    \u003c!--ImageView全屏按钮  View返回按钮--\u003e\n    \u003citem name=\"help_fullscreen\" type=\"id\" /\u003e\n    \u003citem name=\"help_back\" type=\"id\" /\u003e\n\n    //如播放按钮定义,注意: @id 没有加号,这样定义父类会自动完成该按钮逻辑\n    \u003cImageView\n            android:id=\"@id/help_start\"\n            android:layout_width=\"60dp\"\n            android:layout_height=\"60dp\"\n            android:layout_centerInParent=\"true\"/\u003e\n ```\n\u003cbr/\u003e\n    (2) java代码里设置各个状态的ui即可完成自己的播放器,具体参考DemoQSVideoView\u003cbr/\u003e\u003cbr/\u003e\n3.直接使用QSVideoView,自己写控制ui和逻辑\u003cbr/\u003e\n(继承关系:DemoQSVideoView → QSVideoViewHelp → QSVideoView)\n\n\n## Log\n### v2.2.9(2021-09-12)\n  * 全屏虚拟键问题\n  * 优化\n### v2.2.8(2019-04-12)\n  * 清晰度选择\n  * 优化\n### v2.2.7(2019-01-05)\n  * 倍速播放\n  * 优化\n### v2.2.5(2018-10-24)\n  * 支持视频缓存\n### v2.2.4(2018-9-1)\n  * 浮窗超出屏幕回弹效果\n  * 优化\n### v2.2.3(2018-5-12)\n  * +Danmaku(一行代码集成弹幕)\n  * +getCurrentFrame(增加截图\u003e=4.0)\n  * +support systemfloat goback(系统浮窗可返回)\n  * +perfect listenner(完善事件监听)\n### v2.2.2(2018-2-13)\n  * can get the floatparams after moving(可以获取移动后的浮窗参数)\n  * 8.0 callback onInfo (804, -1004) problem(8.0断流回调onInfo(804,-1004)问题)\n  * Immersion Demo(沉浸式Demo)\n### v2.2.1(2018-1-30)\n  * add floatwindow in activity(增加界面内悬浮窗功能,无需权限)\n  * add event(seekbar) listener(增加seekbar事件监听)\n### v2.2.0(2018-1-28)\n  * add floatwindow(增加悬浮窗功能)\n### v2.1.1(2018-1-8)\n  * -add mute(支持静音)\n  * -add enterfullmode(增加进入全屏的模式,根据视频自动确定横竖屏)\n  * -support content uri(支持uri播放)\n  * -fullwindow hide navigation(全屏隐藏虚拟按键)\n  * -fix bug(修复bug)\n\n## Other\n  * 有问题请Add [issues](https://github.com/tohodog/QsVideoPlayer/issues)\n  * 如果项目对你有帮助的话欢迎[![star][starsvg]][star]\n  * logo@[mirzazulfan](https://github.com/mirzazulfan)\n  \n[logopng]: https://raw.githubusercontent.com/tohodog/QSVideoPlayer/master/source/logo.png\n\n[qrpng]: https://raw.githubusercontent.com/tohodog/QSVideoPlayer/master/source/video_qrcode.png\n\n[relesesvg]: https://img.shields.io/github/release/tohodog/QSVideoPlayer.svg\n[relesezip]: https://codeload.github.com/tohodog/QSVideoPlayer/zip/2.2.7\n\n[apkurlsvg]: https://img.shields.io/badge/download-demo.apk-brightgreen.svg?style=flat\n[apkurl]: https://raw.githubusercontent.com/tohodog/QSVideoPlayer/master/source/qsvideoplayer.apk\n\n[apisvg]: https://img.shields.io/badge/API-9+-brightgreen.svg\n[api]: https://android-arsenal.com/api?level=9\n\n[licensesvg]: https://img.shields.io/badge/License-Apache--2.0-red.svg\n[license]: https://github.com/tohodog/QSVideoPlayer/blob/master/LICENSE\n\n[starsvg]: https://img.shields.io/github/stars/tohodog/QSVideoPlayer.svg?style=social\u0026label=Stars\n[star]: https://github.com/tohodog/QSVideoPlayer\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftohodog%2FQSVideoPlayer","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftohodog%2FQSVideoPlayer","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftohodog%2FQSVideoPlayer/lists"}