中文文档

Supports IJKPlayer, Media3(EXOPlayer2), MediaPlayer, AliPlayer, implementing a multi-functional video player. (Please read the following instructions carefully, most questions can be answered below).

* HarmonyOS version openharmony-tpc/GSYVideoPlayer

If cloning is too slow or images are not visible, you can try to synchronize from the following addresses

• GitCode https://gitcode.com/ZuoYueLiang/GSYVideoPlayer
• Gitee：https://gitee.com/CarGuo/GSYVideoPlayer

--------------Demo APK Download Address---------------

I. Using Dependencies

There are currently three hosting methods:

• MavenCentral: Available after version 11.0.0, all base class packages are published and hosted here.
• Github Package: Available from version 9.1.0, but before version 11.0.0, the basic dependencies of GSYIjkJava are still hosted on jitpack.
• Jitpack IO: Will continue to be released, but there is a random loss of packages on the hosting platform.

--- Version Update Instructions --- .

--- Recent Playback Features --- .

ABI and dependency selection in v14.0.0

The gsyvideoplayer aggregate already includes Java, Exo2 and ex_so. For modular IJK setup, choose ex_so or the required standalone ABI modules; do not include two native sets for the same ABI.

Migrated standalone modules and ex_so share codec/protocol configuration. Choose by ABI and package size, rather than the former standard/extended MPEG distinction. Add compose, cast and aliplay only as needed; cast requires API 26, while the core requires API 23. See DECODERS_EN.md and BUILD_SO_EN.md.

1. MavenCentral Reference (Recommended)

Since jitpack keeps losing packages, it has been migrated to MavenCentral. The usage is as follows:

First Add

allprojects {
    repositories {
        ///...
        mavenCentral()
        maven { url "https://maven.aliyun.com/repository/public" }
    }
}

You can choose one of the following three and add it to the build.gradle under the module.

A. Direct Introduction

 //Complete version introduction

implementation 'io.github.carguo:gsyvideoplayer:14.0.0'


//Whether AliPlayer mode is needed
implementation 'io.github.carguo:gsyvideoplayer-aliplay:14.0.0'

//Whether DLNA/UPnP casting is needed (optional, minSdk 26)
implementation 'io.github.carguo:gsyvideoplayer-cast:14.0.0'

B. Add java and the so support you want:

 implementation 'io.github.carguo:gsyvideoplayer-java:14.0.0'

 //Whether ExoPlayer mode is needed
 implementation 'io.github.carguo:gsyvideoplayer-exo2:14.0.0'

 //Optional direct RTMP module; exo2 already exposes it transitively
 implementation 'io.github.carguo:gsyvideoplayer-rtmp:14.0.0'

 //Optional DLNA/UPnP cast implementation (minSdk 26); the default player does not include Jetty
 implementation 'io.github.carguo:gsyvideoplayer-cast:14.0.0'

 //Whether AliPlayer mode is needed
 implementation 'io.github.carguo:gsyvideoplayer-aliplay:14.0.0'

 //Select required ABIs; do not also add ex_so
 implementation 'io.github.carguo:gsyvideoplayer-arm64:14.0.0'
 implementation 'io.github.carguo:gsyvideoplayer-armv7a:14.0.0'
 implementation 'io.github.carguo:gsyvideoplayer-x64:14.0.0'

C. Modular setup with all three migrated ABIs

ex_so bundles all three migrated ABIs with the same codec configuration as the standalone modules in B. Select B when only a subset of ABIs is needed.

 implementation 'io.github.carguo:gsyvideoplayer-java:14.0.0'

 //Whether ExoPlayer mode is needed
 implementation 'io.github.carguo:gsyvideoplayer-exo2:14.0.0'

 //Whether AliPlayer mode is needed
 implementation 'io.github.carguo:gsyvideoplayer-aliplay:14.0.0'

 //IJK native libraries for the three migrated ABIs
 implementation 'io.github.carguo:gsyvideoplayer-ex_so:14.0.0'

D. Jetpack Compose Support (Optional)

The gsyvideoplayer-compose module is published with v13.1.0. It can be consumed from Maven Central / GitHub Packages like the other modules, or by depending on the source module directly with implementation project(":gsyVideoPlayer-compose") when working inside this repository.

🛠 Toolchain note: the Compose module is verified on JDK 21 in CI (.github/workflows/*.yml — actions/setup-java